Toggle Sidebar

EscreverDivididoPrévia

salvo

**ADR** é Architecture Decision Record: um arquivo curto que registra uma decisão estrutural, **por que** ela foi tomada e o que foi descartado no caminho. Não é documentação de como o código funciona (isso o código já conta). É memória do raciocínio, pra ninguém refazer a discussão em três meses nem desfazer sem querer algo que foi deliberado. Vivem em `docs/decisions/` de cada projeto, e a constituição manda criar um sempre que a decisão for grande. **133 ADRs em 18 projetos**, levantados do disco em 11-08-2026. O 0001 é quase sempre "arquitetura inicial". ## Severino e satélites <details> <summary><strong>Severino</strong>: 31 ADRs</summary> O projeto mais documentado depois do knowledge. A trilha mostra a evolução: financeiro básico, depois WhatsApp, depois social. 0001 arquitetura inicial · 0002 autenticação Supabase Auth · 0003 banco próprio · 0004 listas de compras · 0005 compartilhamento de lista · 0006 próximos pagamentos · 0007 compra parcelada no cartão · 0008 deploy VPS substitui Severino · 0009 foto de perfil e notificações · 0010 contas múltiplas · 0011 metas **Bloco WhatsApp** (12 a 19): lançamento por WhatsApp · consulta de saldo · desfazer lançamento · resumo pós-lançamento · criar compromisso na agenda · menu e disparo de aviso · consultar agenda · estado de conversa e pendência **Bloco social** (20 a 31): sistema de amigos · compartilhar agenda · cobrança e assinatura · compartilhar compromisso específico · convite de lista exige aceite · onboarding do primeiro login · lista colapsada vira preferência local · sair de lista compartilhada · agenda de convidado só vê e sai · conta família · compartilhar meta com amigo · chatbot financeiro no dashboard </details> <details> <summary><strong>Backend/Severino</strong>: 5 ADRs</summary> 0001 arquitetura inicial · 0002 integração Supabase e ações administrativas · 0003 isenção de cobrança · 0004 tempo extra de teste · 0005 tela de workflow com execuções n8n </details> <details> <summary><strong>Leads/Severino</strong>: 3 ADRs</summary> 0001 tabela `leads` no banco do Severino · 0002 projeto separado do painel admin · 0003 captura em Edge Function Este não tem "arquitetura inicial": começou já decidindo onde a tabela ia morar. </details> ## Suíte AlienUI <details> <summary><strong>MetaAlienUI</strong>: 9 ADRs</summary> 0001 arquitetura inicial · 0002 token colado em vez de OAuth · 0003 gestão de campanhas · 0004 conjuntos de anúncios · 0005 ad criativo · 0006 melhorias de engajamento, vendas e upload · 0007 páginas de detalhe separadas · 0008 split meta-kit e insta-kit · 0009 tela de login própria </details> <details> <summary><strong>InstaAlienUI</strong>: 4 ADRs, com buraco na numeração</summary> 0001 arquitetura inicial · 0002 token colado em vez de OAuth · **0008** split meta-kit e insta-kit · 0009 upload de mídia Pula do 0002 pro 0008 porque nasceu de um split: os ADRs 3 a 7 aconteceram enquanto ainda era MetaAlienUI. A numeração foi mantida de propósito, pra não fingir uma história que não houve. </details> <details> <summary><strong>IconsAlienUI</strong>: 6 ADRs</summary> 0001 arquitetura inicial · 0002 pivot para logos de marca · 0003 aba illustration (reicon) · 0004 aba illustration (personagens) · 0005 editor genérico de icons e illustration · 0006 entrada na suíte AlienUI </details> <details> <summary><strong>NotesAlienUI</strong>: 5 ADRs</summary> 0001 arquitetura inicial · 0002 login próprio, domínio fora da suíte · 0003 sem autenticação por enquanto · 0004 redesign estilo notepad · 0005 accordion na prévia de markdown Os 0002 e 0003 são o par mais instrutivo do seu portfólio: o 0002 implementou login que você não pediu, o 0003 removeu. É de lá que veio a lição de não presumir "a opção mais segura" quando a resposta foi ambígua. O 0005 é de hoje, e é o que faz estas notas colapsarem. </details> <details> <summary><strong>DashboardAlienUI</strong>: 4 ADRs</summary> 0001 arquitetura inicial · 0002 login único da suíte · 0003 multiusuário, permissões e banco · 0004 banco Turso </details> <details> <summary><strong>GravadorAlienUI</strong>: 3 ADRs</summary> 0001 arquitetura inicial · 0002 tema sem next-themes · 0003 deploy de produção </details> ## Base de conhecimento <details> <summary><strong>knowledge</strong>: 41 ADRs, o mais documentado</summary> Quase um terço do total. Faz sentido: é o projeto cujo produto **é** a regra, então cada decisão de formato precisa ficar escrita, senão a base fica inconsistente. **Fundação** (1 a 10): arquitetura · árvore de categorias e gate de schema · procedência de fontes · gabarito de página primitiva e fronteira de camada · gabarito de página de estilo e anti-espelho · registry como fonte e sidecar de procedência · verificação da página Base UI contra o pacote real · completude de classe como requisito · política de verificação por página · índice llms e fechamento do gate 3 **Formato e fronteiras** (11 a 19): índice valida descoberta · fronteira do posicionamento · esqueleto JSX em página de estilo composta · instalação via CLI · preview como fonte de verdade executável · landing derivada do pagetree · allowlist de headings no check-layer · tabela única de data-atributos **Experimentos e vereditos** (20 a 29): delegabilidade (exp. 0005) · fonte única de gabarito, gate e convenções · segunda rodada do exp. 0005 (select) · prosa é lida, posição estrutural é seguida · preview vira heading exemplo · preview fatiado por variante · escopo declarado no llms.txt · heading fino vira frase explícita · veredito da skill documentar-componente (exp. 0007) · lacuna declarada não preenchida **Consolidação** (30 a 42): homônimo sem relação de camada · só documenta o que a fonte não entrega · dicionário canônico de data-atributos · sem primitivo Base UI vira ausência declarada · selector morto marca por linha · veredito do teste de fumaça (exp. 0008) · protocolo do teste de aceitação dos agentes · veredito do teste de aceitação · protocolo do teste corrigido de classe literal · veredito do teste corrigido · formato único de página · retificação do seletor morto de orientação · seção documentos **Não existe 0017.** A numeração pula, o que é ruído a corrigir ou explicar num README de `docs/decisions/`. </details> ## Ferramentas e infra <details> <summary><strong>UI/uicomponents</strong>: 7 ADRs</summary> 0001 arquitetura inicial · 0002 registry shadcn · 0003 cadastro in-app · 0004 conhecimentos · 0005 seções da sidebar · 0006 cadastro automático · 0007 preview genérico </details> <details> <summary><strong>stack-ia-local</strong>: 5 ADRs</summary> 0001 arquitetura inicial · 0002 troca para Qwen3-4B · 0003 exposição na rede local · 0004 watchdog de travamento do n8n · 0005 SearXNG para busca web </details> <details> <summary><strong>dispositivos</strong>: 3 ADRs</summary> 0001 arquitetura inicial · 0002 PWA standalone · 0003 flag de simulação </details> <details> <summary><strong>Temas</strong>: 2 ADRs</summary> 0001 arquitetura inicial · 0002 theme builder store </details> <details> <summary><strong>UI/workspace</strong>: 2 ADRs</summary> 0001 arquitetura inicial · 0002 Auxiliar, browser logado na VPS </details> <details> <summary><strong>Um ADR só</strong>: 3 projetos</summary> **Firecrawl**, **RF Energia/rfenergia-app** e **tsx-playground** têm apenas o 0001 de arquitetura inicial. Não é falha: são projetos que não tomaram decisão estrutural nova depois do começo. </details> ## Quem não tem nenhum `biblioteca-componentes`, `ia-scaffold`, `teste-shadcn`, `bonjourr`, `Mnemosine`, `opencode-mcp-server`, `support-ui`, `firecrawl-selfhost`, `tiktok-video`, `EditAlenUI` e os projetos em `Others`. Os três primeiros são os mesmos que estão **sem git**. Projeto sem versionamento e sem decisão registrada é o que some sem deixar rastro do porquê existia.

1161 palavras · 7853 caracteres · 6 min de leitura11 de ago., 09:13