toki/iop
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

sync: to agentic-framework v1.1.20

Browse source
This commit is contained in:
toki 2026-05-21 17:56:27 +09:00
parent cb1ead7813
commit 22f11593df
3 changed files with 46 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
agent-ops/.version
View file

@ -1 +1 @@
1.1.19
1.1.20

37
agent-ops/skills/common/create-roadmap/SKILL.md
View file

@ -1,7 +1,7 @@
---
name: create-roadmap
version: 1.0.0
description: AI-first 개인/소규모 프로젝트의 전체 Goal, Phase, Milestone 기반 로드맵 파일과 현재 마일스톤 컨텍스트 로딩 규칙을 처음 생성하는 공통 스킬
description: AI-first 개인/소규모 프로젝트의 전체 Goal, Phase, Milestone 기반 로드맵 파일과 Default/Active Milestone 컨텍스트 로딩 규칙을 처음 생성하는 공통 스킬
---
# Create Roadmap
@ -9,7 +9,7 @@ description: AI-first 개인/소규모 프로젝트의 전체 Goal, Phase, Miles
## 목적
`agent-ops/roadmap/` 하위에 Goal / Phase / Milestone 기반 로드맵 구조를 처음 생성한다.
전체 로드맵은 마일스톤 설계 시에만 읽고, 일반 작업에서는 현재 마일스톤 정의만 읽도록 컨텍스트 로딩 규칙을 만든다.
전체 로드맵은 마일스톤 설계 시에만 읽고, 일반 작업에서는 `current.md`의 Default Milestone 또는 요청에 맞는 Active Milestone 정의만 읽도록 컨텍스트 로딩 규칙을 만든다.
## 언제 호출할지
@ -23,7 +23,8 @@ description: AI-first 개인/소규모 프로젝트의 전체 Goal, Phase, Miles
- `overall-goal`: 프로젝트 전체 Goal 한 줄 또는 짧은 문단 (선택, 없으면 README와 현재 구조에서 추론)
- `phase-hints`: 예상 Phase 목록 또는 단계 힌트 (선택)
- `milestone-hints`: 예상 Milestone 목록 또는 기능 힌트 (선택)
- `active-milestone`: 현재 진행 중인 Milestone 이름 또는 번호 (선택, 없으면 추론 후 사용자에게 확인)
- `default-milestone`: 애매한 요청이나 현재 집중 작업의 기본 Milestone 이름 또는 번호 (선택, 없으면 추론 후 사용자에게 확인)
- `active-milestones`: 동시에 진행 중인 Milestone 목록 (선택, 없으면 현재 구현 상태와 요청에서 추론)
## 생성 구조
@ -40,7 +41,7 @@ agent-ops/
| 파일 | 역할 |
|------|------|
| `agent-ops/roadmap/ROADMAP.md` | 전체 Goal, Phase 흐름, Milestone 인덱스. 로드맵 생성/갱신/Phase 전환 때만 읽는다 |
| `agent-ops/roadmap/current.md` | 현재 Phase와 Active Milestone 문서 경로를 가리키는 얇은 포인터 |
| `agent-ops/roadmap/current.md` | 현재 Phase, Default Milestone, 동시에 진행 중인 Active Milestone 목록을 가리키는 얇은 포인터 |
| `agent-ops/roadmap/milestones/MNN-<milestone-slug>.md` | 일반 작업 시 읽는 Milestone 단위 Goal, Scope, 기능 목록, Non-Goals |
### current.md 형식
@ -51,10 +52,16 @@ agent-ops/
# Current Roadmap Context
- Active Phase: <phase-name>
- Active Milestone: <MNN milestone-name>
- Active Milestone File: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
- Default Milestone: <MNN milestone-name>
- Default Milestone File: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
## Active Milestones
- <MNN milestone-name>: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
```
Default Milestone은 애매한 요청의 기본 작업 초점이다. Active Milestones는 동시에 진행 중인 Milestone 후보 목록이며, 요청이 Default Milestone과 맞지 않으면 이 목록에서 가장 관련 있는 Milestone을 읽는다.
## 먼저 확인할 것
- [ ] `agent-ops/roadmap/ROADMAP.md` 또는 `agent-ops/roadmap/current.md`가 이미 존재하는지 확인
@ -84,7 +91,7 @@ agent-ops/
4. **로드맵 파일 생성**
- `agent-ops/roadmap/ROADMAP.md`에는 전체 Goal, 현재 위치, Phase 개요, Milestone 인덱스, 로딩 정책을 작성한다
- `agent-ops/roadmap/current.md`에는 정해진 `current.md 형식` 그대로 Active Phase와 Active Milestone 문서 경로만 작성한다
- `agent-ops/roadmap/current.md`에는 정해진 `current.md 형식` 그대로 Active Phase, Default Milestone, Active Milestones 목록을 작성한다
- 각 Milestone 문서에는 아래 섹션을 포함한다
- `Goal`
- `Phase`
@ -101,23 +108,26 @@ agent-ops/
```markdown
## 마일스톤 컨텍스트 로딩
- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 읽고, 그 안의 Active Milestone 문서를 같은 세션에서 1회 읽는다.
- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다.
- 요청이 Default Milestone 범위에 맞으면 Default Milestone 문서를 같은 세션에서 1회 읽는다.
- 요청이 Default Milestone과 맞지 않으면 `current.md`의 Active Milestones 목록에서 가장 관련 있는 Milestone 문서를 같은 세션에서 1회 읽는다.
- Active Milestones에도 맞지 않으면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 인덱스를 확인하고 사용자에게 진행/전환 여부를 확인한다.
- `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다.
- 작업 요청이 Active Milestone의 Goal 또는 Non-Goals와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.
- 작업 요청이 선택된 Milestone의 Goal 또는 Non-Goals와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.
```
- 같은 섹션이 이미 있으면 중복 추가하지 않고 필요한 문장만 보완한다
- `agent-ops/rules/project/rules.md`가 없으면 파일을 새로 만들지 말고, 추가하지 못한 항목으로 보고한다
6. **결과 보고**
- 생성한 로드맵 파일 목록
- Active Phase와 Active Milestone
- Active Phase, Default Milestone, Active Milestones
- `rules/project/rules.md`에 추가한 로딩 규칙 여부
- 확인이 필요한 TODO 또는 가정
## 실행 결과 검증
- [ ] `agent-ops/roadmap/ROADMAP.md`가 생성되었는가
- [ ] `agent-ops/roadmap/current.md`가 Active Milestone 문서 경로를 정확히 가리키는가
- [ ] `agent-ops/roadmap/current.md`가 Default Milestone 문서 경로와 Active Milestones 문서 경로를 정확히 가리키는가
- [ ] `agent-ops/roadmap/milestones/` 하위에 Milestone 문서가 생성되었는가
- [ ] 각 Milestone 문서가 필수 섹션을 포함하는가
- [ ] `ROADMAP.md`에 전체 로드맵을 일반 작업마다 읽지 말라는 로딩 정책이 포함되었는가
@ -131,13 +141,14 @@ agent-ops/
- Roadmap: agent-ops/roadmap/ROADMAP.md
- Current Context: agent-ops/roadmap/current.md
- Active Milestone: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
- Default Milestone: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
- Active Milestones: <N개>
- Project Rules 업데이트: <추가함 | 이미 존재함 | rules/project/rules.md 없음>
## 현재 위치
- Phase: <phase-name>
- Milestone: <MNN milestone-name>
- Default Milestone: <MNN milestone-name>
## TODO 항목

33
agent-ops/skills/common/update-roadmap/SKILL.md
View file

@ -1,7 +1,7 @@
---
name: update-roadmap
version: 1.0.0
description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 current.md와 Active Milestone 정의를 동기화하는 공통 스킬
description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 current.md의 Default/Active Milestone 정의를 동기화하는 공통 스킬
---
# Update Roadmap
@ -9,19 +9,21 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
## 목적
기존 `agent-ops/roadmap/` 구조를 현재 프로젝트 방향과 진행 상태에 맞게 갱신한다.
로드맵 전체를 매 작업마다 읽지 않도록 유지하면서, `current.md`와 Active Milestone 문서가 실제 작업 기준으로 동작하게 한다.
로드맵 전체를 매 작업마다 읽지 않도록 유지하면서, `current.md`의 Default Milestone과 Active Milestones 목록이 실제 작업 기준으로 동작하게 한다.
## 언제 호출할지
- 사용자가 "로드맵 업데이트", "마일스톤 갱신", "phase 변경", "현재 마일스톤 바꿔줘"라고 요청할 때
- Milestone 완료, 보류, 폐기, 신규 추가가 필요할 때
- Active Milestone의 Goal, Scope, Required Features, Success Criteria가 달라졌을 때
- Default Milestone 또는 Active Milestone의 Goal, Scope, Required Features, Success Criteria가 달라졌을 때
- 실제 구현 상태와 로드맵 파일이 어긋난 것 같아 동기화가 필요할 때
## 입력
- `mode`: `status` / `milestone` / `phase` / `replan` / `sync` 중 하나 (선택, 요청에서 추론 가능)
- `target-milestone`: 갱신할 Milestone ID 또는 이름 (선택)
- `default-milestone`: 기본 작업 초점으로 둘 Milestone ID 또는 이름 (선택)
- `active-milestones`: 동시에 Active 상태로 둘 Milestone ID 또는 이름 목록 (선택)
- `change-summary`: 반영할 방향 변경 또는 진행 상황 요약 (선택)
- `evidence`: 완료 판단에 사용할 파일, PR, 테스트, 커밋, 사용자 설명 (선택)
@ -31,7 +33,7 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
|------|-----------|
| `status` | 기능 체크박스, Milestone 상태, 완료 기준만 갱신 |
| `milestone` | Milestone Goal, Scope, 기능 목록, Success Criteria 수정 |
| `phase` | Active Phase 또는 Active Milestone 전환 |
| `phase` | Active Phase, Default Milestone, Active Milestones 전환 |
| `replan` | 전체 Phase/Milestone 흐름 재구성 |
| `sync` | 실제 프로젝트 상태와 로드맵 불일치 점검 후 보정 |
@ -39,7 +41,7 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
- [ ] `agent-ops/roadmap/ROADMAP.md` 존재 여부 확인
- [ ] `agent-ops/roadmap/current.md` 존재 여부 확인
- [ ] `current.md`가 가리키는 Active Milestone 문서 존재 여부 확인
- [ ] `current.md`가 가리키는 Default Milestone 문서와 Active Milestones 문서 존재 여부 확인
- [ ] `current.md`가 정해진 형식을 유지하는지 확인
- [ ] 로드맵 파일이 없으면 `create-roadmap` 스킬 사용을 안내하고 중단
- [ ] 완료 상태로 바꾸는 경우 사용자의 명시 또는 확인 가능한 evidence가 있는지 확인
@ -49,12 +51,14 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
1. **갱신 범위 결정**
- 요청에서 mode와 target milestone을 추론한다
- `status` 갱신이면 `current.md`와 대상 Milestone 문서를 우선 읽는다
- 요청이 Default Milestone과 맞지 않으면 `current.md`의 Active Milestones 목록에서 대상 Milestone을 찾는다
- Active Milestones에도 맞지 않으면 `ROADMAP.md`의 Milestone 인덱스를 확인하고 사용자에게 진행/전환 여부를 확인한다
- Phase 전환, Milestone 추가/삭제, 순서 변경, 전체 재계획이면 `ROADMAP.md`도 읽는다
- 불필요하게 모든 Milestone 문서를 읽지 않는다
2. **현재 로드맵 상태 파악**
- `ROADMAP.md`의 전체 Goal, Phase 개요, Milestone 인덱스를 확인한다
- `current.md`의 Active Phase와 Active Milestone 포인터를 확인한다
- `current.md`의 Active Phase, Default Milestone, Active Milestones 포인터를 확인한다
- 대상 Milestone 문서의 Goal, Scope, Required Features, Success Criteria, Non-Goals를 확인한다
3. **변경 내용 검증**
@ -64,13 +68,17 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
4. **로드맵 파일 갱신**
- `ROADMAP.md`는 전체 Goal, Phase 개요, Milestone 인덱스, 현재 위치가 바뀔 때만 수정한다
- `current.md`는 Active Phase 또는 Active Milestone이 바뀔 때 아래 형식으로 수정한다
- `current.md`는 Active Phase, Default Milestone, Active Milestones 목록이 바뀔 때 아래 형식으로 수정한다
```markdown
# Current Roadmap Context
- Active Phase: <phase-name>
- Active Milestone: <MNN milestone-name>
- Active Milestone File: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
- Default Milestone: <MNN milestone-name>
- Default Milestone File: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
## Active Milestones
- <MNN milestone-name>: agent-ops/roadmap/milestones/MNN-<milestone-slug>.md
```
- Milestone 문서는 해당 Milestone의 Goal, Scope, Required Features, Success Criteria, Non-Goals, Context for Work가 바뀔 때 수정한다
- 상태 값은 `Planned`, `Active`, `Done`, `Paused`, `Dropped` 중 하나만 사용한다
@ -89,8 +97,8 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
## 실행 결과 검증
- [ ] `current.md`의 Active Milestone 경로가 실제 파일을 가리키는가
- [ ] `current.md`가 `# Current Roadmap Context`, `Active Phase`, `Active Milestone`, `Active Milestone File` 형식을 유지하는가
- [ ] `current.md`의 Default Milestone과 Active Milestones 경로가 실제 파일을 가리키는가
- [ ] `current.md`가 `# Current Roadmap Context`, `Active Phase`, `Default Milestone`, `Default Milestone File`, `Active Milestones` 형식을 유지하는가
- [ ] `ROADMAP.md`의 현재 위치와 Milestone 인덱스가 `current.md`와 일치하는가
- [ ] 대상 Milestone 문서의 상태가 `ROADMAP.md`의 Milestone 인덱스 상태와 일치하는가
- [ ] 완료 처리한 기능에 사용자 설명 또는 확인 가능한 evidence가 있는가
@ -111,7 +119,8 @@ description: 기존 Goal, Phase, Milestone 기반 로드맵을 갱신하고 curr
## 변경 사항
- Phase: <변경 없음 | 이전 → 이후>
- Active Milestone: <변경 없음 | 이전 → 이후>
- Default Milestone: <변경 없음 | 이전 → 이후>
- Active Milestones: <변경 없음 | 추가/제거 요약>
- Status: <변경 없음 | 이전 → 이후>
- Required Features: <추가/수정/완료/제거 요약>