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