Files
AirCoding/AirPlan/docs/architecture/adr/ADR-0006-align-execution-layer-with-claude-code.md
AirCoding 82f3140847 Initial commit: AirCoding V1.0.0 Alpha architecture baseline
Complete architecture document set with multi-model review remediation:
- Frozen interface contracts, runtime semantics, DB schemas
- Event/tool/error/provider registries
- Scheduler and main agent state machines
- C4 module/code views, solution architecture, baseline V1
- Multi-model review reports and joint assessment
- Phase-gate remediation complete (P0/P1/P2/UX resolved)
- Implementation plan with T-000A through T-045
- Reference folders kept as placeholders only
2026-05-28 18:45:01 +08:00

1.0 KiB

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.