nomadcode/agent-ops/roadmap/ROADMAP.md

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를 읽는다.