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

6.4 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도 로드맵에서 제거하지 않고, archive의 Phase 문서로 연결한다. 검토중 또는 진행중 Phase는 계획 Phase보다 위에 두어, 아래로 갈수록 미래 작업에 가까워지게 정렬한다. 스케치 Phase는 아직 구현 가능한 계획이 아니므로 계획 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 전체에서 에이전트가 확정할 수 없는 결정 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 구현 잠금 상태를 해제로 둔다.