diff --git a/agent-ops/roadmap/ROADMAP.md b/agent-ops/roadmap/ROADMAP.md index dd1d8cb..73f2065 100644 --- a/agent-ops/roadmap/ROADMAP.md +++ b/agent-ops/roadmap/ROADMAP.md @@ -29,7 +29,7 @@ NomadCode는 Flutter 기반 앱, core 서비스, 공유 계약, agent-operation - 요약: Flutter 앱에 섞인 Mattermost push notification migration을 `../mattermost-push-plugin` Flutter plugin repo로 분리했다. - [진행중] Workflow Core - 경로: `agent-ops/roadmap/phase/workflow-core/PHASE.md` - - 요약: 실제 e2e 흐름을 기준으로 task lifecycle, retry, timeout, notification event를 안정화한다. + - 요약: Roadmap Driven Agent-Ops Automation 스케치를 먼저 구체화한 뒤 실제 e2e 흐름을 기준으로 task lifecycle, retry, timeout, notification event를 안정화한다. - [계획] External Integration - 경로: `agent-ops/roadmap/phase/external-integration/PHASE.md` - 요약: Plane 확장, Mattermost, Agent Integrator, IOP OpenAI API Responses-compatible 호출을 실제 통합 흐름으로 확장한다. diff --git a/agent-ops/roadmap/current.md b/agent-ops/roadmap/current.md index 7617147..04bad33 100644 --- a/agent-ops/roadmap/current.md +++ b/agent-ops/roadmap/current.md @@ -7,12 +7,12 @@ ## 활성 Milestone -- [진행중] Workflow Core - - Phase: `agent-ops/roadmap/phase/workflow-core/PHASE.md` - - 경로: `agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md` - [스케치] Roadmap Driven Agent-Ops Automation - Phase: `agent-ops/roadmap/phase/workflow-core/PHASE.md` - 경로: `agent-ops/roadmap/phase/workflow-core/milestones/roadmap-driven-agent-ops-automation.md` +- [계획] Workflow Core + - Phase: `agent-ops/roadmap/phase/workflow-core/PHASE.md` + - 경로: `agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md` ## 선택 규칙 diff --git a/agent-ops/roadmap/phase/workflow-core/PHASE.md b/agent-ops/roadmap/phase/workflow-core/PHASE.md index 8f32bd3..4338765 100644 --- a/agent-ops/roadmap/phase/workflow-core/PHASE.md +++ b/agent-ops/roadmap/phase/workflow-core/PHASE.md @@ -6,23 +6,24 @@ ## 목표 -Plane 통신 토대와 provider-neutral pipeline 설계 이후 실제 상태 변화를 기준으로 task lifecycle, enqueue/running/completed/failed 흐름을 안정화한다. retry, timeout, notification event의 최소 구조를 추가해 core workflow의 운영 기준을 만든다. +Plane 통신 토대와 provider-neutral pipeline 설계 이후, 먼저 로드맵 기반 agent-ops 운영 루프의 상태/책임 경계를 스케치에서 구체화한다. 그 다음 실제 상태 변화를 기준으로 task lifecycle, enqueue/running/completed/failed 흐름을 안정화하고 retry, timeout, notification event의 최소 구조를 추가해 core workflow의 운영 기준을 만든다. ## Milestone 흐름 완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획, 스케치 또는 보류 Milestone은 이 Phase 하위 `milestones/` 경로를 가리킨다. -완료, 검토중, 진행중, 계획, 스케치 순서로 두어 아래로 갈수록 미래 작업에 가까워지게 정렬한다. - -- [진행중] Workflow Core - - 경로: `agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md` - - 요약: task lifecycle, 상태 전이 책임, 실패 정책, retry/timeout, notification event 모델을 안정화한다. +완료, 검토중, 진행중, 계획, 스케치 순서를 기본으로 하되, 이번 Phase에서는 `Roadmap Driven Agent-Ops Automation` 스케치가 `Workflow Core` 구현의 선행 조건이므로 스케치를 먼저 둔다. - [스케치] Roadmap Driven Agent-Ops Automation - 경로: `agent-ops/roadmap/phase/workflow-core/milestones/roadmap-driven-agent-ops-automation.md` - - 요약: 사용자가 중요 판단과 상위 계획을 맡고, 에이전트가 로드맵-마일스톤-계획-리뷰 루프를 자동으로 이어가는 운영 컨셉을 구현 가능한 계획으로 구체화한다. + - 요약: Workflow Core 구현 전에 사용자가 중요 판단과 상위 계획을 맡고, 에이전트가 로드맵-마일스톤-계획-리뷰 루프를 자동으로 이어가는 운영 컨셉을 구현 가능한 계획으로 구체화한다. + +- [계획] Workflow Core + - 경로: `agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md` + - 요약: Roadmap Driven Agent-Ops Automation 스케치가 `[계획]` 수준으로 구체화된 뒤 task lifecycle, 상태 전이 책임, 실패 정책, retry/timeout, notification event 모델을 안정화한다. ## Phase 경계 - Workflow Core는 canonical task lifecycle, retry/timeout envelope, heartbeat, terminal 상태 기록을 소유한다. +- `Roadmap Driven Agent-Ops Automation` 스케치가 먼저 상태/책임/자동화 경계를 정리해야 `Workflow Core` 구현의 task lifecycle과 완료 이벤트 계약을 확정할 수 있다. - 외부 협업 도구 notification 발송, provider별 실제 comment/status 전송, 복잡한 workflow DSL은 후속 Phase로 넘긴다. - IOP/A2A/model runtime 내부 정책은 외부 실행 표면 또는 adapter 책임으로 둔다. diff --git a/agent-ops/roadmap/phase/workflow-core/milestones/roadmap-driven-agent-ops-automation.md b/agent-ops/roadmap/phase/workflow-core/milestones/roadmap-driven-agent-ops-automation.md index 06470e0..668df6c 100644 --- a/agent-ops/roadmap/phase/workflow-core/milestones/roadmap-driven-agent-ops-automation.md +++ b/agent-ops/roadmap/phase/workflow-core/milestones/roadmap-driven-agent-ops-automation.md @@ -7,7 +7,7 @@ ## 목표 -NomadCode가 로드맵을 중심으로 판단, 실행, 리뷰 루프를 끊기지 않게 운영하는 컨셉을 정리한다. 사용자는 중요 판단과 상위 계획을 결정하고, 에이전트는 그 판단을 바탕으로 마일스톤 구체화, plan 생성, 작업, code-review, 재계획, 완료 반영을 표준 루프로 이어가도록 만드는 방향을 다듬는다. +NomadCode가 로드맵을 중심으로 판단, 실행, 리뷰 루프를 끊기지 않게 운영하는 컨셉을 정리한다. 사용자는 중요 판단과 상위 계획을 결정하고, 에이전트는 그 판단을 바탕으로 마일스톤 구체화, plan 생성, 작업, code-review, 재계획, 완료 반영을 표준 루프로 이어가도록 만드는 방향을 다듬는다. 이 스케치는 Workflow Core 구현 전에 task lifecycle과 완료 이벤트 계약의 방향을 정하는 선행 작업이다. ## 상태 @@ -33,6 +33,7 @@ NomadCode가 로드맵을 중심으로 판단, 실행, 리뷰 루프를 끊기 ## 범위 - roadmap 중심 운영 루프의 제품 컨셉 정리 +- Workflow Core 구현 전에 필요한 상태/책임/완료 이벤트 경계 정리 - Milestone 상태 전환과 구현 잠금의 운용 기준 - `[계획]` 이상 Milestone에서 사용할 milestone 기반 plan/code-review 반복 루프의 자동화 후보 정의 - 완료 이벤트가 roadmap에 반영되는 방식과 사용자 최종 확인 지점 정리 @@ -81,6 +82,6 @@ NomadCode가 로드맵을 중심으로 판단, 실행, 리뷰 루프를 끊기 - 관련 경로: `agent-ops/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-/` 루프로 분리한다. -- 선행 작업: Workflow Core -- 후속 작업: `[계획]` 승격 후 runtime, roadmap updater, UI/agent interaction 중 첫 구현 Milestone 후보를 결정한다. +- 선행 작업: Client Integration Standardization, Work Item Provider Pipeline Design +- 후속 작업: Workflow Core, `[계획]` 승격 후 runtime, roadmap updater, UI/agent interaction 중 첫 구현 Milestone 후보를 결정한다. - 확인 필요: 이 스케치를 `[계획]`으로 올릴 때 실제 구현 Milestone을 runtime, roadmap updater, UI/agent interaction 중 어디부터 나눌지 결정해야 한다. diff --git a/agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md b/agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md index 8035b18..f53b860 100644 --- a/agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md +++ b/agent-ops/roadmap/phase/workflow-core/milestones/workflow-core.md @@ -11,7 +11,7 @@ Plane 통신 토대와 별도 pipeline 설계가 정리된 뒤 실제 상태 변 ## 상태 -[진행중] +[계획] ## 구현 잠금 @@ -25,6 +25,7 @@ Plane 통신 토대와 별도 pipeline 설계가 정리된 뒤 실제 상태 변 - retry / timeout 기본 구조 추가 - notification event 구조 정리 - Plane 통신 토대와 후속 pipeline 설계에서 확인된 상태 변화와 실패 케이스 반영 +- Roadmap Driven Agent-Ops Automation 스케치에서 정리되는 로드맵/마일스톤/plan/review/완료 이벤트 책임 경계 반영 ## 필수 기능 @@ -66,9 +67,10 @@ Core task lifecycle과 상태 전이 책임, 실패/재시도/timeout/notificati - 이전 출처: `services/core/README.md`의 `## 단계별 다음 작업` - 주요 작업 영역: `services/core/internal/workflow/`, `services/core/internal/scheduler/`, `services/core/internal/notification/` -- 선행 작업: Plane Communication Foundation, Work Item Provider Pipeline Design +- 선행 작업: Plane Communication Foundation, Work Item Provider Pipeline Design, Roadmap Driven Agent-Ops Automation 스케치 구체화 +- 선행 조건: Roadmap Driven Agent-Ops Automation 스케치를 `[계획]` 수준으로 구체화해 task lifecycle과 완료 이벤트 계약의 방향을 확정한다. - 후속 작업: External Integration -- 현재 지점: Flutter-first Client Consolidation과 Work Item Provider Pipeline Design이 완료되어 아카이브되었고, workflow 상태 전이 구현이 다음 활성 후보가 되었다. +- 현재 지점: Flutter-first Client Consolidation, Client Integration Standardization, Work Item Provider Pipeline Design이 완료되었고, workflow 상태 전이 구현 전에 Roadmap Driven Agent-Ops Automation 스케치 구체화가 선행되어야 한다. - 책임 경계: - NomadCode Workflow Core는 task lifecycle 전이, retry/timeout envelope, heartbeat, terminal 상태 기록을 소유한다. - IOP/A2A/model runtime은 외부 실행 표면이며, 내부 실행 정책과 런타임 세부 retry는 각 adapter 또는 외부 런타임 책임으로 둔다.