Outline Builder

Triggers & routing

• Trigger: outline builder, bullet outline, outline.yml, 大纲生成, bullets-only.
• Use when: structure 阶段（NO PROSE），已有 taxonomy，需要生成可映射/可写作的章节与小节骨架（每小节≥3 bullets）。
• Skip if: 已经有批准过且可映射的 outline（避免无意义 churn）。
• Network: none.
• Guardrail: bullets-only；移除 TODO/模板语句；每小节至少 3 个可检查 bullets。

outline/outline.refined.ok freezes a reviewed outline only while the marker is newer than the outline, all declared inputs, the defaults asset, and the generator. Upstream changes invalidate the marker and trigger a backed-up regeneration.

Build outline/outline.yml from either:

• outline/taxonomy.yml (legacy H3-first compatibility path)
• outline/chapter_skeleton.yml + outline/section_briefs.jsonl (section-first transition path)

Compatibility mode is active: this migration keeps the current output contract while moving intro/related defaults, Stage A bullet templates, and domain-specific comparison framing into references/ and assets/.

Load Order

Always read:

• references/overview.md
• references/stage_a_contract.md

Read by task:

• references/intro_related_patterns.md when changing Introduction / Related Work defaults
• references/examples_good.md and references/examples_bad.md for bullet calibration

Machine-readable asset:

• assets/outline_defaults.yaml

Inputs

Required:

• outline/taxonomy.yml

Optional human calibration only:

• ref/agent-surveys/STYLE_REPORT.md
• ref/agent-surveys/text/

Output

Keep the current output contract:

• outline/outline.yml

Compatibility mode

Current mode is reference-first with script compatibility:

• front-chapter defaults live in assets/outline_defaults.yaml
• Stage A bullet defaults and comparison-axis packs live in assets/outline_defaults.yaml
• examples and boundary rules live in references/
• scripts/run.py still owns outline materialization, section-first input selection, and placeholder-safe overwrite behavior