Milestone: Roadmap Driven Agent-Ops Automation

위치

Roadmap: agent-roadmap/ROADMAP.md
Phase: agent-roadmap/phase/workflow-core/PHASE.md

목표

NomadCode가 로드맵을 중심으로 사용자 입력, 실행 상태, 출력 검토, 완료 승인까지 한 흐름에서 운영하도록 Roadmap Operations Control Plane의 방향을 정한다. NomadCode Core는 roadmap/workflow/action 상태 전이를 소유하고, 외부 에이전트는 MCP-first 제어 표면을 통해 Core를 호출하며, agent-ops 스킬은 문서 작성, 의미 해석, 변경 제안, MCP 호출 준비 계층으로 낮춘다.

상태

[계획]

승격 조건

없음

구현 잠금

상태: 해제
결정 필요: 없음

범위

NomadCode Core가 품을 roadmap/action core 책임 정의
MCP-first 외부 agent 제어 표면 방향 정의
HTTP API와 MCP의 역할 분리
사용자 입력, 출력 검토, 승인, 보완, archive 확인을 NomadCode 라인에서 처리하는 흐름 정의
agent-ops roadmap skills를 작성/제안/MCP 호출 준비 계층으로 낮추는 방향 정의
completion event, USER_REVIEW.md, 완료 리뷰, dependency lock을 Core action으로 다루는 기준 정의

기능

Epic: [control-plane] Roadmap operations control plane

NomadCode 내부 core logic이 roadmap 기반 작업 운영을 소유하고, 외부 agent는 MCP를 통해 제어하는 구조를 정리한다.

[core-state] roadmap, Phase, Milestone, plan, code-review, completion event, approval 상태를 Core가 다루는 state model과 revision/idempotency 계약으로 정리한다.
[core-actions] validate, position, propose/apply change, transition, archive, dependency check, completion event ingest를 Core action 후보로 정의한다.
[mcp-tools] 외부 agent용 MCP tool 표면을 Core action wrapper로 정의하고 dry_run, expected_revision, idempotency_key, actor, reason 입력 원칙을 정한다.
[http-role] HTTP API는 Flutter UI, webhook, internal integration용 표면으로 유지하고, 외부 agent 제어는 MCP-first로 여는 기준을 정한다.
[review-gates] 사용자 입력, 출력 검토, USER_REVIEW.md, 완료 승인, archive 승인을 NomadCode workflow 안의 review gate로 처리하는 흐름을 정한다.
[skill-adapter] agent-ops roadmap skills가 action owner가 아니라 semantic authoring/proposal layer와 MCP call preparation layer가 되도록 축소 기준을 정한다.
[first-slice] 첫 구현 단위를 roadmap.validate, roadmap.get_position, roadmap.ingest_completion_event 중 어떤 순서로 자를지 정한다.

완료 리뷰

상태: 없음
요청일: 없음
완료 근거: 없음
리뷰 필요:
- 사용자가 완료 결과를 확인했다
- archive 이동을 승인했다
리뷰 코멘트: 없음

범위 제외

IOP 내부 모델 라우팅, MCP/tool policy, output validation, RAG, context compression 구현
전체 Flutter UI 구현
Plane/Jira/Mattermost provider projection 세부 구현
사용자 승인 없는 자동 archive 이동
agentic-framework 공통 스킬의 실제 개편

작업 컨텍스트

관련 경로: services/core/internal/workflow/, services/core/internal/scheduler/, services/core/internal/http/, packages/contracts/, agent-roadmap/, agent-ops/skills/common/update-roadmap/SKILL.md, agent-ops/skills/common/plan/SKILL.md, agent-ops/skills/common/code-review/SKILL.md
표준선(선택): NomadCode Core는 roadmap/action 상태 전이의 source of truth이고, MCP는 Core를 외부 에이전트에게 여는 adapter다. agent-ops 스킬은 사용자의 자연어와 문서 초안을 Core/MCP 호출 입력으로 정리한다.
로컬 제어 표면 후보: http://127.0.0.1:8080/v1
선행 작업: Work Item Provider Pipeline Design, 로드맵 스킬 운영 복잡도 평가, Core/MCP-first 방향성 합의
후속 작업: Workflow Core, Roadmap Operations Control Plane 첫 구현 slice, MCP tool contract 작성
확인 필요: 없음

4 KiB Raw Blame History