Section Briefs
Load Order
Always read:
references/overview.md
Use scripts/run.py only for deterministic brief assembly:
- read
outline/chapter_skeleton.ymlfor chapter IDs and target shape - read
outline/section_bindings.jsonlfor saturation and gap signals - read
GOAL.mdwhen present for run-level scope - write
outline/section_briefs.jsonlas planning substrate, not prose
Inputs
outline/chapter_skeleton.ymloutline/section_bindings.jsonl- Optional:
GOAL.md
Outputs
outline/section_briefs.jsonl
Asset contract
assets/output_contract.json
Script
Quick Start
python .codex/skills/section-briefs/scripts/run.py --workspace <workspace_dir>
All Options
--workspace <dir>: workspace containing chapter skeleton and section bindings--unit-id <id>: optional harness metadata--inputs <semicolon-separated>: optional override fromUNITS.csv--outputs <semicolon-separated>: optional output override; default isoutline/section_briefs.jsonl--checkpoint <C*>: optional harness metadata
Examples
- Build chapter-level briefs from the section-first layer:
python .codex/skills/section-briefs/scripts/run.py --workspace workspaces/<ws> --inputs 'outline/chapter_skeleton.yml;outline/section_bindings.jsonl;GOAL.md' --outputs 'outline/section_briefs.jsonl'