# Architecture Change

> Architecture change workflow with mandatory ADR and controlled rollout. Use when proposing or implementing a structural/architectural change to the codebase.

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

---


# Architecture Change

Follow `.agent/workflows/architecture-change.md` strictly.

Execution requirements:

1. Write architecture proposal with options/trade-offs.
2. Create/update ADR file in `docs/decisions/` before finalizing.
3. Implement in isolated steps and validate regressions.
4. Sync architecture-relevant docs and `CHANGELOG.md`.
5. Run pre-commit checks before final handoff.
6. End with ADR + DoD confirmation.

No architecture-level change may be closed without ADR entry.