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

.clinerules

@@ -5,6 +5,8 @@
 - 요청 범위를 넘는 변경을 하지 않는다.
 - 불확실하면 단정하지 말고 후보를 제시한다.
 - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다.
+- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다.
+  예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version`
 
 `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다.
 

.cursorrules

@@ -5,6 +5,8 @@
 - 요청 범위를 넘는 변경을 하지 않는다.
 - 불확실하면 단정하지 말고 후보를 제시한다.
 - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다.
+- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다.
+  예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version`
 
 `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다.
 

AGENTS.md

@@ -5,6 +5,8 @@
 - 요청 범위를 넘는 변경을 하지 않는다.
 - 불확실하면 단정하지 말고 후보를 제시한다.
 - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다.
+- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다.
+  예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version`
 
 `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다.
 

CLAUDE.md

@@ -5,6 +5,8 @@
 - 요청 범위를 넘는 변경을 하지 않는다.
 - 불확실하면 단정하지 말고 후보를 제시한다.
 - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다.
+- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다.
+  예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version`
 
 `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다.
 

GEMINI.md

@@ -5,6 +5,8 @@
 - 요청 범위를 넘는 변경을 하지 않는다.
 - 불확실하면 단정하지 말고 후보를 제시한다.
 - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다.
+- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다.
+  예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version`
 
 `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다.
 

agent-ops/.version

@@ -1 +1 @@
-1.1.31
+1.1.32

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/rules/common/rules.md

@@ -5,6 +5,8 @@
 - 요청 범위를 넘는 변경을 하지 않는다.
 - 불확실하면 단정하지 말고 후보를 제시한다.
 - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다.
+- 이 프로젝트에서 작업을 하나 완료할 때마다 `agent-ops/bin/bump-version.sh`를 실행해 `agent-ops/.version`을 한 단계 올린다.
+  예: `next="$(agent-ops/bin/bump-version.sh "$(cat agent-ops/.version)")" && printf '%s\n' "$next" > agent-ops/.version`
 
 `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다.
 

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>
-```
 
 ## 금지 사항