CLAUDE.md git:20260903.261acdeA

Immutable. This exact content never changes and is served at /api/v1/blob/6656804d5085572f.

# CLAUDE.md — Levara Agent Guide

This repository is the Levara codebase. The Go module now lives at the
repository root; legacy adapter experiments and pre-rebrand code have been
removed from the working tree.

For the canonical memory/MCP playbook, use [`AGENTS.md`](AGENTS.md). Keep the
MCP tool catalog in `AGENTS.md` synchronized through the contract generator
instead of editing tool inventories by hand.

## Current Project Shape

- Main README: [`README.md`](README.md)
- Product ladder: [`docs/product-ladder.md`](docs/product-ladder.md)
- Runtime profiles: [`docs/profile-presets.md`](docs/profile-presets.md)
- Security review checklist: [`docs/internal/security-diff-checklist.md`](docs/internal/security-diff-checklist.md)
- REST/gRPC/MCP contract artifacts: [`docs/api-contract.md`](docs/api-contract.md)
  and [`docs/contract.json`](docs/contract.json)

## Development Commands

Run commands from the repository root.

```bash
make build
make test-commit
make profile-config-check
make contract-check
```

For focused work inside the engine:

```bash
go test ./docs ./pkg/profile ./pkg/access ./pkg/storage
make test-release-candidate
```

## Cleanup Policy

- Do not reintroduce pre-Levara names, adapter experiments, or external
  benchmark scaffolding into top-level docs.
- Keep product claims aligned with `docs/product-ladder.md`.
- Keep enterprise claims honest: SSO/storage/KMS/SIEM production backends are
  adapter roadmap unless concrete implementations and tests exist.