diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..5b203c9
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,35 @@
+# Claude Notes — ollama-mcp
+
+## Stack
+
+- **Runtime:** Python (MCP server)
+- **Protocol:** Model Context Protocol (MCP)
+- **Inference:** Ollama at `192.168.87.18`
+
+## CI/CD
+
+This project follows the **Universal Test Coverage Plan**:
+https://outline.themosers.club/doc/universal-test-coverage-plan-nHgsMTqBgk
+
+CI pipeline: `.gitea/workflows/ci.yml` (Gitea Actions)
+
+**Stages:** Code quality → Unit tests → Dependency scan → SAST → Build image → Trivy scan → Report
+
+Results posted to: Gitea PR comments + Mattermost `#builds`
+
+## Development Workflow
+
+- Branch from `main` for all changes
+- Every change requires updated unit tests
+- All non-trivial plans documented in Outline before implementation
+
+## Testing Standards
+
+| Layer  | Tool                    | Coverage target |
+|--------|-------------------------|-----------------|
+| Python | `pytest` + `pytest-cov` | ≥ 70%           |
+
+## Plans
+
+All non-trivial plans must be documented in Outline before implementation:
+https://outline.themosers.club/doc/development-plans-IcbcQI7WDD