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

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

@@ -1,7 +1,7 @@
 ---
 name: analyze-roadmap-position
-version: 1.0.0
-description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점과 남은 일을 추정하는 읽기 전용 스킬"
+version: 1.0.1
+description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점, Milestone 문서 링크, 남은 일을 추정하는 읽기 전용 스킬"
 ---
 
 # 작업 지점 분석
@@ -9,6 +9,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확
 ## 목적
 
 현재 브랜치, 변경 파일, 코드 구조, 활성 Milestone 문서를 함께 분석해 지금 작업이 어느 Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다.
+결과에는 추정한 Milestone의 문서 링크를 항상 함께 출력한다.
 `current.md`만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다.
 
 ## 언제 호출할지
@@ -28,6 +29,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확
 
 - [ ] `agent-ops/roadmap/current.md` 존재 여부 확인
 - [ ] `current.md`의 활성 Milestone 목록이 가리키는 문서 존재 여부 확인
+- [ ] 활성 Milestone 이름과 문서 경로를 결과 출력에 쓸 Markdown 링크로 기록
 - [ ] git 저장소이면 현재 브랜치, `git status --short`, 변경 파일 목록 확인
 - [ ] 변경 파일이 있으면 `agent-ops/rules/project/rules.md`의 도메인 매핑 기준으로 관련 domain rule 확인
 
@@ -36,6 +38,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확
 1. **활성 Milestone 창 확인**
    - `agent-ops/roadmap/current.md`를 읽고 활성 Milestone 후보와 선택 규칙을 파악한다.
    - 활성 Milestone 문서를 모두 읽되, 목록이 많으면 사용자 요청이나 변경 파일과 관련 높은 문서부터 읽는다.
+   - 읽은 Milestone은 `<milestone-name>: <path>` 형태로 보존하고, 결과 보고에서는 `[<milestone-name>](<path>)` Markdown 링크로 출력한다.
    - `current.md`가 없거나 형식이 맞지 않으면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 불확실성을 보고한다.
 
 2. **작업 흔적 확인**
@@ -57,20 +60,25 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확
 
 5. **결과 보고**
    - 추정 Milestone과 신뢰도
+   - 추정 Milestone 문서 링크
    - 판단 근거
    - 구현된 것으로 보이는 부분
    - 남은 작업
    - 확인 필요 항목
    - 읽은 주요 파일
 
+Milestone을 하나로 확정할 수 없으면 후보 Milestone마다 링크를 출력한다.
+Milestone 문서 경로를 찾지 못한 경우에도 링크 항목을 생략하지 말고 `링크 확인 불가: <이유>`와 확인한 로드맵 파일 경로를 함께 적는다.
+
 ## 실행 결과 검증
 
 - [ ] `current.md`만 근거로 현재 위치를 단정하지 않았는가
 - [ ] 활성 Milestone 문서의 목표와 범위 제외 항목을 확인했는가
+- [ ] 추정 Milestone마다 문서 링크를 출력했는가
 - [ ] 변경 파일 또는 사용자 요청과 Milestone 판단 근거가 연결되어 있는가
 - [ ] 남은 작업을 `확인됨`, `추정됨`, `확인 필요`로 구분했는가
 - [ ] 로드맵 파일을 수정하지 않았는가
-- 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다.
+- 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다. Milestone 링크 누락은 출력 전 반드시 보정한다.
 
 ## 출력 형식
 
@@ -78,6 +86,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확
 ## 현재 작업 분석
 
 - 추정 Milestone: <milestone-name 또는 복수 후보>
+- Milestone 링크: [<milestone-name>](agent-ops/roadmap/milestones/<milestone-slug>.md)
 - 신뢰도: <높음 | 중간 | 낮음>
 
 ## 근거