diff --git a/README.md b/README.md index e9bd1f9..d5a1949 100644 --- a/README.md +++ b/README.md @@ -68,6 +68,7 @@ agent-ops/ roadmap-template.md roadmap-current-template.md roadmap-milestone-template.md + roadmap-position-report-template.md /SKILL.md project/ /SKILL.md @@ -140,6 +141,8 @@ Phase와 Milestone에는 순번을 강제하지 않습니다. 진행 순서는 ` 로드맵 문서는 `agent-ops/skills/common/_templates/roadmap-template.md`, `roadmap-current-template.md`, `roadmap-milestone-template.md` 형식을 따릅니다. 해야 할 작업은 Milestone 문서의 `필수 기능` 체크리스트로, 완료 판단 조건은 `완료 기준` 체크리스트로 관리합니다. +현재 작업 지점/남은 작업 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 형식을 따릅니다. + 일반 작업에서는 전체 `ROADMAP.md`를 매번 읽지 않습니다. 먼저 `current.md`의 활성 Milestone 창을 읽고, 요청 범위와 변경 파일에 맞는 Milestone 문서만 읽습니다. 완료 또는 폐기되어 현재 후보에서 제외할 과거 Milestone은 `agent-ops/roadmap/archive/YYYY/MM/`로 이동합니다. 이때 `ROADMAP.md`에는 `아카이브 Milestone 요약`만 남기고, 아카이브된 Milestone 문서는 아카이빙 당시 기록 스냅샷으로 보존하며 최신 스킬 규약에 맞춰 재포맷하지 않습니다. diff --git a/agent-ops/GUIDE.md b/agent-ops/GUIDE.md index e0efbe4..dcb00a2 100644 --- a/agent-ops/GUIDE.md +++ b/agent-ops/GUIDE.md @@ -60,7 +60,8 @@ agent-ops/ │ │ ├── skill-template.md │ │ ├── roadmap-template.md │ │ ├── roadmap-current-template.md - │ │ └── roadmap-milestone-template.md + │ │ ├── roadmap-milestone-template.md + │ │ └── roadmap-position-report-template.md │ ├── init-agent-ops/SKILL.md # scaffold 초기화 │ ├── sync-pull/SKILL.md # framework → 현재 프로젝트 동기화 │ ├── sync-push/SKILL.md # 현재 프로젝트/framework push 동기화 @@ -82,6 +83,8 @@ Phase와 Milestone에는 순번을 강제하지 않습니다. 진행 순서는 ` 로드맵 문서는 `agent-ops/skills/common/_templates/roadmap-template.md`, `roadmap-current-template.md`, `roadmap-milestone-template.md` 형식을 기준으로 작성합니다. 해야 할 작업은 Milestone 문서의 `필수 기능` 체크리스트로 두고, 완료 여부를 검증하는 조건은 `완료 기준` 체크리스트로 둡니다. +현재 작업 지점/남은 작업 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 형식을 기준으로 작성합니다. + 완료 또는 폐기되어 현재 작업 후보에서 제외할 과거 Milestone은 `agent-ops/roadmap/archive/YYYY/MM/`로 이동합니다. 이때 `ROADMAP.md`에는 `아카이브 Milestone 요약`만 남기고, 아카이브 문서는 사용자가 과거 기록 확인이나 복원을 명시적으로 요청한 경우에만 읽습니다. --- diff --git a/agent-ops/rules/common/rules-roadmap.md b/agent-ops/rules/common/rules-roadmap.md index b9a0975..2ee7dae 100644 --- a/agent-ops/rules/common/rules-roadmap.md +++ b/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 아카이브 diff --git a/agent-ops/skills/common/_templates/roadmap-position-report-template.md b/agent-ops/skills/common/_templates/roadmap-position-report-template.md new file mode 100644 index 0000000..2a93ae8 --- /dev/null +++ b/agent-ops/skills/common/_templates/roadmap-position-report-template.md @@ -0,0 +1,38 @@ +# 현재 작업 분석 + +- 추정 Milestone: +- Milestone 링크: [](agent-ops/roadmap/milestones/.md) +- 신뢰도: <높음 | 중간 | 낮음> +- 구현 잠금: <해제 | 잠금 | 정보 없음> +- 한 줄 결론: <현재 작업 지점과 가장 중요한 다음 판단을 1문장으로 요약> + +## 판단 근거 + +- 브랜치: +- 변경 파일: <없음 | N개, 핵심 경로 요약> +- 로드맵 근거: +- 코드/테스트 근거: <코드, 테스트, diff, 문서에서 확인한 근거> + +## 구현된 것으로 보이는 부분 + +- 확인됨: [] <코드/문서/테스트 근거가 있는 완료 후보> + +## 남은 작업 + +- 확인됨: [] <코드/문서/테스트 근거로 남았다고 볼 수 있는 작업> +- 추정됨: [] <구조상 필요해 보이나 추가 확인이 필요한 작업> +- 확인 필요: [] <사용자 판단, 범위 결정, 제품 의도가 필요한 작업> + +## 위험/불확실성 + +- <없음 또는 신뢰도를 낮춘 이유, 누락된 근거, 잠금/링크/템플릿 문제> + +## 다음 행동 + +- 우선순위 1: <가장 먼저 할 작업 또는 확인> +- 우선순위 2: <다음 작업 또는 확인> +- 사용자 확인 필요: <없음 또는 사용자 결정이 필요한 질문> + +## 읽은 주요 파일 + +- diff --git a/agent-ops/skills/common/analyze-roadmap-position/SKILL.md b/agent-ops/skills/common/analyze-roadmap-position/SKILL.md index 0aa24b3..643d171 100644 --- a/agent-ops/skills/common/analyze-roadmap-position/SKILL.md +++ b/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과 신뢰도 - - 추정 Milestone 문서 링크 - - 구현 잠금 상태와 잠금/정보 없음 상태일 때 필요한 다음 조치 - - 판단 근거 - - 구현된 것으로 보이는 부분 - - 남은 작업 - - 확인 필요 항목 - - 읽은 주요 파일 + - `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 기준으로 출력한다. + - 템플릿의 섹션 제목, 필드명, 순서를 바꾸지 않는다. + - 템플릿의 모든 필드를 채우며, 근거가 없으면 생략하지 말고 `없음`, `확인 불가`, `확인 필요` 중 하나로 명시한다. + - `판단 근거`에는 브랜치, 변경 파일, 로드맵 근거, 코드/테스트 근거를 각각 분리해 적는다. + - `남은 작업`은 `확인됨`, `추정됨`, `확인 필요` 세 분류를 모두 유지한다. + - `다음 행동`에는 가장 우선해야 할 실행 또는 확인을 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 -## 현재 작업 분석 - -- 추정 Milestone: -- Milestone 링크: [](agent-ops/roadmap/milestones/.md) -- 신뢰도: <높음 | 중간 | 낮음> -- 구현 잠금: <잠금 | 해제 | 정보 없음> - -## 근거 - -- <변경 파일, 브랜치, 요청 내용, Milestone 범위와 연결된 근거> - -## 구현된 것으로 보이는 부분 - -- <코드/문서 근거가 있는 항목> - -## 남은 작업 - -- 확인됨: [] <항목> -- 추정됨: [] <항목> -- 확인 필요: [] <항목> - -## 읽은 주요 파일 - -- -``` +- 템플릿 경로: `agent-ops/skills/common/_templates/roadmap-position-report-template.md` +- 템플릿을 그대로 복사해 placeholder를 채운다. +- 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다. +- 값이 없는 필드는 `없음`, `확인 불가`, `확인 필요` 중 하나로 채운다. ## 금지 사항