update roadmap skills and guide documentation
This commit is contained in:
parent
9c66825296
commit
98cc87274b
3 changed files with 30 additions and 9 deletions
|
|
@ -49,7 +49,7 @@ agent-ops/
|
||||||
│ ├── ROADMAP.md
|
│ ├── ROADMAP.md
|
||||||
│ ├── current.md
|
│ ├── current.md
|
||||||
│ └── milestones/
|
│ └── milestones/
|
||||||
│ └── M01-<name>.md
|
│ └── M01-<milestone-slug>.md
|
||||||
└── skills/
|
└── skills/
|
||||||
├── common/ # 공통 스킬 (수정 금지)
|
├── common/ # 공통 스킬 (수정 금지)
|
||||||
│ ├── router.md # 공통 스킬 라우터
|
│ ├── router.md # 공통 스킬 라우터
|
||||||
|
|
|
||||||
|
|
@ -33,15 +33,27 @@ agent-ops/
|
||||||
ROADMAP.md
|
ROADMAP.md
|
||||||
current.md
|
current.md
|
||||||
milestones/
|
milestones/
|
||||||
M01-<slug>.md
|
M01-<milestone-slug>.md
|
||||||
M02-<slug>.md
|
M02-<milestone-slug>.md
|
||||||
```
|
```
|
||||||
|
|
||||||
| 파일 | 역할 |
|
| 파일 | 역할 |
|
||||||
|------|------|
|
|------|------|
|
||||||
| `agent-ops/roadmap/ROADMAP.md` | 전체 Goal, Phase 흐름, Milestone 인덱스. 로드맵 생성/갱신/Phase 전환 때만 읽는다 |
|
| `agent-ops/roadmap/ROADMAP.md` | 전체 Goal, Phase 흐름, Milestone 인덱스. 로드맵 생성/갱신/Phase 전환 때만 읽는다 |
|
||||||
| `agent-ops/roadmap/current.md` | 현재 Phase와 Active Milestone 문서 경로를 가리키는 얇은 포인터 |
|
| `agent-ops/roadmap/current.md` | 현재 Phase와 Active Milestone 문서 경로를 가리키는 얇은 포인터 |
|
||||||
| `agent-ops/roadmap/milestones/MNN-<slug>.md` | 일반 작업 시 읽는 Milestone 단위 Goal, Scope, 기능 목록, Non-Goals |
|
| `agent-ops/roadmap/milestones/MNN-<milestone-slug>.md` | 일반 작업 시 읽는 Milestone 단위 Goal, Scope, 기능 목록, Non-Goals |
|
||||||
|
|
||||||
|
### current.md 형식
|
||||||
|
|
||||||
|
`agent-ops/roadmap/current.md`는 아래 형식을 유지한다.
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Current Roadmap Context
|
||||||
|
|
||||||
|
- Active Phase: <phase-name>
|
||||||
|
- Active Milestone: <MNN milestone-name>
|
||||||
|
- Active Milestone File: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
|
||||||
|
```
|
||||||
|
|
||||||
## 먼저 확인할 것
|
## 먼저 확인할 것
|
||||||
|
|
||||||
|
|
@ -67,12 +79,12 @@ agent-ops/
|
||||||
- 전체 Goal은 프로젝트가 궁극적으로 만들려는 결과를 1~3문장으로 작성한다
|
- 전체 Goal은 프로젝트가 궁극적으로 만들려는 결과를 1~3문장으로 작성한다
|
||||||
- Phase는 큰 진화 단위로 나누고, 각 Phase에 Goal을 둔다
|
- Phase는 큰 진화 단위로 나누고, 각 Phase에 Goal을 둔다
|
||||||
- Milestone은 Phase 안에서 완료 판단이 가능한 단위로 나눈다
|
- Milestone은 Phase 안에서 완료 판단이 가능한 단위로 나눈다
|
||||||
- Milestone ID는 `M01`, `M02`처럼 2자리 번호를 사용하고 파일명은 `M01-<kebab-slug>.md`로 만든다
|
- Milestone ID는 `M01`, `M02`처럼 2자리 번호를 사용하고 파일명은 `M01-<milestone-slug>.md`로 만든다
|
||||||
- 상태 값은 `Planned`, `Active`, `Done`, `Paused`, `Dropped` 중 하나만 사용한다
|
- 상태 값은 `Planned`, `Active`, `Done`, `Paused`, `Dropped` 중 하나만 사용한다
|
||||||
|
|
||||||
4. **로드맵 파일 생성**
|
4. **로드맵 파일 생성**
|
||||||
- `agent-ops/roadmap/ROADMAP.md`에는 전체 Goal, 현재 위치, Phase 개요, Milestone 인덱스, 로딩 정책을 작성한다
|
- `agent-ops/roadmap/ROADMAP.md`에는 전체 Goal, 현재 위치, Phase 개요, Milestone 인덱스, 로딩 정책을 작성한다
|
||||||
- `agent-ops/roadmap/current.md`에는 Active Phase와 Active Milestone 문서 경로만 간결하게 작성한다
|
- `agent-ops/roadmap/current.md`에는 정해진 `current.md 형식` 그대로 Active Phase와 Active Milestone 문서 경로만 작성한다
|
||||||
- 각 Milestone 문서에는 아래 섹션을 포함한다
|
- 각 Milestone 문서에는 아래 섹션을 포함한다
|
||||||
- `Goal`
|
- `Goal`
|
||||||
- `Phase`
|
- `Phase`
|
||||||
|
|
@ -119,7 +131,7 @@ agent-ops/
|
||||||
|
|
||||||
- Roadmap: agent-ops/roadmap/ROADMAP.md
|
- Roadmap: agent-ops/roadmap/ROADMAP.md
|
||||||
- Current Context: agent-ops/roadmap/current.md
|
- Current Context: agent-ops/roadmap/current.md
|
||||||
- Active Milestone: agent-ops/roadmap/milestones/MNN-<slug>.md
|
- Active Milestone: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
|
||||||
- Project Rules 업데이트: <추가함 | 이미 존재함 | rules/project/rules.md 없음>
|
- Project Rules 업데이트: <추가함 | 이미 존재함 | rules/project/rules.md 없음>
|
||||||
|
|
||||||
## 현재 위치
|
## 현재 위치
|
||||||
|
|
|
||||||
|
|
@ -40,6 +40,7 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
|
||||||
- [ ] `agent-ops/roadmap/ROADMAP.md` 존재 여부 확인
|
- [ ] `agent-ops/roadmap/ROADMAP.md` 존재 여부 확인
|
||||||
- [ ] `agent-ops/roadmap/current.md` 존재 여부 확인
|
- [ ] `agent-ops/roadmap/current.md` 존재 여부 확인
|
||||||
- [ ] `current.md`가 가리키는 Active Milestone 문서 존재 여부 확인
|
- [ ] `current.md`가 가리키는 Active Milestone 문서 존재 여부 확인
|
||||||
|
- [ ] `current.md`가 정해진 형식을 유지하는지 확인
|
||||||
- [ ] 로드맵 파일이 없으면 `create-roadmap` 스킬 사용을 안내하고 중단
|
- [ ] 로드맵 파일이 없으면 `create-roadmap` 스킬 사용을 안내하고 중단
|
||||||
- [ ] 완료 상태로 바꾸는 경우 사용자의 명시 또는 확인 가능한 evidence가 있는지 확인
|
- [ ] 완료 상태로 바꾸는 경우 사용자의 명시 또는 확인 가능한 evidence가 있는지 확인
|
||||||
|
|
||||||
|
|
@ -63,7 +64,14 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
|
||||||
|
|
||||||
4. **로드맵 파일 갱신**
|
4. **로드맵 파일 갱신**
|
||||||
- `ROADMAP.md`는 전체 Goal, Phase 개요, Milestone 인덱스, 현재 위치가 바뀔 때만 수정한다
|
- `ROADMAP.md`는 전체 Goal, Phase 개요, Milestone 인덱스, 현재 위치가 바뀔 때만 수정한다
|
||||||
- `current.md`는 Active Phase 또는 Active Milestone이 바뀔 때 수정한다
|
- `current.md`는 Active Phase 또는 Active Milestone이 바뀔 때 아래 형식으로 수정한다
|
||||||
|
```markdown
|
||||||
|
# Current Roadmap Context
|
||||||
|
|
||||||
|
- Active Phase: <phase-name>
|
||||||
|
- Active Milestone: <MNN milestone-name>
|
||||||
|
- Active Milestone File: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
|
||||||
|
```
|
||||||
- Milestone 문서는 해당 Milestone의 Goal, Scope, Required Features, Success Criteria, Non-Goals, Context for Work가 바뀔 때 수정한다
|
- Milestone 문서는 해당 Milestone의 Goal, Scope, Required Features, Success Criteria, Non-Goals, Context for Work가 바뀔 때 수정한다
|
||||||
- 상태 값은 `Planned`, `Active`, `Done`, `Paused`, `Dropped` 중 하나만 사용한다
|
- 상태 값은 `Planned`, `Active`, `Done`, `Paused`, `Dropped` 중 하나만 사용한다
|
||||||
- 완료된 Milestone의 기록은 삭제하지 않고 상태만 변경한다
|
- 완료된 Milestone의 기록은 삭제하지 않고 상태만 변경한다
|
||||||
|
|
@ -82,6 +90,7 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
|
||||||
## 실행 결과 검증
|
## 실행 결과 검증
|
||||||
|
|
||||||
- [ ] `current.md`의 Active Milestone 경로가 실제 파일을 가리키는가
|
- [ ] `current.md`의 Active Milestone 경로가 실제 파일을 가리키는가
|
||||||
|
- [ ] `current.md`가 `# Current Roadmap Context`, `Active Phase`, `Active Milestone`, `Active Milestone File` 형식을 유지하는가
|
||||||
- [ ] `ROADMAP.md`의 현재 위치와 Milestone 인덱스가 `current.md`와 일치하는가
|
- [ ] `ROADMAP.md`의 현재 위치와 Milestone 인덱스가 `current.md`와 일치하는가
|
||||||
- [ ] 대상 Milestone 문서의 상태가 `ROADMAP.md`의 Milestone 인덱스 상태와 일치하는가
|
- [ ] 대상 Milestone 문서의 상태가 `ROADMAP.md`의 Milestone 인덱스 상태와 일치하는가
|
||||||
- [ ] 완료 처리한 기능에 사용자 설명 또는 확인 가능한 evidence가 있는가
|
- [ ] 완료 처리한 기능에 사용자 설명 또는 확인 가능한 evidence가 있는가
|
||||||
|
|
@ -97,7 +106,7 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
|
||||||
- 수정 파일:
|
- 수정 파일:
|
||||||
- agent-ops/roadmap/ROADMAP.md
|
- agent-ops/roadmap/ROADMAP.md
|
||||||
- agent-ops/roadmap/current.md
|
- agent-ops/roadmap/current.md
|
||||||
- agent-ops/roadmap/milestones/MNN-<slug>.md
|
- agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
|
||||||
|
|
||||||
## 변경 사항
|
## 변경 사항
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue