phase-build

Phase Build Orchestrator

Convert outline.json → full markdown draft via parallel section writers + fact verification.

Inputs

Required in workspace/{task_id}/:

• state.json
• research.json
• angle.json (from format-selector + topic-angle-selector)
• outline.json (from outline-architect)

Stages

1. section-drafter (parallel N=outline.sections.length)
   - Spawn N independent subagents via Task tool
   - Each gets: ONE section spec + 800-word context summary of others
   - Each writes markdown + claims[] + citation_capsule
   - Tool whitelist: Read, Write ONLY (no WebFetch, no Bash)
   - Output: workspace/{task}/sections/{0..N-1}.json
   
2. citation-capsule-builder
   - Verify each H2 has 40-60 word AI-quotable block
   - Princeton GEO requirement (+28-41% AI citation rate)

3. chart-generator (if outline.sections[].needs_table)
   - Generate ≥2 markdown tables OR XSS-safe SVG charts
   - At least 1 in front 50% of article

4. fact-check-and-citation
   - For each [claim:cN_S] marker: Crossref → Tavily → HEAD check
   - Build References section (APA 7, ≤10 entries)
   - Replace markers with (Author, Year) in-text
   - Output: workspace/{task}/citations.json

5. assembly (scripts/build/assemble.py)
   - Concatenate: Abstract → Key Takeaways → ToC → Body → FAQ → Conclusion → References
   - Anchor links auto-generated for ToC
   - Mandatory-H2 coverage is enforced by scripts/lint/mandatory_sections_check.py,
     which reads THIS project's `business-context.json :: mandatory_sections` (assemble.py
     imports `_load_mandatory_sections` from it). Do NOT substitute
     markdown_structure_check.py here: it carries a HARDCODED section table and would
     override the project contract (see feedback_project_contract_not_hardcoded_labels).
     It remains available as a standalone structural report, not as this stage's gate.
   - Output: workspace/{task}/draft.md (frontmatter Stage: build-done)

Parallel execution pattern

Section drafter spawns subagents in single Task batch: