Section Bindings

---
name: section-bindings
description: "Bind papers to chapter-level sections first, writing `outline/section_bindings.jsonl` and `outline/section_binding_report.md`."
---

# Section Bindings

## Triggers & routing

- **Trigger**: section bindings, chapter bindings, section-first binding, 章节绑定, 章级绑定.
- **Use when**: survey structure should measure chapter saturation before stable H3 decomposition.


## Load Order

Always read:
- `references/overview.md`

Use `scripts/run.py` only for deterministic binding and report materialization:
- read `papers/core_set.csv` as the authoritative paper pool
- read `outline/chapter_skeleton.yml` as the chapter contract
- read `papers/papers_dedup.jsonl` when available for richer metadata
- write auditable binding artifacts without inventing papers

## Inputs

- `papers/core_set.csv`
- `outline/chapter_skeleton.yml`
- Optional: `papers/papers_dedup.jsonl`

## Outputs

- `outline/section_bindings.jsonl`
- `outline/section_binding_report.md`

## Asset contract

- `assets/output_contract.json`

## Script

### Quick Start

- `uv run python .codex/skills/section-bindings/scripts/run.py --workspace <workspace>`

### All Options

- `--workspace <dir>`: workspace containing the core set and chapter skeleton
- `--unit-id <id>`: optional harness metadata
- `--inputs <semicolon-separated>`: optional override from `UNITS.csv`
- `--outputs <semicolon-separated>`: optional output override; defaults are `outline/section_bindings.jsonl` and `outline/section_binding_report.md`
- `--checkpoint <C*>`: optional harness metadata

### Examples

- Bind papers to chapters before H3 decomposition:
  - `uv run python .codex/skills/section-bindings/scripts/run.py --workspace <workspace> --inputs 'papers/core_set.csv;outline/chapter_skeleton.yml;papers/papers_dedup.jsonl' --outputs 'outline/section_bindings.jsonl;outline/section_binding_report.md'`