Invocation

bash
1
2
3
4
goatcs-harness run graph.json                    # Markdown plan (default)
goatcs-harness run graph.json --json             # JSON plan (plan.schema.json)
goatcs-harness run graph.json --markdown         # explicit Markdown
goatcs-harness run graph.json --json --waiver O=reason   # audited harness-facet waiver

Seed contract

Provide these in the run seed / session state:

Field Required Description
spec_path Yes Path to the source spec
output_format No markdown (default) or json
out_path No Destination for the emitted plan
waived_facets_pairs No Audited --waiver pairs (harness-forge only)

Output format

  • Markdown (default) --- human-readable sections with inline code/command/config examples in fenced blocks. Sections: Coverage Verdict, Structural Verdict, Execution Notes, Requirement Ledger, Graph roots/leaves, Execution Order, and one ### <step_id> block per step.
  • JSON (--json) --- machine-strict format conforming to plan.schema.json. Consumed directly by epiphany-executor.