---
description: Route index.md edits to the regeneration verb, its frontmatter contract, and the hand-edit opt-out
paths:
  - '**/index.md'
---

# Index standards

## Generation

- Do not hand-edit an `index.md` that an agent browses to pick a document. Run `aitk indexes regen` instead.
- Preserve an `index.md`'s own frontmatter (`title`, `subtitle`). The regen walker keeps it.
- Add `auto: false` to an `index.md`'s frontmatter to keep that folder's index hand-edited.
- Skip `index.md` in a code folder or a scratch folder. Neither needs one.