Convention Checklist

Every wiki write should leave the graph more coherent, not merely leave more markdown behind.

Wiki Write Checklist

1. Search the wiki before writing.
2. Shape the durable idea with Wiki Brain Operating Model.
3. File the page with Filing Decision Tree.
4. Use the page format and frontmatter rules from Wiki Page Format.
5. Preserve compiled truth vs timeline separation.
6. Add citations for new facts.
7. Add useful wikilinks and frontmatter relationships.
8. Search aliases/duplicates before creating pages.
9. Merge weak fragments into stronger articles when appropriate.
10. Rebuild generated surfaces.
11. Run targeted validation.
12. Append wiki/log.md.

Closeout Commands

npx tsx scripts/build-index.ts
qmd update && qmd embed

For broad graph work, also run:

npm run wiki-quality
npm run routing-doctor
npx tsx scripts/doctor.ts --quiet

Do Not

• hand-write ## Backlinks
• create stubs just to satisfy a source mention
• split coherent pages by line count alone
• edit generated inventories directly
• skip qmd after changing retrieval-critical pages

---

Timeline

• 2026-07-01 | Upgraded the wiki-write checklist to match the current brain-shape, resolver, generated-surface, and validation loop. Source: User request, 2026-07-01
• 2026-05-31 | Convention checklist from HEARTBEAT.md. Source: public wiki expansion, 2026-05-31