toki/nomadcode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nomadcode/agent-roadmap/phase/workflow-core/milestones/roadmap-driven-agent-ops-automation.md
toki e2e595db74 정리: 로드맵 디렉터리를 분리한다 
agent-ops 공통 파일과 프로젝트 로드맵 상태를 분리해 sync 대상과 로드맵 문서 관리를 독립적으로 유지한다.
2026-05-27 11:18:34 +09:00

5.2 KiB
Raw Blame History

Milestone: Roadmap Driven Agent-Ops Automation

위치

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

목표

NomadCode가 로드맵을 중심으로 판단, 실행, 리뷰 루프를 끊기지 않게 운영하는 컨셉을 정리한다. 사용자는 중요 판단과 상위 계획을 결정하고, 에이전트는 그 판단을 바탕으로 마일스톤 구체화, plan 생성, 작업, code-review, 재계획, 완료 반영을 표준 루프로 이어가도록 만드는 방향을 다듬는다. 이 스케치는 Workflow Core 구현 전에 task lifecycle과 완료 이벤트 계약의 방향을 정하는 선행 작업이다.

상태

[스케치] http://127.0.0.1:8080/v1

승격 조건

  • 로드맵, Phase, Milestone, plan, code-review, runtime 완료 이벤트 사이의 책임 경계를 정의한다.
  • 사용자가 반드시 결정해야 하는 항목과 에이전트가 표준선으로 채워도 되는 항목을 구분한다.
  • [스케치], [계획], [진행중], [검토중], [완료] 상태 전환 조건을 NomadCode 자동화 흐름에 맞게 검증한다.
  • [계획] 이상으로 승격된 후속 Milestone에서 사용할 agent-task/m-<milestone-slug> 생성, 반복 리뷰, complete.log, roadmap 갱신, archive 승인 흐름의 최소 계약을 정한다.
  • 자동 실행 범위와 중단 조건, USER_REVIEW.md 사용자 확인 지점, 실패 또는 보완 필요 시 되돌아가는 정책을 정한다.
  • 첫 구현 Milestone으로 쪼갤 후보와 완료 기준을 나눈다.

구현 잠금

  • 상태: 잠금
  • 결정 필요:
    • 사용자가 직접 승인해야 하는 경계가 milestone 생성, plan 생성, 작업 시작, 검토중 전환, 완료 archive 중 어디까지인지 정한다.
    • NomadCode가 백그라운드에서 자동 진행해도 되는 작업 단위와 명시 확인이 필요한 작업 단위를 정한다.
    • "현재 작업" 질의가 스케치/계획/진행중 후보를 어떤 우선순위로 보여줘야 하는지 정한다.

범위

  • roadmap 중심 운영 루프의 제품 컨셉 정리
  • Workflow Core 구현 전에 필요한 상태/책임/완료 이벤트 경계 정리
  • Milestone 상태 전환과 구현 잠금의 운용 기준
  • [계획] 이상 Milestone에서 사용할 milestone 기반 plan/code-review 반복 루프의 자동화 후보 정의
  • 완료 이벤트가 roadmap에 반영되는 방식과 사용자 최종 확인 지점 정리
  • NomadCode 내부 agent orchestration 후보 정리

필수 기능

Epic: [roadmap-loop] Roadmap-led operation loop

로드맵과 마일스톤을 기준으로 에이전트가 다음 작업을 판단하고, 계획/작업/리뷰/재계획을 반복하는 운영 루프를 구체화한다.

  • [loop-map] 초기 컨셉에서 roadmap, milestone, plan, code-review, complete.log, archive까지 이어지는 상태 흐름을 정의한다.
  • [decision-boundary] 사용자 판단 영역과 에이전트 자동 보강 영역을 구분한다.
  • [automation-contract] 자동으로 진행 가능한 단계와 중단 또는 사용자 확인이 필요한 단계를 정한다.
  • [user-review-stop] 반복 실패와 테스트 환경 차단 상황에서 USER_REVIEW.md로 루프를 멈추는 조건과 템플릿 계약을 정한다.
  • [runtime-routing] [계획] 이상 Milestone의 task group과 완료 이벤트가 roadmap 갱신으로 이어지는 routing 계약을 정한다.
  • [first-slice] 구현 가능한 첫 Milestone 또는 Epic 후보를 분리한다.

완료 기준

  • 컨셉이 [계획] Milestone으로 승격 가능한 목표, 범위, 완료 기준을 갖춘다.
  • 사용자 결정 항목과 에이전트 표준 처리 항목이 분리된다.
  • plan/code-review 반복 루프와 roadmap 갱신 루프의 최소 계약이 문서화된다.
  • 자동 루프 중단 조건과 사용자 리뷰 파일 계약이 문서화된다.
  • 첫 구현 단위 후보가 하나 이상 도출된다.

완료 리뷰

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

범위 제외

  • 실제 runtime scheduler 구현
  • 백그라운드 agent 실행 큐 구현
  • UI 화면/API/DB schema 확정
  • 외부 provider 또는 IOP 세부 통합
  • 사용자 승인 없는 자동 archive 이동

작업 컨텍스트

  • 관련 경로: agent-roadmap/, agent-ops/skills/common/plan/SKILL.md, agent-ops/skills/common/code-review/SKILL.md, agent-ops/skills/common/update-roadmap/SKILL.md
  • 표준선(선택): 로드맵은 판단과 방향의 source of truth로 둔다. 이 [스케치] 자체는 구현 계획 대상이 아니며, 승격 이후 구현 작업만 milestone 기반 agent-task/m-<milestone-slug>/ 루프로 분리한다.
  • 선행 작업: Client Integration Standardization, Work Item Provider Pipeline Design
  • 후속 작업: Workflow Core, [계획] 승격 후 runtime, roadmap updater, UI/agent interaction 중 첫 구현 Milestone 후보를 결정한다.
  • 확인 필요: 이 스케치를 [계획]으로 올릴 때 실제 구현 Milestone을 runtime, roadmap updater, UI/agent interaction 중 어디부터 나눌지 결정해야 한다.