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

name	version	description
analyze-roadmap-position	1.11.0	여러 레포를 전환할 때 코드/git 분석 없이 전체 ROADMAP > Phase > Milestone > current 현지점을 링크 달린 breadcrumb와 흐름 목록으로 빠르게 보여주는 읽기 전용 스킬

로드맵 현지점

목적

여러 레포를 병렬 운용하다가 돌아왔을 때, 현재 작업이 전체 로드맵의 어느 Phase와 Milestone에 있는지 빠르게 보여준다. 기본 출력은 로드맵 > Phase > Milestone breadcrumb와 전체 Phase 흐름, 현재 Phase의 Milestone 흐름이다. 코드 진행도 감사, git diff 분석, 테스트 근거 확인, 남은 작업 정밀 판정은 기본 책임이 아니다.

언제 호출할지

• 사용자가 "지금 작업이 뭐지?", "현재 작업이 뭐야?", "어디까지 했지?"라고 물을 때
• 사용자가 레포 전환 직후 로드맵상 현재 좌표를 빠르게 알고 싶어 할 때
• "로드맵상 현 위치", "현재 마일스톤 위치", "current 기준 breadcrumb"를 요청할 때
• 구현 시작 전 전체 Roadmap > Phase > Milestone 관계만 확인하면 될 때

먼저 확인할 것

• agent-ops/skills/common/_templates/roadmap-position-report-template.md를 읽어 최신 답변 템플릿 확인
• agent-roadmap/ 디렉터리 존재 여부 확인
• 로컬 agent-roadmap/current.md 존재 여부 확인
• 로드맵이 있으면 ROADMAP.md의 Phase 흐름을 확인
• 로컬 current.md의 활성 Phase와 활성 Milestone 이름, 상태, 경로 확인
• 활성 Phase 문서의 Milestone 흐름 확인
• 활성 Milestone 문서의 제목, 목표, 상태, 구현 잠금의 SDD 요약만 확인

실행 절차

1. agent-roadmap/ 존재 여부를 확인한다.
   • 없으면 로드맵 없음으로 짧게 보고하고 멈춘다.
2. agent-ops/skills/common/_templates/roadmap-position-report-template.md를 읽는다.
3. 로컬 agent-roadmap/current.md를 확인한다.
   • 없으면 로컬 current 없음으로 보고하고, ROADMAP.md가 있으면 Phase 흐름만 보여준다.
4. ROADMAP.md의 Phase 흐름을 읽어 전체 Phase 목록을 만든다.
   • 각 Phase는 상태, 이름, 링크만 남긴다.
   • current의 활성 Phase와 일치하는 항목에 ← 현재 표시를 붙인다.
   • 완료된 Phase가 archive 경로를 가리켜도 링크만 표시하고 archive 문서는 읽지 않는다.
5. current의 활성 Phase 경로를 열고 Milestone 흐름을 읽는다.
   • 각 Milestone은 상태, 이름, 링크만 남긴다.
   • current의 활성 Milestone과 일치하는 항목에 ← 현재 후보 표시를 붙인다.
6. current의 활성 Milestone 문서를 열고 제목, 목표, 상태, 구현 잠금의 SDD 요약만 읽는다.
   • SDD: 필요이면 SDD 경로와 같은 디렉터리의 USER_REVIEW.md 존재 여부만 확인한다.
   • 기능, 완료 리뷰, 범위 제외, 작업 컨텍스트는 사용자가 명시적으로 요청한 경우에만 읽는다.
7. 결과를 템플릿 형식 그대로 출력한다.

실행 결과 검증

• roadmap-position-report-template.md의 출력 구조를 유지했는가
• 로컬 current.md, ROADMAP.md, 활성 PHASE.md, 활성 Milestone의 제목/목표/상태/SDD 요약만 기본으로 읽었는가
• 완료 또는 archive Phase/Milestone은 링크만 표시하고 archive 문서를 읽지 않았는가
• current가 여러 Milestone을 가리키면 모두 현재 후보로 표시했는가
• 코드 파일, 테스트 파일, git status, git diff를 기본 동작에서 읽지 않았는가
• 로드맵 파일을 수정하지 않았는가

출력 형식

• 템플릿 경로: agent-ops/skills/common/_templates/roadmap-position-report-template.md
• 템플릿을 그대로 복사해 placeholder를 채운다.
• 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다.
• current가 여러 Milestone을 가리키면 breadcrumb와 Milestone 흐름에 모두 표시한다.
• 현재 후보의 역할 태그는 선행 스케치, 다음 구현 계획, 검토 후보, 보류 후보처럼 짧게 쓴다.
• 현재 후보에 SDD: 필요가 있으면 역할 태그에 SDD 잠금, SDD 사용자 리뷰, SDD 승인됨 중 하나를 붙인다.
• 로드맵이 없는 프로젝트에서는 로드맵 없음으로 짧게 보고하고 템플릿을 억지로 채우지 않는다.

금지 사항

• 기본 동작에서 코드 파일, 테스트 파일, git status, git diff를 읽지 않는다.
• 기본 동작에서 Milestone의 기능 체크리스트를 감사하지 않는다.
• 완료 여부, 남은 작업, 코드와 문서의 동기화 상태를 evidence 기반으로 판정하지 않는다.
• 사용자가 명시하지 않은 상태에서 ROADMAP.md, 로컬 current.md, Phase, Milestone 문서를 수정하지 않는다.
• 사용자가 과거 기록 확인을 명시하지 않으면 agent-roadmap/archive/**를 읽지 않는다.