feat: AI chat as a knowledge base standard (CLAUDE.md)

[mcabico-blip]

What this adds

A standard for treating AI chat sessions as a versioned, project-local knowledge base — defined entirely inside CLAUDE.md so it's immediately usable with no extra tooling.

The problem

Every productive Claude session generates institutional knowledge that vanishes when the window closes. Traced a subtle bug? Explained why the middleware order matters? Discovered an undocumented SDK quirk? That knowledge lives nowhere.

The solution

A .claude/knowledge/ directory convention + two slash commands that make capture and retrieval frictionless:

• /save-insight <title> — distills the current session's key insight into a structured Markdown entry and updates an index
• /search-kb <query> — searches the index and returns ranked matches with summaries

The CLAUDE.md section tells Claude to read the index at session start, so it automatically avoids re-solving already-solved problems — and offers to run /save-insight whenever something new is discovered.

What's in this PR

• CLAUDE.md with the full standard:
  • Directory layout (.claude/knowledge/{decisions,patterns,gotchas,integrations,processes}/)
  • Entry file format (frontmatter + structured sections)
  • Drop-in CLAUDE.md block for any project
  • /save-insight command definition
  • /search-kb command definition
  • Design principles

Design principles

• Zero-friction capture (one command, one title)
• Version-controlled — lives in the repo, not a cloud service
• Claude-readable plain Markdown — Claude can cite and update entries natively
• Self-reinforcing — the CLAUDE.md section makes Claude grow the base automatically

🤖 Generated with Claude Code