chore: update project docs and rules

This commit is contained in:
toki 2026-05-21 18:00:18 +09:00
parent 22f11593df
commit 3cf542a543
4 changed files with 25 additions and 11 deletions

View file

@ -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로 관리한다.

View file

@ -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`

View file

@ -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

View file

@ -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와 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.
## 도메인 매핑