Docs

INDEX

Read one file at session start. The brain's entry point - a short, ranked summary of where the project is right now. Every CLAUDE.md instruction reads it first; every fresh agent walks in oriented.

See it in motion

Where to find it

  • Desktop: localhost:4000, then Memory in the sidebar, then Reference index under All tools, in the Lessons, wiki and patterns group, which lists it.
  • Hosted: repoops.ai/team/reference, from Memory in the sidebar, then Reference index under All tools, in the Lessons, wiki and patterns group, which lists it.
  • Keyboard: ⌘ K, then type “INDEX”.
  • On disk: .claude/brain/INDEX.md in every tracked repo

What it does for you

Walk in oriented, not lost.A short read tells you what the project is, what just shipped, what's next, and which brain files matter for what you're about to do.
The next agent walks in just as oriented.CLAUDE.md tells every session to read INDEX.md and the latest session entry at the start, and any agent you point at the brain can do the same. Update INDEX the next session inherits the update.
Bumped in the same PR as the change.When a state-of-the-project line moves, the PR that moved it edits INDEX in the same commit. A CI gate (index-freshness) holds the floor: it fails the build when INDEX falls more than 7 days behind the newest session, when 250 commits land without its content changing, or when a line still calls a merged PR open.

Configure

Nothing - it's a hand-curated markdown file. Bump it whenever a state-of-the-project line moves (see the end-of-session rule in CLAUDE.md).

Use it well

At session start, read INDEX + the latest sessions/ entry. That's the minimum re-orientation. At session end, bump INDEX if your PR moved a state-of-the-project line. Don't let it grow into a wall of text - keep it ranked and short.

Read more

Last updated