nomadcode/agent-roadmap/phase/workflow-core/PHASE.md

2.1 KiB

Phase: Workflow Core

상태

[진행중]

목표

Plane 통신 토대와 provider-neutral pipeline 설계 이후, 내부 런타임 간 신규 통신은 proto-socket 기본 레일로 통일하고, client-core 통신을 먼저 열어 실제 상태 변화를 기준으로 task lifecycle, enqueue/running/completed/failed 흐름을 안정화한다.

Milestone 흐름

완료된 Milestone은 archive 경로를 가리키고, 검토중, 진행중, 계획, 스케치 또는 보류 Milestone은 이 Phase 하위 milestones/ 경로를 가리킨다. 완료, 검토중, 진행중, 계획, 스케치 순서를 기본으로 하되, 이번 Phase에서는 Proto-Socket Infrastructure Communication RailWorkflow Core 구현의 선행 조건이므로 먼저 둔다.

  • [진행중] Proto-Socket Infrastructure Communication Rail

    • 경로: agent-roadmap/phase/workflow-core/milestones/proto-socket-infrastructure-communication-rail.md
    • 요약: 내부 런타임 간 신규 통신을 proto-socket 기본 레일로 통일하고, client-core task 요청과 상태 이벤트가 오갈 수 있는 기반을 만든다.
  • [계획] Workflow Core

    • 경로: agent-roadmap/phase/workflow-core/milestones/workflow-core.md
    • 요약: proto-socket client-core 통신 기준을 반영해 task lifecycle, 상태 전이 책임, 실패 정책, retry/timeout, notification event 모델을 안정화한다.

Phase 경계

  • Workflow Core는 canonical task lifecycle, retry/timeout envelope, heartbeat, terminal 상태 기록을 소유한다.
  • MCP 기반 agent-ops control plane은 Agent-Ops MCP Control Plane Phase로 미루며, 현재 Workflow Core의 선행 조건으로 두지 않는다.
  • 내부 런타임 간 신규 통신은 proto-socket을 기본으로 하며, REST/HTTP 예외는 health/readiness, 외부 provider 호환 API, 운영 smoke/curl, public callback, 단순 정적 조회로 제한한다.
  • 외부 협업 도구 notification 발송, provider별 실제 comment/status 전송, 복잡한 workflow DSL은 후속 Phase로 넘긴다.
  • IOP/A2A/model runtime 내부 정책은 외부 실행 표면 또는 adapter 책임으로 둔다.