AirCoding/AirPlan/docs/architecture/adr/ADR-0006-align-execution-layer-with-claude-code.md

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.