stageflow 0.12.0 → 0.15.0

package/skills/stageflow-session-capture/references/catalog-authoring.md

@@ -10,22 +10,25 @@ Resolve collision-safe ids with `scripts/resolve-catalog-id.mjs` (`--text`, `--d
 
 ## External stage file
 
-Required fields: `id`, `system_prompt`, `model`. Filename stem must match `id` (`research.yaml` → `id: research`).
+Required fields: `id`, `system_prompt`. Filename stem must match `id` (`research.yaml` → `id: research`). `model` is optional when the pipeline or manifest supplies it.
 
 Every `system_prompt` ends with a mandatory `emit_stage_envelope` footer, for example:
 
 ```
 When finished, call emit_stage_envelope once with status, summary, artifacts,
-and a payload the next stage can use.
+and a payload the next stage can use. Your last tool call in this attempt must
+be emit_stage_envelope. An empty final message is a stage failure.
 ```
 
+Write reviewable or required outputs with `write_stage_artifact`, not checkout `write`/`edit`, unless the step's deliverable is intentionally checkout-only. `summary` is for the next stage — outcomes and artifact pointers only; do not put this stage's prohibitions in the summary.
+
 Omit `gate_kinds`. A human-review checkpoint from the source session stays as prose in the stage approach, not a HITL gate.
 
 Worked example: `assets/example-pipeline/research.yaml` and `assets/example-pipeline/implement.yaml`.
 
 ## Pipeline file
 
-`id` plus `stages:` entries with `id`, `uses:` (path relative to the pipeline file), and `needs:` for every non-root stage. Linear chain: each stage `needs` the previous id.
+`id` plus `stages:` entries with `id`, `uses:` (path relative to the pipeline file), and `needs:` for every non-root stage. Linear chain: each stage `needs` the previous id (scalar or a one-item array). Optional pipeline-root `model` fills stages that omit `model`. Put body contracts (`io`, `verify`) on stage files; put `on_verify_fail` on the pipeline entry when after-phase verify should repair or wait for an operator.
 
 Worked example: `assets/example-pipeline/example.pipeline.yaml`.