74 lines
4.6 KiB
Markdown
74 lines
4.6 KiB
Markdown
---
|
|
name: analyze-roadmap-position
|
|
version: 1.11.0
|
|
description: "여러 레포를 전환할 때 코드/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 문서의 제목, `목표`, `상태`만 확인
|
|
|
|
## 실행 절차
|
|
|
|
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 문서를 열고 제목, `목표`, `상태`만 읽는다.
|
|
- `기능`, `완료 리뷰`, `범위 제외`, `작업 컨텍스트`는 사용자가 명시적으로 요청한 경우에만 읽는다.
|
|
7. 결과를 템플릿 형식 그대로 출력한다.
|
|
|
|
## 실행 결과 검증
|
|
|
|
- [ ] `roadmap-position-report-template.md`의 출력 구조를 유지했는가
|
|
- [ ] 로컬 `current.md`, `ROADMAP.md`, 활성 `PHASE.md`, 활성 Milestone의 제목/목표/상태만 기본으로 읽었는가
|
|
- [ ] 완료 또는 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 흐름에 모두 표시한다.
|
|
- 현재 후보의 역할 태그는 `선행 스케치`, `다음 구현 계획`, `검토 후보`, `보류 후보`처럼 짧게 쓴다.
|
|
- 로드맵이 없는 프로젝트에서는 로드맵 없음으로 짧게 보고하고 템플릿을 억지로 채우지 않는다.
|
|
|
|
## 금지 사항
|
|
|
|
- 기본 동작에서 코드 파일, 테스트 파일, `git status`, `git diff`를 읽지 않는다.
|
|
- 기본 동작에서 Milestone의 `기능` 체크리스트를 감사하지 않는다.
|
|
- 완료 여부, 남은 작업, 코드와 문서의 동기화 상태를 evidence 기반으로 판정하지 않는다.
|
|
- 사용자가 명시하지 않은 상태에서 `ROADMAP.md`, 로컬 `current.md`, Phase, Milestone 문서를 수정하지 않는다.
|
|
- 사용자가 과거 기록 확인을 명시하지 않으면 `agent-roadmap/archive/**`를 읽지 않는다.
|