@the-bearded-bear/claude-craft 3.0.2 → 3.1.0-next.a356bbd

package/Dev/i18n/pt/Common/agents/ralph-conductor.md

@@ -0,0 +1,146 @@
+---
+name: ralph-conductor
+description: Orquestra sessoes de loop continuo Ralph Wiggum com validacao DoD
+---
+
+# Agente Ralph Conductor
+
+Voce e um agente especializado para orquestrar sessoes de loop continuo Ralph Wiggum. Seu papel e guiar tarefas atraves da execucao iterativa do Claude ate que os criterios de Definition of Done (DoD) sejam atendidos.
+
+## Responsabilidades Principais
+
+### 1. Gerenciamento de Sessao
+- Inicializar sessoes Ralph com configuracao apropriada
+- Acompanhar progresso de iteracoes e metricas
+- Gerenciar estado de sessao e recuperacao
+
+### 2. Validacao Definition of Done
+- Avaliar criterios DoD em cada iteracao
+- Fornecer feedback sobre criterios aprovados/reprovados
+- Sugerir acoes corretivas quando criterios falham
+
+### 3. Monitoramento do Disjuntor
+- Monitorar condicoes de estagnacao (sem progresso)
+- Detectar loops de erro e falhas repetidas
+- Recomendar parar quando apropriado
+
+### 4. Avaliacao de Progresso
+- Avaliar se progresso significativo esta sendo feito
+- Identificar quando tarefas estao bloqueadas
+- Sugerir abordagens alternativas quando necessario
+
+## Modo de Trabalho
+
+Ao orquestrar uma sessao Ralph:
+
+1. **Avaliacao Inicial**
+   - Entender requisitos da tarefa
+   - Identificar criterios de sucesso
+   - Configurar checklist DoD apropriada
+
+2. **Guia de Iteracao**
+   - Fornecer prompts claros e acionaveis
+   - Focar em um objetivo por vez
+   - Construir incrementalmente sobre progresso anterior
+
+3. **Portoes de Qualidade**
+   - Verificar que testes passam antes de continuar
+   - Checar metricas de qualidade de codigo
+   - Validar atualizacoes de documentacao
+
+4. **Sinais de Conclusao**
+   - Indicar claramente quando DoD e atingido
+   - Usar marcador de conclusao: `<promise>COMPLETE</promise>`
+   - Resumir o que foi realizado
+
+## Tipos de Validadores DoD
+
+| Tipo | Quando Usar |
+|------|-------------|
+| `command` | Executar testes, linting, build |
+| `output_contains` | Verificar marcadores de conclusao |
+| `file_changed` | Verificar atualizacoes de documentacao |
+| `hook` | Integrar com portoes de qualidade existentes |
+| `human` | Decisoes criticas que requerem aprovacao |
+
+## Boas Praticas
+
+### Decomposicao de Tarefas
+Decompor tarefas complexas em passos menores e verificaveis:
+1. Escrever teste que falha primeiro (VERMELHO)
+2. Implementar codigo minimo para passar (VERDE)
+3. Refatorar mantendo testes verdes (REFATORAR)
+4. Atualizar documentacao
+5. Sinalizar conclusao
+
+### Indicadores de Progresso
+Incluir marcadores de progresso claros na saida:
+- `[PROGRESSO]` - Fazendo progresso
+- `[BLOQUEADO]` - Obstaculo encontrado
+- `[TESTING]` - Executando verificacao
+- `[COMPLETO]` - Tarefa finalizada
+
+### Tratamento de Erros
+Ao encontrar erros:
+1. Descrever o erro claramente
+2. Analisar causa raiz
+3. Propor solucao
+4. Implementar correcao
+5. Verificar resolucao
+
+## Exemplo de Fluxo de Sessao
+
+```
+Sessao: ralph-1704067200-a1b2
+Tarefa: Implementar autenticacao de usuario
+
+Iteracao 1:
+[PROGRESSO] Analisando estrutura de codigo existente
+- Entidade User encontrada
+- Servico de autenticacao precisa ser criado
+- Diretorio de testes pronto
+
+Iteracao 2:
+[TESTING] Escrevendo testes de autenticacao
+- Criado AuthServiceTest.php
+- 3 casos de teste: login, logout, validateToken
+- Testes atualmente FALHANDO (esperado)
+
+Iteracao 3:
+[PROGRESSO] Implementando AuthService
+- Criado AuthService.php
+- Implementada geracao de token JWT
+- Testes agora PASSANDO
+
+Iteracao 4:
+[PROGRESSO] Atualizando documentacao
+- Secao de autenticacao adicionada ao README
+- Endpoints de API documentados
+
+<promise>COMPLETE</promise>
+
+Resumo:
+- AuthService criado com suporte JWT
+- 3 testes passando
+- Documentacao atualizada
+```
+
+## Pontos de Integracao
+
+- Funciona com comando `/common:ralph-run`
+- Integra com hooks existentes (quality-gate.sh)
+- Compativel com workflow `/project:sprint-dev`
+- Usa principios do `@tdd-coach`
+
+## Quando Parar
+
+Sinalizar conclusao e parar iteracoes quando:
+1. Todos os criterios DoD obrigatorios passam
+2. Objetivos da tarefa completamente atingidos
+3. Testes verificam funcionalidade
+4. Documentacao atualizada
+
+NAO continuar se:
+- Limites do disjuntor atingidos
+- Falhas repetidas indicam problema fundamental
+- Intervencao humana necessaria

package/Dev/i18n/pt/Common/commands/ralph-run.md

@@ -0,0 +1,171 @@
+---
+description: Executar Claude em loop continuo ate completar tarefa (Ralph Wiggum)
+argument-hint: <descricao-tarefa> [--auto|--full]
+---
+
+# Ralph Run - Loop Continuo de Agente IA
+
+Executar Claude em loop continuo ate que a tarefa esteja completa ou os criterios de Definition of Done (DoD) sejam atendidos.
+
+## Argumentos
+
+**$ARGUMENTS**
+
+- `<descricao-tarefa>`: A tarefa para Claude completar
+- `--auto`: Deteccao automatica maxima, perguntas minimas
+- `--full`: Modo completo com todas as verificacoes DoD
+
+## Processo
+
+### 1. Inicializacao de Sessao
+
+1. **Verificar pre-requisitos**:
+   - Verificar se Claude esta disponivel
+   - Procurar configuracao `ralph.yml`
+   - Inicializar diretorio de sessao (`.ralph/`)
+
+2. **Carregar configuracao**:
+   - Ler `ralph.yml` ou `.claude/ralph.yml`
+   - Definir iteracoes max, timeouts, criterios DoD
+
+### 2. Loop Principal
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  LOOP RALPH                                                  │
+│                                                              │
+│  while (iteracoes < max && !DoD_aprovado) {                  │
+│      1. Verificar disjuntor                                  │
+│      2. Invocar Claude com prompt atual                      │
+│      3. Processar saida                                      │
+│      4. Validar Definition of Done                           │
+│      5. Criar checkpoint (commit git)                        │
+│      6. Se DoD nao atendido, usar resposta como prompt       │
+│  }                                                           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 3. Validacao Definition of Done
+
+O sistema DoD valida conclusao atraves de multiplos criterios:
+
+| Validador | Descricao |
+|-----------|-----------|
+| `command` | Executar comando shell (tests, lint, build) |
+| `output_contains` | Verificar padrao na saida do Claude |
+| `file_changed` | Verificar se arquivos foram modificados |
+| `hook` | Executar hook Claude existente |
+| `human` | Validacao humana interativa |
+
+Exemplo DoD em `ralph.yml`:
+
+```yaml
+definition_of_done:
+  checklist:
+    - id: tests
+      name: "Todos os testes passam"
+      type: command
+      command: "docker compose exec app npm test"
+      required: true
+
+    - id: completion
+      name: "Claude sinaliza conclusao"
+      type: output_contains
+      pattern: "<promise>COMPLETE</promise>"
+      required: true
+```
+
+### 4. Disjuntor (Circuit Breaker)
+
+Mecanismo de seguranca para prevenir loops infinitos:
+
+| Gatilho | Limite | Acao |
+|---------|--------|------|
+| Sem alteracoes de arquivos | 3 iteracoes | Parar |
+| Erros repetidos | 5 iteracoes | Parar |
+| Declinio de saida | 70% | Parar |
+| Max iteracoes | 25 (padrao) | Parar |
+
+### 5. Checkpointing
+
+Checkpoints Git sao criados apos cada iteracao para:
+- **Recuperacao**: Restaurar estado anterior se necessario
+- **Historico**: Acompanhar progresso atraves das iteracoes
+- **Revisao**: Inspecionar o que mudou em cada passo
+
+## Saida
+
+```
+╔════════════════════════════════════════════════════════════╗
+║     🔁 Ralph Wiggum - Loop Continuo de Agente IA            ║
+╚════════════════════════════════════════════════════════════╝
+
+✓ Sessao criada: ralph-1704067200-a1b2
+
+ℹ Iniciando loop Ralph...
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Iteracao 1 de 25
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ℹ Invocando Claude...
+ℹ Verificando criterios DoD...
+  ✓ [tests] Todos os testes passam - OK
+  ✓ [lint] Sem erros lint - OK
+  ✓ [completion] Claude sinaliza conclusao - OK
+
+  Todos os criterios obrigatorios aprovados!
+
+✓ DoD APROVADO
+
+╔════════════════════════════════════════════════════════════╗
+║     📊 Resumo da Sessao                                     ║
+╚════════════════════════════════════════════════════════════╝
+
+  ID da sessao:        ralph-1704067200-a1b2
+  Total de iteracoes:  3
+  Duracao:             45s
+  Status DoD:          APROVADO
+  Motivo de saida:     dod_complete
+```
+
+## Configuracao
+
+Criar `ralph.yml` na raiz do projeto:
+
+```yaml
+version: "1.0"
+
+session:
+  max_iterations: 25
+  timeout: 600000
+
+circuit_breaker:
+  enabled: true
+  no_file_changes_threshold: 3
+
+definition_of_done:
+  checklist:
+    - id: tests
+      type: command
+      command: "npm test"
+      required: true
+    - id: completion
+      type: output_contains
+      pattern: "<promise>COMPLETE</promise>"
+      required: true
+```
+
+## Boas Praticas
+
+1. **Descricao clara**: Fornecer tarefas especificas e acionaveis
+2. **Configurar DoD**: Definir criterios de conclusao em `ralph.yml`
+3. **Usar TDD**: Escrever testes primeiro, deixar Ralph implementar
+4. **Monitorar progresso**: Observar saidas de iteracao
+5. **Limites razoaveis**: Ajustar max_iterations conforme complexidade
+
+## Ver tambem
+
+- `@ralph-conductor` - Agente para orquestracao Ralph
+- `/common:fix-bug-tdd` - Correcao de bugs com TDD
+- `/project:sprint-dev` - Desenvolvimento de sprint com TDD

package/Dev/i18n/pt/Common/commands/setup-project-context.md

@@ -0,0 +1,286 @@
+---
+name: setup-project-context
+description: Analisar o codigo e configurar o contexto do projeto interativamente
+arguments:
+  - name: mode
+    description: Modo de detecao (--auto perguntas minimas, --full questionario completo)
+    required: false
+---
+
+# Configuracao do Contexto do Projeto
+
+Configura `.claude/rules/00-project-context.md` analisando o codigo e fazendo perguntas direcionadas.
+
+## Execucao
+
+### Fase 1: Detecao Automatica
+
+Analisar os seguintes arquivos e diretorios:
+
+**Arquivos de Configuracao:**
+- `package.json` → Nome do projeto Node.js, dependencias, scripts
+- `composer.json` → Nome do projeto PHP, dependencias, framework
+- `pubspec.yaml` → Nome do projeto Flutter/Dart, dependencias
+- `requirements.txt` / `pyproject.toml` → Dependencias Python
+- `Cargo.toml` → Projeto Rust
+- `go.mod` → Modulo Go
+
+**Ambiente e Configuracao:**
+- `.env`, `.env.example` → Banco de dados, servicos
+- `config/` → Configuracao do framework
+- `docker-compose.yml` → Servicos (DB, Redis, etc.)
+
+**Estrutura:**
+- `src/`, `lib/`, `app/` → Localizacao do codigo fonte
+- `tests/`, `spec/` → Framework de testes
+- `docs/`, `specifications/` → Documentacao
+- `.github/`, `.gitlab-ci.yml` → CI/CD
+
+**Dominio (se aplicavel):**
+- `src/Entity/`, `src/Domain/` → Entidades de negocio (PHP/Symfony)
+- `lib/models/`, `lib/domain/` → Modelos (Flutter/Dart)
+- `models/`, `schemas/` → Modelos de dados
+- `migrations/` → Schema do banco de dados
+
+Exibir resultados da analise:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║             RESULTADOS DA ANALISE DO PROJETO                  ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Informacoes Detectadas:
+┌─────────────────┬────────────────────────────────┐
+│ Elemento        │ Valor                          │
+├─────────────────┼────────────────────────────────┤
+│ Nome do Projeto │ {nome_detectado}               │
+│ Linguagem       │ {linguagem_detectada}          │
+│ Framework       │ {framework_detectado}          │
+│ Banco de Dados  │ {database_detectado}           │
+│ Testes          │ {testes_detectados}            │
+│ CI/CD           │ {cicd_detectado}               │
+└─────────────────┴────────────────────────────────┘
+
+📁 Estrutura do Projeto:
+{estrutura_detectada}
+
+📄 Documentacao Encontrada:
+{docs_detectados}
+
+❌ Nao Detectado (sera perguntado):
+- {elementos_faltantes}
+```
+
+### Fase 2: Perguntas Interativas
+
+Perguntar apenas sobre informacoes NAO detectadas na Fase 1.
+Pular perguntas se o modo `--auto` for usado e existir um padrao razoavel.
+
+**Perguntas Essenciais:**
+
+1. **Tipo de Aplicacao** (se nao detectado):
+   ```
+   Que tipo de aplicacao e esta?
+   [ ] API REST      [ ] Aplicacao Web     [ ] Aplicativo Movel
+   [ ] Ferramenta CLI [ ] Biblioteca/Pacote [ ] Monorepo
+   ```
+
+2. **Dominio de Negocio**:
+   ```
+   Qual e o dominio de negocio?
+   [ ] E-commerce    [ ] Plataforma SaaS   [ ] FinTech
+   [ ] HealthTech    [ ] EdTech            [ ] Social/Comunidade
+   [ ] Midia/Conteudo [ ] IoT              [ ] Outro: _____
+   ```
+
+3. **Usuarios Alvo** (2-3 personas):
+   ```
+   Descreva seus usuarios principais:
+
+   Usuario Principal:
+   > Funcao: _____
+   > Objetivo principal: _____
+
+   Usuario Secundario (opcional):
+   > Funcao: _____
+   > Objetivo principal: _____
+   ```
+
+4. **Requisitos de Conformidade**:
+   ```
+   Quais requisitos de conformidade se aplicam?
+   [ ] LGPD/GDPR (Protecao de dados)
+   [ ] HIPAA (Saude EUA)
+   [ ] PCI-DSS (Cartoes de pagamento)
+   [ ] SOC2 (Seguranca)
+   [ ] Nenhum / Nao aplicavel
+   ```
+
+**Perguntas Estendidas** (apenas com modo `--full`):
+
+5. **Objetivos de Negocio**:
+   ```
+   Objetivos de curto prazo (3-6 meses):
+   > _____
+
+   Objetivos de medio prazo (6-12 meses):
+   > _____
+   ```
+
+6. **Problemas Conhecidos/Divida Tecnica**:
+   ```
+   Ha problemas conhecidos ou divida tecnica a documentar?
+   > _____
+   ```
+
+7. **Termos do Glossario**:
+   ```
+   Termos de negocio chave para definir (separados por virgula):
+   > _____
+   ```
+
+### Fase 3: Gerar Arquivo de Contexto
+
+Criar `.claude/rules/00-project-context.md`:
+
+```markdown
+# Contexto do Projeto - {NOME_PROJETO}
+
+> Gerado automaticamente por `/common:setup-project-context` em {DATA}
+> Revisar e personalizar conforme necessario.
+
+## Visao Geral
+
+**{NOME_PROJETO}** e uma aplicacao {TIPO} para o dominio {DOMINIO}.
+
+{DESCRICAO_DO_README_OU_USUARIO}
+
+## Stack Tecnico
+
+| Componente   | Tecnologia           |
+|--------------|----------------------|
+| Linguagem    | {LINGUAGEM}          |
+| Framework    | {FRAMEWORK}          |
+| Banco Dados  | {DATABASE}           |
+| Cache        | {CACHE_SE_DETECTADO} |
+| Testes       | {FRAMEWORKS_TESTE}   |
+| CI/CD        | {PLATAFORMA_CICD}    |
+
+## Estrutura do Projeto
+
+```
+{ESTRUTURA_DETECTADA}
+```
+
+## Dominio de Negocio
+
+### Conceitos Chave
+
+{ENTIDADES_SE_DETECTADAS}
+
+### Bounded Contexts
+
+<!-- Adicionar se usar DDD -->
+- Contexto 1: ...
+- Contexto 2: ...
+
+## Usuarios e Personas
+
+### {FUNCAO_USUARIO_PRINCIPAL}
+- **Objetivo:** {OBJETIVO_USUARIO_PRINCIPAL}
+- **Pontos de dor:** A documentar
+- **Fluxos chave:** A documentar
+
+### {FUNCAO_USUARIO_SECUNDARIO}
+- **Objetivo:** {OBJETIVO_USUARIO_SECUNDARIO}
+- **Pontos de dor:** A documentar
+- **Fluxos chave:** A documentar
+
+## Restricoes
+
+### Conformidade
+{REQUISITOS_CONFORMIDADE}
+
+### Metas de Desempenho
+- Tempo de carregamento da pagina: < 3s
+- Tempo de resposta da API: < 200ms
+- Disponibilidade: 99.9%
+
+### Requisitos de Seguranca
+- Conformidade OWASP Top 10
+- Validacao de entrada em todos os endpoints
+- Autenticacao necessaria para recursos protegidos
+
+## Objetivos
+
+### Curto prazo
+{OBJETIVOS_CURTO_PRAZO_OU_PLACEHOLDER}
+
+### Medio prazo
+{OBJETIVOS_MEDIO_PRAZO_OU_PLACEHOLDER}
+
+## Problemas Conhecidos / Divida Tecnica
+
+{PROBLEMAS_OU_PLACEHOLDER}
+
+## Glossario
+
+| Termo | Definicao |
+|-------|-----------|
+{TERMOS_GLOSSARIO_OU_EXEMPLOS}
+```
+
+### Fase 4: Validacao e Proximos Passos
+
+Exibir resumo e recomendacoes:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║              CONTEXTO DO PROJETO GERADO                       ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Arquivo criado: .claude/rules/00-project-context.md
+
+Resumo:
+┌─────────────────┬────────────────────────────────┐
+│ Projeto         │ {NOME_PROJETO}                 │
+│ Tipo            │ {TIPO}                         │
+│ Stack           │ {FRAMEWORK} + {DATABASE}       │
+│ Dominio         │ {DOMINIO}                      │
+│ Conformidade    │ {CONFORMIDADE}                 │
+│ Personas        │ {QUANTIDADE} definidos         │
+└─────────────────┴────────────────────────────────┘
+
+📋 Proximos Passos Recomendados:
+
+1. Revisar arquivo gerado e completar secoes placeholder
+2. Adicionar bounded contexts detalhados se usar DDD
+3. Documentar fluxos de negocio chave
+4. Considerar executar agentes especializados:
+   - @database-architect → Documentar schema do banco de dados
+   - @api-designer → Documentar endpoints da API
+   - @security-reviewer → Revisar restricoes de seguranca
+
+Deseja que eu abra o arquivo para revisao?
+```
+
+## Modos
+
+| Modo | Comportamento |
+|------|---------------|
+| (padrao) | Detecao + perguntas essenciais (tipo, dominio, usuarios, conformidade) |
+| `--auto` | Detecao maxima, pular perguntas com padroes razoaveis |
+| `--full` | Todas as perguntas incluindo objetivos, problemas e glossario |
+
+## Exemplos
+
+```bash
+# Modo padrao - detecao e perguntas equilibradas
+/common:setup-project-context
+
+# Modo auto - interacao minima
+/common:setup-project-context --auto
+
+# Modo completo - questionario exaustivo
+/common:setup-project-context --full
+```