sync: agent-ops from agentic-framework v1.1.65
This commit is contained in:
parent
6e82fb0304
commit
0563ad4aa1
11 changed files with 70 additions and 142 deletions
|
|
@ -23,7 +23,7 @@
|
|||
- skill 생성
|
||||
- README 생성
|
||||
- 로드맵/마일스톤 생성·갱신
|
||||
- 현재 작업 지점 / 남은 작업 분석
|
||||
- 로드맵 현지점 / 현재 작업 지점 확인
|
||||
- 계획 작성 / plan 생성
|
||||
- 코드 리뷰 / review 진행
|
||||
- git commit / push
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@
|
|||
- skill 생성
|
||||
- README 생성
|
||||
- 로드맵/마일스톤 생성·갱신
|
||||
- 현재 작업 지점 / 남은 작업 분석
|
||||
- 로드맵 현지점 / 현재 작업 지점 확인
|
||||
- 계획 작성 / plan 생성
|
||||
- 코드 리뷰 / review 진행
|
||||
- git commit / push
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@
|
|||
- skill 생성
|
||||
- README 생성
|
||||
- 로드맵/마일스톤 생성·갱신
|
||||
- 현재 작업 지점 / 남은 작업 분석
|
||||
- 로드맵 현지점 / 현재 작업 지점 확인
|
||||
- 계획 작성 / plan 생성
|
||||
- 코드 리뷰 / review 진행
|
||||
- git commit / push
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@
|
|||
- skill 생성
|
||||
- README 생성
|
||||
- 로드맵/마일스톤 생성·갱신
|
||||
- 현재 작업 지점 / 남은 작업 분석
|
||||
- 로드맵 현지점 / 현재 작업 지점 확인
|
||||
- 계획 작성 / plan 생성
|
||||
- 코드 리뷰 / review 진행
|
||||
- git commit / push
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@
|
|||
- skill 생성
|
||||
- README 생성
|
||||
- 로드맵/마일스톤 생성·갱신
|
||||
- 현재 작업 지점 / 남은 작업 분석
|
||||
- 로드맵 현지점 / 현재 작업 지점 확인
|
||||
- 계획 작성 / plan 생성
|
||||
- 코드 리뷰 / review 진행
|
||||
- git commit / push
|
||||
|
|
|
|||
|
|
@ -1 +1 @@
|
|||
1.1.57
|
||||
1.1.65
|
||||
|
|
|
|||
|
|
@ -17,7 +17,8 @@
|
|||
- 세션 최초 1회 `agent-ops/roadmap/current.md`를 읽고 활성 Phase, 활성 Milestone의 이름, 경로, 선택 규칙만 짧게 기억한다.
|
||||
- 일반 작업에서는 `ROADMAP.md`를 읽지 않는다.
|
||||
- 일반 작업에서는 `agent-ops/roadmap/archive/**`를 읽지 않는다.
|
||||
- 기능 추가, 구조 변경, 구현 계획, 현재 작업 분석 전에는 요청과 변경 파일에 맞는 활성 Phase와 활성 Milestone 문서를 읽는다.
|
||||
- 기능 추가, 구조 변경, 구현 계획 전에는 요청과 변경 파일에 맞는 활성 Phase와 활성 Milestone 문서를 읽는다.
|
||||
- 로드맵 현지점 확인은 `current.md`, `ROADMAP.md`의 Phase 흐름, 활성 `PHASE.md`의 Milestone 흐름, 활성 Milestone의 제목/목표/상태만 기본으로 읽는다.
|
||||
- `ROADMAP.md`는 로드맵 생성/갱신, Phase 추가/삭제/전환, 전체 구조 변경, 활성 범위 밖 작업 확인 때만 읽는다.
|
||||
- 과거 완료 내용, 완료 근거, 복원, 비교가 필요한 경우에만 `ROADMAP.md` 또는 `PHASE.md`에 있는 archive 링크를 따라가서 필요한 archive 문서만 읽는다.
|
||||
|
||||
|
|
@ -101,12 +102,12 @@
|
|||
- 사용자가 완료를 승인한 뒤에만 `[완료]`로 전환하고 archive 이동을 수행한다.
|
||||
- Phase도 모든 하위 Milestone이 `[완료]` 또는 `[폐기]`로 정리되어 Phase 완료 후보가 되면 `[검토중]`으로 두고 사용자 최종 확인을 받은 뒤 `[완료]` 또는 `[폐기]`로 전환한다.
|
||||
|
||||
## 작업 지점 분석
|
||||
## 로드맵 현지점
|
||||
|
||||
- 현재 작업 지점이나 남은 작업 분석 요청은 `analyze-roadmap-position` 스킬로 처리한다.
|
||||
- 분석 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 섹션과 필드 순서를 따른다.
|
||||
- 이때 `current.md`만으로 단정하지 말고 코드, git 상태, diff, 활성 Phase, 활성 Milestone 문서를 함께 본다.
|
||||
- Phase 또는 Milestone 후보가 여럿이면 단순 나열하지 말고 1순위와 2순위를 추천하고 근거를 함께 제시한다.
|
||||
- 현재 작업 지점이나 로드맵상 현 위치 확인 요청은 `analyze-roadmap-position` 스킬로 처리한다.
|
||||
- 답변은 `agent-ops/skills/common/_templates/roadmap-position-report-template.md` 섹션과 필드 순서를 따른다.
|
||||
- 기본 동작에서는 코드, git 상태, diff를 읽지 않고 `로드맵 > Phase > Milestone` breadcrumb와 흐름 목록으로 현재 좌표를 보여준다.
|
||||
- current가 Phase 또는 Milestone 후보를 여럿 가리키면 모두 `현재 후보`로 표시하고 짧은 역할 태그만 붙인다.
|
||||
|
||||
## 아카이브
|
||||
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@
|
|||
- skill 생성
|
||||
- README 생성
|
||||
- 로드맵/마일스톤 생성·갱신
|
||||
- 현재 작업 지점 / 남은 작업 분석
|
||||
- 로드맵 현지점 / 현재 작업 지점 확인
|
||||
- 계획 작성 / plan 생성
|
||||
- 코드 리뷰 / review 진행
|
||||
- git commit / push
|
||||
|
|
|
|||
|
|
@ -1,50 +1,21 @@
|
|||
# 현재 작업 분석
|
||||
# 로드맵 현지점
|
||||
|
||||
- 추정 Phase: <phase-name 또는 복수 후보>
|
||||
- 추정 Milestone: <milestone-name 또는 복수 후보>
|
||||
- Phase 링크: [<phase-name>](agent-ops/roadmap/phase/<phase-slug>/PHASE.md)
|
||||
- Milestone 링크: [<milestone-name>](agent-ops/roadmap/phase/<phase-slug>/milestones/<milestone-slug>.md)
|
||||
- 우선순위 추천: <단일 후보 | 1순위: phase/milestone; 2순위: phase/milestone; 추천 근거>
|
||||
- 신뢰도: <높음 | 중간 | 낮음>
|
||||
- 구현 잠금: <해제 | 잠금 | 정보 없음>
|
||||
- 승격 조건: <없음 | [스케치] 항목의 [계획] 전환 조건 요약 | 정보 없음; [계획] 이상에서 섹션이 없으면 없음>
|
||||
- 완료 리뷰: <없음 | 요청됨 | 보완 필요 | 승인됨 | 보류 | 폐기 | 정보 없음>
|
||||
- 결정 필요: <없음 | 현재 요청에 직접 영향을 주는 사용자 결정 항목 요약>
|
||||
- 한 줄 결론: <현재 작업 지점과 가장 중요한 다음 판단을 1문장으로 요약>
|
||||
- [current.md](agent-ops/roadmap/current.md)
|
||||
|
||||
## 판단 근거
|
||||
- [로드맵: <roadmap-name>](agent-ops/roadmap/ROADMAP.md)
|
||||
- [Phase: <phase-name>](agent-ops/roadmap/phase/<phase-slug>/PHASE.md)
|
||||
- [Milestone: <milestone-name>](agent-ops/roadmap/phase/<phase-slug>/milestones/<milestone-slug>.md)
|
||||
- [<상태>] <목표 또는 역할 한 줄>
|
||||
- [Milestone: <milestone-name>](agent-ops/roadmap/phase/<phase-slug>/milestones/<milestone-slug>.md)
|
||||
- [<상태>] <목표 또는 역할 한 줄>
|
||||
|
||||
- 브랜치: <branch-name 또는 확인 불가>
|
||||
- 변경 파일: <없음 | N개, 핵심 경로 요약>
|
||||
- 로드맵 근거: <Milestone 목표/범위/기능 Task와 연결된 근거>
|
||||
- 코드/테스트 근거: <코드, 테스트, diff, 문서에서 확인한 근거>
|
||||
## 전체 Phase 흐름
|
||||
|
||||
## 후보 우선순위
|
||||
- [<상태>] [<Phase 이름>](<phase-path>)
|
||||
- [<상태>] [<현재 Phase 이름>](<phase-path>) ← 현재
|
||||
- [<상태>] [<Phase 이름>](<phase-path>)
|
||||
|
||||
- 1순위: <단일 후보 또는 가장 먼저 봐야 할 Phase/Milestone과 이유>
|
||||
- 2순위: <없음 또는 다음으로 봐야 할 Phase/Milestone과 이유>
|
||||
- 낮은 우선순위/보류: <없음 또는 후보에서 밀린 Phase/Milestone과 이유>
|
||||
## 현재 Phase의 Milestone 흐름
|
||||
|
||||
## 구현된 것으로 보이는 부분
|
||||
|
||||
- 확인됨: [<epic-id 또는 해당 없음>] [<item-id 또는 해당 없음>] <코드/문서/테스트 근거가 있는 완료 후보>
|
||||
|
||||
## 남은 작업
|
||||
|
||||
- 확인됨: [<epic-id 또는 신규 id 필요>] [<item-id 또는 신규 id 필요>] <코드/문서/테스트 근거로 남았다고 볼 수 있는 작업>
|
||||
- 추정됨: [<epic-id 또는 신규 id 필요>] [<item-id 또는 신규 id 필요>] <구조상 필요해 보이나 추가 확인이 필요한 작업>
|
||||
- 확인 필요: [<epic-id 또는 신규 id 필요>] [<item-id 또는 신규 id 필요>] <사용자 판단, 범위 결정, 제품 의도가 필요한 작업>
|
||||
|
||||
## 위험/불확실성
|
||||
|
||||
- <없음 또는 신뢰도를 낮춘 이유, 누락된 근거, 잠금/링크/템플릿 문제>
|
||||
|
||||
## 다음 행동
|
||||
|
||||
- 우선순위 1: <가장 먼저 할 작업 또는 확인>
|
||||
- 우선순위 2: <다음 작업 또는 확인>
|
||||
- 사용자 확인 필요: <없음 또는 현재 요청에 직접 영향을 주는 사용자 결정 질문>
|
||||
|
||||
## 읽은 주요 파일
|
||||
|
||||
- <path>
|
||||
- [<상태>] [<Milestone 이름>](<milestone-path>) ← 현재 후보, <역할 태그>
|
||||
- [<상태>] [<Milestone 이름>](<milestone-path>) ← 현재 후보, <역할 태그>
|
||||
|
|
|
|||
|
|
@ -1,103 +1,59 @@
|
|||
---
|
||||
name: analyze-roadmap-position
|
||||
version: 1.10.0
|
||||
description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 로드맵이 있으면 활성 Phase/Milestone과 코드 상태를 함께 읽고, 로드맵이 없으면 git/active task 기준으로 현재 작업 지점과 남은 일을 추정하는 읽기 전용 스킬"
|
||||
version: 1.11.0
|
||||
description: "여러 레포를 전환할 때 코드/git 분석 없이 전체 ROADMAP > Phase > Milestone > current 현지점을 링크 달린 breadcrumb와 흐름 목록으로 빠르게 보여주는 읽기 전용 스킬"
|
||||
---
|
||||
|
||||
# 작업 지점 분석
|
||||
# 로드맵 현지점
|
||||
|
||||
## 목적
|
||||
|
||||
현재 브랜치, 변경 파일, 코드 구조를 분석하고, 로드맵이 있으면 활성 Phase와 활성 Milestone 문서를 함께 읽어 지금 작업이 어느 Phase/Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다.
|
||||
로드맵이 있으면 결과에는 추정한 Phase와 Milestone의 문서 링크를 함께 출력한다.
|
||||
Phase나 Milestone 후보가 여럿이면 가장 먼저 볼 후보와 다음 후보를 추천하고, 추천 근거를 짧게 남긴다.
|
||||
Milestone의 `기능`에 Epic/Task id가 있으면 남은 작업과 판단 근거에 함께 표시해 사용자가 짧은 id로 후속 지시를 할 수 있게 한다.
|
||||
`current.md`만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다.
|
||||
`agent-ops/roadmap/` 디렉터리 또는 `current.md`가 없으면 로드맵 분석을 건너뛰고 git 상태, active `agent-task`, 요청 문장을 기준으로만 보고한다.
|
||||
여러 레포를 병렬 운용하다가 돌아왔을 때, 현재 작업이 전체 로드맵의 어느 Phase와 Milestone에 있는지 빠르게 보여준다.
|
||||
기본 출력은 `로드맵 > Phase > Milestone` breadcrumb와 전체 Phase 흐름, 현재 Phase의 Milestone 흐름이다.
|
||||
코드 진행도 감사, git diff 분석, 테스트 근거 확인, 남은 작업 정밀 판정은 기본 책임이 아니다.
|
||||
|
||||
## 언제 호출할지
|
||||
|
||||
- 사용자가 "지금 작업이 뭐지?", "현재 작업이 뭐야?", "어디까지 했지?"라고 물을 때
|
||||
- 사용자가 현재 브랜치 또는 변경 파일 기준으로 남은 작업을 알고 싶어 할 때
|
||||
- 활성 Phase/Milestone 안에서 이번 요청이 어느 범위에 속하는지 확인해야 할 때
|
||||
- 구현 전에 로드맵 기준 작업 위치를 가볍게 점검해야 할 때
|
||||
- 사용자가 레포 전환 직후 로드맵상 현재 좌표를 빠르게 알고 싶어 할 때
|
||||
- "로드맵상 현 위치", "현재 마일스톤 위치", "current 기준 breadcrumb"를 요청할 때
|
||||
- 구현 시작 전 전체 Roadmap > Phase > Milestone 관계만 확인하면 될 때
|
||||
|
||||
## 먼저 확인할 것
|
||||
|
||||
- [ ] `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 읽어 최신 답변 템플릿 확인
|
||||
- [ ] `agent-ops/roadmap/` 디렉터리 존재 여부 확인
|
||||
- [ ] `agent-ops/roadmap/current.md` 존재 여부 확인
|
||||
- [ ] 로드맵이 있으면 `current.md`의 활성 Phase와 활성 Milestone 목록이 가리키는 문서 존재 여부 확인
|
||||
- [ ] 로드맵이 있으면 활성 항목이 `agent-ops/roadmap/archive/**` 경로를 가리키지 않는지 확인
|
||||
- [ ] 로드맵이 있으면 활성 Phase/Milestone 이름과 문서 경로를 결과 출력에 쓸 Markdown 링크로 기록
|
||||
- [ ] git 저장소이면 현재 브랜치, `git status --short`, 변경 파일 목록 확인
|
||||
- [ ] 변경 파일이 있으면 `agent-ops/rules/project/rules.md`의 도메인 매핑 기준으로 관련 domain rule 확인
|
||||
- [ ] 로드맵이 있으면 `ROADMAP.md`의 `Phase 흐름`을 확인
|
||||
- [ ] `current.md`의 활성 Phase와 활성 Milestone 이름, 상태, 경로 확인
|
||||
- [ ] 활성 Phase 문서의 `Milestone 흐름` 확인
|
||||
- [ ] 활성 Milestone 문서의 제목, `목표`, `상태`만 확인
|
||||
|
||||
## 실행 절차
|
||||
|
||||
1. **활성 창 확인**
|
||||
- `agent-ops/roadmap/` 디렉터리가 없으면 `ROADMAP.md`, `current.md`, Phase, Milestone, archive 문서를 읽지 않고 로드맵 없음으로 기록한 뒤 작업 흔적 확인으로 넘어간다. 이 경우 아래 로드맵 읽기 단계는 수행하지 않는다.
|
||||
- `agent-ops/roadmap/current.md`가 없으면 `ROADMAP.md`를 자동으로 읽지 않는다. 로드맵 컨텍스트는 `없음` 또는 `확인 불가`로 기록하고 작업 흔적 확인으로 넘어간다. 이 경우 아래 로드맵 읽기 단계는 수행하지 않는다.
|
||||
- `agent-ops/roadmap/current.md`를 읽고 활성 Phase, 활성 Milestone 후보와 선택 규칙을 파악한다.
|
||||
- `current.md`의 후보가 `agent-ops/roadmap/archive/**`를 가리키면 해당 문서는 읽지 말고 로드맵 갱신 필요 항목으로 기록한다.
|
||||
- 관련 활성 Phase 문서를 읽고 Phase 목표, Milestone 흐름, Phase 경계를 확인한다.
|
||||
- 관련 활성 Milestone 문서를 읽고 목표, 상태, 승격 조건, 범위, 기능 Task, 완료 리뷰, 범위 제외, 구현 잠금을 확인한다. `승격 조건`은 `[스케치]`에서만 필수이며, `[계획]` 이상에서 섹션이 없으면 `없음`으로 본다.
|
||||
- 목록이 많으면 사용자 요청이나 변경 파일과 관련 높은 Phase/Milestone부터 읽는다.
|
||||
- `current.md` 형식이 맞지 않으면 `ROADMAP.md`를 자동으로 읽지 말고 로드맵 컨텍스트 불확실성을 보고한다.
|
||||
|
||||
2. **작업 흔적 확인**
|
||||
- git 저장소이면 `git branch --show-current`, `git status --short`, `git diff --name-only`, 필요 시 `git diff --stat`을 확인한다.
|
||||
- 변경 파일이 없으면 사용자의 요청 문장과 최근 대상 경로 힌트를 기준으로 추정한다.
|
||||
- 변경 파일이 있으면 관련 코드와 테스트 파일을 필요한 만큼만 읽는다.
|
||||
|
||||
3. **Phase/Milestone 매칭**
|
||||
- 로드맵이 없거나 `current.md`가 없으면 Phase/Milestone을 추정하지 않는다. `추정 Phase`, `추정 Milestone`, 문서 링크는 `없음`으로 기록하고 아래 Phase/Milestone 비교 항목은 수행하지 않는다.
|
||||
- 활성 Phase의 목표/경계와 변경 파일/요청 내용을 비교한다.
|
||||
- 활성 Milestone의 목표, 범위, 기능 Task, 범위 제외 항목과 변경 파일/요청 내용을 비교한다.
|
||||
- Milestone의 `기능`에서 관련 Epic/Task id가 있으면 판단 근거와 남은 작업에 함께 기록한다.
|
||||
- 여러 Milestone 후보에서 같은 epic-id 또는 item-id가 보이면 id만으로 위치를 확정하지 말고 Milestone 이름과 문서 링크를 함께 제시한다.
|
||||
- 활성 Milestone의 `구현 잠금` 섹션, 상태, `완료 리뷰` 섹션, `결정 필요` 항목을 함께 확인한다.
|
||||
- 하나의 Milestone에 명확히 속하면 단일 후보로 보고한다.
|
||||
- 둘 이상의 Phase 또는 Milestone에 걸치면 복수 후보로 보고하고, 어떤 파일이나 기능이 어느 후보에 닿는지 나눈다.
|
||||
- 복수 후보일 때는 후보 우선순위를 추천한다. 요청 문장/변경 파일 직접성, 현재 diff 근거, Milestone 상태, 구현 잠금, 선후 의존성, Phase/Milestone 흐름상 위치를 함께 본다.
|
||||
- 관련성이 비슷하면 `[검토중]` 후보는 리뷰/승인 요청에서 우선하고, 구현 작업 요청에서는 `[진행중]` 후보를 `[계획]` 후보보다 우선한다. `[스케치]` 후보는 구현 작업보다 컨셉 보강/계획 승격 요청에서 우선한다. 같은 상태라면 현재 변경 파일을 더 많이 설명하는 후보를 우선한다.
|
||||
- 사용자가 특정 Phase, Milestone, epic-id, item-id, 파일 경로를 명시했으면 그 후보를 우선하되, 범위 제외나 잠금 결정 필요가 있으면 우선순위 근거에 같이 적는다.
|
||||
- 로드맵이 있고 활성 Phase/Milestone 밖으로 보이면 `ROADMAP.md`의 Phase 흐름을 확인하고 전환 또는 신규 Phase/Milestone 필요성을 제안한다.
|
||||
|
||||
4. **남은 작업 분류**
|
||||
- `확인됨`: 코드, 문서, 테스트, diff로 근거가 있는 남은 작업
|
||||
- `추정됨`: 구조상 필요해 보이지만 추가 확인이 필요한 작업
|
||||
- `확인 필요`: 현재 요청에 직접 영향을 주는 제품 판단, 범위 결정, 사용자 의도가 필요한 작업
|
||||
- 완료 여부는 evidence 없이 확정하지 않는다.
|
||||
|
||||
5. **결과 보고**
|
||||
- `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 기준으로 출력한다.
|
||||
- 템플릿의 섹션 제목, 필드명, 순서를 바꾸지 않는다.
|
||||
- 템플릿의 모든 필드를 채우며, 근거가 없으면 생략하지 말고 `없음`, `확인 불가`, `확인 필요` 중 하나로 명시한다.
|
||||
- `판단 근거`에는 브랜치, 변경 파일, 로드맵 근거, 코드/테스트 근거를 각각 분리해 적는다.
|
||||
- `후보 우선순위`에는 복수 후보일 때 1순위와 2순위를 적고, 단일 후보이면 `단일 후보`라고 적는다.
|
||||
- `남은 작업`은 `확인됨`, `추정됨`, `확인 필요` 세 분류를 모두 유지한다.
|
||||
- `다음 행동`에는 가장 우선해야 할 실행 또는 확인을 1~2개만 적는다.
|
||||
- `읽은 주요 파일`에는 실제로 읽은 핵심 파일만 적는다.
|
||||
1. `agent-ops/roadmap/` 존재 여부를 확인한다.
|
||||
- 없으면 로드맵 없음으로 짧게 보고하고 멈춘다.
|
||||
2. `agent-ops/skills/common/_templates/roadmap-position-report-template.md`를 읽는다.
|
||||
3. `agent-ops/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`를 읽고 그 섹션 순서와 필드명을 유지했는가
|
||||
- [ ] 로드맵이 없는 프로젝트에서 `ROADMAP.md`, `current.md`, Phase, Milestone 문서를 읽으려 하지 않았는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 `current.md`만 근거로 현재 위치를 단정하지 않았는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 활성 Phase 문서의 목표와 Phase 경계를 확인했는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 활성 Milestone 문서의 목표와 범위 제외 항목을 확인했는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 `[스케치]` Phase/Milestone의 승격 조건과 구현 계획 금지 여부를 확인했는가
|
||||
- [ ] `[계획]` 이상 Milestone에 `승격 조건` 섹션이 없어도 템플릿 문제로 보고하지 않았는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 활성 Milestone 문서의 `완료 리뷰` 섹션과 `[검토중]` 상태 여부를 확인했는가
|
||||
- [ ] `agent-ops/roadmap/archive/**` 문서를 명시 요청 없이 읽지 않았는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 활성 Milestone 문서의 `구현 잠금` 섹션 존재 여부, 상태, `결정 필요` 항목을 확인했는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 추정 Phase/Milestone마다 문서 링크를 출력했는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 Phase/Milestone 후보가 여럿이면 1순위와 2순위 추천 및 근거를 출력했는가
|
||||
- [ ] 로드맵이 있는 프로젝트에서 관련 Epic/Task id가 있으면 결과에 함께 표시했는가
|
||||
- [ ] 변경 파일 또는 사용자 요청과 Phase/Milestone 판단 근거가 연결되어 있는가
|
||||
- [ ] 남은 작업을 `확인됨`, `추정됨`, `확인 필요`로 구분했는가
|
||||
- [ ] 템플릿 필드를 근거 없이 생략하지 않고 `없음`, `확인 불가`, `확인 필요`로 채웠는가
|
||||
- [ ] `roadmap-position-report-template.md`의 출력 구조를 유지했는가
|
||||
- [ ] `current.md`, `ROADMAP.md`, 활성 `PHASE.md`, 활성 Milestone의 제목/목표/상태만 기본으로 읽었는가
|
||||
- [ ] 완료 또는 archive Phase/Milestone은 링크만 표시하고 archive 문서를 읽지 않았는가
|
||||
- [ ] current가 여러 Milestone을 가리키면 모두 `현재 후보`로 표시했는가
|
||||
- [ ] 코드 파일, 테스트 파일, `git status`, `git diff`를 기본 동작에서 읽지 않았는가
|
||||
- [ ] 로드맵 파일을 수정하지 않았는가
|
||||
|
||||
## 출력 형식
|
||||
|
|
@ -105,14 +61,14 @@ Milestone의 `기능`에 Epic/Task id가 있으면 남은 작업과 판단 근
|
|||
- 템플릿 경로: `agent-ops/skills/common/_templates/roadmap-position-report-template.md`
|
||||
- 템플릿을 그대로 복사해 placeholder를 채운다.
|
||||
- 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다.
|
||||
- 값이 없는 필드는 `없음`, `확인 불가`, `확인 필요` 중 하나로 채운다.
|
||||
- 로드맵이 없는 프로젝트에서는 추정 Phase, 추정 Milestone, Phase 링크, Milestone 링크, 로드맵 근거를 `없음`으로 채운다.
|
||||
- current가 여러 Milestone을 가리키면 breadcrumb와 Milestone 흐름에 모두 표시한다.
|
||||
- 현재 후보의 역할 태그는 `선행 스케치`, `다음 구현 계획`, `검토 후보`, `보류 후보`처럼 짧게 쓴다.
|
||||
- 로드맵이 없는 프로젝트에서는 로드맵 없음으로 짧게 보고하고 템플릿을 억지로 채우지 않는다.
|
||||
|
||||
## 금지 사항
|
||||
|
||||
- `current.md`만 읽고 현재 작업 위치를 확정하지 않는다.
|
||||
- 로드맵이 없는 프로젝트에서 로드맵 파일을 만들거나 읽는 것을 현재 작업 분석의 선행 조건으로 삼지 않는다.
|
||||
- 기본 동작에서 코드 파일, 테스트 파일, `git status`, `git diff`를 읽지 않는다.
|
||||
- 기본 동작에서 Milestone의 `기능` 체크리스트를 감사하지 않는다.
|
||||
- 완료 여부, 남은 작업, 코드와 문서의 동기화 상태를 evidence 기반으로 판정하지 않는다.
|
||||
- 사용자가 명시하지 않은 상태에서 `ROADMAP.md`, `current.md`, Phase, Milestone 문서를 수정하지 않는다.
|
||||
- 사용자가 명시하지 않은 상태에서 `agent-ops/roadmap/archive/**`를 읽지 않는다.
|
||||
- evidence 없이 Phase, Milestone, Epic, Task를 `[완료]` 또는 `[검토중]`으로 처리하지 않는다.
|
||||
- 활성 Phase/Milestone 밖 작업을 임의로 새 항목으로 추가하지 않는다.
|
||||
- 사용자가 과거 기록 확인을 명시하지 않으면 `agent-ops/roadmap/archive/**`를 읽지 않는다.
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@
|
|||
| README 작성해줘, README 만들어줘, 프로젝트 설명 문서 만들어줘 | `agent-ops/skills/common/create-readme/SKILL.md` |
|
||||
| 로드맵 만들어줘, roadmap 생성, 마일스톤 설계, goal/phase 구조 잡아줘 | `agent-ops/skills/common/create-roadmap/SKILL.md` |
|
||||
| 로드맵 업데이트, roadmap 갱신, 로드맵에 추가, 로드맵 작업 추가, 로드맵 기능 추가, 로드맵 Epic 추가, 로드맵 에픽 추가, 로드맵 Task 추가, 로드맵 태스크 추가, 로드맵 테스크 추가, 로드맵 TODO 추가, 마일스톤에 추가, 마일스톤 추가, 마일스톤 갱신, 마일스톤 아카이브, phase 추가, phase 변경, 페이즈 추가, 페이즈 변경, 현재 마일스톤 변경, 로드맵 한국어 전환, 로드맵 번역 | `agent-ops/skills/common/update-roadmap/SKILL.md` |
|
||||
| 지금 작업이 뭐지?, 현재 작업 분석, 어디까지 했지?, 남은 작업 뭐야 | `agent-ops/skills/common/analyze-roadmap-position/SKILL.md` |
|
||||
| 지금 작업이 뭐지?, 현재 작업 분석, 어디까지 했지?, 로드맵상 현 위치, 현재 마일스톤 위치, current 기준 breadcrumb | `agent-ops/skills/common/analyze-roadmap-position/SKILL.md` |
|
||||
| 계획 세워줘, 계획 작성해, 계획 만들어줘, 구현 계획, PLAN.md, plan, plan 작성해, plan 만들어줘 | `agent-ops/skills/common/plan/SKILL.md` |
|
||||
| 코드 리뷰해줘, 리뷰 진행해, 리뷰해줘, code review, CODE_REVIEW.md, 리뷰 루프 | `agent-ops/skills/common/code-review/SKILL.md` |
|
||||
| 커밋해줘, 푸시해줘, commit, push, 반영해줘 | `agent-ops/skills/common/commit-push/SKILL.md` |
|
||||
|
|
|
|||
Loading…
Reference in a new issue