The meta-guardian of the stack: quantify technical debt, track agent API costs, and trip a circuit breaker before a runaway agent does damage.
Part of the SIN-Code agent-engineering stack.
Autonomous agents can quietly rack up complexity and API spend, or loop forever. ADW gives you measurable guardrails: a debt score that rises when code rots, a running cost ledger per agent/task, and a circuit breaker that aborts when cost, iterations, or debt cross your thresholds.
- Complexity analyzer (built on radon) — cyclomatic complexity, maintainability index, and hotspot detection.
- Debt score (0–100) with levels: healthy / manageable / warning / critical.
- Cost tracker — append-only JSONL ledger of token usage and USD cost per model, agent, and task.
- Circuit breaker — abort on max cost, max iterations, or debt increase.
- Watchdog daemon — background polling that alerts on debt spikes.
- CLI (
adw) for scanning, recording costs, and watching.
pip install -e .
adw scan # architectural debt of the current repo
adw record gpt-4o 1200 800 --agent a1 --task "refactor"
adw costs --agent a1 # tally spend
adw watch --interval 30 # run the background watchdogMIT — see LICENSE.