How to Synthesize the Wiki

Periodically consolidate accumulated pages into updated, coherent understanding.

When to Run

• After ingesting 3+ sources on the same topic
• When you notice pages that feel stale or siloed
• As a periodic health pass (e.g. monthly, or after a burst of ingestion)

How to Trigger

Say one of:

• synthesize — all topics
• synthesize elastic — one topic
• synthesize knowledge-management — another topic

What the Agent Does

1. Reads all pages in scope.
2. Looks for: contradictions, duplications, missing cross-refs, outdated overviews, unresolved ⚠️/❓ flags, and concepts that have evolved across multiple ingests without the overview reflecting it.
3. Discusses findings with you before writing anything — you approve what changes get made.
4. Executes approved changes and logs the pass.

Typical Outputs

• Updated overviews that reflect the full picture, not just the first ingest
• New pages in comparisons/ when multiple sources now tell a coherent story
• Resolved ⚠️ contradiction flags
• New [[cross-references]] between pages that were created independently

Key Constraint

Synthesis never deletes — it merges. A removed page leaves a > Merged into [[...]] note before being dropped from index.md.

See Also

• llm-wiki-pattern — synthesize is the fourth core operation in the LLM Wiki pattern
• lint-the-wiki — structural health check (broken refs, orphans)
• ingest-a-source — adding new sources
• wiki-schema — the schema that governs all operations