From 4c0f5e5d0a63513459e19c49e93d17739c860c95 Mon Sep 17 00:00:00 2001 From: toki Date: Thu, 21 May 2026 20:37:16 +0900 Subject: [PATCH] refactor: rename milestone files and update roadmap structure --- agent-ops/roadmap/ROADMAP.md | 28 +++++++++---------- agent-ops/roadmap/current.md | 12 ++++---- ...integration.md => external-integration.md} | 4 +-- ...-server-skeleton.md => server-skeleton.md} | 4 +-- ...{M02-workflow-core.md => workflow-core.md} | 4 +-- agent-ops/rules/project/rules.md | 7 +++-- 6 files changed, 30 insertions(+), 29 deletions(-) rename agent-ops/roadmap/milestones/{M03-external-integration.md => external-integration.md} (96%) rename agent-ops/roadmap/milestones/{M01-server-skeleton.md => server-skeleton.md} (96%) rename agent-ops/roadmap/milestones/{M02-workflow-core.md => workflow-core.md} (96%) diff --git a/agent-ops/roadmap/ROADMAP.md b/agent-ops/roadmap/ROADMAP.md index 06607cb..04ad324 100644 --- a/agent-ops/roadmap/ROADMAP.md +++ b/agent-ops/roadmap/ROADMAP.md @@ -6,38 +6,36 @@ NomadCode는 모바일 앱, 웹 콘솔, core 서비스, 공유 계약, agent-ope 현재 로드맵은 기존 `services/core/README.md`의 단계별 다음 작업을 `agent-ops/roadmap/` 구조로 옮긴 것이다. 범위는 우선 core 백엔드 오케스트레이션의 서버 골격, workflow 안정화, 외부 통합 준비에 둔다. -## 현재 위치 - -- 현재 Phase: Phase 1. Server Skeleton -- 기본 Milestone: M01 Server Skeleton -- 상태: 진행 중 - ## Phase 개요 -### Phase 1. Server Skeleton +진행 순서는 이 문서의 위에서 아래 흐름으로 해석한다. Phase와 Milestone 표시명에는 순번을 붙이지 않는다. + +### Server Skeleton 서버 실행 골격, task 저장 구조, 로컬 모델 호출 기반 비동기 job 실행, Adapter stub을 구성한다. -### Phase 2. Workflow Core +### Workflow Core task 상태 전이와 enqueue / running / completed / failed 흐름을 안정화하고 retry, timeout, notification event의 기본 구조를 정리한다. -### Phase 3. External Integration +### External Integration Plane, Mattermost, Agent Integrator, IOP 연결을 실제 통합 흐름으로 확장한다. -## Milestone 인덱스 +## Milestone 목록 | Milestone | Phase | 상태 | 문서 | |-----------|-------|------|------| -| M01 Server Skeleton | Phase 1. Server Skeleton | 진행 중 | `agent-ops/roadmap/milestones/M01-server-skeleton.md` | -| M02 Workflow Core | Phase 2. Workflow Core | 계획 | `agent-ops/roadmap/milestones/M02-workflow-core.md` | -| M03 External Integration | Phase 3. External Integration | 계획 | `agent-ops/roadmap/milestones/M03-external-integration.md` | +| Server Skeleton | Server Skeleton | 진행 중 | `agent-ops/roadmap/milestones/server-skeleton.md` | +| Workflow Core | Workflow Core | 계획 | `agent-ops/roadmap/milestones/workflow-core.md` | +| External Integration | External Integration | 계획 | `agent-ops/roadmap/milestones/external-integration.md` | ## 로딩 정책 - 일반 기능 작업에서는 이 전체 로드맵을 매번 읽지 않는다. - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업에서는 먼저 `agent-ops/roadmap/current.md`를 읽는다. -- 요청이 기본 Milestone 범위에 맞으면 기본 Milestone 문서를 같은 세션에서 1회 읽는다. -- 요청이 기본 Milestone과 맞지 않으면 `current.md`의 진행 중인 Milestone 목록에서 가장 관련 있는 Milestone 문서를 같은 세션에서 1회 읽는다. +- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. +- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다. +- 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. +- 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. - Phase 전환, Milestone 추가/수정, 전체 로드맵 갱신 요청에서만 `agent-ops/roadmap/ROADMAP.md`를 읽는다. diff --git a/agent-ops/roadmap/current.md b/agent-ops/roadmap/current.md index b2a5652..da9a7cb 100644 --- a/agent-ops/roadmap/current.md +++ b/agent-ops/roadmap/current.md @@ -1,9 +1,11 @@ # 현재 로드맵 컨텍스트 -- 현재 Phase: Phase 1. Server Skeleton -- 기본 Milestone: M01 Server Skeleton -- 기본 Milestone 파일: agent-ops/roadmap/milestones/M01-server-skeleton.md +## 활성 Milestone -## 진행 중인 Milestone +- Server Skeleton: agent-ops/roadmap/milestones/server-skeleton.md -- M01 Server Skeleton: agent-ops/roadmap/milestones/M01-server-skeleton.md +## 선택 규칙 + +- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택한다. +- 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. +- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. diff --git a/agent-ops/roadmap/milestones/M03-external-integration.md b/agent-ops/roadmap/milestones/external-integration.md similarity index 96% rename from agent-ops/roadmap/milestones/M03-external-integration.md rename to agent-ops/roadmap/milestones/external-integration.md index dbe0948..2803d30 100644 --- a/agent-ops/roadmap/milestones/M03-external-integration.md +++ b/agent-ops/roadmap/milestones/external-integration.md @@ -1,4 +1,4 @@ -# M03 External Integration +# External Integration ## 목표 @@ -6,7 +6,7 @@ Plane, Mattermost, Agent Integrator, IOP 연결을 stub 또는 호환 호출 경 ## 단계 -- Phase: Phase 3. External Integration +- External Integration ## 상태 diff --git a/agent-ops/roadmap/milestones/M01-server-skeleton.md b/agent-ops/roadmap/milestones/server-skeleton.md similarity index 96% rename from agent-ops/roadmap/milestones/M01-server-skeleton.md rename to agent-ops/roadmap/milestones/server-skeleton.md index cd65990..114d9cd 100644 --- a/agent-ops/roadmap/milestones/M01-server-skeleton.md +++ b/agent-ops/roadmap/milestones/server-skeleton.md @@ -1,4 +1,4 @@ -# M01 Server Skeleton +# Server Skeleton ## 목표 @@ -6,7 +6,7 @@ core 서비스의 서버 실행 골격을 구성하고, task 저장 구조와 ## 단계 -- Phase: Phase 1. Server Skeleton +- Server Skeleton ## 상태 diff --git a/agent-ops/roadmap/milestones/M02-workflow-core.md b/agent-ops/roadmap/milestones/workflow-core.md similarity index 96% rename from agent-ops/roadmap/milestones/M02-workflow-core.md rename to agent-ops/roadmap/milestones/workflow-core.md index b723943..663a01c 100644 --- a/agent-ops/roadmap/milestones/M02-workflow-core.md +++ b/agent-ops/roadmap/milestones/workflow-core.md @@ -1,4 +1,4 @@ -# M02 Workflow Core +# Workflow Core ## 목표 @@ -6,7 +6,7 @@ task 상태 전이를 정리하고 enqueue / running / completed / failed 흐름 ## 단계 -- Phase: Phase 2. Workflow Core +- Workflow Core ## 상태 diff --git a/agent-ops/rules/project/rules.md b/agent-ops/rules/project/rules.md index 0646d34..5c3d94c 100644 --- a/agent-ops/rules/project/rules.md +++ b/agent-ops/rules/project/rules.md @@ -60,9 +60,10 @@ NomadCode는 AI 병렬 작업 운용을 위한 원레포다. 백엔드 오케스 ## 마일스톤 컨텍스트 로딩 - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다. -- 요청이 기본 Milestone 범위에 맞으면 기본 Milestone 문서를 같은 세션에서 1회 읽는다. -- 요청이 기본 Milestone과 맞지 않으면 `current.md`의 진행 중인 Milestone 목록에서 가장 관련 있는 Milestone 문서를 같은 세션에서 1회 읽는다. -- 진행 중인 Milestone에도 맞지 않으면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 인덱스를 확인하고 사용자에게 진행/전환 여부를 확인한다. +- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다. +- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다. +- 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. +- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. - `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다. - 작업 요청이 선택된 Milestone의 목표 또는 범위 제외 항목과 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.