# Architecture Drift Repair

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

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

---


# 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.