Documentation for AI Coding Agents
Codebase Context Specification
A convention developers can all easily adopt to capture and communicate the context of your codebase for both AI coding agents and humans. Similar to .env and .editorconfig, but focused on documenting your code.
Watch the new video about the 1.1 specManual Setup Instructions
Create a .context directory in your project root with an index.md file. Additional files and directories are optional:
.context/
index.md(required)
docs.md(optional)
diagrams/(optional)
images/(optional)
.contextignore(optional)
Custom Instructions
Add custom instructions to your AI coding agents to leverage your context directory:
<instruction> Before you start a task, if a .context directory exists, read it for an archtectural overview & project context starting at .context/index.md </instruction>Browse by category