diff --git a/agent-ops/.version b/agent-ops/.version index 93325dd..9090603 100644 --- a/agent-ops/.version +++ b/agent-ops/.version @@ -1 +1 @@ -1.1.27 +1.1.28 diff --git a/agent-ops/rules/common/rules-roadmap.md b/agent-ops/rules/common/rules-roadmap.md new file mode 100644 index 0000000..3f9e44e --- /dev/null +++ b/agent-ops/rules/common/rules-roadmap.md @@ -0,0 +1,26 @@ +# 로드맵 규칙 + +`agent-ops/roadmap/` 디렉터리가 있는 프로젝트에서만 적용한다. + +## 로딩 + +- 세션 최초 1회 `agent-ops/roadmap/current.md`를 읽고 활성 Milestone 이름, 경로, 목표, 주요 범위, 범위 제외만 짧게 기억한다. +- 일반 작업에서는 `ROADMAP.md`를 읽지 않는다. +- `ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정, 활성 Milestone 밖 작업 확인 때만 읽는다. + +## Milestone 선택 + +- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. +- 기능 추가, 구조 변경, 스킬/문서 구조 변경 전에는 요청, 브랜치, 변경 파일, 관련 경로를 보고 관련 Milestone 문서를 1회 읽는다. +- 선택한 Milestone의 목표 또는 범위 제외와 요청이 충돌하면 구현 전에 사용자에게 확인한다. + +## 구현 잠금 + +- 선택한 Milestone에 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 코드 구현, `agent-task` 구현 계획, 세부 API/파일 구조 확정을 시작하지 않는다. +- 단순 "진행", "구현", "계획 작성" 요청은 잠금을 해제하지 않는다. +- 잠금 해제는 사용자가 Milestone 구체화 업데이트 또는 잠금 해제를 명시한 경우에만 검토한다. + +## 작업 지점 분석 + +- 현재 작업 지점이나 남은 작업 분석 요청은 `analyze-roadmap-position` 스킬로 처리한다. +- 이때 `current.md`만으로 단정하지 말고 코드, git 상태, diff, 활성 Milestone 문서를 함께 본다. diff --git a/agent-ops/rules/common/rules.md b/agent-ops/rules/common/rules.md index 2279ce5..8095d70 100644 --- a/agent-ops/rules/common/rules.md +++ b/agent-ops/rules/common/rules.md @@ -8,7 +8,7 @@ `agent-ops/rules/project/rules.md`와 `agent-ops/rules/private/rules.md`는 세션 최초 1회 읽는다. 파일이 없으면 무시한다. -`agent-ops/roadmap/current.md`가 있으면 세션 최초 1회 읽고, 활성 Milestone의 이름, 경로, 목표, 주요 범위, 주의할 범위 제외 항목만 짧게 요약해 세션 컨텍스트로 유지한다. +`agent-ops/roadmap/` 디렉터리가 있으면 세션 최초 1회 `agent-ops/rules/common/rules-roadmap.md`를 읽는다. 로드맵 디렉터리나 파일이 없으면 무시한다. 아래 성격의 요청은 사용자가 명시적으로 요청한 경우에만 `agent-ops/skills/common/router.md`를 작업 최초 1회 읽고 수행한다. 자동으로 수행하지 않는다. - agent-ops 초기화 diff --git a/agent-ops/skills/common/analyze-roadmap-position/SKILL.md b/agent-ops/skills/common/analyze-roadmap-position/SKILL.md index c47bdcf..c5075fb 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.1.0 +version: 1.1.1 description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 활성 Milestone과 코드 상태를 함께 읽어 현재 작업 지점, Milestone 문서 링크, 남은 일을 추정하는 읽기 전용 스킬" --- @@ -62,7 +62,7 @@ description: "지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확 5. **결과 보고** - 추정 Milestone과 신뢰도 - 추정 Milestone 문서 링크 -- 구현 잠금 상태와 잠금/정보 없음 상태일 때 필요한 다음 조치 + - 구현 잠금 상태와 잠금/정보 없음 상태일 때 필요한 다음 조치 - 판단 근거 - 구현된 것으로 보이는 부분 - 남은 작업 diff --git a/agent-ops/skills/common/create-roadmap/SKILL.md b/agent-ops/skills/common/create-roadmap/SKILL.md index ea5061c..b5bf265 100644 --- a/agent-ops/skills/common/create-roadmap/SKILL.md +++ b/agent-ops/skills/common/create-roadmap/SKILL.md @@ -1,6 +1,6 @@ --- name: create-roadmap -version: 1.5.0 +version: 1.5.1 description: AI-first 개인/소규모 프로젝트의 전체 목표, Phase, 구현 구체화 잠금이 있는 순번 없는 Milestone 문서, 활성 Milestone 창을 처음 생성하는 공통 스킬 --- @@ -9,7 +9,7 @@ description: AI-first 개인/소규모 프로젝트의 전체 목표, Phase, 구 ## 목적 `agent-ops/roadmap/` 하위에 전체 목표 / Phase / Milestone 기반 한국어 로드맵 구조를 처음 생성한다. -전체 로드맵은 로드맵 설계와 갱신 때만 읽고, 일반 작업에서는 `current.md`의 활성 Milestone 창과 관련 Milestone 문서만 읽도록 컨텍스트 로딩 규칙을 만든다. +전체 로드맵은 로드맵 설계와 갱신 때만 읽고, 일반 작업에서는 `current.md`의 활성 Milestone 창과 관련 Milestone 문서만 읽도록 공통 로드맵 룰을 따른다. Milestone은 구현 계획이 아니라 방향성, 범위, 선행 조건, 브레이킹 포인트를 잡는 게이트 문서로 시작한다. 구현 수준으로 구체화되지 않은 Milestone에는 `구현 잠금`을 걸어 사용자가 단순히 "진행"을 요청해도 코드 구현이나 `agent-task` 구현 계획으로 내려가지 않게 한다. @@ -92,7 +92,8 @@ agent-ops/ - [ ] `agent-ops/skills/common/_templates/roadmap-template.md`를 읽어 최신 ROADMAP 형식 확인 - [ ] `agent-ops/skills/common/_templates/roadmap-current-template.md`를 읽어 최신 current.md 형식 확인 - [ ] `agent-ops/skills/common/_templates/roadmap-milestone-template.md`를 읽어 최신 Milestone 형식 확인 -- [ ] `agent-ops/rules/project/rules.md`가 있으면 마일스톤 컨텍스트 로딩 섹션 추가 위치 확인 +- [ ] `agent-ops/rules/common/rules.md`가 로드맵 디렉터리 존재 시 `agent-ops/rules/common/rules-roadmap.md`를 읽도록 라우팅하는지 확인 +- [ ] `agent-ops/rules/common/rules-roadmap.md`가 없으면 로드맵 룰이 설치되지 않은 상태로 보고하고, 프로젝트 전용 규칙에 마일스톤 컨텍스트 로딩 섹션을 추가하지 않는다 - [ ] Milestone을 구현 계획으로 바로 사용할 수 있을 만큼 구체화하라고 사용자가 명시했는지 확인. 명시가 없으면 새 Milestone은 잠금으로 둔다. ## 실행 절차 @@ -129,30 +130,16 @@ agent-ops/ - `완료 기준`도 검증 가능한 조건의 `- [ ]` 체크리스트로 작성한다. - 미래 Milestone은 확정된 방향과 capability만 `필수 기능`에 넣고, 불확실한 구현 세부는 `작업 컨텍스트`의 확인 필요 항목으로 둔다. -5. **마일스톤 컨텍스트 로딩 규칙 추가** - - `agent-ops/rules/project/rules.md`가 있으면 아래 섹션을 추가한다. - ```markdown - ## 마일스톤 컨텍스트 로딩 - - - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다. - - `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. - - `current.md`에는 개인별 현재 작업 위치나 완료 상태를 기록하지 않는다. - - 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다. - - 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. - - 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. - - `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다. - - 상세 작업과 완료 기준은 각 Milestone 문서의 체크리스트로 관리한다. - - 작업 요청이 선택된 Milestone의 목표 또는 범위 제외 항목과 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다. - - 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 코드 구현, `agent-task` 구현 계획 생성, 세부 API/파일 구조 확정을 시작하지 않는다. - - `구현 잠금`이 없거나 잠긴 Milestone은 사용자가 "진행"을 요청해도 우회하지 않고, 먼저 Milestone 문서의 구현 구체화와 잠금 해제를 사용자에게 요청한다. - ``` - - 같은 섹션이 이미 있으면 중복 추가하지 않고 필요한 문장만 보완한다. - - `agent-ops/rules/project/rules.md`가 없으면 파일을 새로 만들지 말고, 추가하지 못한 항목으로 보고한다. +5. **로드맵 룰 라우팅 확인** + - `agent-ops/rules/common/rules.md`는 `agent-ops/roadmap/` 디렉터리가 있을 때만 `agent-ops/rules/common/rules-roadmap.md`를 읽도록 라우팅해야 한다. + - `agent-ops/rules/common/rules-roadmap.md`에는 `current.md` 의미, Milestone 선택, `ROADMAP.md` 로딩 조건, 구현 잠금, 현재 작업 지점 확인 방법이 들어 있어야 한다. + - 로드맵 컨텍스트 로딩 규칙은 공통 로드맵 룰에 둔다. `agent-ops/rules/project/rules.md`에는 프로젝트 고유 구조, 도메인 매핑, 기술 스택만 남기고 마일스톤 컨텍스트 로딩 섹션을 추가하지 않는다. + - 공통 로드맵 룰이 설치되지 않은 프로젝트에서는 타겟 프로젝트의 공통 파일을 임의 수정하지 말고 agent-ops 업데이트 필요 항목으로 보고한다. 6. **결과 보고** - 생성한 로드맵 파일 목록 - 활성 Milestone 목록 - - `rules/project/rules.md`에 추가한 로딩 규칙 여부 + - 공통 로드맵 룰 라우팅 확인 여부 - 확인이 필요한 TODO 또는 가정 ## 실행 결과 검증 @@ -166,8 +153,9 @@ agent-ops/ - [ ] 각 Milestone 문서에 `구현 잠금` 섹션이 있고, 구현 구체화가 없으면 상태가 `잠금`인가 - [ ] 각 Milestone 문서의 `필수 기능`과 `완료 기준`이 체크리스트 형식인가 - [ ] `ROADMAP.md`에 전체 로드맵을 일반 작업마다 읽지 말라는 로딩 정책이 포함되었는가 -- [ ] 로딩 정책에 잠긴 Milestone의 구현/계획 시작 금지 규칙이 포함되었는가 -- [ ] `agent-ops/rules/project/rules.md`가 있는 경우 마일스톤 컨텍스트 로딩 섹션이 추가되었는가 +- [ ] 로딩 정책에 `구현 잠금`이 없거나 잠긴 Milestone의 구현/계획 시작 금지 규칙이 포함되었는가 +- [ ] `agent-ops/rules/common/rules.md`가 로드맵 디렉터리 존재 시 `rules-roadmap.md`를 읽도록 라우팅하는가 +- [ ] `agent-ops/rules/common/rules-roadmap.md`가 로드맵 컨텍스트 로딩과 구현 잠금 규칙을 포함하는가 - 검증 실패 시: 누락된 파일이나 섹션만 보완하고 기존 내용을 덮어쓰지 않는다. ## 출력 형식 @@ -180,7 +168,7 @@ agent-ops/ - Milestone 문서: - 활성 Milestone: - 구현 잠금: <잠금 Milestone N개 | 해제 Milestone N개> -- 프로젝트 규칙 업데이트: <추가함 | 이미 존재함 | rules/project/rules.md 없음> +- 공통 로드맵 룰: <확인함 | 설치 필요 | 해당 없음> ## 활성 Milestone diff --git a/agent-ops/skills/common/update-roadmap/SKILL.md b/agent-ops/skills/common/update-roadmap/SKILL.md index 2e9ebd5..ed5323a 100644 --- a/agent-ops/skills/common/update-roadmap/SKILL.md +++ b/agent-ops/skills/common/update-roadmap/SKILL.md @@ -1,6 +1,6 @@ --- name: update-roadmap -version: 1.7.0 +version: 1.7.1 description: 기존 전체 목표, Phase, 구현 구체화 잠금이 있는 순번 없는 Milestone 기반 한국어 로드맵을 갱신하고 신규 작업의 삽입 위치와 단위를 사용자 지정 또는 자동 판단으로 배치하며 current.md의 활성 Milestone 창을 동기화하는 공통 스킬 --- @@ -28,7 +28,7 @@ Milestone은 구현 전 방향성, 범위, 선행 조건, 브레이킹 포인트 ## 입력 -- `mode`: `status` / `milestone` / `phase` / `replan` / `sync` 중 하나 (선택, 요청에서 추론 가능) +- `mode`: `status` / `milestone` / `phase` / `replan` / `sync` / `concretize` 중 하나 (선택, 요청에서 추론 가능) - `target-milestone`: 갱신할 Milestone 이름, slug, 파일 경로 (선택) - `active-milestones`: 활성 Milestone 창에 둘 Milestone 이름, slug, 파일 경로 목록 (선택) - `new-feature`: 추가할 기능, 작업, 또는 새 Milestone 설명 (선택) @@ -206,12 +206,11 @@ Milestone은 구현 전 방향성, 범위, 선행 조건, 브레이킹 포인트 - 상태 값은 `계획`, `진행 중`, `완료`, `보류`, `폐기` 중 하나만 사용한다. - 완료된 Milestone의 기록은 삭제하지 않고 상태만 변경한다. -6. **마일스톤 컨텍스트 로딩 규칙 점검** - - `agent-ops/rules/project/rules.md`가 있으면 `## 마일스톤 컨텍스트 로딩` 섹션이 있는지 확인한다. - - 없으면 `create-roadmap`과 동일한 로딩 규칙을 추가한다. - - 기존 섹션이 있으면 전체 `ROADMAP.md`를 일반 작업마다 읽도록 되어 있지 않은지 확인하고 보정한다. - - 기존 섹션이 `current.md`를 현재 작업 위치로 단정하게 만들면 활성 Milestone 후보 목록으로 의미를 고친다. - - 기존 섹션에 잠긴 Milestone의 구현/계획 시작 금지 규칙이 없으면 추가한다. +6. **로드맵 룰 라우팅 점검** + - `agent-ops/rules/common/rules.md`가 `agent-ops/roadmap/` 디렉터리 존재 시 `agent-ops/rules/common/rules-roadmap.md`를 읽도록 라우팅하는지 확인한다. + - `agent-ops/rules/common/rules-roadmap.md`에 `current.md` 의미, Milestone 선택, `ROADMAP.md` 로딩 조건, 구현 잠금, 현재 작업 지점 확인 방법이 포함되어 있는지 확인한다. + - 로드맵 컨텍스트 로딩 규칙은 공통 로드맵 룰에 둔다. 프로젝트 전용 `rules/project/rules.md`에는 중복 마일스톤 컨텍스트 로딩 섹션을 추가하지 않는다. + - 기존 프로젝트 규칙에 마일스톤 컨텍스트 로딩 섹션이 남아 있으면 프로젝트 고유 내용이 아닌지 확인하고, 공통 룰과 중복되는 내용은 제거 대상으로 보고한다. 7. **결과 보고** - 수정한 파일 목록 @@ -230,7 +229,7 @@ Milestone은 구현 전 방향성, 범위, 선행 조건, 브레이킹 포인트 - [ ] `ROADMAP.md`의 Milestone 목록과 대상 Milestone 문서의 상태가 서로 충돌하지 않는가 - [ ] 갱신 대상 Milestone 문서가 `roadmap-milestone-template.md`의 섹션 순서와 형식을 따르는가 - [ ] 갱신 대상 Milestone 문서에 `구현 잠금` 섹션이 있는가 -- [ ] 잠긴 Milestone에 구현 태스크, `agent-task` 계획, 세부 API/파일 구조 확정을 추가하지 않았는가 +- [ ] `구현 잠금`이 없거나 잠긴 Milestone에 구현 태스크, `agent-task` 계획, 세부 API/파일 구조 확정을 추가하지 않았는가 - [ ] 잠금 해제한 경우 사용자 승인 또는 구체화 근거를 결과 보고에 남겼는가 - [ ] 갱신 대상 Milestone 문서의 `필수 기능`과 `완료 기준`이 체크리스트 형식인가 - [ ] 신규 작업이 사용자 지정 위치를 따랐거나, 위치 미지정 시 자동 배치 근거가 남아 있는가 @@ -238,7 +237,8 @@ Milestone은 구현 전 방향성, 범위, 선행 조건, 브레이킹 포인트 - [ ] 자동 배치 위치가 Phase/Milestone 목표, 범위 제외 항목, 선후 의존성과 충돌하지 않는가 - [ ] 대상 Milestone 문서의 상태가 `계획`, `진행 중`, `완료`, `보류`, `폐기` 중 하나인가 - [ ] 완료 처리한 기능에 사용자 설명 또는 확인 가능한 evidence가 있는가 -- [ ] `rules/project/rules.md`가 있는 경우 마일스톤 컨텍스트 로딩 섹션이 유지되는가 +- [ ] `rules/common/rules.md`가 로드맵 디렉터리 존재 시 `rules-roadmap.md`를 읽도록 라우팅하는가 +- [ ] `rules/common/rules-roadmap.md`에 로드맵 컨텍스트 로딩과 구현 잠금 규칙이 유지되는가 - 검증 실패 시: 불일치한 파일만 다시 읽고 해당 항목만 수정한다. ## 출력 형식