1.0 KiB
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:
.venv/bin/python -m pytest -q
.venv/bin/ruff check . && .venv/bin/ruff format --check .
.venv/bin/mypy .