@@ -13,3 +13,19 @@
 **O que NÃO fazer**:
 - Não pedir confirmação extra por toggle ao instalar/remover a skill — o próprio toggle já é a ação.
 - Não misturar o gate de "aparece no combobox" com o status bruto de detecção — são coisas diferentes (detecção é sempre completa e reporta todo agente conhecido; o combobox filtra por skill instalada).
+
+## Iniciativa: Tech Debt — divisão de arquivos grandes (`packages/app/src`)
+
+**Responsabilidade**: reduzir arquivos monolíticos de `packages/app/src` em módulos menores por responsabilidade, sem alterar comportamento.
+
+**Rastreamento**: issues rotuladas `tech-debt` no GitHub (alltomatos/opencode) — #13, #14, #15, #16, #17, #18, #19. Trabalho sequencial, uma issue por vez/PR.
+
+**Invariantes**:
+- `pages/layout.tsx` (#13) e `context/layout.tsx` (#18) NÃO devem ser divididos antes do épico #25 (descontinuação do layout legado / `newLayoutDesigns()`) avançar — dividir agora é trabalho descartável, pois o épico planeja deletar/reescrever esses arquivos por completo. Priorizar as fatias independentes do épico #25 primeiro: #19, #17, #16, #15, #14.
+- Cada issue vira slices pequenos (idealmente um PR por issue, commits menores dentro dela), verificados manualmente no preview antes de prosseguir — nunca um PR monolítico misturando múltiplas issues de split.
+- Divisão de arquivo é refatoração pura: nenhuma mudança de comportamento/UX deve acompanhar o split. Se um bug for encontrado durante o split, abrir issue separada — não corrigir dentro do PR de refactor.
+- Após cada split, `/qa-analyst` deve confrontar app antes/depois (sem regressão visual/funcional) antes de abrir PR.
+
+**O que NÃO fazer**:
+- Não iniciar #13 ou #18 sem antes checar o status do épico #25.
+- Não abrir uma única issue/PR cobrindo dois arquivos grandes ao mesmo tempo — mantém rastreabilidade 1:1 com a issue do GitHub.