What epiphany-executor does

epiphany-executor is the terminal stage of the pipeline: epiphany-brief -> epiphany-spec -> epiphany-plan -> **epiphany-executor**.

It takes a structured plan (from epiphany-plan) and executes it to produce the implemented solution. The executor transforms the plan into a deterministic runtime graph via the COMPILE model: each plan step becomes one harness node, one checkpoint, and one Burr action.

Key properties

  • 13 harness nodes / 16 edges --- the executor's own runtime graph.
  • COMPILE model --- each plan step is compiled into a graph node with lifecycle, DoD, effect, and traces contracts.
  • Independent verification --- verify_dod runs as a separate act from execute_step, preventing self-grading.
  • Checkpointed --- every step is committed (git) before advancing. A failed DoD halts and offers recovery.
  • Recoverable --- resume, fork, and handoff are first-class operations.