Massive Report Writing

Overview

Use evidence ledgering to compress large research corpora into structured, quotable material. For very large corpora, harness iteration handles multi-pass synthesis automatically.

When to Use

| Condition | Threshold | Action | |-----------|-----------|--------| | Medium corpus | 100-150K chars, 8-15 files | Build evidence ledger, write in one pass | | Large corpus (harness mode) | >150K chars, >15 files | Ledger → harness restart → write from ledger | | Large corpus (non-harness) | >150K chars | Suggest user enable harness mode |

---

Workflow: Evidence Ledger Mode

1. Build Evidence Ledger

Call build_evidence_ledger(session_dir, topic, task_name) after finalize_research.

The tool extracts from each source:

• Direct quotes with attribution
• Specific numbers (percentages, counts, costs)
• Key dates and timelines
• Claims and findings

Output: tasks/{task_name}/evidence_ledger.md with EVID-XXX entries.

2. Read Only the Ledger

After ledger is built:

• ✅ Read evidence_ledger.md for synthesis
• ❌ Do NOT re-read raw corpus files
• ❌ Do NOT use read_research_files again

This is how you avoid context exhaustion.

3. Write Report from Ledger

Use EVID-XXX references when citing:

According to ISW (EVID-003), Russian forces gained 74 square miles...

---

Harness Integration

When corpus exceeds safe limits AND harness mode is active:

1. Iteration 1: finalize → build ledger → ledger saved to disk → context exhaustion
2. Harness restart: Context cleared, handoff.json injected
3. Iteration 2: Read ledger from disk → write report

The harness handles multi-pass automatically. You don't need map-reduce orchestration.

---

Chunked Write Sequence

Use when single Write calls fail or output is >30KB:

1) Write header + CSS + title block
2) Append executive summary
3) Append Section 1 (cite EVID-XXX)
4) Append Section 2
... repeat ...
N) Append references

Use append_to_file for sections 2-N.

---

Templates

See references/massive_report_templates.md for:

• Evidence ledger entry format
• Section outline template
• Chunked write sequence

---

Anti-Summary-of-Summary Rule

• Every claim in the final report must trace to an EVID-XXX
• If a point cannot be traced to a ledger item, drop it or re-read the source
• Batch summaries (if used) are navigation only, not source material