# ADR-0006: Align Execution Layer With Claude Code Quality Discipline

- Status: Accepted
- Date: 2026-05-27

## Context

AirCoding's usefulness depends heavily on safe, correct code modifications. The user explicitly prioritized Claude Code-level execution quality over broad but loose tool behavior.

## Decision

Align execution-layer primitives with Claude Code as much as possible:

- read before edit
- exact conservative replacements
- small patches
- no unrelated refactors
- no premature abstractions
- schema-validated tool use
- permission checks before side effects
- verification before completion
- build/test/debug evidence collection
- root-cause failure diagnosis
- explicit blocker escalation for architecture/interface conflicts

## Consequences

- `fs.edit`, `fs.patch`, `shell.run`, WorkerResult, and review gates must preserve this discipline.
- Codex/OpenCode may inform tool breadth/UI/runtime ideas, but not at the cost of execution quality.
- Workers should fail or block rather than guessing unsafe edits.
