# CLAUDE.md ## Direction This repository holds two things. The **Execution engine** (`execution_engine/`) is the package an agent runs on. The **Orchestration engine** is the service every request comes through; it is not built yet. Before designing or restructuring anything, read `CONTEXT.md` and `docs/adr/`. ADR-0001 is the anchor: the Execution engine names no Deliverable, no Cloud provider and no subject. Everything about a subject arrives in a Workflow. The engine is built from a reference, `gcp_solution_architecture_agent`, which is only ever read (ADR-0002). Never edit a file there. Bring a module across with `scripts/bring.py`, which records where it came from in `REFERENCE.lock.json`. Plans and history live in `.agents/plans/`, one directory per iteration; read `.agents/plans/README.md` before changing code. The design spec is `.scratch/engine/spec.md`. ## Checks A step is done when all three pass: ```bash .venv/bin/python -m pytest -q .venv/bin/ruff check . && .venv/bin/ruff format --check . .venv/bin/mypy . ```