1 min read
Index Rebuild Cadence
Rebuild index, backlinks, README stats, and qmd search after substantive wiki edits.
The index layer is not decorative. wiki/_index.md, wiki/_backlinks.json, README stats, and qmd embeddings are how future agents find the work. Source: AGENTS.md Indexing and Logging; scripts/build-index.ts
Commands
npx tsx scripts/build-index.ts
qmd update && qmd embed
Run After
- creating, deleting, renaming, or moving pages
- changing frontmatter, aliases, related links, or title
- broad rewrites of identity, resolver, skill, heartbeat, or meta docs
- ingest/capture work that updates compiled pages
- README stats changes
Failure Handling
If build-index or qmd fails, report the command and error. Do not claim the wiki is updated for retrieval until search is current or the failure is explicit.
Timeline
- 2026-07-01 | Rebuilt index cadence around retrieval correctness, qmd parity, README stats, and failure reporting. Source: User request, 2026-07-01
- 2026-05-31 | Index rebuild cadence documented. Source: public wiki expansion, 2026-05-31