Files
orchestration_engine/.agents/plans/iter-01-execution-engine/MAP.md

2.4 KiB

Plan Map

Iteration: 1, the Execution engine Intent: An installable package that holds one Execution of any Workflow, built from the Reference without changing it. Status: steps 1 to 6 built on 2026-10-13; 529 tests pass

Sources of truth

  • .scratch/engine/spec.md: the Workflow and what each step brings.
  • docs/adr/0001-the-execution-engine-takes-a-workflow.md, docs/adr/0002-built-from-a-reference-that-is-never-modified.md.
  • REFERENCE.lock.json: what has been brought, and from which commit.

Status

Step What Done when Status
1 The repository: package, vocabulary, the two ADRs, the bring script The package installs built 2026-10-13 (steps/step-1.md); both ADRs accepted by the owner on 2026-10-13
2 The modules that depend on nothing about a subject, with their tests Those tests pass built 2026-10-13 (steps/step-2.md)
3 The Workflow value and its hooks; the modules that name Deliverables brought and rewritten to use it No engine module names a Deliverable built 2026-10-13 (steps/step-3.md); wording and a few fields of the Reference's remain, listed there
4 A toy Workflow, with a small agent root under tests/ (role files, a bundle, stand-in Skills) It completes on the fake runtime through a question, an Approval, a Revision and a Change request; the role loader, the assembly and the A2A server are tested on it built 2026-10-13 (steps/step-4.md), with four Deliverables in three Phases
5 The Reference's workflow as an example in the tests The Reference's tests for its graph, checks and hooks pass against it built 2026-10-13 with step 3 (steps/step-3.md); six of its test files are not brought; steps/step-4.md says what that leaves untested
6 The digest step: sources to a spec, adapters listed by a Workflow, provenance per value The toy Workflow starts from a digested spec built 2026-10-13 (steps/step-6.md)
7 How an agent's container build obtains the engine One agent image builds from a clean checkout in progress: the owner chose on 2026-10-20 a named build context for local builds (--build-context engine=../orchestration_engine) and a pinned-commit dependency for CI; built as step 1 of ../tom_analysis/.agents/plans/iter-02-platform-deployment/

Steps 3 and 5 were built together: the Reference's workflow is what the converted modules are tested with. Step 4 follows them. Steps 6 and 7 depend on 4.