# Failure Taxonomy (12 Runtime Classes)

<!-- Generated by scripts/failure-taxonomy.mjs. Do not hand-edit class rows. -->

This is the canonical MartinLoop taxonomy. The class list is generated from `FAILURE_CLASSES` in `@martin/contracts`.

| Runtime class | Meaning |
| --- | --- |
| `logic_error` | Core reasoning or implementation logic did not satisfy objective constraints. |
| `hallucination` | Agent asserted or used unsupported repo/runtime facts. |
| `syntax_error` | Generated code failed syntax validation before runtime correctness checks. |
| `type_error` | Generated code failed static type checks. |
| `test_regression` | Changes caused tests that previously passed to fail. |
| `scope_creep` | Attempt modified behavior or files outside the declared objective boundary. |
| `no_progress` | Retries continued without meaningful objective progress. |
| `repo_grounding_failure` | Edits were not grounded to actual repository symbols/paths/state. |
| `verification_failure` | Verifier gate failed; run did not satisfy completion criteria. |
| `environment_mismatch` | Execution failed due to host/runtime/tooling mismatch. |
| `budget_pressure` | Run hit or approached budget/iteration/token constraints. |
| `safety_leash_blocked` | Policy/safety enforcement blocked unsafe or disallowed actions. |
| `sandbox_write_blocked` | Runtime failure classification. |
