Agent context & exploration
This section contains internal project knowledge useful for contributors and AI coding assistants. It includes design decisions, prior art, open questions, and an exploration log.
Unlike the rest of the docs, this section is written for contributors and AI agents rather than end users. It provides the “why” behind design choices and captures institutional knowledge that would otherwise be lost between sessions.
What’s here
Section titled “What’s here”| Page | Purpose |
|---|---|
| Current state | Start here. Where the project is right now, the live direction, the open wall |
| Glossary | Plain-language definitions of every project term, with code locations |
| Vision | Short- and long-term goals; the problem this plugin solves |
| Decisions | Key technical decisions and their rationale |
| Tradeoffs | Known tradeoffs and their justifications |
| Open questions | Unresolved design questions |
| Prior art | Existing plugins and related tools |
| Exploration log | Dated notes from development sessions |
| Research challenges | Adversarial briefs for fresh agents |
For AI agents
Section titled “For AI agents”If you’re an AI coding assistant working on this project, start here to understand context that isn’t obvious from the code alone. The .claude/ folder in the repo contains source versions of these documents with agent-specific instructions.
Key reading order for a fresh session:
- Current state — where the project is right now and the live direction (orients you in two minutes)
- Glossary — every project term, plain-language; consult the moment a word is unfamiliar
- Vision — what problem this solves
- Decisions — what’s already been decided and why
- Open questions — what’s still up for debate
- Exploration log — recent session history (newest first)