# GitContext

This repository uses GitContext for AI-assisted knowledge capture.

## Proactive Context Retrieval

**At the start of any file-editing conversation**, call `get_context_for_file` with the file you are about to edit. This surfaces relevant docs and open blockers before you begin.

## Available MCP Tools

Use the `gitcontext` MCP server tools to capture and retrieve knowledge:

- `get_context_for_file` — get relevant docs and blockers for a specific file path
- `search_docs_for_context` — search docs with optional file/branch context, returns relevance reasons
- `capture_doc` — capture a learning, bug, convention, or blocker doc
- `get_git_context` — get current branch, commit, and recent changes
- `get_git_diff` — get diff between branches
- `list_open_blockers` — list currently open blockers

## When to Capture

- **Bug**: after fixing a non-obvious issue — include root cause and fix
- **Convention**: after making a design decision or establishing a code pattern
- **Learning**: after understanding something that will help future work
- **Blocker**: when hitting a blocking dependency or external issue
