update agent-ops docs and add roadmap position report template

README.md

@@ -68,6 +68,7 @@ agent-ops/
         roadmap-template.md
         roadmap-current-template.md
         roadmap-milestone-template.md
+        roadmap-position-report-template.md
       <skill-name>/SKILL.md
     project/
       <skill-name>/SKILL.md
@@ -140,6 +141,8 @@ Phase와 Milestone에는 순번을 강제하지 않습니다. 진행 순서는 `
 
 로드맵 문서는 `agent-ops/skills/common/_templates/roadmap-template.md`, `roadmap-current-template.md`, `roadmap-milestone-template.md` 형식을 따릅니다. 해야 할 작업은 Milestone 문서의 `필수 기능` 체크리스트로, 완료 판단 조건은 `완료 기준` 체크리스트로 관리합니다.
 
+현재 작업 지점/남은 작업 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 형식을 따릅니다.
+
 일반 작업에서는 전체 `ROADMAP.md`를 매번 읽지 않습니다. 먼저 `current.md`의 활성 Milestone 창을 읽고, 요청 범위와 변경 파일에 맞는 Milestone 문서만 읽습니다.
 
 완료 또는 폐기되어 현재 후보에서 제외할 과거 Milestone은 `agent-ops/roadmap/archive/YYYY/MM/`로 이동합니다. 이때 `ROADMAP.md`에는 `아카이브 Milestone 요약`만 남기고, 아카이브된 Milestone 문서는 아카이빙 당시 기록 스냅샷으로 보존하며 최신 스킬 규약에 맞춰 재포맷하지 않습니다.

agent-ops/GUIDE.md

@@ -60,7 +60,8 @@ agent-ops/
     │   │   ├── skill-template.md
     │   │   ├── roadmap-template.md
     │   │   ├── roadmap-current-template.md
-    │   │   └── roadmap-milestone-template.md
+    │   │   ├── roadmap-milestone-template.md
+    │   │   └── roadmap-position-report-template.md
     │   ├── init-agent-ops/SKILL.md       # scaffold 초기화
     │   ├── sync-pull/SKILL.md            # framework → 현재 프로젝트 동기화
     │   ├── sync-push/SKILL.md            # 현재 프로젝트/framework push 동기화
@@ -82,6 +83,8 @@ Phase와 Milestone에는 순번을 강제하지 않습니다. 진행 순서는 `
 
 로드맵 문서는 `agent-ops/skills/common/_templates/roadmap-template.md`, `roadmap-current-template.md`, `roadmap-milestone-template.md` 형식을 기준으로 작성합니다. 해야 할 작업은 Milestone 문서의 `필수 기능` 체크리스트로 두고, 완료 여부를 검증하는 조건은 `완료 기준` 체크리스트로 둡니다.
 
+현재 작업 지점/남은 작업 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 형식을 기준으로 작성합니다.
+
 완료 또는 폐기되어 현재 작업 후보에서 제외할 과거 Milestone은 `agent-ops/roadmap/archive/YYYY/MM/`로 이동합니다. 이때 `ROADMAP.md`에는 `아카이브 Milestone 요약`만 남기고, 아카이브 문서는 사용자가 과거 기록 확인이나 복원을 명시적으로 요청한 경우에만 읽습니다.
 
 ---

agent-ops/rules/common/rules-roadmap.md

@@ -35,6 +35,7 @@
 ## 작업 지점 분석
 
 - 현재 작업 지점이나 남은 작업 분석 요청은 `analyze-roadmap-position` 스킬로 처리한다.
+- 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 섹션과 필드 순서를 따른다.
 - 이때 `current.md`만으로 단정하지 말고 코드, git 상태, diff, 활성 Milestone 문서를 함께 본다.
 
 ## Milestone 아카이브

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

@@ -0,0 +1,38 @@
+# 현재 작업 분석
+
+- 추정 Milestone: <milestone-name 또는 복수 후보>
+- Milestone 링크: [<milestone-name>](agent-ops/roadmap/milestones/<milestone-slug>.md)
+- 신뢰도: <높음 | 중간 | 낮음>
+- 구현 잠금: <해제 | 잠금 | 정보 없음>
+- 한 줄 결론: <현재 작업 지점과 가장 중요한 다음 판단을 1문장으로 요약>
+
+## 판단 근거
+
+- 브랜치: <branch-name 또는 확인 불가>
+- 변경 파일: <없음 | N개, 핵심 경로 요약>
+- 로드맵 근거: <Milestone 목표/범위/필수 기능/완료 기준과 연결된 근거>
+- 코드/테스트 근거: <코드, 테스트, diff, 문서에서 확인한 근거>
+
+## 구현된 것으로 보이는 부분
+
+- 확인됨: [<item-id 또는 해당 없음>] <코드/문서/테스트 근거가 있는 완료 후보>
+
+## 남은 작업
+
+- 확인됨: [<item-id 또는 신규 id 필요>] <코드/문서/테스트 근거로 남았다고 볼 수 있는 작업>
+- 추정됨: [<item-id 또는 신규 id 필요>] <구조상 필요해 보이나 추가 확인이 필요한 작업>
+- 확인 필요: [<item-id 또는 신규 id 필요>] <사용자 판단, 범위 결정, 제품 의도가 필요한 작업>
+
+## 위험/불확실성
+
+- <없음 또는 신뢰도를 낮춘 이유, 누락된 근거, 잠금/링크/템플릿 문제>
+
+## 다음 행동
+
+- 우선순위 1: <가장 먼저 할 작업 또는 확인>
+- 우선순위 2: <다음 작업 또는 확인>
+- 사용자 확인 필요: <없음 또는 사용자 결정이 필요한 질문>
+
+## 읽은 주요 파일
+
+- <path>

agent-ops/skills/common/analyze-roadmap-position/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: analyze-roadmap-position
-version: 1.2.1
+version: 1.3.0
 description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점, Milestone 문서 링크, 남은 일을 추정하는 읽기 전용 스킬"
 ---
 
@@ -11,6 +11,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확
 현재 브랜치, 변경 파일, 코드 구조, 활성 Milestone 문서를 함께 분석해 지금 작업이 어느 Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다.
 결과에는 추정한 Milestone의 문서 링크를 항상 함께 출력한다.
 Milestone의 `필수 기능` 항목에 item-id가 있으면 남은 작업과 판단 근거에 함께 표시해 사용자가 짧은 id로 후속 지시를 할 수 있게 한다.
+결과 보고는 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 템플릿의 섹션, 필드, 순서를 그대로 따라 작성한다.
 `current.md`만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다.
 
 ## 언제 호출할지
@@ -28,6 +29,7 @@ Milestone의 `필수 기능` 항목에 item-id가 있으면 남은 작업과 판
 
 ## 먼저 확인할 것
 
+- [ ] `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 읽어 최신 답변 템플릿 확인
 - [ ] `agent-ops/roadmap/current.md` 존재 여부 확인
 - [ ] `current.md`의 활성 Milestone 목록이 가리키는 문서 존재 여부 확인
 - [ ] 활성 Milestone 목록이 `agent-ops/roadmap/archive/**` 경로를 가리키지 않는지 확인
@@ -65,20 +67,20 @@ Milestone의 `필수 기능` 항목에 item-id가 있으면 남은 작업과 판
    - 완료 여부는 evidence 없이 확정하지 않는다.
 
 5. **결과 보고**
-   - 추정 Milestone과 신뢰도
+   - `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 기준으로 출력한다.
-   - 추정 Milestone 문서 링크
+   - 템플릿의 섹션 제목, 필드명, 순서를 바꾸지 않는다.
-   - 구현 잠금 상태와 잠금/정보 없음 상태일 때 필요한 다음 조치
+   - 템플릿의 모든 필드를 채우며, 근거가 없으면 생략하지 말고 `없음`, `확인 불가`, `확인 필요` 중 하나로 명시한다.
-   - 판단 근거
+   - `판단 근거`에는 브랜치, 변경 파일, 로드맵 근거, 코드/테스트 근거를 각각 분리해 적는다.
-   - 구현된 것으로 보이는 부분
+   - `남은 작업`은 `확인됨`, `추정됨`, `확인 필요` 세 분류를 모두 유지한다.
-   - 남은 작업
+   - `다음 행동`에는 가장 우선해야 할 실행 또는 확인을 1~2개만 적는다.
-   - 확인 필요 항목
+   - `읽은 주요 파일`에는 실제로 읽은 핵심 파일만 적는다.
-   - 읽은 주요 파일
 
 Milestone을 하나로 확정할 수 없으면 후보 Milestone마다 링크를 출력한다.
 Milestone 문서 경로를 찾지 못한 경우에도 링크 항목을 생략하지 말고 `링크 확인 불가: <이유>`와 확인한 로드맵 파일 경로를 함께 적는다.
 
 ## 실행 결과 검증
 
+- [ ] `roadmap-position-report-template.md`를 읽고 그 섹션 순서와 필드명을 유지했는가
 - [ ] `current.md`만 근거로 현재 위치를 단정하지 않았는가
 - [ ] 활성 Milestone 문서의 목표와 범위 제외 항목을 확인했는가
 - [ ] `agent-ops/roadmap/archive/**` 문서를 명시 요청 없이 읽지 않았는가
@@ -87,37 +89,16 @@ Milestone 문서 경로를 찾지 못한 경우에도 링크 항목을 생략하
 - [ ] 관련 `필수 기능` 항목에 item-id가 있으면 결과에 함께 표시했는가
 - [ ] 변경 파일 또는 사용자 요청과 Milestone 판단 근거가 연결되어 있는가
 - [ ] 남은 작업을 `확인됨`, `추정됨`, `확인 필요`로 구분했는가
+- [ ] 템플릿 필드를 근거 없이 생략하지 않고 `없음`, `확인 불가`, `확인 필요`로 채웠는가
 - [ ] 로드맵 파일을 수정하지 않았는가
 - 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다. Milestone 링크 누락은 출력 전 반드시 보정한다.
 
 ## 출력 형식
 
-```markdown
+- 템플릿 경로: `agent-ops/skills/common/_templates/roadmap-position-report-template.md`
-## 현재 작업 분석
+- 템플릿을 그대로 복사해 placeholder를 채운다.
-
+- 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다.
-- 추정 Milestone: <milestone-name 또는 복수 후보>
+- 값이 없는 필드는 `없음`, `확인 불가`, `확인 필요` 중 하나로 채운다.
-- Milestone 링크: [<milestone-name>](agent-ops/roadmap/milestones/<milestone-slug>.md)
-- 신뢰도: <높음 | 중간 | 낮음>
-- 구현 잠금: <잠금 | 해제 | 정보 없음>
-
-## 근거
-
-- <변경 파일, 브랜치, 요청 내용, Milestone 범위와 연결된 근거>
-
-## 구현된 것으로 보이는 부분
-
-- <코드/문서 근거가 있는 항목>
-
-## 남은 작업
-
-- 확인됨: [<item-id>] <항목>
-- 추정됨: [<item-id>] <항목>
-- 확인 필요: [<item-id 또는 신규 id 필요>] <항목>
-
-## 읽은 주요 파일
-
-- <path>
-```
 
 ## 금지 사항