---
name: architecture-deepening
description: Identificar oportunidades de módulos mais profundos, seams reais e refactors com maior testabilidade antes de Tech Spec, Refinement ou Review.
---

# Architecture Deepening SDD

## Objetivo

Melhorar navegabilidade e testabilidade sem refactor especulativo. Use quando discovery, review ou execution indicar módulo raso, acoplamento alto, seam ruim ou baixa localidade.

## Procedimento

1. Leia glossário, ADRs, Tech Spec e Context Pack antes de avaliar arquitetura.
2. Mapeie módulos, interfaces, implementações, adapters e callers afetados.
3. Use o teste de delecao: se apagar um módulo remove complexidade, ele e provavelmente pass-through; se espalha complexidade nos callers, ele tem leverage.
4. Proponha candidatos com problema, beneficio, risco, arquivos provaveis e estratégia de teste.
5. Não refatore em discovery; converta em Tech Spec, Refinement, ADR ou task com checkpoint.

## Regras

- Uma adapter sozinha e seam hipotetico; duas ou mais adapters tornam o seam real.
- Prefira localidade e leverage a camadas cosmeticas.
- Respeite ADRs existentes; reabrir ADR exige evidência de friccao real.

## Fonte externa

- Matt Pocock Skills: https://github.com/mattpocock/skills
