From 03fefd3f9d0e7ed6c0161c490d3b3a198cebb873 Mon Sep 17 00:00:00 2001 From: toki Date: Sat, 18 Jul 2026 23:02:26 +0900 Subject: [PATCH] sync: agent-ops from agentic-framework v1.1.167 --- .clinerules | 1 + .cursorrules | 1 + AGENTS.md | 1 + CLAUDE.md | 1 + GEMINI.md | 1 + agent-ops/rules/common/rules-roadmap.md | 11 ++-- agent-ops/rules/common/rules.md | 1 + .../_templates/roadmap-milestone-template.md | 1 - .../roadmap-priority-queue-template.md | 3 -- .../common/_templates/roadmap-template.md | 4 +- .../skills/common/update-roadmap/SKILL.md | 51 ++++--------------- 11 files changed, 19 insertions(+), 57 deletions(-) diff --git a/.clinerules b/.clinerules index 045f54f..f9b998f 100644 --- a/.clinerules +++ b/.clinerules @@ -3,6 +3,7 @@ **현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.** - 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다. +- `agent-ops/rules/common/**`와 `agent-ops/skills/common/**`은 중앙 관리되는 공통 영역이므로 어떤 프로젝트 작업에서도 절대 직접 수정하지 않는다. 프로젝트별 규칙과 스킬은 반드시 대응하는 `project/**` 영역에만 반영한다. - 사용자에게 보이는 최종 답변과 설명은 기본적으로 한국어로 작성한다. - 코드 변경 전 관련 domain rule을 먼저 확인한다. - 요청 범위를 넘는 변경을 하지 않는다. diff --git a/.cursorrules b/.cursorrules index 045f54f..f9b998f 100644 --- a/.cursorrules +++ b/.cursorrules @@ -3,6 +3,7 @@ **현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.** - 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다. +- `agent-ops/rules/common/**`와 `agent-ops/skills/common/**`은 중앙 관리되는 공통 영역이므로 어떤 프로젝트 작업에서도 절대 직접 수정하지 않는다. 프로젝트별 규칙과 스킬은 반드시 대응하는 `project/**` 영역에만 반영한다. - 사용자에게 보이는 최종 답변과 설명은 기본적으로 한국어로 작성한다. - 코드 변경 전 관련 domain rule을 먼저 확인한다. - 요청 범위를 넘는 변경을 하지 않는다. diff --git a/AGENTS.md b/AGENTS.md index 045f54f..f9b998f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,6 +3,7 @@ **현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.** - 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다. +- `agent-ops/rules/common/**`와 `agent-ops/skills/common/**`은 중앙 관리되는 공통 영역이므로 어떤 프로젝트 작업에서도 절대 직접 수정하지 않는다. 프로젝트별 규칙과 스킬은 반드시 대응하는 `project/**` 영역에만 반영한다. - 사용자에게 보이는 최종 답변과 설명은 기본적으로 한국어로 작성한다. - 코드 변경 전 관련 domain rule을 먼저 확인한다. - 요청 범위를 넘는 변경을 하지 않는다. diff --git a/CLAUDE.md b/CLAUDE.md index 045f54f..f9b998f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -3,6 +3,7 @@ **현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.** - 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다. +- `agent-ops/rules/common/**`와 `agent-ops/skills/common/**`은 중앙 관리되는 공통 영역이므로 어떤 프로젝트 작업에서도 절대 직접 수정하지 않는다. 프로젝트별 규칙과 스킬은 반드시 대응하는 `project/**` 영역에만 반영한다. - 사용자에게 보이는 최종 답변과 설명은 기본적으로 한국어로 작성한다. - 코드 변경 전 관련 domain rule을 먼저 확인한다. - 요청 범위를 넘는 변경을 하지 않는다. diff --git a/GEMINI.md b/GEMINI.md index 045f54f..f9b998f 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -3,6 +3,7 @@ **현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.** - 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다. +- `agent-ops/rules/common/**`와 `agent-ops/skills/common/**`은 중앙 관리되는 공통 영역이므로 어떤 프로젝트 작업에서도 절대 직접 수정하지 않는다. 프로젝트별 규칙과 스킬은 반드시 대응하는 `project/**` 영역에만 반영한다. - 사용자에게 보이는 최종 답변과 설명은 기본적으로 한국어로 작성한다. - 코드 변경 전 관련 domain rule을 먼저 확인한다. - 요청 범위를 넘는 변경을 하지 않는다. diff --git a/agent-ops/rules/common/rules-roadmap.md b/agent-ops/rules/common/rules-roadmap.md index fb275ac..f2c5dc8 100644 --- a/agent-ops/rules/common/rules-roadmap.md +++ b/agent-ops/rules/common/rules-roadmap.md @@ -36,12 +36,12 @@ ## 로딩 - 세션 최초 1회 `agent-roadmap/current.md`가 있으면 읽고 활성 Phase, 활성 Milestone의 이름, 경로, 선택 규칙만 짧게 기억한다. -- `agent-roadmap/priority-queue.md`가 있으면 새 Milestone 생성, Phase를 가로지르는 다음 작업 후보 선택, 사용자가 요청한 순서 조정, archive/폐기/경로 변경/split/merge 후 큐 정리, 깨진 링크 복구가 필요할 때 읽는다. +- `agent-roadmap/priority-queue.md`가 있으면 Phase를 가로지르는 다음 작업 후보 선택, 사용자가 요청한 순서 조정, archive/폐기/경로 변경/split/merge 후 큐 정리, 깨진 링크 복구가 필요할 때만 읽는다. - `agent-roadmap/current.md`는 브랜치별 로컬 포인터이며 git 추적 대상이 아니다. - `current.md`가 없고 로드맵 기반 계획 또는 갱신이 필요하면 `agent-ops/skills/common/_templates/roadmap-current-template.md` 형식으로 로컬 파일을 만들거나 `ROADMAP.md`와 활성 `PHASE.md`에서 후보를 고른다. - 읽기 전용 로드맵 현지점 확인에서는 `current.md`가 없어도 만들지 않고, 로컬 current 없음으로 보고한 뒤 `priority-queue.md`가 있으면 전역 실행 순서와 `ROADMAP.md`의 Phase 흐름을 보여준다. - 일반 작업에서는 `ROADMAP.md`를 읽지 않는다. -- 일반 작업에서는 `priority-queue.md`를 읽지 않는다. 단, 새 Milestone 생성, 구현 계획, 다음 작업 선택처럼 Phase를 가로지르는 후보 선택이나 큐 삽입이 필요하면 읽는다. +- 일반 작업에서는 `priority-queue.md`를 읽지 않는다. 단, 구현 계획이나 다음 작업 선택처럼 Phase를 가로지르는 후보 선택이 필요하면 읽는다. - 일반 작업에서는 `agent-roadmap/archive/**`를 읽지 않는다. - 기능 추가, 구조 변경, 구현 계획 전에는 요청과 변경 파일에 맞는 활성 Phase와 활성 Milestone 문서를 읽는다. - 선택한 Milestone의 `구현 잠금`에 `SDD: 필요`가 있으면 `agent-roadmap/sdd///SDD.md`와 같은 디렉터리의 `USER_REVIEW.md` 존재 여부를 확인한다. @@ -54,12 +54,7 @@ - `current.md`는 현재 작업 위치가 아니라 활성 Phase와 활성 Milestone 후보 목록이다. - `priority-queue.md`는 현재 작업 위치가 아니라 Phase를 가로지르는 실행 순서 문서다. 위에 있는 항목을 먼저 검토한다. - `priority-queue.md`는 순서 전용 문서이며, Milestone 제목 링크와 식별용 한 줄 설명만 둔다. 상태, 목표, 범위, 잠금, 기능, 완료 근거, 의존성은 Milestone 문서를 원본으로 삼는다. -- 새 Milestone을 `[스케치]`, `[계획]`, `[진행중]`, `[검토중]` 상태로 만들면 같은 갱신에서 `priority-queue.md`에 정확히 한 번 삽입한다. `[보류]`, `[완료]`, `[폐기]` Milestone은 삽입하지 않는다. -- 신규 Milestone 큐 위치는 사용자 지정 앞/뒤/순번, Milestone `작업 컨텍스트 > 큐 배치`의 명시 anchor, 큐 끝 순서로 결정한다. `선행 작업`과 `후속 작업`은 구현 의존성 설명이며 큐 위치로 해석하지 않는다. -- 큐에 있는 Milestone이 `[보류]`, `[완료]`, `[폐기]`로 바뀌면 제거한다. `[보류]` Milestone이 `[스케치]`, `[계획]`, `[진행중]`, `[검토중]`으로 재활성화되면 신규 삽입과 같은 규칙으로 다시 삽입한다. -- 신규 삽입과 그에 따른 순번 재계산은 기존 항목의 순서 변경으로 보지 않는다. 기존 항목끼리의 상대 순서는 사용자가 순서 조정을 요청한 경우에만 바꾼다. 단, archive/폐기 제거, 경로 변경, split/merge, 실행 의미 변경, 깨진 링크 복구는 예외다. -- 명시된 `큐 배치` 조건이 서로 충돌하거나 anchor를 찾을 수 없으면 임의 위치에 넣거나 조용히 누락하지 않고 큐 배치 차단 사유를 결과에 남긴다. -- Milestone 문서에는 변하기 쉬운 `N순위` 숫자를 복제하지 않고 `큐 배치`의 앞/뒤 anchor 또는 [priority-queue.md](../../../agent-roadmap/priority-queue.md) 링크만 남긴다. +- `priority-queue.md`의 순서는 사용자가 순서 조정을 요청한 경우에만 바꾼다. 단, archive/폐기 제거, 경로 변경, split/merge, 실행 의미 변경, 깨진 링크 복구는 예외다. - `priority-queue.md` 링크가 깨졌으면 추측하지 말고 활성 Milestone 문서를 기준으로 큐를 재정렬하거나 재생성한다. - `current.md`는 공유 진행 상태가 아니며, 공유해야 할 상태는 `ROADMAP.md`, `PHASE.md`, Milestone 문서, `.agent-roadmap-sync/locks.yaml`에 남긴다. - 활성 Phase는 `agent-roadmap/phase/**/PHASE.md`만 대상으로 한다. diff --git a/agent-ops/rules/common/rules.md b/agent-ops/rules/common/rules.md index 045f54f..f9b998f 100644 --- a/agent-ops/rules/common/rules.md +++ b/agent-ops/rules/common/rules.md @@ -3,6 +3,7 @@ **현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.** - 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다. +- `agent-ops/rules/common/**`와 `agent-ops/skills/common/**`은 중앙 관리되는 공통 영역이므로 어떤 프로젝트 작업에서도 절대 직접 수정하지 않는다. 프로젝트별 규칙과 스킬은 반드시 대응하는 `project/**` 영역에만 반영한다. - 사용자에게 보이는 최종 답변과 설명은 기본적으로 한국어로 작성한다. - 코드 변경 전 관련 domain rule을 먼저 확인한다. - 요청 범위를 넘는 변경을 하지 않는다. diff --git a/agent-ops/skills/common/_templates/roadmap-milestone-template.md b/agent-ops/skills/common/_templates/roadmap-milestone-template.md index a7ae461..1f1848c 100644 --- a/agent-ops/skills/common/_templates/roadmap-milestone-template.md +++ b/agent-ops/skills/common/_templates/roadmap-milestone-template.md @@ -93,7 +93,6 @@ Task 체크리스트는 Epic 바로 아래의 flat list로 유지하고, 구현 - 관련 경로: `` - 표준선(선택): <기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 진행할 기본 기준> -- 큐 배치(선택): <없음 | [Milestone 이름](../other-milestone.md) 뒤 | [Milestone 이름](../other-milestone.md) 앞 | 앞/뒤 anchor 조합. `N순위` 숫자는 기록하지 않음> - 선행 작업: <없음 또는 파일 위치 기준 Markdown 링크(예: [Milestone 이름](../other-milestone.md))/태스크 이름> - 후속 작업: <없음 또는 파일 위치 기준 Markdown 링크(예: [Milestone 이름](../next-milestone.md))/태스크 이름> - 확인 필요: <없음 | `구현 잠금 > 결정 필요` 또는 [USER_REVIEW.md](../../../sdd///USER_REVIEW.md)로 분리할 항목> diff --git a/agent-ops/skills/common/_templates/roadmap-priority-queue-template.md b/agent-ops/skills/common/_templates/roadmap-priority-queue-template.md index 7d313f4..9dbaf8e 100644 --- a/agent-ops/skills/common/_templates/roadmap-priority-queue-template.md +++ b/agent-ops/skills/common/_templates/roadmap-priority-queue-template.md @@ -7,9 +7,6 @@