From 3cf542a543ca1f791a3ff07de566ca950f308c4b Mon Sep 17 00:00:00 2001 From: toki Date: Thu, 21 May 2026 18:00:18 +0900 Subject: [PATCH] chore: update project docs and rules --- README.md | 2 +- agent-ops/roadmap/ROADMAP.md | 18 ++++++++++++------ agent-ops/roadmap/current.md | 9 +++++++-- agent-ops/rules/project/rules.md | 7 +++++-- 4 files changed, 25 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 0b13898..7b6a043 100644 --- a/README.md +++ b/README.md @@ -231,7 +231,7 @@ NomadCode ## Roadmap 제품 방향, Phase, Milestone, 우선순위의 canonical source of truth는 `agent-ops/roadmap/ROADMAP.md`다. -일반 작업에서 AI가 읽어야 하는 현재 작업 기준은 `agent-ops/roadmap/current.md`가 가리키는 Active Milestone 문서다. +일반 작업에서 AI가 읽어야 하는 현재 작업 기준은 `agent-ops/roadmap/current.md`가 가리키는 Default Milestone 또는 요청에 맞는 Active Milestone 문서다. 로드맵의 큰 축은 Edge-Node 실행 기반, Edge input surface, CLI Automation runtime, remote terminal bridge, agent bootstrap/OTO enrollment, Control Plane/Portal, policy/history/audit, multi-edge operations로 관리한다. diff --git a/agent-ops/roadmap/ROADMAP.md b/agent-ops/roadmap/ROADMAP.md index 45d739c..e86bfbf 100644 --- a/agent-ops/roadmap/ROADMAP.md +++ b/agent-ops/roadmap/ROADMAP.md @@ -11,14 +11,20 @@ IOP(Inference Operations Platform)는 Control Plane - Edge - Node 계층 구조 ## Current Position - Active Phase: Phase 1. Edge-Node Execution Foundation -- Active Milestone: M01 Edge-Node Execution Skeleton -- Active Milestone File: `agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md` +- Default Milestone: M01 Edge-Node Execution Skeleton +- Default Milestone File: `agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md` +- Active Milestones: + - M01 Edge-Node Execution Skeleton: `agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md` + - M02 Edge Input Surfaces: `agent-ops/roadmap/milestones/M02-edge-input-surfaces.md` ## Loading Policy -- 일반 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업에서는 `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와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다. ## Status Semantics @@ -28,7 +34,7 @@ IOP(Inference Operations Platform)는 Control Plane - Edge - Node 계층 구조 - `Paused`: 일시 중단된 Milestone이다. - `Dropped`: 현재 제품 방향에서 제외된 Milestone이다. -`current.md`가 가리키는 Active Milestone은 여러 `Active` Milestone 중 현재 세션의 기본 작업 초점이다. +`current.md`의 Default Milestone은 여러 `Active` Milestone 중 현재 세션의 기본 작업 초점이다. ## Phase Overview @@ -73,7 +79,7 @@ Goal: 여러 Edge를 관찰하고 운영하는 중앙 제어면과 Portal을 구 ## Roadmap Ownership - 제품 방향, Phase, Milestone, 우선순위: `agent-ops/roadmap/ROADMAP.md` -- 현재 작업 기준: `agent-ops/roadmap/current.md`와 Active Milestone 문서 +- 현재 작업 기준: `agent-ops/roadmap/current.md`와 요청에 맞는 Default/Active Milestone 문서 - 아키텍처 불변 원칙: `docs/architecture.md` - dev/field 배포 절차: `docs/deploy-dev.md` - 앱별 현재 구현과 사용법: `apps/*/README.md` diff --git a/agent-ops/roadmap/current.md b/agent-ops/roadmap/current.md index ea7c0ae..2b09af2 100644 --- a/agent-ops/roadmap/current.md +++ b/agent-ops/roadmap/current.md @@ -1,5 +1,10 @@ # Current Roadmap Context - Active Phase: Phase 1. Edge-Node Execution Foundation -- Active Milestone: M01 Edge-Node Execution Skeleton -- Active Milestone File: agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md +- Default Milestone: M01 Edge-Node Execution Skeleton +- Default Milestone File: agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md + +## Active Milestones + +- M01 Edge-Node Execution Skeleton: agent-ops/roadmap/milestones/M01-edge-node-execution-skeleton.md +- M02 Edge Input Surfaces: agent-ops/roadmap/milestones/M02-edge-input-surfaces.md diff --git a/agent-ops/rules/project/rules.md b/agent-ops/rules/project/rules.md index f6db9f1..e772795 100644 --- a/agent-ops/rules/project/rules.md +++ b/agent-ops/rules/project/rules.md @@ -60,9 +60,12 @@ ## 마일스톤 컨텍스트 로딩 -- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `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와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다. ## 도메인 매핑