@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/pt/ReactNative/templates/test-component.md

@@ -0,0 +1,225 @@
+# Template: Teste de Componente
+
+## Estrutura de Teste
+
+```typescript
+// components/{{CATEGORY}}/{{COMPONENT_NAME}}/{{COMPONENT_NAME}}.test.tsx
+import React from 'react';
+import { render, fireEvent, waitFor } from '@testing-library/react-native';
+import { {{COMPONENT_NAME}} } from './{{COMPONENT_NAME}}';
+import type { {{COMPONENT_NAME}}Props } from './{{COMPONENT_NAME}}.types';
+
+// Mockar dependências se necessário
+jest.mock('@/services/api', () => ({
+  api: {
+    getData: jest.fn(),
+  },
+}));
+
+describe('{{COMPONENT_NAME}}', () => {
+  // Props padrão
+  const defaultProps: {{COMPONENT_NAME}}Props = {
+    prop1: 'valor de teste',
+    onAction: jest.fn(),
+  };
+
+  // Função auxiliar para renderizar componente
+  const renderComponent = (props: Partial<{{COMPONENT_NAME}}Props> = {}) => {
+    return render(<{{COMPONENT_NAME}} {...defaultProps} {...props} />);
+  };
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe('Renderização', () => {
+    it('renderiza corretamente', () => {
+      const { getByText } = renderComponent();
+      expect(getByText('valor de teste')).toBeTruthy();
+    });
+
+    it('renderiza com props personalizadas', () => {
+      const { getByText } = renderComponent({ prop1: 'valor personalizado' });
+      expect(getByText('valor personalizado')).toBeTruthy();
+    });
+
+    it('renderiza children', () => {
+      const { getByText } = render(
+        <{{COMPONENT_NAME}} {...defaultProps}>
+          <Text>Conteúdo filho</Text>
+        </{{COMPONENT_NAME}}>
+      );
+      expect(getByText('Conteúdo filho')).toBeTruthy();
+    });
+  });
+
+  describe('Interações', () => {
+    it('chama onAction quando pressionado', () => {
+      const onAction = jest.fn();
+      const { getByText } = renderComponent({ onAction });
+
+      fireEvent.press(getByText('valor de teste'));
+
+      expect(onAction).toHaveBeenCalledTimes(1);
+    });
+
+    it('não chama onAction quando desabilitado', () => {
+      const onAction = jest.fn();
+      const { getByText } = renderComponent({ onAction, disabled: true });
+
+      fireEvent.press(getByText('valor de teste'));
+
+      expect(onAction).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('Estados', () => {
+    it('mostra estado de carregamento', () => {
+      const { getByTestId } = renderComponent({ isLoading: true });
+      expect(getByTestId('loading-spinner')).toBeTruthy();
+    });
+
+    it('mostra estado de erro', () => {
+      const error = new Error('Erro de teste');
+      const { getByText } = renderComponent({ error });
+      expect(getByText('Erro de teste')).toBeTruthy();
+    });
+
+    it('mostra estado vazio', () => {
+      const { getByText } = renderComponent({ data: [] });
+      expect(getByText('Nenhum dado disponível')).toBeTruthy();
+    });
+  });
+
+  describe('Comportamento Assíncrono', () => {
+    it('carrega dados assincronamente', async () => {
+      const { getByText, queryByTestId } = renderComponent();
+
+      // Inicialmente carregando
+      expect(queryByTestId('loading-spinner')).toBeTruthy();
+
+      // Aguardar carregamento de dados
+      await waitFor(() => {
+        expect(getByText('Dados carregados')).toBeTruthy();
+      });
+
+      // Loading spinner deve ter sumido
+      expect(queryByTestId('loading-spinner')).toBeNull();
+    });
+
+    it('trata erros assíncronos', async () => {
+      // Mock API para lançar erro
+      const { getByText } = renderComponent();
+
+      await waitFor(() => {
+        expect(getByText('Erro ocorreu')).toBeTruthy();
+      });
+    });
+  });
+
+  describe('Acessibilidade', () => {
+    it('tem labels de acessibilidade corretos', () => {
+      const { getByLabelText } = renderComponent();
+      expect(getByLabelText('{{COMPONENT_NAME}}')).toBeTruthy();
+    });
+
+    it('é acessível', () => {
+      const { getByRole } = renderComponent();
+      expect(getByRole('button')).toBeTruthy();
+    });
+  });
+
+  describe('Estilização', () => {
+    it('aplica estilo personalizado', () => {
+      const customStyle = { backgroundColor: 'red' };
+      const { getByTestId } = renderComponent({ style: customStyle });
+
+      const component = getByTestId('{{COMPONENT_NAME}}');
+      expect(component.props.style).toContainEqual(customStyle);
+    });
+  });
+
+  describe('Casos Extremos', () => {
+    it('trata dados nulos', () => {
+      const { getByText } = renderComponent({ data: null });
+      expect(getByText('Sem dados')).toBeTruthy();
+    });
+
+    it('trata props indefinidas', () => {
+      const { getByText } = renderComponent({ prop1: undefined });
+      expect(getByText('Valor padrão')).toBeTruthy();
+    });
+
+    it('trata strings muito longas', () => {
+      const longString = 'a'.repeat(1000);
+      const { getByText } = renderComponent({ prop1: longString });
+      expect(getByText(longString)).toBeTruthy();
+    });
+  });
+});
+```
+
+## Teste de Snapshot
+
+```typescript
+// components/{{CATEGORY}}/{{COMPONENT_NAME}}/{{COMPONENT_NAME}}.snapshot.test.tsx
+import React from 'react';
+import renderer from 'react-test-renderer';
+import { {{COMPONENT_NAME}} } from './{{COMPONENT_NAME}}';
+
+describe('Snapshots {{COMPONENT_NAME}}', () => {
+  it('corresponde ao snapshot', () => {
+    const tree = renderer
+      .create(
+        <{{COMPONENT_NAME}} prop1="test" onAction={() => {}} />
+      )
+      .toJSON();
+    expect(tree).toMatchSnapshot();
+  });
+
+  it('corresponde ao snapshot com children', () => {
+    const tree = renderer
+      .create(
+        <{{COMPONENT_NAME}} prop1="test" onAction={() => {}}>
+          <Text>Child</Text>
+        </{{COMPONENT_NAME}}>
+      )
+      .toJSON();
+    expect(tree).toMatchSnapshot();
+  });
+});
+```
+
+## Teste de Integração
+
+```typescript
+// __tests__/integration/{{COMPONENT_NAME}}.integration.test.tsx
+import { render, fireEvent, waitFor } from '@testing-library/react-native';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { {{COMPONENT_NAME}} } from '@/components/{{CATEGORY}}/{{COMPONENT_NAME}}';
+
+const createWrapper = () => {
+  const queryClient = new QueryClient({
+    defaultOptions: {
+      queries: { retry: false },
+    },
+  });
+
+  return ({ children }: { children: React.ReactNode }) => (
+    <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+  );
+};
+
+describe('Integração {{COMPONENT_NAME}}', () => {
+  it('integra com API', async () => {
+    const { getByText } = render(
+      <{{COMPONENT_NAME}} prop1="test" onAction={() => {}} />,
+      { wrapper: createWrapper() }
+    );
+
+    await waitFor(() => {
+      expect(getByText('Dados carregados')).toBeTruthy();
+    });
+  });
+});
+```

package/Dev/i18n/pt/Symfony/CLAUDE.md.template

@@ -0,0 +1,238 @@
+# Configuration Claude Code - {{PROJECT_NAME}}
+
+> Genere le {{GENERATION_DATE}} - Version 1.0.0
+> Script : install-symfony-rules.sh
+
+## Regles Fondamentales OBLIGATOIRES
+
+### 1. Analyse AVANT Action (CRITIQUE)
+
+**AVANT toute modification (feature/bugfix/refactoring) :**
+
+1. **Lire le code existant concerne**
+2. **Identifier impacts et dependances**
+3. **Documenter l'analyse** (template `.claude/templates/analysis.md`)
+4. **Valider avec utilisateur** si impact significatif
+5. **INTERDIT de coder directement sans cette phase**
+
+### 2. Langues OBLIGATOIRES
+
+| Element | Langue |
+|---------|--------|
+| Code (classes, methodes, variables) | ANGLAIS |
+| Commits | ANGLAIS |
+| Commentaires code | ANGLAIS |
+| Documentation (.md, README) | FRANCAIS |
+| Messages UI/logs | FRANCAIS |
+
+### 3. Architecture OBLIGATOIRE
+
+**Clean Architecture + DDD + Hexagonale**
+
+```
+src/
+├── Domain/              # Coeur metier (AUCUNE dependance externe)
+│   ├── Entity/          # Aggregates roots
+│   ├── ValueObject/     # Objects immuables
+│   ├── Event/           # Domain Events
+│   └── Repository/      # Interfaces repositories
+├── Application/         # Use Cases
+│   ├── Command/         # Commands (write)
+│   ├── Query/           # Queries (read)
+│   └── Handler/         # Handlers
+└── Infrastructure/      # Details techniques
+    ├── Persistence/     # Doctrine repositories impl
+    ├── Http/            # Controllers
+    ├── Email/           # Mailer
+    └── Cache/           # Redis
+```
+
+### 4. Principes SOLID + KISS
+
+- **S** : Une classe = une responsabilite
+- **O** : Extension sans modification
+- **L** : Substitution sans rupture contrat
+- **I** : Interfaces specifiques
+- **D** : Dependre des abstractions
+- **KISS** : Solution la plus simple qui fonctionne
+
+Voir `.claude/rules/04-solid-principles.md` et `05-kiss-dry-yagni.md`
+
+### 5. Docker OBLIGATOIRE
+
+**TOUTE commande DOIT passer par Docker via Makefile**
+
+```bash
+# INTERDIT
+php bin/console ...
+composer install
+
+# OBLIGATOIRE
+make console CMD="..."
+make composer CMD="install"
+```
+
+### 6. Hadolint OBLIGATOIRE
+
+Tout Dockerfile DOIT passer Hadolint sans erreur :
+```bash
+make hadolint
+```
+
+### 7. TDD/BDD OBLIGATOIRE
+
+**RED -> GREEN -> REFACTOR**
+1. Ecrire test AVANT implementation
+2. Test echoue (RED)
+3. Implementer minimum (GREEN)
+4. Refactorer (REFACTOR)
+5. `make quality`
+
+### 8. Qualite OBLIGATOIRE
+
+Apres CHAQUE modification :
+```bash
+make quality  # PHPStan + CS-Fixer + Rector + Deptrac + Tests
+```
+
+### 9. Couverture Tests 80%+
+
+```bash
+make test-coverage  # Genere rapport HTML
+```
+
+## Fichiers de Regles
+
+Consulter OBLIGATOIREMENT selon contexte :
+
+| Contexte | Fichier |
+|----------|---------|
+| Avant modification | `.claude/rules/01-workflow-analysis.md` |
+| Architecture | `.claude/rules/02-architecture-clean-ddd.md` |
+| Standards code | `.claude/rules/03-coding-standards.md` |
+| Design classe | `.claude/rules/04-solid-principles.md` |
+| Simplicite | `.claude/rules/05-kiss-dry-yagni.md` |
+| Docker/Shell | `.claude/rules/06-docker-hadolint.md` |
+| Tests | `.claude/rules/07-testing-tdd-bdd.md` |
+| Qualite | `.claude/rules/08-quality-tools.md` |
+| Git/Commits | `.claude/rules/09-git-workflow.md` |
+| Documentation | `.claude/rules/10-documentation.md` |
+| Securite/RGPD | `.claude/rules/11-security-rgpd.md` |
+| Performance | `.claude/rules/12-performance.md` |
+| Patterns DDD | `.claude/rules/13-ddd-patterns.md` |
+| Multitenant | `.claude/rules/14-multitenant.md` |
+| Doctrine Extensions | `.claude/rules/15-doctrine-extensions.md` |
+| i18n | `.claude/rules/16-i18n.md` |
+| Async/Messenger | `.claude/rules/17-async.md` |
+| Value Objects | `.claude/rules/18-value-objects.md` |
+| Aggregates | `.claude/rules/19-aggregates.md` |
+| Domain Events | `.claude/rules/20-domain-events.md` |
+| CQRS | `.claude/rules/21-cqrs.md` |
+
+## Commandes Makefile
+
+### Docker
+```bash
+make help              # Affiche l'aide
+make up                # Demarre la stack
+make down              # Arrete la stack
+make restart           # Redemarre (down + up)
+make logs              # Logs live
+make build             # Build images
+make shell             # Shell dans container PHP
+```
+
+### PHP / Symfony
+```bash
+make console CMD="cache:clear"    # Symfony console
+make composer CMD="require ..."   # Composer
+```
+
+### Tests
+```bash
+make test              # Tous les tests
+make test-unit         # Tests unitaires
+make test-integration  # Tests integration
+make test-behat        # Tests BDD Behat
+make test-e2e          # Tests end-to-end
+make test-coverage     # Couverture HTML
+make test-mutation     # Mutation testing (Infection)
+```
+
+### Qualite
+```bash
+make quality           # ALL: cs-fix + phpstan + rector + deptrac + hadolint + tests
+make phpstan           # Analyse statique (niveau max)
+make cs-check          # Verif code style
+make cs-fix            # Fix code style
+make rector            # Rector dry-run
+make rector-fix        # Rector apply
+make deptrac           # Architecture boundaries
+make hadolint          # Lint Dockerfiles
+```
+
+### Database
+```bash
+make db-create         # Cree DB
+make db-migrate        # Migrations
+make db-fixtures       # Charge fixtures
+make db-reset          # Drop + Create + Migrate + Fixtures
+```
+
+### Installation
+```bash
+make install           # Installation complete (up + vendor + db-create + db-migrate)
+make vendor            # Composer install
+```
+
+## Stack Technique
+
+{{TECH_STACK}}
+
+## Templates et Checklists
+
+### Templates
+- `.claude/templates/analysis.md` - Analyse prealable
+- `.claude/templates/value-object.md` - Value Object immuable
+- `.claude/templates/service.md` - Service metier
+- `.claude/templates/aggregate-root.md` - Aggregate DDD
+- `.claude/templates/domain-event.md` - Domain Event
+- `.claude/templates/test-unit.md` - Test unitaire TDD
+- `.claude/templates/test-integration.md` - Test integration
+- `.claude/templates/test-behat.md` - Contexte Behat
+
+### Checklists
+- `.claude/checklists/pre-commit.md` - Checklist avant commit
+- `.claude/checklists/new-feature.md` - Checklist nouvelle feature TDD
+- `.claude/checklists/refactoring.md` - Checklist refactoring safe
+- `.claude/checklists/security-rgpd.md` - Checklist audit securite RGPD
+
+### Exemples
+- `.claude/examples/clean-architecture-structure.md` - Organisation dossiers Clean Arch
+- `.claude/examples/value-object-examples.md` - Money, Email, DateRange
+- `.claude/examples/aggregate-examples.md` - Aggregate complet
+- `.claude/examples/domain-event-examples.md` - Domain Events
+
+## Workflow de Developpement
+
+1. **Analyse** -> Consulter `.claude/rules/01-workflow-analysis.md`
+2. **TDD** -> RED -> GREEN -> REFACTOR
+3. **Qualite** -> `make quality` apres chaque changement
+4. **Commit** -> Convention Conventional Commits
+5. **Push** -> Tests CI passent
+
+## Regles Critiques
+
+- **JAMAIS** executer de commande PHP/Composer/Symfony directement
+- **TOUJOURS** passer par `make` et Docker
+- **JAMAIS** commiter sans `make quality` OK
+- **TOUJOURS** ecrire tests AVANT implementation (TDD strict)
+- **TOUJOURS** chiffrer donnees sensibles (RGPD)
+
+<!-- PROJECT-SPECIFIC-START -->
+## Configuration Specifique au Projet
+
+<!-- Ajouter ici la configuration specifique au projet -->
+<!-- Cette section est preservee lors des mises a jour -->
+
+<!-- PROJECT-SPECIFIC-END -->

package/Dev/i18n/pt/Symfony/adr/README.md

@@ -0,0 +1,230 @@
+# Architecture Decision Records (ADR)
+
+> Documentação das decisões arquiteturais importantes do projeto
+
+## O que é um ADR?
+
+Um **Architecture Decision Record** (ADR) é um documento que captura uma decisão arquitetural importante, incluindo:
+- O **contexto** e o problema a resolver
+- As **alternativas** consideradas com suas vantagens/desvantagens
+- A **decisão** tomada e sua justificativa
+- As **consequências** positivas E negativas
+- Os detalhes de **implementação**
+
+**Formato utilizado**: MADR v2.2 (Markdown Any Decision Records)
+
+---
+
+## Índice dos ADRs
+
+### Críticos (P0)
+
+| ADR | Título | Status | Data | Tags |
+|-----|--------|--------|------|------|
+| [0001](0001-halite-encryption.md) | Criptografia Halite para Dados Sensíveis LGPD | ✅ Accepted | 2025-11-26 | security, lgpd, halite |
+| [0002](0002-gedmo-doctrine-extensions.md) | Gedmo Doctrine Extensions para Audit Trail | ✅ Accepted | 2025-11-26 | audit, gedmo, lgpd |
+| [0003](0003-clean-architecture-ddd.md) | Clean Architecture + DDD + Hexagonal | 🔄 Refactoring | 2025-11-26 | architecture, ddd |
+
+### Importantes (P1)
+
+| ADR | Título | Status | Data | Tags |
+|-----|--------|--------|------|------|
+| [0004](0004-docker-multi-stage.md) | Docker Multi-stage para Dev e Prod | ✅ Accepted | 2025-11-26 | docker, infra |
+| [0005](0005-symfony-messenger-async.md) | Symfony Messenger para Emails Assíncronos | 📝 Proposed | 2025-11-26 | async, messaging |
+| [0006](0006-postgresql-database.md) | PostgreSQL 16 como Banco de Dados | ✅ Accepted | 2025-11-26 | database |
+
+### Padrão (P2)
+
+| ADR | Título | Status | Data | Tags |
+|-----|--------|--------|------|------|
+| [0007](0007-easyadmin-backoffice.md) | EasyAdmin para o Backoffice | ✅ Accepted | 2025-11-26 | admin, crud |
+| [0008](0008-tailwind-alpine-frontend.md) | Tailwind CSS + Alpine.js para Frontend | ✅ Accepted | 2025-11-26 | frontend |
+| [0009](0009-phpstan-quality-tools.md) | PHPStan e Ferramentas de Qualidade | ✅ Accepted | 2025-11-26 | quality, phpstan |
+| [0010](0010-conventional-commits.md) | Conventional Commits | ✅ Accepted | 2025-11-26 | git, commits |
+
+### Legenda dos Status
+
+- 📝 **Proposed**: Em discussão, ainda não aceito
+- ✅ **Accepted**: Decisão validada e em produção
+- 🔄 **Refactoring**: Implementação em andamento (migração progressiva)
+- ⚠️ **Deprecated**: Obsoleto, não usar
+- 🔄 **Superseded**: Substituído por um novo ADR (ver link)
+
+---
+
+## Quando Criar um ADR?
+
+### ✅ CRIAR um ADR se:
+
+- **Decisão arquitetural estrutural** impactando > 1 bounded context
+- **Trade-offs significativos** entre várias opções viáveis
+- **Restrição** regulatória/segurança/performance impondo uma escolha
+- **Pergunta recorrente** em code review necessitando resposta oficial
+- **Mudança de paradigma** (ex: sync → async, monolito → microserviços)
+- **Escolha de tecnologia** importante (framework, biblioteca, infraestrutura)
+- **Padrão arquitetural** novo para a equipe
+
+### ❌ NÃO CRIAR um ADR se:
+
+- **Decisão tática local** afetando < 3 arquivos
+- **Bug fix** simples sem impacto arquitetural
+- **CRUD padrão** seguindo padrões existentes
+- **Atualização de dependência menor** (patch/minor version)
+- **Escolha óbvia** sem alternativa viável
+- **Configuração** de ambiente (exceto se impactar segurança/conformidade)
+
+**Regra de ouro**: Em caso de dúvida, discuta com o Lead Dev antes de criar o ADR.
+
+---
+
+## Processo de Criação de um ADR
+
+### 1️⃣ Proposta (Status: Proposed)
+
+```bash
+# 1. Criar branch dedicada
+git checkout -b adr/0011-titulo-decisao
+
+# 2. Copiar o template
+cp .claude/adr/template.md .claude/adr/0011-titulo-decisao.md
+
+# 3. Preencher todas as seções obrigatórias
+# - Mínimo 2 opções com vantagens/desvantagens
+# - Justificativa clara da decisão
+# - Consequências positivas E negativas
+
+# 4. Commit
+git add .claude/adr/0011-titulo-decisao.md
+git commit -m "docs: add ADR-0011 for [titulo] (Proposed)"
+```
+
+### 2️⃣ Discussão (Pull Request)
+
+```bash
+# 5. Push e criar PR
+git push origin adr/0011-titulo-decisao
+
+# 6. Abrir PR com título: [ADR] ADR-0011: Título Decisão
+#    - Tag: [ADR]
+#    - Reviewers: Lead Dev + 1 Senior mínimo
+#    - Descrição: Link para o ADR no corpo do PR
+```
+
+**Elementos a discutir no PR**:
+- Todas as opções foram consideradas?
+- A justificativa é convincente?
+- As consequências negativas são aceitáveis?
+- Há riscos não documentados?
+- A implementação está clara?
+
+### 3️⃣ Aceitação (Status: Accepted)
+
+**Critérios de aceitação**:
+- ✅ Mínimo 2 reviewers aprovaram (Lead Dev + 1 Senior)
+- ✅ Todas as seções obrigatórias preenchidas
+- ✅ Mínimo 2 opções documentadas com prós/contras
+- ✅ Consequências positivas E negativas listadas
+- ✅ Referências a regras/código existente presentes
+- ✅ Exemplos de código concretos (não genéricos)
+
+### 4️⃣ Implementação
+
+```bash
+# Ao implementar a decisão:
+git commit -m "feat: implement [feature] (see ADR-0011)"
+```
+
+### 5️⃣ Superseded (Se Evolução Necessária)
+
+Se uma decisão precisa ser modificada significativamente:
+
+```bash
+# 1. NUNCA excluir o ADR antigo
+# 2. Marcar o ADR antigo como Superseded
+#    Status: Superseded by ADR-0015
+# 3. Criar novo ADR (ADR-0015) explicando:
+#    - Por que a decisão inicial não é mais válida
+#    - O que mudou (contexto, restrições)
+#    - A nova decisão
+# 4. Vincular ambos os ADRs mutuamente
+```
+
+---
+
+## Checklist de Validação
+
+Antes de enviar um ADR no PR, verificar:
+
+- [ ] **Título** claro e descritivo (≤10 palavras)
+- [ ] **Status** correto (Proposed para novo ADR)
+- [ ] **Data** no formato YYYY-MM-DD
+- [ ] **Decisores** listados com nomes completos
+- [ ] **Tags** pertinentes (3-5 tags)
+- [ ] **Contexto** explica claramente o problema (2-3 parágrafos)
+- [ ] **Mínimo 2 opções** documentadas
+- [ ] Cada opção tem **vantagens** E **desvantagens**
+- [ ] **Decisão** justificada em detalhes (por que esta opção?)
+- [ ] **Consequências positivas** listadas (3-5)
+- [ ] **Consequências negativas** listadas honestamente (2-4)
+- [ ] **Riscos** identificados com mitigação
+- [ ] **Implementação**: arquivos afetados listados
+- [ ] **Exemplo de código** concreto do projeto (NÃO genérico)
+- [ ] **Referências** a regras `.claude/`, docs, ADRs relacionados
+- [ ] **Testes** necessários descritos
+- [ ] Revisão de ortografia/gramática
+
+---
+
+## Recursos e Referências
+
+### Documentação Interna
+
+- **Configuração do projeto**: [`.claude/CLAUDE.md`](../CLAUDE.md)
+- **Regras de arquitetura**: [`.claude/rules/02-architecture-clean-ddd.md`](../rules/02-architecture-clean-ddd.md)
+- **Regras de segurança LGPD**: [`.claude/rules/11-security-rgpd.md`](../rules/11-security-rgpd.md)
+- **Templates de desenvolvimento**: [`.claude/templates/`](../templates/)
+- **Checklists de qualidade**: [`.claude/checklists/`](../checklists/)
+
+### Recursos MADR
+
+- [MADR (Markdown Any Decision Records)](https://adr.github.io/madr/) - Formato oficial
+- [ADR Tools](https://github.com/npryce/adr-tools) - CLI para gerenciar ADRs
+- [Architecture Decision Records (Michael Nygard)](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions) - Artigo fundador
+
+---
+
+## Boas Práticas
+
+### ✅ FAZER
+
+- **Seja conciso**: Máximo 2 páginas por ADR (exceto casos excepcionais)
+- **Seja honesto**: Documente desvantagens e riscos
+- **Seja concreto**: Exemplos de código do projeto, não genéricos
+- **Referencie**: Vincule ADRs, regras, código existente
+- **Atualize**: Adicione feedback pós-implementação
+- **Versione**: Numeração sequencial (0001, 0002, ...)
+- **Date**: Data de criação/aceitação clara
+
+### ❌ NÃO FAZER
+
+- **Nunca exclua** um ADR (use Superseded)
+- **Não copie** código das regras (referencie)
+- **Não generalize** em excesso (mantenha o contexto do projeto)
+- **Não esqueça** as consequências negativas (é crucial)
+- **Não atrase**: Crie o ADR ANTES da implementação se possível
+- **Não negligencie** as reviews (2+ reviewers obrigatórios)
+
+---
+
+**Última atualização**: 2025-11-26
+
+- **Total ADRs**: 10
+- **Aceitos**: 9
+- **Propostos**: 1
+- **Refactoring**: 1
+- **Deprecated**: 0
+- **Superseded**: 0
+
+---
+
+*Este README é mantido pela equipe de Arquitetura. Qualquer modificação deve ser validada pelo Lead Dev.*