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

name	version	description
analyze-roadmap-position	1.0.0	지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점과 남은 일을 추정하는 읽기 전용 스킬

작업 지점 분석

목적

현재 브랜치, 변경 파일, 코드 구조, 활성 Milestone 문서를 함께 분석해 지금 작업이 어느 Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다. current.md만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다.

언제 호출할지

• 사용자가 "지금 작업이 뭐지?", "현재 작업이 뭐야?", "어디까지 했지?"라고 물을 때
• 사용자가 현재 브랜치 또는 변경 파일 기준으로 남은 작업을 알고 싶어 할 때
• 활성 Milestone 안에서 이번 요청이 어느 범위에 속하는지 확인해야 할 때
• 구현 전에 로드맵 기준 작업 위치를 가볍게 점검해야 할 때

입력

• question: 사용자의 현재 작업 지점 질문 또는 남은 작업 질문 (선택)
• scope: 분석할 경로, 기능명, 도메인명, 브랜치명 힌트 (선택)
• depth: quick 또는 deep (선택, 없으면 quick)

먼저 확인할 것

• agent-ops/roadmap/current.md 존재 여부 확인
• current.md의 활성 Milestone 목록이 가리키는 문서 존재 여부 확인
• git 저장소이면 현재 브랜치, git status --short, 변경 파일 목록 확인
• 변경 파일이 있으면 agent-ops/rules/project/rules.md의 도메인 매핑 기준으로 관련 domain rule 확인

실행 절차

1. 활성 Milestone 창 확인

   • agent-ops/roadmap/current.md를 읽고 활성 Milestone 후보와 선택 규칙을 파악한다.
   • 활성 Milestone 문서를 모두 읽되, 목록이 많으면 사용자 요청이나 변경 파일과 관련 높은 문서부터 읽는다.
   • current.md가 없거나 형식이 맞지 않으면 agent-ops/roadmap/ROADMAP.md의 Milestone 목록을 확인하고 불확실성을 보고한다.

2. 작업 흔적 확인

   • git 저장소이면 git branch --show-current, git status --short, git diff --name-only, 필요 시 git diff --stat을 확인한다.
   • 변경 파일이 없으면 사용자의 요청 문장과 최근 대상 경로 힌트를 기준으로 추정한다.
   • 변경 파일이 있으면 관련 코드와 테스트 파일을 필요한 만큼만 읽는다.

3. Milestone 매칭

   • 활성 Milestone의 목표, 범위, 완료 기준, 범위 제외 항목과 변경 파일/요청 내용을 비교한다.
   • 하나의 Milestone에 명확히 속하면 단일 후보로 보고한다.
   • 둘 이상의 Milestone에 걸치면 복수 후보로 보고하고, 어떤 파일이나 기능이 어느 Milestone에 닿는지 나눈다.
   • 활성 Milestone 밖으로 보이면 ROADMAP.md의 Milestone 목록을 확인하고 전환 또는 신규 Milestone 필요성을 제안한다.

4. 남은 작업 분류

   • 확인됨: 코드, 문서, 테스트, diff로 근거가 있는 남은 작업
   • 추정됨: 구조상 필요해 보이지만 추가 확인이 필요한 작업
   • 확인 필요: 제품 판단, 범위 결정, 사용자 의도가 필요한 작업
   • 완료 여부는 evidence 없이 확정하지 않는다.

5. 결과 보고

   • 추정 Milestone과 신뢰도
   • 판단 근거
   • 구현된 것으로 보이는 부분
   • 남은 작업
   • 확인 필요 항목
   • 읽은 주요 파일

실행 결과 검증

• current.md만 근거로 현재 위치를 단정하지 않았는가
• 활성 Milestone 문서의 목표와 범위 제외 항목을 확인했는가
• 변경 파일 또는 사용자 요청과 Milestone 판단 근거가 연결되어 있는가
• 남은 작업을 확인됨, 추정됨, 확인 필요로 구분했는가
• 로드맵 파일을 수정하지 않았는가
• 검증 실패 시: 부족한 근거를 명시하고 신뢰도를 낮춘다.

출력 형식

## 현재 작업 분석

- 추정 Milestone: <milestone-name 또는 복수 후보>
- 신뢰도: <높음 | 중간 | 낮음>

## 근거

- <변경 파일, 브랜치, 요청 내용, Milestone 범위와 연결된 근거>

## 구현된 것으로 보이는 부분

- <코드/문서 근거가 있는 항목>

## 남은 작업

- 확인됨: <항목>
- 추정됨: <항목>
- 확인 필요: <항목>

## 읽은 주요 파일

- <path>

금지 사항

• current.md만 읽고 현재 작업 위치를 확정하지 않는다.
• 사용자가 명시하지 않은 상태에서 ROADMAP.md, current.md, Milestone 문서를 수정하지 않는다.
• evidence 없이 Milestone이나 기능을 완료 처리하지 않는다.
• 활성 Milestone 밖 작업을 임의로 새 Milestone으로 추가하지 않는다.