From f67cd18ef59068ca0a43588fd11b1c892a8f6e70 Mon Sep 17 00:00:00 2001 From: toki Date: Fri, 22 May 2026 09:09:07 +0900 Subject: [PATCH] sync: agent-ops from agentic-framework v1.1.26 --- .../_templates/roadmap-current-template.md | 12 +++ .../_templates/roadmap-milestone-template.md | 37 ++++++++ .../common/_templates/roadmap-template.md | 26 ++++++ .../skills/common/create-roadmap/SKILL.md | 72 +++++++++------- .../skills/common/update-roadmap/SKILL.md | 84 +++++++++++++------ 5 files changed, 173 insertions(+), 58 deletions(-) create mode 100644 agent-ops/skills/common/_templates/roadmap-current-template.md create mode 100644 agent-ops/skills/common/_templates/roadmap-milestone-template.md create mode 100644 agent-ops/skills/common/_templates/roadmap-template.md diff --git a/agent-ops/skills/common/_templates/roadmap-current-template.md b/agent-ops/skills/common/_templates/roadmap-current-template.md new file mode 100644 index 0000000..47711d3 --- /dev/null +++ b/agent-ops/skills/common/_templates/roadmap-current-template.md @@ -0,0 +1,12 @@ +# 현재 로드맵 컨텍스트 + +## 활성 Milestone + +- : agent-ops/roadmap/milestones/.md + +## 선택 규칙 + +- 이 문서는 활성 Milestone 후보 목록이며, 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다. +- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택하고 같은 세션에서 1회 읽는다. +- 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. +- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. diff --git a/agent-ops/skills/common/_templates/roadmap-milestone-template.md b/agent-ops/skills/common/_templates/roadmap-milestone-template.md new file mode 100644 index 0000000..825e92f --- /dev/null +++ b/agent-ops/skills/common/_templates/roadmap-milestone-template.md @@ -0,0 +1,37 @@ +# + +## 목표 + +<이 Milestone이 끝났을 때 달성되어야 하는 결과를 1~3문장으로 작성> + +## 단계 + + + +## 상태 + +<계획 | 진행 중 | 완료 | 보류 | 폐기> + +## 범위 + +- <이 Milestone에 포함되는 제품/기술/문서 범위> + +## 필수 기능 + +- [ ] <완료 가능한 태스크> + - [ ] <필요한 하위 작업> + +## 완료 기준 + +- [ ] <완료 여부를 확인할 수 있는 기준> + +## 범위 제외 + +- <이 Milestone에서 의도적으로 하지 않는 일> + +## 작업 컨텍스트 + +- 관련 경로: `` +- 선행 작업: <없음 또는 Milestone/태스크 이름> +- 후속 작업: <없음 또는 Milestone/태스크 이름> +- 확인 필요: diff --git a/agent-ops/skills/common/_templates/roadmap-template.md b/agent-ops/skills/common/_templates/roadmap-template.md new file mode 100644 index 0000000..cb7eb65 --- /dev/null +++ b/agent-ops/skills/common/_templates/roadmap-template.md @@ -0,0 +1,26 @@ +# 로드맵 + +## 전체 목표 + +<프로젝트가 최종적으로 달성하려는 결과를 1~3문장으로 작성> + +## Phase 흐름 + +- : <이 Phase의 목표와 역할> + +## Milestone 목록 + +### + +- [](milestones/.md) - 상태: <계획 | 진행 중 | 완료 | 보류 | 폐기>; 목표: <짧은 목표 요약> + +## 로딩 정책 + +- 일반 작업에서는 `agent-ops/roadmap/ROADMAP.md`를 매번 읽지 않는다. +- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다. +- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. +- `current.md`에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다. +- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다. +- 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. +- 이 문서는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다. +- 상세 작업과 완료 기준은 각 Milestone 문서의 체크리스트로 관리한다. diff --git a/agent-ops/skills/common/create-roadmap/SKILL.md b/agent-ops/skills/common/create-roadmap/SKILL.md index d29518c..5db6ea3 100644 --- a/agent-ops/skills/common/create-roadmap/SKILL.md +++ b/agent-ops/skills/common/create-roadmap/SKILL.md @@ -1,6 +1,6 @@ --- name: create-roadmap -version: 1.2.0 +version: 1.4.0 description: AI-first 개인/소규모 프로젝트의 전체 목표, Phase, 순번 없는 Milestone 문서, 활성 Milestone 창을 처음 생성하는 공통 스킬 --- @@ -40,7 +40,23 @@ agent-ops/ |------|------| | `agent-ops/roadmap/ROADMAP.md` | 전체 목표, Phase 흐름, 문서 순서 기반 Milestone 목록. 로드맵 생성/갱신/Phase 전환 때만 읽는다 | | `agent-ops/roadmap/current.md` | 지금 열려 있는 활성 Milestone 창과 선택 규칙을 담는 얇은 포인터 | -| `agent-ops/roadmap/milestones/.md` | 일반 작업 시 읽는 Milestone 단위 목표, 범위, 기능 목록, 범위 제외 항목 | +| `agent-ops/roadmap/milestones/.md` | 일반 작업 시 읽는 Milestone 단위 목표, 범위, 태스크 체크리스트, 범위 제외 항목 | + +## 로드맵 문서 템플릿 + +- `agent-ops/roadmap/ROADMAP.md`는 `agent-ops/skills/common/_templates/roadmap-template.md` 형식을 따른다. +- `agent-ops/roadmap/current.md`는 `agent-ops/skills/common/_templates/roadmap-current-template.md` 형식을 따른다. +- `ROADMAP.md`는 전체 목표, Phase 흐름, Milestone 목록, 로딩 정책만 담고, 상세 작업 체크리스트를 넣지 않는다. +- `current.md`는 활성 Milestone 후보 목록과 선택 규칙만 담고, 개인별 현재 작업 위치나 완료 상태를 적지 않는다. + +## Milestone 문서 템플릿 + +- 새 Milestone 문서는 `agent-ops/skills/common/_templates/roadmap-milestone-template.md` 형식을 따른다. +- 섹션 순서는 `목표`, `단계`, `상태`, `범위`, `필수 기능`, `완료 기준`, `범위 제외`, `작업 컨텍스트`를 유지한다. +- `필수 기능`은 해야 할 작업 목록이므로 `- [ ]` 체크리스트로 작성한다. 완료 근거가 명확한 항목만 `- [x]`로 표시한다. +- `필수 기능`의 하위 작업도 체크리스트로 작성하고, 부모 태스크를 완성하는 구현 세부/보완/테스트/문서화 항목만 하위에 둔다. +- `완료 기준`은 검증 가능한 조건의 체크리스트로 작성한다. +- `범위`, `범위 제외`, `작업 컨텍스트`는 설명 목록으로 작성하고, 실행해야 할 작업을 이 섹션에 숨기지 않는다. ## 작성 언어 @@ -59,21 +75,7 @@ agent-ops/ ### current.md 형식 -`agent-ops/roadmap/current.md`는 아래 형식을 유지한다. - -```markdown -# 현재 로드맵 컨텍스트 - -## 활성 Milestone - -- : agent-ops/roadmap/milestones/.md - -## 선택 규칙 - -- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택한다. -- 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. -- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. -``` +`agent-ops/roadmap/current.md`는 `agent-ops/skills/common/_templates/roadmap-current-template.md` 형식을 유지한다. `current.md`는 개인별 작업 위치가 아니라 현재 열어둘 Milestone 후보 목록이다. 실제 현 작업 지점과 남은 작업은 `analyze-roadmap-position` 스킬이 코드와 git 상태를 함께 읽고 분석한다. @@ -83,6 +85,9 @@ agent-ops/ - [ ] 이미 존재하면 덮어쓰지 말고 `update-roadmap` 스킬 사용을 안내 - [ ] `README.md`, `agent-ops/GUIDE.md`, `agent-ops/rules/project/rules.md` 등 프로젝트 방향을 설명하는 문서를 확인 - [ ] `rg --files`로 현재 프로젝트의 주요 구조를 가볍게 확인 +- [ ] `agent-ops/skills/common/_templates/roadmap-template.md`를 읽어 최신 ROADMAP 형식 확인 +- [ ] `agent-ops/skills/common/_templates/roadmap-current-template.md`를 읽어 최신 current.md 형식 확인 +- [ ] `agent-ops/skills/common/_templates/roadmap-milestone-template.md`를 읽어 최신 Milestone 형식 확인 - [ ] `agent-ops/rules/project/rules.md`가 있으면 마일스톤 컨텍스트 로딩 섹션 추가 위치 확인 ## 실행 절차 @@ -105,18 +110,15 @@ agent-ops/ - 상태 값은 `계획`, `진행 중`, `완료`, `보류`, `폐기` 중 하나만 사용한다. 4. **로드맵 파일 생성** - - `agent-ops/roadmap/ROADMAP.md`에는 전체 목표, Phase 개요, Milestone 목록, 로딩 정책을 작성한다. - - `agent-ops/roadmap/current.md`에는 정해진 `current.md 형식` 그대로 활성 Milestone 목록과 선택 규칙을 작성한다. - - 각 Milestone 문서에는 아래 섹션을 포함한다. - - `목표` - - `단계` - - `상태` - - `범위` - - `필수 기능` - - `완료 기준` - - `범위 제외` - - `작업 컨텍스트` - - 미래 Milestone은 확정된 내용만 작성하고, 불확실한 기능은 TODO로 둔다. + - `agent-ops/roadmap/ROADMAP.md`는 `roadmap-template.md`의 섹션 순서와 형식을 따른다. + - `agent-ops/roadmap/current.md`는 `roadmap-current-template.md`의 섹션 순서와 형식을 따른다. + - `ROADMAP.md`에는 전체 목표, Phase 흐름, Milestone 목록, 로딩 정책을 작성하고, 상세 작업 체크리스트는 Milestone 문서에 둔다. + - `current.md`에는 활성 Milestone 목록과 선택 규칙만 작성하고, 개인별 현재 작업 위치나 완료 상태는 적지 않는다. + - 각 Milestone 문서는 `roadmap-milestone-template.md`의 섹션 순서와 형식을 따른다. + - `필수 기능`과 그 하위 작업은 `- [ ]` 체크리스트로 작성한다. + - 완료 근거가 확인된 항목만 `- [x]`로 표시하고, 근거가 없으면 체크하지 않는다. + - `완료 기준`도 검증 가능한 조건의 `- [ ]` 체크리스트로 작성한다. + - 미래 Milestone은 확정된 내용만 `필수 기능`에 넣고, 불확실한 기능은 `작업 컨텍스트`의 확인 필요 항목으로 둔다. 5. **마일스톤 컨텍스트 로딩 규칙 추가** - `agent-ops/rules/project/rules.md`가 있으면 아래 섹션을 추가한다. @@ -125,10 +127,12 @@ agent-ops/ - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다. - `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. + - `current.md`에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다. - 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다. - 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. - 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. - `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다. + - 상세 작업과 완료 기준은 각 Milestone 문서의 체크리스트로 관리한다. - 작업 요청이 선택된 Milestone의 목표 또는 범위 제외 항목과 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다. ``` - 같은 섹션이 이미 있으면 중복 추가하지 않고 필요한 문장만 보완한다. @@ -144,8 +148,11 @@ agent-ops/ - [ ] `agent-ops/roadmap/ROADMAP.md`가 생성되었는가 - [ ] `agent-ops/roadmap/current.md`가 활성 Milestone 문서 경로를 정확히 가리키는가 +- [ ] `ROADMAP.md`가 `roadmap-template.md`의 섹션 순서와 형식을 따르는가 +- [ ] `current.md`가 `roadmap-current-template.md`의 섹션 순서와 형식을 따르는가 - [ ] `agent-ops/roadmap/milestones/` 하위에 순번 없는 Milestone 문서가 생성되었는가 -- [ ] 각 Milestone 문서가 한국어 필수 섹션을 포함하는가 +- [ ] 각 Milestone 문서가 `roadmap-milestone-template.md`의 섹션 순서와 형식을 따르는가 +- [ ] 각 Milestone 문서의 `필수 기능`과 `완료 기준`이 체크리스트 형식인가 - [ ] `ROADMAP.md`에 전체 로드맵을 일반 작업마다 읽지 말라는 로딩 정책이 포함되었는가 - [ ] `agent-ops/rules/project/rules.md`가 있는 경우 마일스톤 컨텍스트 로딩 섹션이 추가되었는가 - 검증 실패 시: 누락된 파일이나 섹션만 보완하고 기존 내용을 덮어쓰지 않는다. @@ -175,6 +182,9 @@ agent-ops/ - 기존 `agent-ops/roadmap/` 파일을 덮어쓰지 않는다. - 일반 작업마다 전체 `ROADMAP.md`를 읽도록 규칙을 만들지 않는다. - Phase와 Milestone 이름 또는 파일명에 순번을 강제하지 않는다. -- Milestone 문서를 단순 TODO 목록으로만 만들지 않는다. 반드시 목표, 범위, 완료 기준, 범위 제외 항목을 포함한다. +- `ROADMAP.md`에 Milestone 상세 작업 체크리스트를 넣지 않는다. +- `current.md`에 개인별 현재 작업 위치나 완료 상태를 적지 않는다. +- Milestone 문서를 단순 TODO 목록으로만 만들지 않는다. 반드시 템플릿의 목표, 단계, 상태, 범위, 필수 기능, 완료 기준, 범위 제외, 작업 컨텍스트를 포함한다. +- 해야 할 작업을 일반 불릿이나 설명 문장에 숨기지 않는다. `필수 기능` 또는 그 하위 작업의 체크리스트로 작성한다. - 확정되지 않은 제품 방향을 사실처럼 단정하지 않는다. - `agent-ops/rules/common/`이나 `agent-ops/skills/common/`을 타겟 프로젝트에서 직접 수정하지 않는다. diff --git a/agent-ops/skills/common/update-roadmap/SKILL.md b/agent-ops/skills/common/update-roadmap/SKILL.md index cf151ea..5d44147 100644 --- a/agent-ops/skills/common/update-roadmap/SKILL.md +++ b/agent-ops/skills/common/update-roadmap/SKILL.md @@ -1,6 +1,6 @@ --- name: update-roadmap -version: 1.4.0 +version: 1.6.0 description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국어 로드맵을 갱신하고 신규 작업의 삽입 위치와 단위를 사용자 지정 또는 자동 판단으로 배치하며 current.md의 활성 Milestone 창을 동기화하는 공통 스킬 --- @@ -19,6 +19,8 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - 특정 기능이나 작업을 새 Milestone, 기존 Milestone의 태스크, 기존 태스크 하위 항목 중 적절한 위치에 추가해야 할 때 - 활성 Milestone 창에 포함할 Milestone 목록이 달라졌을 때 - 기본 목표, Phase, Milestone의 목표, 범위, 필수 기능, 완료 기준이 달라졌을 때 +- `ROADMAP.md` 또는 `current.md` 형식이 템플릿과 달라 표준화해야 할 때 +- Milestone 문서 형식이 제각각이라 템플릿 기준으로 표준화해야 할 때 - 실제 구현 상태와 로드맵 파일이 어긋난 것 같아 동기화가 필요할 때 ## 입력 @@ -36,8 +38,8 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 | mode | 사용 상황 | |------|-----------| -| `status` | 기능 체크박스, Milestone 상태, 완료 기준만 갱신 | -| `milestone` | Milestone 목표, 범위, 기능 목록, 완료 기준 수정 | +| `status` | 태스크 체크박스, Milestone 상태, 완료 기준만 갱신 | +| `milestone` | Milestone 목표, 범위, 태스크 체크리스트, 완료 기준 수정 | | `phase` | Phase 설명 또는 활성 Milestone 창 전환 | | `replan` | 전체 Phase/Milestone 흐름 재구성 | | `sync` | 실제 프로젝트 상태와 로드맵 불일치 점검 후 보정 | @@ -59,6 +61,27 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - `Non-Goals` -> `범위 제외` - `Context for Work` -> `작업 컨텍스트` +## 로드맵 문서 템플릿 + +- `agent-ops/roadmap/ROADMAP.md`는 `agent-ops/skills/common/_templates/roadmap-template.md` 형식을 기준으로 생성·갱신한다. +- `agent-ops/roadmap/current.md`는 `agent-ops/skills/common/_templates/roadmap-current-template.md` 형식을 기준으로 생성·갱신한다. +- `ROADMAP.md` 표준 섹션은 `전체 목표`, `Phase 흐름`, `Milestone 목록`, `로딩 정책`이다. +- `ROADMAP.md`에는 Phase/Milestone 흐름과 문서 링크만 두고, 상세 작업 체크리스트는 Milestone 문서에 둔다. +- `current.md` 표준 섹션은 `활성 Milestone`, `선택 규칙`이다. +- `current.md`는 활성 Milestone 후보 목록이며, 개인별 현재 작업 위치나 완료 상태의 진실로 쓰지 않는다. +- 갱신 범위에 포함된 `ROADMAP.md`나 `current.md`가 템플릿과 다르면, 프로젝트 로드맵 정보는 보존하면서 표준 섹션 순서로 재배치한다. +- `current.md`에 남아 있는 개인별 또는 세션별 작업 위치/완료 상태는 공유 로드맵 정보로 이관하지 말고 결과 보고의 확인 필요 항목에 남긴다. + +## Milestone 문서 템플릿 + +- Milestone 문서는 `agent-ops/skills/common/_templates/roadmap-milestone-template.md` 형식을 기준으로 생성·갱신한다. +- 표준 섹션 순서는 `목표`, `단계`, `상태`, `범위`, `필수 기능`, `완료 기준`, `범위 제외`, `작업 컨텍스트`다. +- 갱신 범위에 포함된 Milestone 문서가 제각각 형식이면, 내용을 삭제하지 말고 표준 섹션 순서로 재배치한다. +- `필수 기능`은 해야 할 작업 목록이므로 `- [ ]` 또는 `- [x]` 체크리스트로 유지한다. +- `완료 기준`은 검증 가능한 조건의 체크리스트로 유지한다. +- 일반 불릿이나 설명 문장에 숨어 있는 해야 할 작업은 성격을 판단해 `필수 기능` 체크리스트 또는 기존 태스크의 하위 체크리스트로 옮긴다. +- `범위`, `범위 제외`, `작업 컨텍스트`는 설명 목록으로 유지하고, 실행해야 할 작업을 이 섹션에 숨기지 않는다. + ## 순서 정책 - Phase와 Milestone 이름에 `1`, `2`, `M01`, `P1` 같은 순번을 붙이지 않는다. @@ -73,7 +96,7 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 ## 삽입 단위 정책 -신규 추가 요청은 먼저 "어디에 둘지"와 "어떤 단위로 둘지"를 분리해서 판단한다. 여기서 태스크는 Milestone 문서의 `필수 기능`, TODO, 또는 기존 체크리스트 항목을 뜻한다. +신규 추가 요청은 먼저 "어디에 둘지"와 "어떤 단위로 둘지"를 분리해서 판단한다. 여기서 태스크는 Milestone 문서 `필수 기능` 섹션의 체크리스트 항목 또는 기존 체크리스트 항목을 뜻한다. | 삽입 단위 | 사용 기준 | |-----------|-----------| @@ -92,21 +115,7 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 ### current.md 형식 -`agent-ops/roadmap/current.md`는 아래 형식을 유지한다. - -```markdown -# 현재 로드맵 컨텍스트 - -## 활성 Milestone - -- : agent-ops/roadmap/milestones/.md - -## 선택 규칙 - -- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택한다. -- 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. -- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. -``` +`agent-ops/roadmap/current.md`는 `agent-ops/skills/common/_templates/roadmap-current-template.md` 형식을 유지한다. `current.md`는 개인별 작업 위치나 완료 상태의 진실이 아니다. 현재 열려 있는 Milestone 후보 목록이며, 실제 현 작업 지점과 남은 작업은 `analyze-roadmap-position` 스킬이 코드와 git 상태를 함께 읽고 분석한다. @@ -116,6 +125,9 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - [ ] `agent-ops/roadmap/current.md` 존재 여부 확인 - [ ] `current.md`가 가리키는 활성 Milestone 문서 존재 여부 확인 - [ ] `current.md`가 정해진 한국어 형식을 유지하는지 확인 +- [ ] `agent-ops/skills/common/_templates/roadmap-template.md`를 읽어 최신 ROADMAP 형식 확인 +- [ ] `agent-ops/skills/common/_templates/roadmap-current-template.md`를 읽어 최신 current.md 형식 확인 +- [ ] `agent-ops/skills/common/_templates/roadmap-milestone-template.md`를 읽어 최신 Milestone 형식 확인 - [ ] 로드맵 파일이 없으면 `create-roadmap` 스킬 사용을 안내하고 중단 - [ ] 완료 상태로 바꾸는 경우 사용자의 명시 또는 확인 가능한 evidence가 있는지 확인 @@ -123,7 +135,7 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 1. **갱신 범위 결정** - 요청에서 mode, target Milestone, new feature, placement, placement-unit을 추론한다. - - 로드맵 언어 전환 요청이면 `sync`로 보고 `ROADMAP.md`, `current.md`, 전체 Milestone 문서를 갱신 범위에 포함할 수 있다. + - 로드맵 언어 전환, ROADMAP/current 형식 표준화, 또는 Milestone 형식 표준화 요청이면 `sync`로 보고 `ROADMAP.md`, `current.md`, 전체 Milestone 문서를 갱신 범위에 포함할 수 있다. - `status` 갱신이면 `current.md`와 대상 Milestone 문서를 우선 읽는다. - 요청이 활성 Milestone에 없으면 `ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. - Phase 전환, Milestone 추가/삭제, 순서 변경, 전체 재계획이면 `ROADMAP.md`도 읽는다. @@ -131,9 +143,11 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - 불필요하게 모든 Milestone 문서를 읽지 않는다. 2. **현재 로드맵 상태 파악** - - `ROADMAP.md`의 전체 목표, Phase 개요, Milestone 목록을 확인한다. + - `ROADMAP.md`의 전체 목표, Phase 흐름, Milestone 목록을 확인한다. - `current.md`의 활성 Milestone 창과 선택 규칙을 확인한다. + - `ROADMAP.md`와 `current.md`가 표준 템플릿 섹션 순서와 형식을 따르는지 확인한다. - 대상 또는 후보 Milestone 문서의 목표, 범위, 필수 기능, 완료 기준, 범위 제외 항목을 확인한다. + - 대상 Milestone 문서가 표준 템플릿 섹션 순서와 체크리스트 형식을 따르는지 확인한다. - 신규 작업과 이름, 산출물, 코드 경계, 완료 기준이 겹치는 기존 태스크가 있는지 확인한다. 3. **신규 작업 삽입 단위와 위치 판단** @@ -153,12 +167,19 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - 변경 요청이 전체 목표 또는 Phase 목표와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다. 5. **로드맵 파일 갱신** - - `ROADMAP.md`는 전체 목표, Phase 개요, Milestone 목록, 로딩 정책이 바뀔 때만 수정한다. - - `current.md`는 활성 Milestone 창이 바뀔 때 정해진 `current.md 형식`으로 수정한다. + - `ROADMAP.md`는 전체 목표, Phase 흐름, Milestone 목록, 로딩 정책이 바뀔 때만 수정한다. + - `current.md`는 활성 Milestone 창이 바뀔 때 `roadmap-current-template.md` 형식으로 수정한다. + - 갱신 대상 `ROADMAP.md`가 표준 템플릿과 다르면 기존 내용을 보존하면서 `전체 목표`, `Phase 흐름`, `Milestone 목록`, `로딩 정책` 순서로 정리한다. + - 갱신 대상 `current.md`가 표준 템플릿과 다르면 기존 활성 Milestone 목록을 보존하면서 `활성 Milestone`, `선택 규칙` 순서로 정리한다. + - `ROADMAP.md`에 상세 작업 체크리스트가 있으면 삭제하지 말고 관련 Milestone 문서의 `필수 기능` 체크리스트로 옮긴다. + - `current.md`에 개인별 현재 작업 위치나 완료 상태가 있으면 `current.md`에서는 제거하고 공유 로드맵으로 이관하지 않는다. 프로젝트에 의미 있는 근거가 명확한 내용만 관련 Milestone 문서나 작업 컨텍스트로 옮기고, 이관하지 않은 내용은 결과 보고의 확인 필요 항목에 남긴다. - Milestone 문서는 해당 Milestone의 목표, 범위, 필수 기능, 완료 기준, 범위 제외, 작업 컨텍스트가 바뀔 때 수정한다. + - 갱신 대상 Milestone 문서가 표준 템플릿과 다르면 기존 내용을 보존하면서 템플릿 섹션 순서로 정리하고, 누락 섹션은 TODO 또는 확인 필요 표시와 함께 추가한다. - 새 Milestone은 사용자 지정 또는 자동 판단 위치에 삽입하고, 기존 Milestone 이름이나 파일명을 순서 맞춤 목적으로 바꾸지 않는다. - - 기존 Milestone에 새 태스크를 넣는 경우에도 사용자 지정 또는 자동 판단 위치에 삽입하고, 근거 없이 목록 맨 앞이나 맨 뒤에 붙이지 않는다. - - 기존 태스크의 하위 작업으로 넣는 경우 기존 문서의 체크박스/불릿 스타일을 유지하고, 부모 태스크의 의미가 바뀌면 부모 문장도 필요한 만큼만 보완한다. + - 기존 Milestone에 새 태스크를 넣는 경우 `필수 기능` 체크리스트에 사용자 지정 또는 자동 판단 위치로 삽입하고, 근거 없이 목록 맨 앞이나 맨 뒤에 붙이지 않는다. + - 기존 태스크의 하위 작업으로 넣는 경우 부모 태스크 아래의 하위 체크리스트로 작성하고, 부모 태스크의 의미가 바뀌면 부모 문장도 필요한 만큼만 보완한다. + - 기존 `필수 기능`이 일반 불릿이면 상태 근거를 보존해 `- [ ]` 또는 `- [x]` 체크리스트로 변환한다. + - 기존 `완료 기준`이 일반 불릿이면 검증 조건 단위의 체크리스트로 변환한다. - 상태 값은 `계획`, `진행 중`, `완료`, `보류`, `폐기` 중 하나만 사용한다. - 완료된 Milestone의 기록은 삭제하지 않고 상태만 변경한다. @@ -172,6 +193,7 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - 수정한 파일 목록 - 변경된 Phase / Milestone / 상태 - 신규 작업의 삽입 단위와 배치 위치, 자동 배치인 경우 판단 근거 + - ROADMAP/current/Milestone 문서 템플릿 보정 여부 - 활성 Milestone 창 변경 사항 - 체크하거나 추가/제거한 태스크 또는 하위 작업 - 확인 필요로 남긴 항목 @@ -179,8 +201,11 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 ## 실행 결과 검증 - [ ] `current.md`의 활성 Milestone 경로가 실제 파일을 가리키는가 -- [ ] `current.md`가 `# 현재 로드맵 컨텍스트`, `활성 Milestone`, `선택 규칙` 형식을 유지하는가 +- [ ] `ROADMAP.md`가 `roadmap-template.md`의 섹션 순서와 형식을 따르는가 +- [ ] `current.md`가 `roadmap-current-template.md`의 섹션 순서와 형식을 따르는가 - [ ] `ROADMAP.md`의 Milestone 목록과 대상 Milestone 문서의 상태가 서로 충돌하지 않는가 +- [ ] 갱신 대상 Milestone 문서가 `roadmap-milestone-template.md`의 섹션 순서와 형식을 따르는가 +- [ ] 갱신 대상 Milestone 문서의 `필수 기능`과 `완료 기준`이 체크리스트 형식인가 - [ ] 신규 작업이 사용자 지정 위치를 따랐거나, 위치 미지정 시 자동 배치 근거가 남아 있는가 - [ ] 신규 작업의 삽입 단위가 작업 성격과 기존 태스크 포함 관계에 맞는가 - [ ] 자동 배치 위치가 Phase/Milestone 목표, 범위 제외 항목, 선후 의존성과 충돌하지 않는가 @@ -205,6 +230,7 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - Phase: <변경 없음 | 요약> - 삽입 단위: - 배치: <사용자 지정 위치 반영 | 자동 배치 위치와 근거 | 변경 없음> +- 템플릿 보정: - 활성 Milestone: <변경 없음 | 추가/제거 요약> - 상태: <변경 없음 | 이전 -> 이후> - 태스크: <추가/수정/완료/제거 요약> @@ -219,11 +245,15 @@ description: 기존 전체 목표, Phase, 순번 없는 Milestone 기반 한국 - 로드맵 파일이 없는데 새 구조를 임의로 만들지 않는다. 이 경우 `create-roadmap`을 사용한다. - evidence 없이 기능이나 Milestone을 완료 처리하지 않는다. - 전체 `ROADMAP.md`를 모든 작업의 필수 로딩 파일로 만들지 않는다. +- `ROADMAP.md`에 상세 작업 체크리스트를 남기지 않는다. +- `current.md`에 개인별 현재 작업 위치나 완료 상태를 남기지 않는다. - 완료된 Milestone 기록을 삭제하지 않는다. - Phase와 Milestone 이름 또는 파일명에 순번을 강제하지 않는다. - 기존 순번 파일명을 대규모 rename하지 않는다. - 신규 작업을 근거 없이 항상 새 Milestone으로 만들거나 맨 앞/맨 뒤에 추가하지 않는다. - 작업 성격과 기존 태스크 포함 관계를 확인하지 않고 모든 신규 작업을 같은 단위로 처리하지 않는다. - 사용자가 지정한 앞/뒤/아래 anchor 또는 대상 Phase/Milestone 컨테이너를 무시하지 않는다. -- Milestone 목표와 범위 제외 항목을 무시하고 기능 목록만 갱신하지 않는다. +- Milestone 목표와 범위 제외 항목을 무시하고 태스크 체크리스트만 갱신하지 않는다. +- 해야 할 작업을 `필수 기능` 체크리스트 밖의 설명 문장에 숨기지 않는다. +- 갱신 대상 Milestone의 형식이 다르다는 이유로 기존 내용이나 완료 체크 근거를 삭제하지 않는다. - 타겟 프로젝트에서 `agent-ops/rules/common/` 또는 `agent-ops/skills/common/`을 직접 수정하지 않는다.