# NomadCode 로드맵

## 전체 목표

NomadCode는 모바일 앱, 웹 콘솔, core 서비스, 공유 계약, agent-operation 규칙을 하나의 원레포로 묶어 AI-assisted development workflow를 조율하는 프로젝트다.

현재 로드맵은 기존 `services/core/README.md`의 단계별 다음 작업을 `agent-ops/roadmap/` 구조로 옮긴 것이다. 범위는 우선 core 백엔드 오케스트레이션의 서버 골격, workflow 안정화, 외부 통합 준비에 둔다.

## Phase 개요

진행 순서는 이 문서의 위에서 아래 흐름으로 해석한다. Phase와 Milestone 표시명에는 순번을 붙이지 않는다.

### Server Skeleton

서버 실행 골격, task 저장 구조, 로컬 모델 호출 기반 비동기 job 실행, Adapter stub을 구성한다.

### Workflow Core

task 상태 전이와 enqueue / running / completed / failed 흐름을 안정화하고 retry, timeout, notification event의 기본 구조를 정리한다.

### External Integration

Plane, Mattermost, Agent Integrator, IOP 연결을 실제 통합 흐름으로 확장한다.

## Milestone 목록

| Milestone | Phase | 상태 | 문서 |
|-----------|-------|------|------|
| 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`를 읽는다.
- `current.md`는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
- 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 활성 Milestone 문서를 같은 세션에서 1회 읽는다.
- 요청이 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다.
- 활성 Milestone 밖의 작업이면 이 문서의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다.
- Phase 전환, Milestone 추가/수정, 전체 로드맵 갱신 요청에서만 `agent-ops/roadmap/ROADMAP.md`를 읽는다.