@brunosps00/dev-workflow 0.0.3

package/scaffold/pt-br/commands/run-task.md

@@ -0,0 +1,158 @@
+<system_instructions>
+Você é um assistente IA responsável por implementar tasks de desenvolvimento de software. Sua tarefa é identificar a próxima tarefa disponível, realizar a configuração necessária, implementar e validar antes de commitar.
+
+<critical>Você não deve se apressar para finalizar a tarefa. Sempre verifique os arquivos necessários, verifique os testes, faça um processo de reasoning para garantir tanto a compreensão quanto a execução correta.</critical>
+<critical>A TAREFA NÃO PODE SER CONSIDERADA COMPLETA ENQUANTO TODOS OS TESTES NÃO ESTIVEREM PASSANDO</critical>
+
+## Localização dos Arquivos
+
+- PRD: `ai/spec/prd-[nome-funcionalidade]/prd.md`
+- Tech Spec: `ai/spec/prd-[nome-funcionalidade]/techspec.md`
+- Tasks: `ai/spec/prd-[nome-funcionalidade]/tasks.md`
+- Rules do Projeto: `ai/rules/`
+
+## Etapas para Executar
+
+### 0. Verificar Branch
+- Confirmar que está na branch `feat/prd-[nome-funcionalidade]`
+- Se não estiver: `git checkout feat/prd-[nome-funcionalidade]`
+
+### 1. Configuração Pré-Tarefa
+- Ler a definição da tarefa (`[num]_task.md`)
+- Revisar o contexto do PRD
+- Verificar requisitos da spec técnica (incluindo estratégia de testes)
+- Entender dependências de tarefas anteriores
+
+### 2. Análise da Tarefa
+Analise considerando:
+- Objetivos principais da tarefa
+- Como a tarefa se encaixa no contexto do projeto
+- Alinhamento com regras e padrões do projeto (`ai/rules/`)
+- Possíveis soluções ou abordagens
+
+### 3. Resumo da Tarefa
+
+```
+ID da Tarefa: [ID ou número]
+Nome da Tarefa: [Nome ou descrição breve]
+Contexto PRD: [Pontos principais do PRD]
+Requisitos Tech Spec: [Requisitos técnicos principais]
+Dependências: [Lista de dependências]
+Objetivos Principais: [Objetivos primários]
+Riscos/Desafios: [Riscos ou desafios identificados]
+```
+
+### 4. Plano de Abordagem
+
+```
+1. [Primeiro passo]
+2. [Segundo passo]
+3. [Passos adicionais conforme necessário]
+```
+
+## Implementação
+
+Após fornecer o resumo e abordagem, **comece imediatamente** a implementar a tarefa:
+- Executar comandos necessários
+- Fazer alterações de código
+- **Implementar testes unitários** (obrigatório para backend)
+- Seguir padrões estabelecidos do projeto
+- Garantir que todos os requisitos sejam atendidos
+- **Rodar testes** conforme o comando de teste do projeto
+
+**VOCÊ DEVE** iniciar a implementação logo após o processo acima.
+
+<critical>Utilize o Context7 MCP para analisar a documentação da linguagem, frameworks e bibliotecas envolvidas na implementação</critical>
+
+## Notas Importantes
+
+- Sempre verifique contra PRD, spec técnica e arquivo de tarefa
+- Implemente soluções adequadas **sem usar gambiarras**
+- Siga todos os padrões estabelecidos do projeto
+
+## Validação Pós-Implementação - Nível 1 (Obrigatório)
+
+<critical>Esta validação é OBRIGATÓRIA antes do commit. Se falhar, corrija e re-valide.</critical>
+
+Após implementar, execute a validação leve (Nível 1):
+
+### Checklist de Critérios de Aceite
+Para cada critério de aceitação definido na task:
+- Verificar se foi implementado com evidência no código
+- Se algum critério não foi atendido: **CORRIJA antes de prosseguir**
+
+### Execução de Testes
+- [ ] Todos os testes passam (existentes + novos)
+- [ ] Novos testes foram criados para código novo
+- Se algum teste falha: **CORRIJA antes de prosseguir**
+
+### Verificação de Padrões Básicos
+- [ ] Tipos explícitos (sem `any`)
+- [ ] Código compila sem erros
+- [ ] Lint passa
+- [ ] Padrões do projeto seguidos (`ai/rules/`)
+
+### Verificação de UI Funcional (para tasks com frontend)
+<critical>Páginas placeholder/stub NÃO são entrega aceitável para RFs de interação do usuário.</critical>
+- [ ] Cada página/rota criada renderiza conteúdo funcional (NÃO placeholder genérico)
+- [ ] Se a task cobre um RF de listagem: a página mostra tabela/lista com dados reais da API
+- [ ] Se a task cobre um RF de criação: a página tem formulário/dialog funcional
+- [ ] Se a task cobre um RF de configuração: a página exibe e permite editar os parâmetros
+- [ ] Nenhuma página mostra mensagem genérica como "fundação inicial", "base protegida" ou "placeholder"
+- Se alguma verificação falha: **a task NÃO está completa — implemente a UI real antes de commitar**
+
+### Documentação de Artefatos Criados (OBRIGATÓRIO)
+
+<critical>
+Ao finalizar cada task, REGISTRAR no tasks.md do projeto uma seção "Artefatos Criados" com:
+
+1. **Rotas de API novas**: método + path (ex: `GET /modulo/recurso`)
+2. **Páginas de frontend novas**:
+   - URL (ex: `/modulo/pagina`)
+   - Como é acessada: via menu (item do sidebar) OU via link em outra página (especificar qual)
+3. **Componentes reutilizáveis criados**: nome + localização
+
+Uma página que NÃO é acessível pelo menu NEM por outra página é INÚTIL — garantir que
+toda página nova tenha pelo menos um caminho de acesso para o usuário.
+</critical>
+
+Formato no tasks.md (adicionar após marcar a task como concluída):
+
+```markdown
+### Artefatos da Task X.0
+
+| Artefato | Tipo | Acesso |
+|----------|------|--------|
+| `GET /modulo/recurso` | API | — |
+| `/modulo/pagina` | Página | Menu: Módulo > Item |
+| `ComponenteScreen` | Componente | Usado por páginas X, Y, Z |
+```
+
+### Resultado da Validação
+- **Se TUDO OK**: Prossiga para o commit
+- **Se FALHA**: Corrija os problemas e re-execute a validação
+- **NÃO gere relatório em arquivo** - apenas output no terminal
+
+## Commit Automático (Obrigatório)
+
+Ao final da task (após validação Nível 1 passar), **sempre** fazer commit (sem push):
+
+```bash
+git status
+git add .
+git commit -m "feat([modulo]): [descrição concisa]
+
+- [item 1 implementado]
+- [item 2 implementado]
+- Add unit tests"
+```
+
+**Nota**: O push será feito apenas no `/gerar-pr` ao final de todas as tasks.
+
+<critical>Após completar a tarefa, marque como completa em tasks.md</critical>
+
+## Próximos Passos
+
+- Se há mais tasks: `/executar-task [próxima-task]`
+- Se última task: `/gerar-pr [branch-alvo]` (ex: `/gerar-pr main`)
+</system_instructions>

package/scaffold/pt-br/templates/bugfix-template.md

@@ -0,0 +1,91 @@
+# Bugfix: [Nome do Bug]
+
+## Resumo do Problema
+
+| Campo | Valor |
+|-------|-------|
+| **Projeto(s) Afetado(s)** | [projeto1, projeto2, etc.] |
+| **Severidade** | [crítico / alto / médio / baixo] |
+| **Ambiente** | [produção / staging / desenvolvimento] |
+| **Reportado em** | [data] |
+| **Reportado por** | [nome/canal] |
+
+## Descrição do Bug
+
+[Descreva o comportamento incorreto observado. Seja específico sobre o que acontece vs o que deveria acontecer.]
+
+## Passos para Reprodução
+
+1. [Passo 1]
+2. [Passo 2]
+3. [Passo 3]
+4. [Resultado observado]
+
+**Dados de teste:** [Se aplicável, inclua dados necessários para reproduzir]
+
+## Comportamento Esperado
+
+[Descreva o comportamento correto que deveria ocorrer]
+
+## Evidências
+
+### Logs/Stack Trace
+```
+[Cole logs relevantes ou stack traces]
+```
+
+### Screenshots/Vídeos
+[Se aplicável]
+
+### Commits Relacionados
+- [hash] - [descrição]
+
+## Análise de Causa Raiz
+
+### Sintoma
+[O que o usuário observa]
+
+### Causa Identificada
+[Explicação técnica da causa do bug]
+
+### Arquivos Afetados
+| Arquivo | Tipo de Mudança | Descrição |
+|---------|-----------------|-----------|
+| [path] | [fix/test/config] | [o que mudar] |
+
+## Impacto
+
+### Usuários Afetados
+[Quantos usuários? Quais personas?]
+
+### Funcionalidades Impactadas
+[Lista de funcionalidades que dependem do código com bug]
+
+### Risco de Regressão
+[baixo / médio / alto] - [justificativa]
+
+## Solução Proposta
+
+[Descreva a abordagem para correção em alto nível]
+
+### Alternativas Consideradas
+| Alternativa | Prós | Contras |
+|-------------|------|---------|
+| [opção 1] | | |
+| [opção 2] | | |
+
+## Critérios de Aceitação
+
+- [ ] Bug não se reproduz mais nos passos descritos
+- [ ] Testes automatizados cobrem o cenário
+- [ ] Não há regressão em funcionalidades relacionadas
+- [ ] [Outros critérios específicos]
+
+## Fora de Escopo
+
+[O que NÃO será corrigido neste bugfix - melhorias futuras, refatorações, etc.]
+
+## Questões em Aberto
+
+- [ ] [Pergunta 1]
+- [ ] [Pergunta 2]

package/scaffold/pt-br/templates/prd-template.md

@@ -0,0 +1,70 @@
+# Template de Documento de Requisitos de Produto (PRD)
+
+## Visão Geral
+
+[Forneça uma visão geral de alto nível do seu produto/funcionalidade. Explique qual problema resolve, para quem é e por que é valioso.]
+
+## Objetivos
+
+[Liste objetivos específicos e mensuráveis para esta funcionalidade:
+
+- Como é o sucesso
+- Métricas principais para acompanhar
+- Objetivos de negócio a alcançar]
+
+## Histórias de Usuário
+
+[Detalhe as narrativas do usuário descrevendo uso e benefícios da funcionalidade:
+
+- Como [tipo de usuário], eu quero [realizar uma ação] para que [benefício]
+- Inclua personas de usuários primários e secundários
+- Cubra fluxos principais e casos extremos]
+
+## Funcionalidades Principais
+
+[Liste e descreva as funcionalidades principais do seu produto. Para cada funcionalidade, inclua:
+
+- O que ela faz
+- Por que é importante
+- Como funciona em alto nível
+- Requisitos funcionais (numerados para clareza)]
+
+## Experiência do Usuário
+
+[Descreva a jornada e experiência do usuário:
+
+- Personas de usuário e suas necessidades
+- Fluxos e interações principais do usuário
+- Considerações e requisitos de UI/UX
+- Requisitos de acessibilidade]
+
+## Restrições Técnicas de Alto Nível
+
+[Capture apenas restrições e considerações de alto nível (evite soluções de design -- essas pertencem à Tech Spec):
+
+- Integrações externas requeridas ou sistemas existentes para interfacear
+- Mandatos de conformidade, regulatórios ou de segurança
+- Metas de performance/escalabilidade (ex: TPS esperado, limites superiores de latência)
+- Considerações de sensibilidade de dados/privacidade
+- Requisitos não negociáveis de tecnologia ou protocolo
+
+Detalhes de implementação serão abordados na Especificação Técnica.]
+
+## Fora de Escopo
+
+[Declare claramente o que esta funcionalidade NÃO incluirá para gerenciar o escopo:
+
+- Funcionalidades explicitamente excluídas
+- Considerações futuras que estão fora de escopo
+- Limites e limitações
+
+(Nota: Riscos de implementação técnica serão detalhados na Tech Spec.)]
+
+## Questões em Aberto
+
+[Liste quaisquer questões restantes ou áreas precisando de esclarecimento adicional:
+
+- Requisitos não claros ou casos extremos
+- Perguntas sobre necessidades do usuário ou objetivos de negócio
+- Dependências de fatores de negócio externos
+- Áreas requerendo design ou pesquisa de usuário]

package/scaffold/pt-br/templates/task-template.md

@@ -0,0 +1,62 @@
+# Tarefa X.0: [Título da Tarefa Principal]
+
+<critical>Ler os arquivos de prd.md e techspec.md desta pasta, se você não ler esses arquivos sua tarefa será invalidada</critical>
+
+## Visão Geral
+
+[Breve descrição da tarefa]
+
+**Requisitos Funcionais cobertos**: RF[X.Y], RF[X.Z] (máximo 2 por task)
+
+<requirements>
+[Lista de requisitos obrigatórios]
+</requirements>
+
+## Subtarefas
+
+### Implementação
+- [ ] X.1 [Descrição da subtarefa]
+- [ ] X.2 [Descrição da subtarefa]
+
+### Testes Unitários (Obrigatório para Backend)
+- [ ] X.3 Criar testes para [service/use-case]
+- [ ] X.4 Criar testes para [controller/adapter]
+
+## Testes Unitários
+
+### Casos a Testar
+
+| Método | Casos |
+|--------|-------|
+| `[método1]` | Happy path, edge case, erro |
+| `[método2]` | Happy path, not found |
+
+### Mocks Necessários
+- `[repositório/service]` - mockado via mock function
+
+## Detalhes de Implementação
+
+[Seções relevantes da spec técnica - referencie a techspec.md ao invés de duplicar conteúdo]
+
+## Critérios de Sucesso
+
+- [Resultados mensuráveis]
+- [Requisitos de qualidade]
+- **Testes unitários passando**
+- **Cobertura mínima 80%** em services/use-cases
+
+## Arquivos Relevantes
+- [Arquivos relevantes desta tarefa]
+- [Arquivo].spec.ts - Testes unitários
+
+## Commit ao Final
+
+Ao completar esta task, fazer commit:
+```bash
+git add .
+git commit -m "feat([modulo]): [descrição]
+
+- [item 1]
+- [item 2]
+- Add unit tests"
+```

package/scaffold/pt-br/templates/tasks-template.md

@@ -0,0 +1,34 @@
+# Resumo de Tarefas de Implementação de [Funcionalidade]
+
+## Branch
+
+```
+feat/prd-[nome-funcionalidade]
+```
+
+## Projetos Impactados
+
+- [ ] [Projeto 1]
+- [ ] [Projeto 2]
+
+## Tarefas
+
+| Task | Descrição | RFs | Status |
+|------|-----------|-----|--------|
+| 1.0 | [Título] | RF1.1, RF1.2 | Pendente |
+| 2.0 | [Título] | RF2.1 | Pendente |
+| 3.0 | [Título] | RF3.1, RF3.2 | Pendente |
+
+## Progresso
+
+- [ ] 1.0 Título da Tarefa Principal
+- [ ] 2.0 Título da Tarefa Principal
+- [ ] 3.0 Título da Tarefa Principal
+
+## Workflow
+
+Cada task segue o fluxo:
+1. `/executar-task [N]_task.md` - Implementa a task
+2. Testes unitários incluídos na implementação
+3. Commit ao final da task (sem push)
+4. Próxima task ou `/gerar-pr [branch-alvo]` quando todas concluídas

package/scaffold/pt-br/templates/techspec-template.md

@@ -0,0 +1,123 @@
+# Template de Especificação Técnica
+
+## Resumo Executivo
+
+[Forneça uma breve visão técnica da abordagem de solução. Resuma as decisões arquiteturais principais e a estratégia de implementação em 1-2 parágrafos.]
+
+## Arquitetura do Sistema
+
+### Visão Geral dos Componentes
+
+[Breve descrição dos componentes principais e suas responsabilidades:
+
+- Nomes dos componentes e funções primárias
+- Relacionamentos principais entre componentes
+- Visão geral do fluxo de dados]
+
+## Design de Implementação
+
+### Interfaces Principais
+
+[Defina interfaces de serviço principais (<=20 linhas por exemplo):
+
+```
+// Exemplo de definição de interface
+type NomeServico interface {
+    NomeMetodo(ctx context.Context, entrada Tipo) (saida Tipo, error)
+}
+```
+
+]
+
+### Modelos de Dados
+
+[Defina estruturas de dados essenciais:
+
+- Entidades de domínio principais (se aplicável)
+- Tipos de requisição/resposta
+- Esquemas de banco de dados (se aplicável)]
+
+### Endpoints de API
+
+[Liste endpoints de API se aplicável:
+
+- Método e caminho (ex: `POST /api/v0/recurso`)
+- Breve descrição
+- Referências de formato requisição/resposta]
+
+## Pontos de Integração
+
+[Inclua apenas se a funcionalidade requer integrações externas:
+
+- Serviços ou APIs externos
+- Requisitos de autenticação
+- Abordagem de tratamento de erros]
+
+## Abordagem de Testes
+
+### Testes Unitários
+
+[Descreva estratégia de testes unitários:
+
+- Componentes principais a testar
+- Requisitos de mock (apenas serviços externos)
+- Cenários de teste críticos]
+
+### Testes de Integração
+
+[Se necessário, descreva testes de integração:
+
+- Componentes a testar juntos
+- Requisitos de dados de teste]
+
+## Sequenciamento de Desenvolvimento
+
+### Ordem de Construção
+
+[Defina sequência de implementação:
+
+1. Primeiro componente/funcionalidade (por que primeiro)
+2. Segundo componente/funcionalidade (dependências)
+3. Componentes subsequentes
+4. Integração e testes]
+
+### Dependências Técnicas
+
+[Liste quaisquer dependências bloqueantes:
+
+- Infraestrutura requerida
+- Disponibilidade de serviço externo]
+
+## Monitoramento e Observabilidade
+
+[Defina abordagem de monitoramento usando infraestrutura existente:
+
+- Métricas a expor
+- Logs principais e níveis de log
+- Integração com dashboards existentes]
+
+## Considerações Técnicas
+
+### Decisões Principais
+
+[Documente decisões técnicas importantes:
+
+- Escolha de abordagem e justificativa
+- Trade-offs considerados
+- Alternativas rejeitadas e por quê]
+
+### Riscos Conhecidos
+
+[Identifique riscos técnicos:
+
+- Desafios potenciais
+- Abordagens de mitigação
+- Áreas precisando pesquisa]
+
+### Conformidade com Padrões
+
+[Pesquise as rules em `ai/rules/` que se encaixam nesta techspec e liste-as abaixo:]
+
+### Arquivos Relevantes
+
+[Liste aqui arquivos relevantes do projeto]

package/scaffold/rules-readme.md

@@ -0,0 +1,25 @@
+# Project Rules
+
+This directory contains auto-generated project rules created by the `analyze-project` command.
+
+## How to populate
+
+Run the `/analyze-project` command inside your AI assistant to scan your codebase and generate:
+
+- `index.md` — Project overview, stack summary, quick reference
+- `{module}.md` — Per-module detailed rules with patterns and conventions
+
+## Structure
+
+```
+ai/rules/
+├── README.md          # This file
+├── index.md           # Project overview (auto-generated)
+└── {module}.md        # Per-module rules (auto-generated)
+```
+
+## Usage
+
+These rules are automatically read by workflow commands (`create-prd`, `create-techspec`, `run-task`, etc.) to ensure generated artifacts follow your project's conventions.
+
+Re-run `/analyze-project` whenever your stack or conventions change significantly.