toki/alt
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
alt/agent-ops/skills/common/_templates/roadmap-template.md

6.5 KiB
Raw Blame History

로드맵

고정 실행 순서

  • 전역 Milestone 실행 순서는 전역 마일스톤 실행 순서를 먼저 확인한다.
  • Phase는 도메인/책임 영역이며 순차 실행 게이트가 아니다.
  • Phase 흐름과 상태는 로드맵 구조를 설명하고, 실제 다음 작업 선택은 priority-queue.md의 위아래 순서를 우선한다.
  • priority-queue.md는 순서 전용 문서이며, 상태, 목표, 범위, 잠금, 기능, 완료 근거는 각 Milestone 문서를 원본으로 삼는다.
  • priority-queue.md 항목은 Milestone 제목 링크와 식별용 한 줄 설명만 둔다.
  • priority-queue.md는 로드맵 생성 시 함께 만들며, 실행 후보가 없을 때도 문서와 실행 순서 섹션은 유지한다.
  • priority-queue.md는 사용자가 순서 조정을 요청한 경우, Milestone archive 시 완료 항목 제거가 필요한 경우, 큐에 있는 Milestone이 폐기, 경로 변경, split/merge, 또는 실행 의미가 바뀔 정도로 수정된 경우에만 재정렬한다.
  • priority-queue.md의 링크가 깨졌으면 활성 Milestone 문서를 기준으로 큐를 재정렬하거나 재생성한다.

전체 목표

<프로젝트가 최종적으로 달성하려는 결과를 1~3문장으로 작성>

Phase 흐름

Phase는 실행 순서가 아니라 도메인/책임 영역의 구조적 지도다. 완료된 Phase도 로드맵에서 제거하지 않고, archive의 Phase 문서로 연결한다. 상태 그룹은 완료, 검토중, 진행중, 계획, 스케치 순서로 정리해 각 도메인 축의 성숙도와 정리 상태를 읽기 쉽게 한다. 실제 다음 작업 선택은 전역 마일스톤 실행 순서의 위아래 순서를 우선한다.

  • [<스케치 | 계획 | 진행중 | 검토중 | 완료 | 보류 | 폐기>] <Phase 이름>

로딩 정책

  • 일반 작업에서는 ROADMAP.md를 매번 읽지 않는다.
  • Phase를 가로지르는 다음 작업 후보를 고를 때는 전역 마일스톤 실행 순서를 먼저 확인한다.
  • 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 current.md를 먼저 읽는다.
  • current.md는 현재 작업 위치가 아니라 활성 Phase와 활성 Milestone 후보 목록이다.
  • current.md는 브랜치별 로컬 포인터이며 git 추적 대상이 아니다. 로드맵 기반 계획/갱신에서 없으면 agent-ops/skills/common/_templates/roadmap-current-template.md 형식으로 생성해 사용하고, 읽기 전용 현지점 확인에서는 생성하지 않는다.
  • current.md에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
  • current.md의 활성 Phase는 PHASE.md를 가리킨다.
  • current.md의 활성 Milestone은 Milestone 문서를 가리킨다.
  • current.md는 agent-roadmap/archive/** 경로를 활성 항목으로 포함하지 않는다.
  • 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Phase와 Milestone 문서를 같은 세션에서 1회 읽는다.
  • 활성 Phase 또는 Milestone 밖의 작업이면 이 문서의 Phase 흐름을 확인하고 범위 충돌을 보고한다. 제품/범위 결정이 필요하면 대상 Milestone의 구현 잠금 > 결정 필요 또는 SDD USER_REVIEW.md로 분리한다.
  • 이 문서는 로드맵 생성/갱신, Phase 전환, Phase 추가/수정, 전체 구조 변경 요청이 있을 때만 읽는다.
  • 상세 작업은 각 Milestone 문서의 기능으로 관리한다. 검증이 필요한 기능만 같은 Task 안에 검증:으로 통합한다.
  • 큰 Milestone의 설계 게이트는 SDD.md에 두고, Milestone 구현 잠금의 SDD 조건과 연결한다.
  • SDD 사용자 리뷰가 필요하면 USER_REVIEW.md로 남기며, 해결 후 user_review_N.log로 보존한다.
  • [스케치] Phase/Milestone은 방향성, 문제의식, 후보 범위, 미정 질문을 기록하는 컨셉 상태이며 구현 계획 생성 대상이 아니다.
  • [스케치] 항목은 승격 조건을 정리해 [계획]으로 전환한 뒤 구현 계획을 만든다.
  • 모든 기능 Task와 Task 안에 명시된 검증이 충족되고 구현 잠금이 해제된 Milestone은 먼저 [검토중]으로 두고, 완료 근거와 archive 조건이 정리되면 [완료]로 전환한다.
  • 완료된 Phase는 archive PHASE.md로 이동하고, 하위 Milestone도 같은 archive Phase scaffold 아래에 둔다.
  • 진행중 Phase 안에서 완료된 Milestone은 활성 Phase 문서에 짧은 링크를 남기고, 상세 문서는 archive milestones로 이동한다.
  • archive PHASE.md는 Phase 자체가 완료 또는 폐기될 때만 만들며, 진행중 Phase의 완료 Milestone만 archive된 경우 archive Phase 디렉터리에 milestones/만 있을 수 있다.
  • agent-roadmap/archive/**는 일반 작업에서 읽지 않는다. 과거 완료 내용, 완료 근거, 복원, 비교가 필요한 경우에만 ROADMAP.md 또는 PHASE.md의 archive 링크를 따라가서 읽는다.
  • 아카이브된 Phase/Milestone 문서는 최신 템플릿이나 스킬 규약에 맞춰 재포맷하지 않는다.
  • 선택된 Milestone의 구현 잠금 섹션이 없거나, 상태가 잠금이거나, 미완료 결정 필요 항목이 있으면 코드 구현, agent-task 구현 계획 생성, 세부 API/파일 구조 확정을 시작하지 않는다.
  • 선택된 Milestone에 SDD: 필요가 있으면 SDD 상태가 [승인됨]이고 SDD 잠금이 해제되었으며 SDD 사용자 리뷰가 없어야 구현 계획을 만들 수 있다.
  • 잠금 상태의 Milestone에서는 "현재 요청과 직접 관련 없음"을 이유로 실구현 계획이나 코드 구현을 진행하지 않는다. 먼저 roadmap-only 갱신으로 범위 제외, 후속 Milestone, 작업 컨텍스트 이동 또는 잠금 해제를 문서화한다.
  • Milestone 전체에서 에이전트가 확정할 수 없는 결정 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 구현 잠금 상태를 해제로 둔다.