sync: agent-ops from agentic-framework v1.1.26

agent-ops/skills/common/_templates/roadmap-current-template.md

@@ -0,0 +1,12 @@
+# 현재 로드맵 컨텍스트
+
+## 활성 Milestone
+
+- <milestone-name>: agent-ops/roadmap/milestones/<milestone-slug>.md
+
+## 선택 규칙
+
+- 이 문서는 활성 Milestone 후보 목록이며, 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
+- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택하고 같은 세션에서 1회 읽는다.
+- 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다.
+- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.

agent-ops/skills/common/_templates/roadmap-milestone-template.md

@@ -0,0 +1,37 @@
+# <Milestone 이름>
+
+## 목표
+
+<이 Milestone이 끝났을 때 달성되어야 하는 결과를 1~3문장으로 작성>
+
+## 단계
+
+<ROADMAP.md의 Phase 이름>
+
+## 상태
+
+<계획 | 진행 중 | 완료 | 보류 | 폐기>
+
+## 범위
+
+- <이 Milestone에 포함되는 제품/기술/문서 범위>
+
+## 필수 기능
+
+- [ ] <완료 가능한 태스크>
+  - [ ] <필요한 하위 작업>
+
+## 완료 기준
+
+- [ ] <완료 여부를 확인할 수 있는 기준>
+
+## 범위 제외
+
+- <이 Milestone에서 의도적으로 하지 않는 일>
+
+## 작업 컨텍스트
+
+- 관련 경로: `<path>`
+- 선행 작업: <없음 또는 Milestone/태스크 이름>
+- 후속 작업: <없음 또는 Milestone/태스크 이름>
+- 확인 필요: <!-- TODO: 확인 필요 -->

agent-ops/skills/common/_templates/roadmap-template.md

@@ -0,0 +1,26 @@
+# 로드맵
+
+## 전체 목표
+
+<프로젝트가 최종적으로 달성하려는 결과를 1~3문장으로 작성>
+
+## Phase 흐름
+
+- <Phase 이름>: <이 Phase의 목표와 역할>
+
+## Milestone 목록
+
+### <Phase 이름>
+
+- [<Milestone 이름>](milestones/<milestone-slug>.md) - 상태: <계획 | 진행 중 | 완료 | 보류 | 폐기>; 목표: <짧은 목표 요약>
+
+## 로딩 정책
+
+- 일반 작업에서는 `agent-ops/roadmap/ROADMAP.md`를 매번 읽지 않는다.
+- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다.
+- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
+- `current.md`에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다.
+- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다.
+- 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
+- 이 문서는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다.
+- 상세 작업과 완료 기준은 각 Milestone 문서의 체크리스트로 관리한다.

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/<milestone-slug>.md` | 일반 작업 시 읽는 Milestone 단위 목표, 범위, 기능 목록, 범위 제외 항목 |
+| `agent-ops/roadmap/milestones/<milestone-slug>.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
-
-- <milestone-name>: agent-ops/roadmap/milestones/<milestone-slug>.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/`을 타겟 프로젝트에서 직접 수정하지 않는다.

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
-
-- <milestone-name>: agent-ops/roadmap/milestones/<milestone-slug>.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 | 태스크 | 하위 작업 | 작업 컨텍스트/TODO | 변경 없음>
 - 배치: <사용자 지정 위치 반영 | 자동 배치 위치와 근거 | 변경 없음>
+- 템플릿 보정: <ROADMAP 적용 | current.md 적용 | Milestone 적용 | 이미 일치 | 변경 없음>
 - 활성 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/`을 직접 수정하지 않는다.