From ef92054106abcdd83e98aa0258f7f5224bca6cb0 Mon Sep 17 00:00:00 2001 From: Jonathan Haas Date: Mon, 9 Mar 2026 13:39:47 -0700 Subject: [PATCH] Add CLAUDE.md with project conventions and dev setup Provides persistent context for Claude Code sessions: Rust stack, multi-model AI, Vault integration, and self-hosted deployment conventions. Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..68fb07d --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,29 @@ +# DiffScope - AI Code Review Engine + +## Quick Reference +```bash +cargo build # Build +cargo test # Run tests +cargo run -- --help # CLI usage +``` + +## Architecture +- **Language**: Rust +- **Database**: PostgreSQL (via sqlx with compile-time checked queries) +- **AI providers**: Multi-model support (Anthropic primary, OpenAI, OpenRouter) +- **Deployment**: Docker → k3s via Helm chart in `charts/` +- **GitHub integration**: GitHub App auth (not PATs) + +## Key Directories +- `src/` — Core analysis engine, CLI, API +- `charts/` — Helm chart for k8s deployment +- `migrations/` — PostgreSQL migrations (sqlx) +- `eval/` — Evaluation and benchmarking +- `examples/` — Usage examples + +## Conventions +- Use frontier models for reviews — never default to smaller models +- Vault integration for secrets management (HashiCorp Vault) +- GitHub App authentication over personal access tokens +- Wide events for observability (OpenTelemetry-compatible) +- Self-hosted first: Ollama/vLLM/LM Studio should be first-class providers