8.7 KiB
8.7 KiB
| name | version | description |
|---|---|---|
| update-roadmap | 1.1.0 | 기존 전체 목표, Phase, Milestone 기반 한국어 로드맵을 갱신하고 current.md의 기본/진행 중 Milestone 정의를 동기화하는 공통 스킬 |
로드맵 업데이트
목적
기존 agent-ops/roadmap/ 구조를 현재 프로젝트 방향과 진행 상태에 맞게 한국어로 갱신한다.
로드맵 전체를 매 작업마다 읽지 않도록 유지하면서, current.md의 기본 Milestone과 진행 중인 Milestone 목록이 실제 작업 기준으로 동작하게 한다.
언제 호출할지
- 사용자가 "로드맵 업데이트", "마일스톤 갱신", "phase 변경", "현재 마일스톤 바꿔줘"라고 요청할 때
- 사용자가 "로드맵 한국어 전환", "로드맵 번역", "영문 로드맵을 한국어로 바꿔줘"라고 요청할 때
- Milestone 완료, 보류, 폐기, 신규 추가가 필요할 때
- 기본 Milestone 또는 진행 중인 Milestone의 목표, 범위, 필수 기능, 완료 기준이 달라졌을 때
- 실제 구현 상태와 로드맵 파일이 어긋난 것 같아 동기화가 필요할 때
입력
mode:status/milestone/phase/replan/sync중 하나 (선택, 요청에서 추론 가능)target-milestone: 갱신할 Milestone ID 또는 이름 (선택)default-milestone: 기본 작업 초점으로 둘 Milestone ID 또는 이름 (선택)active-milestones: 동시에 진행 중 상태로 둘 Milestone ID 또는 이름 목록 (선택)change-summary: 반영할 방향 변경 또는 진행 상황 요약 (선택)evidence: 완료 판단에 사용할 파일, PR, 테스트, 커밋, 사용자 설명 (선택)
모드
| mode | 사용 상황 |
|---|---|
status |
기능 체크박스, Milestone 상태, 완료 기준만 갱신 |
milestone |
Milestone 목표, 범위, 기능 목록, 완료 기준 수정 |
phase |
현재 Phase, 기본 Milestone, 진행 중인 Milestone 전환 |
replan |
전체 Phase/Milestone 흐름 재구성 |
sync |
실제 프로젝트 상태와 로드맵 불일치 점검 후 보정 |
작성 언어
agent-ops/roadmap/하위 로드맵 문서는 사람이 함께 검토하고 수정하는 협업 문서이므로 기본 작성 언어를 한국어로 한다.- 전체 구성, 섹션 제목, 설명 문장, 기능 설명, 완료 기준, TODO, 가정은 한국어 문장으로 작성한다.
- Goal, Phase, Milestone, Scope, API, CLI처럼 개발자에게 자연스러운 일반 용어, 파일명, 경로, Milestone ID(
M01등), slug, 코드 식별자는 영어 또는 숫자를 유지할 수 있다. - 상태 값은
계획,진행 중,완료,보류,폐기중 하나만 사용한다. - 기존 영문 상태 값은
Planned→계획,Active→진행 중,Done→완료,Paused→보류,Dropped→폐기로 맞춘다. - 기존 영문 섹션명이 갱신 범위에 포함되면 아래 한국어 표준 섹션명으로 정리한다.
Goal→목표Phase→단계Status→상태Scope→범위Required Features→필수 기능Success Criteria→완료 기준Non-Goals→범위 제외Context for Work→작업 컨텍스트
먼저 확인할 것
agent-ops/roadmap/ROADMAP.md존재 여부 확인agent-ops/roadmap/current.md존재 여부 확인current.md가 가리키는 기본 Milestone 문서와 진행 중인 Milestone 문서 존재 여부 확인current.md가 정해진 한국어 형식을 유지하는지 확인- 로드맵 파일이 없으면
create-roadmap스킬 사용을 안내하고 중단 - 완료 상태로 바꾸는 경우 사용자의 명시 또는 확인 가능한 evidence가 있는지 확인
실행 절차
-
갱신 범위 결정
- 요청에서 mode와 target milestone을 추론한다
- 로드맵 언어 전환 요청이면
sync로 보고ROADMAP.md,current.md, 전체 Milestone 문서를 갱신 범위에 포함할 수 있다 status갱신이면current.md와 대상 Milestone 문서를 우선 읽는다- 요청이 기본 Milestone과 맞지 않으면
current.md의 진행 중인 Milestone 목록에서 대상 Milestone을 찾는다 - 진행 중인 Milestone에도 맞지 않으면
ROADMAP.md의 Milestone 인덱스를 확인하고 사용자에게 진행/전환 여부를 확인한다 - Phase 전환, Milestone 추가/삭제, 순서 변경, 전체 재계획이면
ROADMAP.md도 읽는다 - 불필요하게 모든 Milestone 문서를 읽지 않는다
-
현재 로드맵 상태 파악
ROADMAP.md의 전체 목표, Phase 개요, Milestone 인덱스를 확인한다current.md의 현재 Phase, 기본 Milestone, 진행 중인 Milestone 포인터를 확인한다- 대상 Milestone 문서의 목표, 범위, 필수 기능, 완료 기준, 범위 제외 항목을 확인한다
-
변경 내용 검증
- 기능 완료 체크는 사용자 설명 또는 파일/테스트/커밋 등 확인 가능한 근거를 기준으로 한다
- evidence 없이 완료 여부가 불확실하면 체크하지 않고 TODO 또는 확인 필요로 남긴다
- 변경 요청이 전체 목표 또는 Phase 목표와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다
-
로드맵 파일 갱신
ROADMAP.md는 전체 목표, Phase 개요, Milestone 인덱스, 현재 위치가 바뀔 때만 수정한다current.md는 현재 Phase, 기본 Milestone, 진행 중인 Milestone 목록이 바뀔 때 아래 형식으로 수정한다# 현재 로드맵 컨텍스트 - 현재 Phase: <phase-name> - 기본 Milestone: <MNN milestone-name> - 기본 Milestone 파일: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md ## 진행 중인 Milestone - <MNN milestone-name>: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md- Milestone 문서는 해당 Milestone의 목표, 범위, 필수 기능, 완료 기준, 범위 제외, 작업 컨텍스트가 바뀔 때 수정한다
- 상태 값은
계획,진행 중,완료,보류,폐기중 하나만 사용한다 - 완료된 Milestone의 기록은 삭제하지 않고 상태만 변경한다
-
마일스톤 컨텍스트 로딩 규칙 점검
agent-ops/rules/project/rules.md가 있으면## 마일스톤 컨텍스트 로딩섹션이 있는지 확인한다- 없으면
create-roadmap과 동일한 로딩 규칙을 추가한다 - 기존 섹션이 있으면 전체
ROADMAP.md를 일반 작업마다 읽도록 되어 있지 않은지 확인하고 보정한다
-
결과 보고
- 수정한 파일 목록
- 변경된 Phase / Milestone / 상태
- 체크하거나 추가/제거한 필수 기능
- 확인 필요로 남긴 항목
실행 결과 검증
current.md의 기본 Milestone과 진행 중인 Milestone 경로가 실제 파일을 가리키는가current.md가# 현재 로드맵 컨텍스트,현재 Phase,기본 Milestone,기본 Milestone 파일,진행 중인 Milestone형식을 유지하는가ROADMAP.md의 현재 위치와 Milestone 인덱스가current.md와 일치하는가- 대상 Milestone 문서의 상태가
ROADMAP.md의 Milestone 인덱스 상태와 일치하는가 - 완료 처리한 기능에 사용자 설명 또는 확인 가능한 evidence가 있는가
rules/project/rules.md가 있는 경우 마일스톤 컨텍스트 로딩 섹션이 유지되는가- 검증 실패 시: 불일치한 파일만 다시 읽고 해당 항목만 수정한다
출력 형식
## 업데이트 완료
- 모드: <status | milestone | phase | replan | sync>
- 수정 파일:
- agent-ops/roadmap/ROADMAP.md
- agent-ops/roadmap/current.md
- agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
## 변경 사항
- Phase: <변경 없음 | 이전 → 이후>
- 기본 Milestone: <변경 없음 | 이전 → 이후>
- 진행 중인 Milestone: <변경 없음 | 추가/제거 요약>
- 상태: <변경 없음 | 이전 → 이후>
- 필수 기능: <추가/수정/완료/제거 요약>
## TODO 항목
- <확인이 필요한 항목> (해당 시)
금지 사항
- 로드맵 파일이 없는데 새 구조를 임의로 만들지 않는다. 이 경우
create-roadmap을 사용한다 - evidence 없이 기능이나 Milestone을 완료 처리하지 않는다
- 전체
ROADMAP.md를 모든 작업의 필수 로딩 파일로 만들지 않는다 - 완료된 Milestone 기록을 삭제하지 않는다
- Milestone 목표와 범위 제외 항목을 무시하고 기능 목록만 갱신하지 않는다
- 타겟 프로젝트에서
agent-ops/rules/common/또는agent-ops/skills/common/을 직접 수정하지 않는다