refactor: rename milestone files and update roadmap structure

This commit is contained in:
toki 2026-05-21 20:37:16 +09:00
parent 599ef4026b
commit 4c0f5e5d0a
6 changed files with 30 additions and 29 deletions

View file

@ -6,38 +6,36 @@ NomadCode는 모바일 앱, 웹 콘솔, core 서비스, 공유 계약, agent-ope
현재 로드맵은 기존 `services/core/README.md`의 단계별 다음 작업을 `agent-ops/roadmap/` 구조로 옮긴 것이다. 범위는 우선 core 백엔드 오케스트레이션의 서버 골격, workflow 안정화, 외부 통합 준비에 둔다. 현재 로드맵은 기존 `services/core/README.md`의 단계별 다음 작업을 `agent-ops/roadmap/` 구조로 옮긴 것이다. 범위는 우선 core 백엔드 오케스트레이션의 서버 골격, workflow 안정화, 외부 통합 준비에 둔다.
## 현재 위치
- 현재 Phase: Phase 1. Server Skeleton
- 기본 Milestone: M01 Server Skeleton
- 상태: 진행 중
## Phase 개요 ## Phase 개요
### Phase 1. Server Skeleton 진행 순서는 이 문서의 위에서 아래 흐름으로 해석한다. Phase와 Milestone 표시명에는 순번을 붙이지 않는다.
### Server Skeleton
서버 실행 골격, task 저장 구조, 로컬 모델 호출 기반 비동기 job 실행, Adapter stub을 구성한다. 서버 실행 골격, task 저장 구조, 로컬 모델 호출 기반 비동기 job 실행, Adapter stub을 구성한다.
### Phase 2. Workflow Core ### Workflow Core
task 상태 전이와 enqueue / running / completed / failed 흐름을 안정화하고 retry, timeout, notification event의 기본 구조를 정리한다. task 상태 전이와 enqueue / running / completed / failed 흐름을 안정화하고 retry, timeout, notification event의 기본 구조를 정리한다.
### Phase 3. External Integration ### External Integration
Plane, Mattermost, Agent Integrator, IOP 연결을 실제 통합 흐름으로 확장한다. Plane, Mattermost, Agent Integrator, IOP 연결을 실제 통합 흐름으로 확장한다.
## Milestone 인덱스 ## Milestone 목록
| Milestone | Phase | 상태 | 문서 | | Milestone | Phase | 상태 | 문서 |
|-----------|-------|------|------| |-----------|-------|------|------|
| M01 Server Skeleton | Phase 1. Server Skeleton | 진행 중 | `agent-ops/roadmap/milestones/M01-server-skeleton.md` | | Server Skeleton | Server Skeleton | 진행 중 | `agent-ops/roadmap/milestones/server-skeleton.md` |
| M02 Workflow Core | Phase 2. Workflow Core | 계획 | `agent-ops/roadmap/milestones/M02-workflow-core.md` | | Workflow Core | Workflow Core | 계획 | `agent-ops/roadmap/milestones/workflow-core.md` |
| M03 External Integration | Phase 3. External Integration | 계획 | `agent-ops/roadmap/milestones/M03-external-integration.md` | | External Integration | External Integration | 계획 | `agent-ops/roadmap/milestones/external-integration.md` |
## 로딩 정책 ## 로딩 정책
- 일반 기능 작업에서는 이 전체 로드맵을 매번 읽지 않는다. - 일반 기능 작업에서는 이 전체 로드맵을 매번 읽지 않는다.
- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업에서는 먼저 `agent-ops/roadmap/current.md`를 읽는다. - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업에서는 먼저 `agent-ops/roadmap/current.md`를 읽는다.
- 요청이 기본 Milestone 범위에 맞으면 기본 Milestone 문서를 같은 세션에서 1회 읽는다. - `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
- 요청이 기본 Milestone과 맞지 않으면 `current.md`의 진행 중인 Milestone 목록에서 가장 관련 있는 Milestone 문서를 같은 세션에서 1회 읽는다. - 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다.
- 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다.
- 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
- Phase 전환, Milestone 추가/수정, 전체 로드맵 갱신 요청에서만 `agent-ops/roadmap/ROADMAP.md`를 읽는다. - Phase 전환, Milestone 추가/수정, 전체 로드맵 갱신 요청에서만 `agent-ops/roadmap/ROADMAP.md`를 읽는다.

View file

@ -1,9 +1,11 @@
# 현재 로드맵 컨텍스트 # 현재 로드맵 컨텍스트
- 현재 Phase: Phase 1. Server Skeleton ## 활성 Milestone
- 기본 Milestone: M01 Server Skeleton
- 기본 Milestone 파일: agent-ops/roadmap/milestones/M01-server-skeleton.md
## 진행 중인 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 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.

View file

@ -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
## 상태 ## 상태

View file

@ -1,4 +1,4 @@
# M01 Server Skeleton # Server Skeleton
## 목표 ## 목표
@ -6,7 +6,7 @@ core 서비스의 서버 실행 골격을 구성하고, task 저장 구조와
## 단계 ## 단계
- Phase: Phase 1. Server Skeleton - Server Skeleton
## 상태 ## 상태

View file

@ -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
## 상태 ## 상태

View file

@ -60,9 +60,10 @@ NomadCode는 AI 병렬 작업 운용을 위한 원레포다. 백엔드 오케스
## 마일스톤 컨텍스트 로딩 ## 마일스톤 컨텍스트 로딩
- 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다. - 기능 추가, 구조 변경, 스킬 추가/수정, 문서 구조 변경 작업을 수행할 때는 `agent-ops/roadmap/current.md`를 먼저 읽는다.
- 요청이 기본 Milestone 범위에 맞으면 기본 Milestone 문서를 같은 세션에서 1회 읽는다. - `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
- 요청이 기본 Milestone과 맞지 않으면 `current.md`의 진행 중인 Milestone 목록에서 가장 관련 있는 Milestone 문서를 같은 세션에서 1회 읽는다. - 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다.
- 진행 중인 Milestone에도 맞지 않으면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 인덱스를 확인하고 사용자에게 진행/전환 여부를 확인한다. - 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다.
- 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
- `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다. - `agent-ops/roadmap/ROADMAP.md`는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정 요청이 있을 때만 읽는다.
- 작업 요청이 선택된 Milestone의 목표 또는 범위 제외 항목과 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다. - 작업 요청이 선택된 Milestone의 목표 또는 범위 제외 항목과 충돌하면 구현 전에 사용자에게 알리고 방향을 확인한다.