@girardelli/architect 2.2.0 → 4.0.0

package/__test_agent_output__/workflows/new-feature.md

@@ -0,0 +1,311 @@
+---
+antigravity:
+  trigger: 'on_demand'
+  description: 'Workflow completo para nova feature em test-project'
+---
+
+# 🚀 Workflow: Nova Feature
+
+> **Este workflow é OBRIGATÓRIO para qualquer nova funcionalidade.**
+> Cada step tem um gate de aprovação. Pular steps é violação do protocolo.
+
+---
+
+## Pré-requisitos
+
+```
+□ Li INDEX.md e entendi a estrutura do framework
+□ Li 00-general.md (Regras de Ouro)
+□ Li PREFLIGHT.md e completei TODAS as fases
+□ Li QUALITY-GATES.md e sei quais métricas atender
+□ Estou em uma branch feature/ (NUNCA main/develop)
+```
+
+---
+
+## FASE 0: AÇÃO ZERO — Diagnóstico
+
+> **ANTES de qualquer coisa, fazer diagnóstico do estado atual.**
+
+```bash
+# Estado do projeto
+git branch --show-current
+git status
+
+# Build e testes ANTES de começar
+npm run build && npm run test
+
+# Score atual
+npx @girardelli/architect score .
+
+# Ler lições aprendidas (se existir)
+cat LESSONS-LEARNED.md 2>/dev/null || echo "Sem lessons learned"
+
+# Regras de negócio (se existir)
+cat BUSINESS-RULES.md 2>/dev/null || echo "Sem business rules"
+```
+
+```
+□ Build passando ✓
+□ Testes passando ✓
+□ Score anotado: ___/100 (não pode regredir)
+□ Lessons learned lidos
+```
+
+---
+
+## FASE 1: Diagnóstico da Feature
+
+```
+Quero implementar [NOME DA FEATURE].
+
+Contexto:
+- Quem usa: [usuário / admin / sistema externo / ...]
+- Tem UI: [sim/não]
+- Tem API: [sim/não]
+- Tem banco: [sim/não]
+- Repo: [test-project / monorepo path / ...]
+
+Descrição:
+[2-3 frases do ponto de vista do usuário]
+
+Critérios de aceite:
+- CA1: [critério mensurável]
+- CA2: [critério mensurável]
+- CA3: [critério mensurável]
+```
+
+---
+
+## Step 1: MOCKUP (se tem UI)
+
+> **Gate 1 — Primeiro artefato. Nada começa sem mockup aprovado (quando tem UI).**
+
+```
+╔══════════════════════════════════════════════════════╗
+║  O MOCKUP DEVE CONTER:                               ║
+║                                                       ║
+║  ✓ TODAS as telas/páginas envolvidas                 ║
+║  ✓ Estado: com dados (normal)                        ║
+║  ✓ Estado: vazio (empty state)                       ║
+║  ✓ Estado: carregando (loading)                      ║
+║  ✓ Estado: erro (error state)                        ║
+║  ✓ TODOS os modais / dialogs                         ║
+║  ✓ Mensagens de sucesso                              ║
+║  ✓ Mensagens de erro                                 ║
+║  ✓ Fluxo completo (passo a passo)                    ║
+║  ✓ Padrão visual do sistema (cores, fontes, layout)  ║
+║                                                       ║
+║  Formato: HTML interativo ou imagens anotadas        ║
+╚══════════════════════════════════════════════════════╝
+```
+
+**Apresentar ao humano → Aguardar `/approved`**
+
+---
+
+## Step 2: User Stories
+
+> **Gate 2 — Histórias de usuário com critérios de aceite mensuráveis.**
+
+Formato:
+
+```markdown
+## US-001: [Título]
+
+**Como** [ator],
+**Quero** [ação],
+**Para** [benefício].
+
+### Critérios de Aceite
+- CA1: [critério mensurável]
+- CA2: [critério mensurável]
+
+### Regras de Negócio
+- RN1: [regra]
+
+### Exceções
+- E1: Se [condição], então [comportamento]
+```
+
+**Apresentar ao humano → Aguardar `/approved`**
+
+---
+
+## Step 3: Arquitetura (C4)
+
+> **Gate 3 — Visão técnica da implementação.**
+
+Usar template [C4.md](../templates/C4.md):
+
+```
+Nível 1 — Contexto: Quem são os atores e sistemas externos?
+Nível 2 — Container: Quais serviços/apps são afetados?
+Nível 3 — Componente: Quais módulos/classes são criados/modificados?
+Nível 4 — Código: Interfaces, DTOs, entidades (se complexo)
+```
+
+Se a decisão é significativa → criar ADR (template [ADR.md](../templates/ADR.md))
+
+**Apresentar ao humano → Aguardar `/approved`**
+
+---
+
+## Step 4: Task Breakdown
+
+> **Gate 4 — Lista de tarefas com estimativa.**
+
+Formato:
+
+```markdown
+## TASK-001: [Título]
+- **US:** US-001
+- **Camada:** Backend / Frontend / App / Database
+- **Estimativa:** XS / S / M / L / XL
+- **Agente:** [quem executa]
+- **Deps:** [depende de TASK-XXX, se houver]
+```
+
+Ordenar por dependência. Backend SEMPRE primeiro.
+
+**Apresentar ao humano → Aguardar `/approved`**
+
+---
+
+## Step 5: BDD (Cenários)
+
+> **Gate 5 — Cenários de comportamento para cada critério de aceite.**
+
+Formato (Gherkin):
+
+```gherkin
+Feature: [Nome da Feature]
+
+  Scenario: [cenário happy path]
+    Given [contexto]
+    When [ação do usuário]
+    Then [resultado esperado]
+
+  Scenario: [cenário de erro]
+    Given [contexto]
+    When [ação inválida]
+    Then [mensagem de erro esperada]
+
+  Scenario: [cenário edge case]
+    Given [contexto específico]
+    When [ação]
+    Then [comportamento esperado]
+```
+
+**Apresentar ao humano → Aguardar `/approved`**
+
+---
+
+## Step 6: TDD (Casos de Teste)
+
+> **Gate 6 — Casos de teste ANTES do código.**
+
+```
+Para cada TASK:
+  1. Listar os testes que serão escritos
+  2. Descrever input → output esperado
+  3. Incluir testes de erro/exceção
+  4. Incluir testes de boundary
+
+Meta: Cobertura ≥ 80% (INEGOCIÁVEL)
+```
+
+**Apresentar ao humano → Aguardar `/approved`**
+
+---
+
+## Step 7: Implementação — Backend
+
+> **SOMENTE após TODOS os 6 gates aprovados.**
+
+```
+□ Criar/modificar entities e DTOs
+□ Criar/modificar services (lógica de negócio)
+□ Criar/modificar controllers (endpoints)
+□ Criar migrations (se houver alteração de banco)
+□ Escrever testes (RED → GREEN → REFACTOR)
+□ Rodar: build ✓ + tests ✓ + coverage ≥ 80% ✓
+```
+
+---
+
+## Step 8: Documento de Integração
+
+> **OBRIGATÓRIO se tem frontend/app. Gerado APÓS backend completo.**
+
+```markdown
+# Documento de Integração: [Feature]
+
+## Endpoints
+
+### [METHOD] /api/v1/[recurso]
+
+**Request:**
+\`\`\`json
+{
+  "campo": "tipo — descrição"
+}
+\`\`\`
+
+**Response (200):**
+\`\`\`json
+{
+  "campo": "tipo — descrição"
+}
+\`\`\`
+
+**Erros:**
+| Código | Mensagem | Quando |
+|--------|----------|--------|
+| 400 | Validation error | Input inválido |
+| 404 | Not found | Recurso inexistente |
+
+## Regras
+- [regra 1]
+- [regra 2]
+```
+
+---
+
+## Step 9: Implementação — Frontend / App
+
+> **Baseado no Documento de Integração.**
+
+```
+□ Criar/modificar componentes (seguir mockup)
+□ Implementar state management
+□ Integrar com endpoints (conforme doc de integração)
+□ Implementar TODOS os estados (loading, error, empty, data)
+□ Escrever testes (unitários + e2e se aplicável)
+□ Rodar: build ✓ + tests ✓ + coverage ≥ 80% ✓
+```
+
+---
+
+## Step 10: Verificação Final
+
+```
+╔════════════════════════════════════════════════╗
+║  CHECKLIST FINAL — TODOS devem ser ✓          ║
+║                                                ║
+║  □ Build compila sem erros                     ║
+║  □ TODOS os testes passam                      ║
+║  □ Cobertura ≥ 80 %                         ║
+║  □ Score ≥ 70 /100 (sem regressão)        ║
+║  □ Lint sem errors                             ║
+║  □ Zero anti-patterns CRITICAL novos           ║
+║  □ Todos os critérios de aceite cobertos       ║
+║  □ Documentação atualizada                     ║
+║  □ LESSONS-LEARNED atualizado (se aplicável)   ║
+║  □ PR criado com descrição completa            ║
+╚════════════════════════════════════════════════╝
+```
+
+---
+
+**Gerado por Architect v3.1 · Score: 72/100 · 2026-03-25**

package/__test_agent_output__/workflows/review.md

@@ -0,0 +1,95 @@
+---
+antigravity:
+  trigger: 'on_demand'
+  description: 'Workflow de code review estruturado para test-project'
+---
+
+# 🔍 Workflow: Code Review
+
+> **Code review não é "LGTM".**
+> É uma verificação sistemática em 6 dimensões.
+
+---
+
+## Dimensão 1: Correção Funcional
+
+```
+□ O código faz o que a US/task pede?
+□ Todos os critérios de aceite estão cobertos?
+□ Edge cases foram tratados?
+□ Erros são tratados adequadamente?
+□ Regras de negócio estão corretas?
+```
+
+## Dimensão 2: Qualidade de Código
+
+```
+□ Código legível sem comentários explicativos?
+□ Naming é descritivo e consistente?
+□ Sem duplicação (DRY)?
+□ Funções/métodos com responsabilidade única?
+□ Sem magic numbers (extrair para constantes)?
+□ Tipos corretos (sem `any` / `type: ignore` injustificado)?
+□ Sem código morto / comentado?
+```
+
+## Dimensão 3: Testes
+
+```
+□ Testes existem para o novo código?
+□ Cobertura ≥ 80%?
+□ Testes são significativos (não apenas `expect(true).toBe(true)`)?
+□ Happy path coberto?
+□ Error path coberto?
+□ Edge cases cobertos?
+□ Nenhum teste com .skip() injustificado?
+```
+
+## Dimensão 4: Segurança
+
+```
+□ Sem secrets hardcoded?
+□ Input validado e sanitizado?
+□ SQL injection prevenido (parameterized queries)?
+□ XSS prevenido (output encoding)?
+□ Autenticação/autorização verificada?
+□ Dados sensíveis não logados?
+□ Rate limiting em endpoints novos?
+```
+
+## Dimensão 5: Performance
+
+```
+□ Sem N+1 queries?
+□ Queries com índice adequado?
+□ Sem loops desnecessários sobre coleções grandes?
+□ Lazy loading onde aplicável?
+□ Sem memory leaks óbvios (subscriptions, listeners)?
+□ Caching considerado onde faz sentido?
+```
+
+## Dimensão 6: Arquitetura
+
+```
+□ Segue os padrões do projeto (rules/)?
+□ Camada correta (controller ≠ service ≠ entity)?
+□ Sem violações de layer (data layer acessando UI)?
+□ Score não regrediu: architect score ≥ 70/100
+□ Sem novos anti-patterns CRITICAL?
+□ Imports organizados, sem circulares?
+```
+
+---
+
+## Resultado do Review
+
+| Resultado | Ação |
+|-----------|------|
+| ✅ Aprovado | Merge permitido |
+| ⚠️ Aprovado com observações | Merge permitido, fix no próximo PR |
+| ❌ Mudanças necessárias | Bloquear merge até resolver |
+| 🔴 Bloqueado | Issue de segurança ou regressão — resolver imediatamente |
+
+---
+
+**Gerado por Architect v3.1 · Score: 72/100 · 2026-03-25**

package/__test_context_Rf5fNJ/src/modules/mixed/mixed.ts

@@ -0,0 +1,5 @@
+line1
+line2
+line3
+line4
+line5

package/__test_context_WRCnYH/src/modules/test/test.ts

@@ -0,0 +1,10 @@
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");

package/__test_context_YsnVS3/src/modules/test/test.ts

@@ -0,0 +1,10 @@
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");
+console.log("test");

package/__test_context_w7XZeH/src/modules/mixed/mixed.ts

@@ -0,0 +1,5 @@
+line1
+line2
+line3
+line4
+line5

package/__test_framework__24OjAu/package.json

@@ -0,0 +1 @@
+{"name":"test","dependencies":{"jest":"^29.0.0","express":"^4.18.0"},"devDependencies":{"jest":"^29.0.0"}}

package/__test_framework__3ZDZsx/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+dependencies = [
+  "fastapi>=0.109.0",
+  "uvicorn[standard]>=0.27.0"
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "ruff>=0.1.0"]

package/__test_framework__4T54Jn/package.json

@@ -0,0 +1 @@
+{"name":"test","dependencies":{"jest":"^29.0.0","express":"^4.18.0"},"devDependencies":{"jest":"^29.0.0"}}

package/__test_framework__4tlXu9/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+dependencies = [
+  "fastapi>=0.109.0",
+  "uvicorn[standard]>=0.27.0"
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "ruff>=0.1.0"]

package/__test_framework__6boWqQ/Pipfile

@@ -0,0 +1,6 @@
+[packages]
+tornado = "*"
+peewee = ">=3.0"
+
+[dev-packages]
+pytest = "*"

package/__test_framework__6gygMU/pom.xml

@@ -0,0 +1,10 @@
+<project>
+  <dependencies>
+    <dependency>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+    <dependency>
+      <artifactId>spring-boot-starter-data-jpa</artifactId>
+    </dependency>
+  </dependencies>
+</project>

package/__test_framework__6kxj0N/go.mod

@@ -0,0 +1,8 @@
+module myapp
+
+go 1.21
+
+require (
+  github.com/gin-gonic/gin v1.9.0
+  github.com/labstack/echo v3.3.0
+)

package/__test_framework__7CEoXw/pom.xml

@@ -0,0 +1,10 @@
+<project>
+  <dependencies>
+    <dependency>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+    <dependency>
+      <artifactId>spring-boot-starter-data-jpa</artifactId>
+    </dependency>
+  </dependencies>
+</project>

package/__test_framework__85DDz0/Pipfile

@@ -0,0 +1,6 @@
+[packages]
+tornado = "*"
+peewee = ">=3.0"
+
+[dev-packages]
+pytest = "*"

package/__test_framework__9WrRIr/pom.xml

@@ -0,0 +1,7 @@
+<project>
+  <dependencies>
+    <dependency>
+      <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+  </dependencies>
+</project>

package/__test_framework__ANqGKl/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 7.0.0"
+gem "sinatra"
+gem "rspec"

package/__test_framework__BCXTEM/go.mod

@@ -0,0 +1,3 @@
+module myapp
+go 1.21
+require github.com/gin-gonic/gin v1.9.0

package/__test_framework__BHiPNq/setup.py

@@ -0,0 +1,2 @@
+flask>=2.0
+sqlalchemy>=2.0

package/__test_framework__BqkiKv/package.json

@@ -0,0 +1 @@
+{"name":"test-app","dependencies":{"express":"^4.18.0","@nestjs/core":"^10.0.0"},"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0"}}

package/__test_framework__C5yd8X/Pipfile.lock

@@ -0,0 +1 @@
+{}

package/__test_framework__C5yd8X/requirements.txt

@@ -0,0 +1 @@
+flask>=2.0

package/__test_framework__C87d3a/manage.py

@@ -0,0 +1 @@
+import django

package/__test_framework__C87d3a/requirements.txt

@@ -0,0 +1,2 @@
+django>=4.0
+pytest>=7.0

package/__test_framework__DXNwc5/build.gradle

@@ -0,0 +1,7 @@
+plugins {
+  id 'java'
+}
+
+dependencies {
+  implementation 'io.quarkus:quarkus-core'
+}

package/__test_framework__GhHSt3/build.gradle.kts

@@ -0,0 +1,4 @@
+dependencies {
+  implementation("io.micronaut:micronaut-core")
+  implementation("io.ktor:ktor-server-core")
+}

package/__test_framework__GzklJP/Cargo.toml

@@ -0,0 +1,7 @@
+[package]
+name = "myapp"
+version = "0.1.0"
+
+[dependencies]
+actix-web = "4.4"
+axum = "0.7"

package/__test_framework__H4hd13/go.mod

@@ -0,0 +1,8 @@
+module myapp
+
+go 1.21
+
+require (
+  github.com/gin-gonic/gin v1.9.0
+  github.com/labstack/echo v3.3.0
+)

package/__test_framework__HKjOXO/composer.json

@@ -0,0 +1 @@
+{"require":{"laravel/framework":"^10.0"}}

package/__test_framework__HaDN45/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+gem "rails", "~> 7.0.0"
+gem "rspec"

package/__test_framework__IBO7YG/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+dependencies = [
+  "fastapi>=0.109.0",
+  "sqlalchemy>=2.0",
+  "uvicorn[standard]>=0.27"
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "ruff>=0.1.0"]

package/__test_framework__JwSOyF/pyproject.toml

@@ -0,0 +1,6 @@
+[project]
+dependencies = ["fastapi>=0.109.0"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "ruff>=0.1.0"]
+test = ["hypothesis>=6.0"]

package/__test_framework__K6HrCr/build.gradle

@@ -0,0 +1,2 @@
+plugins { id 'java' }
+dependencies { implementation 'org.springframework.boot:spring-boot' }

package/__test_framework__KzRPlh/pubspec.yaml

@@ -0,0 +1,9 @@
+name: myapp
+description: A Flutter app
+
+flutter:
+  uses-material-design: true
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter

package/__test_framework__L6uIym/pyproject.toml

@@ -0,0 +1,6 @@
+[project]
+dependencies = ["fastapi>=0.109.0"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "ruff>=0.1.0"]
+test = ["hypothesis>=6.0"]

package/__test_framework__LOdoGK/requirements.txt

@@ -0,0 +1,4 @@
+pytest>=7.0
+fastapi>=0.100.0
+flask>=2.0
+black>=23.0

package/__test_framework__LgHzss/package.json

@@ -0,0 +1 @@
+{}

package/__test_framework__M76M6q/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "rails", "~> 7.0.0"
+gem "sinatra"
+gem "rspec"

package/__test_framework__Mr9vWW/composer.json

@@ -0,0 +1 @@
+{"name":"myapp","require":{"laravel/framework":"^10.0","php":"^8.1"}}

package/__test_framework__N03Gnv/package.json

@@ -0,0 +1 @@
+{"name":"test","dependencies":{"express":"^4.18.0"},"devDependencies":{"jest":"^29.0.0"}}

package/__test_framework__Num4UE/requirements

@@ -0,0 +1 @@
+placeholder