3.5 KiB
3.5 KiB
로드맵
전체 목표
<프로젝트가 최종적으로 달성하려는 결과를 1~3문장으로 작성>
Phase 흐름
위에서 아래로 진행된 순서와 예정 흐름을 나타낸다. 완료된 Phase도 로드맵에서 제거하지 않고, archive의 Phase 문서로 연결한다. 진행중 Phase는 계획 Phase보다 위에 두어, 아래로 갈수록 미래 계획에 가까워지게 정렬한다.
- [<계획 | 진행중 | 완료 | 보류 | 폐기>] <Phase 이름>
- 경로:
agent-ops/roadmap/phase/<phase-slug>/PHASE.md또는agent-ops/roadmap/archive/phase/<phase-slug>/PHASE.md - 요약: <이 Phase의 목표와 역할 1문장>
- 경로:
로딩 정책
- 일반 작업에서는
agent-ops/roadmap/ROADMAP.md를 매번 읽지 않는다. - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는
agent-ops/roadmap/current.md를 먼저 읽는다. current.md는 현재 작업 위치가 아니라 활성 Phase와 활성 Milestone 후보 목록이다.current.md에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.current.md의 활성 Phase는agent-ops/roadmap/phase/<phase-slug>/PHASE.md를 가리킨다.current.md의 활성 Milestone은agent-ops/roadmap/phase/<phase-slug>/milestones/<milestone-slug>.md를 가리킨다.current.md는agent-ops/roadmap/archive/**경로를 활성 항목으로 포함하지 않는다.- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Phase와 Milestone 문서를 같은 세션에서 1회 읽는다.
- 활성 Phase 또는 Milestone 밖의 작업이면 이 문서의 Phase 흐름을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
- 이 문서는 로드맵 생성/갱신, Phase 전환, Phase 추가/수정, 전체 구조 변경 요청이 있을 때만 읽는다.
- 상세 작업과 완료 기준은 각 Milestone 문서의
필수 기능,완료 기준으로 관리한다. - 완료된 Phase는
agent-ops/roadmap/archive/phase/<phase-slug>/PHASE.md로 이동하고, 하위 Milestone도 같은 archive Phase scaffold 아래에 둔다. - 진행중 Phase 안에서 완료된 Milestone은 활성 Phase 문서에 짧은 링크를 남기고, 상세 문서는
agent-ops/roadmap/archive/phase/<phase-slug>/milestones/로 이동한다. - archive
PHASE.md는 Phase 자체가 완료 또는 폐기될 때만 만들며, 진행중 Phase의 완료 Milestone만 archive된 경우 archive Phase 디렉터리에milestones/만 있을 수 있다. agent-ops/roadmap/archive/**는 일반 작업에서 읽지 않는다. 과거 완료 내용, 완료 근거, 복원, 비교가 필요한 경우에만ROADMAP.md또는PHASE.md의 archive 링크를 따라가서 읽는다.- 아카이브된 Phase/Milestone 문서는 최신 템플릿이나 스킬 규약에 맞춰 재포맷하지 않는다.
- 선택된 Milestone의
구현 잠금섹션이 없거나 상태가잠금이면 코드 구현,agent-task구현 계획 생성, 세부 API/파일 구조 확정을 시작하기 전에 현재 요청에 직접 영향을 주는결정 필요항목만 확인한다. - 현재 요청과 직접 관련 없는 미정 항목은 잠금 상태로 남겨도 되며, 기존 구조/도메인 rule/플랫폼 관례로 정할 수 있는 작업은 표준선으로 기록하고 진행할 수 있다.
- Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면
구현 잠금상태를해제로 둔다.