generate-captured-workflow-from-references

Generate Captured Workflow from References

Synthesize a Stage 0 captured_workflow for $app from a structured reference set and constraints.

What this skill does

One sentence — synthesize the inputs that D2.4 step 6 ($generate-eou-candidates) needs, plus the per-app constitutional domain_values layer, from a user goal + 5-role reference set + constraints + explicit user contributions.

Inputs required

• $app (required) — the app or domain identifier; used in the output filename cw-{slug}.yml.
• user_goal (required) — outcome category in plain language ("I want to make X").
• reference_set (required) — mapping with all 5 role slots filled, each with {ref, why} entries:
  • aspirational — what the user wants to make
  • anti_reference — similar surface, wrong soul
  • boundary_case — edge of the field
  • mainstream_baseline — the median of the field
  • outlier — "I dislike this but it succeeds" (mandatory V1 defense against blind-spot encoding)
• constraints (required) — audience, scale, budget, time, risk_tolerance, desired_effect.
• negative_constraints (required) — what the user rejects explicitly.
• user_contributed_references (required) — ≥1 reference per role slot that the AI did not propose (V2 anti-abdication enforcement).
• starter_pack (optional) — engine/starter-packs/{domain}.yml if present and the user opts in.

Inputs forbidden

• Pre-existing workflow prose — that input belongs to $generate-eou-candidates, not this skill. If the user can already articulate a workflow, this skill returns the operational_value_test reject decision and recommends $generate-eou-candidates directly.

Required reading

1. schemas/captured-workflow.schema.yml
2. dev-docs/06-values-over-rules.md
3. dev-docs/08-stage-0-design.md
4. engine/meta-eous/generate-captured-workflow-from-references.yml

Stop conditions

Halt and report if any of the following hold:

• Any role slot is empty after best-effort elicitation.
• user_contributed_references is empty for any slot (V2 violation).
• Fewer than 3 surviving domain_values after inclusion-test filtering.
• More than 8 surviving domain_values (cap mirrors foundry V1–V8 sizing).
• Counterfactual swap audit reveals fewer than 3 flips out of 5 tests (the value layer is decoration).
• User can articulate a workflow unaided (skill is the wrong tool; use $generate-eou-candidates directly).
• The app is governance scaffolding only with no real craft domain.