# Architecture Drift Repair

> Repair confirmed architecture drift in small batches while preserving public canon and avoiding broad opportunistic refactors.

- Skill: `clawic/architecture-drift-repair-2` (Agent Skill)
- Install (CLI): `npx get-skill add clawic/architecture-drift-repair-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clawic/architecture-drift-repair-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: clawic (https://skillmd.com/u/clawic)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/clawic/architecture-drift-repair-2

---


# architecture-drift-repair

Repair a confirmed mismatch between implementation and accepted architecture.

## Procedure

1. Begin from a specific drift finding, ADR, decision-map row, failing guard, or documented contradiction.
2. Re-read the canonical source and the smallest affected implementation area.
3. Define a batch that can be reviewed independently and should compile independently.
4. Update implementation, docs, tests, manifests, and guardrails together when the drift crosses those surfaces.
5. If the drift requires a broad migration, land only a bounded preparatory repair and record the remaining debt.
6. Validate with the relevant focused checks before broader lanes.

## Constraints

- Keep repairs small; "align with the Constitution" is not permission for a sweeping refactor.
- Do not hide drift by deleting checks, weakening docs, or bypassing ownership boundaries.
- Preserve unrelated user or agent work in a dirty tree.

