section-briefs

name

section-briefs

description

Build chapter-level briefs (`outline/section_briefs.jsonl`) from chapter skeleton plus section bindings before stable H3 decomposition. **Trigger**: section briefs, chapter planning cards, section-first briefs, 章节 brief, 章级 brief. **Use when**: section bindings exist and the run needs chapter-level rationale and decomposition guidance before emitting stable H3 ids. **Skip if**: `outline/section_briefs.jsonl` already exists and is refined. **Network**: none. **Guardrail**: NO PROSE; do not invent papers; emit planning constraints, not reader-facing text.

Section Briefs

Load Order

Always read:

• references/overview.md

Use scripts/run.py only for deterministic brief assembly:

• read outline/chapter_skeleton.yml for chapter IDs and target shape
• read outline/section_bindings.jsonl for saturation and gap signals
• read GOAL.md when present for run-level scope
• write outline/section_briefs.jsonl as planning substrate, not prose

Inputs

• outline/chapter_skeleton.yml
• outline/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 from UNITS.csv
• --outputs <semicolon-separated>: optional output override; default is outline/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'