Checkpoint Brief

Checkpoint Brief

Prepare the review surface between machine-produced Artifacts and a human

checkpoint. This Skill summarizes; it does not choose a Workflow, approve a

checkpoint, or modify semantic Artifacts.

Inputs

• the active PIPELINE.lock.md
• the stage Artifacts named by the current Unit
• the existing DECISIONS.md

Output

• one current checkpoint block in DECISIONS.md

Steps

• Read the locked Workflow and current checkpoint.
• Inspect only the declared stage Artifacts.
• Summarize scope, structure, coverage, and unresolved choices without adding

new research claims.

• Upsert the checkpoint block while preserving the approval checklist and

prior Decision history.

• Stop before approval. human-checkpoint owns the approval Decision.

Acceptance

• DECISIONS.md names the current checkpoint and the Artifacts reviewed.
• unresolved choices are explicit and bounded.
• no approval is inferred or written.
• no Pipeline lock, Unit state, or semantic Artifact is changed.

Script

uv run python .codex/skills/checkpoint-brief/scripts/run.py \
  --workspace workspaces/<name> \
  --checkpoint C2 \
  --inputs 'outline/taxonomy.yml;outline/outline.yml'

The Pipeline adapter supplies the current Unit's declared inputs. Manual

invocations must do the same; an empty input list is reported as unreviewable

rather than inferred from unrelated Workspace files.