Files
tom_analysis_agent/CLAUDE.md

1.3 KiB

CLAUDE.md

Direction

This agent turns a description of a solution into a reviewed target operating model. It is the Execution engine (../orchestration_engine) and one Workflow, app/operating_model/workflow.py. Read CONTEXT.md and docs/adr/ before designing or restructuring anything.

Three rules are the point of the design:

  • The solution is never changed here. What operations needs and the solution lacks is a finding, returned to whoever owns the design (ADR-0001).
  • No agent writes a number of people or a cost. They are computed from the rate card Skill, whose prices only the service provider sets (ADR-0003).
  • Behaviour lives in Skills. The core names no Cloud provider and no framework. The capability catalogue is in our own words and cites the frameworks it draws on.

Engine code is not edited here. A fault in it is fixed in ../orchestration_engine.

Plans and history live in .agents/plans/; IMPLEMENTATION_PLAN.md is the plan across both repositories. The design spec is .scratch/target-operating-model/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 .

Set up with pip install -e ../orchestration_engine --config-settings editable_mode=compat and then pip install -e '.[dev]'.