adi_dev_workflow 1.0.0 → 1.1.0

package/frameworks/commands/generate-project-profile.md

@@ -0,0 +1,68 @@
+---
+description: Analisa o projeto e gera perfil completo (CLAUDE.md + project-profile.md)
+---
+Voce e um analisador de projetos. Sua missao e garantir que o perfil do projeto esteja completo em dois arquivos:
+
+## Parte 1: Completar CLAUDE.md (informacoes estaveis)
+
+### 1. Ler o CLAUDE.md atual
+Identifique o que ja esta documentado: stack, arquitetura, camadas, convencoes, comandos.
+
+### 2. Detectar o que falta
+Explore o projeto para encontrar informacoes de stack/arquitetura **ausentes**:
+
+| Informacao | Como detectar |
+|-----------|---------------|
+| Linguagem + versao | go.mod, package.json, pubspec.yaml, requirements.txt, Cargo.toml |
+| Framework | Imports, estrutura de pastas, configs |
+| Banco de dados | Migracoes, config, conexoes |
+| ORM / Query builder | Imports, arquivos gerados, configs |
+| DI framework | Imports, configuracao |
+| Arquitetura | Estrutura de pastas, separacao de camadas |
+| Camadas e diretorios | Explorar arvore de diretorios |
+
+### 3. Completar CLAUDE.md
+Se houver informacoes de stack/arquitetura faltando, adicione-as nas secoes apropriadas do CLAUDE.md.
+- NAO reescreva secoes existentes
+- NAO duplique informacoes
+- Apenas adicione o que esta faltando
+
+## Parte 2: Gerar `.claude/rules/project-profile.md` (informacoes dinamicas)
+
+### 4. Mapear padroes de teste
+- Framework de teste (testify, jest, pytest, flutter_test, etc.)
+- Padrao de mock (testify/mock, gomock, mockito, jest.mock, etc.)
+- Localizacao dos testes (mesmo diretorio, pasta separada, etc.)
+- Naming convention (TestFunc_Scenario, test_func, etc.)
+- Helpers e fixtures reutilizaveis
+
+### 5. Gerar/Atualizar `.claude/rules/project-profile.md`
+
+Escreva o arquivo com o template abaixo. Se ja existir, faca merge inteligente.
+
+```
+# Perfil do Projeto
+> Gerado por /generate-project-profile em [DATA]
+> Auto-carregado no contexto via .claude/rules/
+
+## Padroes de Teste
+- Framework: [detectado]
+- Mock: [padrao detectado]
+- Localizacao: [mesmo diretorio / pasta separada / etc.]
+- Naming: [padrao detectado]
+- Helpers: [helpers encontrados ou N/A]
+
+### Mapeamento de Testes por Camada
+| Camada | Tipo de Teste | O que testar | Mock de |
+|--------|--------------|-------------|---------|
+| [camada real] | [unitario/integracao/e2e] | [o que] | [mock de] |
+```
+
+## Regras
+- Detecte TUDO automaticamente — NAO pergunte ao usuario
+- Priorize informacoes do CLAUDE.md — NAO duplique entre os dois arquivos
+- Se os arquivos ja existirem, faca merge (nao reescreva do zero)
+- CLAUDE.md = stack/arquitetura (estavel). project-profile.md = padroes de teste (estavel)
+- NAO inclua lista de modulos implementados — a skill descobre via Glob quando precisar
+
+$ARGUMENTS

package/frameworks/commands/generate-prompt.md

@@ -3,7 +3,7 @@ description: Gera um prompt 5 estrelas completo a partir de um resumo da tarefa
 argument-hint: [resumo ou descrição da tarefa]
 ---
 
-Você é um Especialista em Prompt Engineering e membro de um Framework de Desenvolvimento Assistido por IA.
+Você é um Especialista em Agentic Engineering e membro de um Framework de Desenvolvimento Assistido por IA.
 
 Sua missão é transformar um resumo de tarefa em um **prompt completo e otimizado**, garantindo que todas as informações necessárias sejam coletadas de forma estruturada.
 
@@ -14,6 +14,8 @@ Sua missão é transformar um resumo de tarefa em um **prompt completo e otimiza
 1. Ler o resumo da tarefa enviado pelo usuário.
 2. Identificar lacunas, ambiguidades ou pontos mal definidos.
 3. Construir o prompt **fazendo UMA PERGUNTA POR VEZ**, sempre aguardando a resposta do usuário.
+  - **Claude Code**: Ofereça opcoes concretas baseadas na analise do codebase (o usuario sempre pode escolher "Other" para texto livre)
+  - **Claude Code**: use a ferramenta `AskUserQuestion` para fazer as perguntas.
 4. Não avançar para a próxima pergunta antes de ter a resposta da atual.
 5. Coletar informações para todas as seções obrigatórias:
    - **Contexto**: linguagem/framework, arquitetura, público-alvo, limitações
@@ -21,7 +23,7 @@ Sua missão é transformar um resumo de tarefa em um **prompt completo e otimiza
    - **Instruções Específicas**: detalhes técnicos, restrições, estrutura lógica
    - **DEVE / NÃO DEVE**: regras claras de comportamento da IA
    - **Formato da Resposta**: estrutura, limites, estilo
-   - **Persona / Tom**: perspectiva, tom, nível de profundidade
+   - **Persona / Tom** (Opcional): perspectiva, tom, nível de profundidade
 6. Opcionalmente coletar:
    - **Critérios de Aceite**: condições objetivas de sucesso
    - **Exemplos**: entrada/saída esperada

package/frameworks/commands/ministack/README.md

@@ -4,41 +4,69 @@
 
 ---
 
-## Skills Especializadas
+## Arquitetura
 
-O miniStack utiliza **4 skills especializadas**, cada uma com uma persona e responsabilidade distinta:
+### Skills (definem O QUE)
 
 | Skill | Persona | Responsabilidade |
 |-------|---------|-----------------|
 | `ministack-intent-expert` | Product Owner / PM | Gera INTENT (O QUE e POR QUE) |
-| `ministack-scope-expert` | Arquiteto de Software Senior | Gera SCOPE (COMO sera feito) |
-| `ministack-expert` | Engenheiro de Software | TASKS, Code Review e Execucao |
-| `ministack-qa-expert` | QA Engineer Senior / SDET | Estrategia de testes e testes por task |
+| `ministack-scope-expert` | Arquiteto de Software Senior | Gera SCOPE (COMO sera feito) + project-profile.md |
+| `ministack-tasks-expert` | Engenheiro de Software Senior | Gera TASKS atomicas e executaveis |
+
+### Agentes (validam)
+
+| Agente | Papel | Quando |
+|--------|-------|--------|
+| `qa-staff-engineer` | QA Engineer Senior | Gera testes (no generate-tasks) + valida pos-implementacao (Gate 1) |
+| `tech-review-conformance` | Tech Reviewer | Valida conformidade arquitetural (Gate 2) + code review |
+
+### Comandos (orquestram COMO)
+
+| Comando | Descricao |
+|---------|-----------|
+| `/generate-intent` | Gera INTENT via skill intent-expert |
+| `/generate-scope` | Gera SCOPE via skill scope-expert |
+| `/generate-tasks` | Gera TASKS via skill tasks-expert + delega testes ao qa-staff-engineer |
+| `/code-review` | Delega review ao agente tech-review-conformance |
+| `/run-ministack-tasks` | Orquestra execucao com gates QA + Tech Review |
+| `/run-ministack-withlinear` | Execucao com rastreamento no Linear |
 
 ---
 
 ## Fluxo Completo
 
 ```
-Descricao
-   |
-/generate-intent              (ministack-intent-expert)
-   | (INTENT aprovada)
-   |
-   +-- tech_direction.md      (OPCIONAL - criado manualmente pelo dev)
-   |
-/generate-scope                (ministack-scope-expert)
-   | (SCOPE aprovado)
-/generate-tasks                (ministack-expert)
-   | (TASKS aprovadas)
-/generate-tests                (ministack-qa-expert) [opcional]
-   | (Testes definidos)
-/code-review                   (ministack-expert) [opcional]
-   |
-/run-ministack-tasks           (ministack-expert)
-   OU /run-ministack-withlinear
-   |
-Feature Implementada
+Descricao da Feature
+        |
+   /generate-intent              skill: ministack-intent-expert
+        | (INTENT aprovada)
+        |
+        +-- tech_direction.md    (OPCIONAL - criado manualmente pelo dev)
+        |
+   /generate-scope               skill: ministack-scope-expert
+        | (SCOPE aprovado)        (gera project-profile.md se nao existe)
+   /generate-tasks               skill: ministack-tasks-expert
+        | (TASKS aprovadas)       comando delega testes ao qa-staff-engineer
+   /run-ministack-tasks          COMANDO ORQUESTRADOR
+        |
+   [Para cada Task]:
+        |
+   Executor (agent_name)         sub-agente implementa
+        |
+   qa-staff-engineer             Gate 1 (VALIDAR_IMPLEMENTACAO)
+        |
+   ├─ REJEITADO → Fix Loop → volta ao Gate 1
+   └─ APROVADO ↓
+        |
+   tech-review-conformance       Gate 2
+        |
+   ├─ rejected → Fix Loop → volta ao Gate 1
+   └─ approved → Task Concluida
+        |
+   (max 3 tentativas → Blocked + escalar)
+        |
+   Feature Implementada
 ```
 
 ---
@@ -76,43 +104,34 @@ Define escopo tecnico (COMO) baseado na INTENT aprovada.
 
 ### 3. `/generate-tasks`
 
-Gera tasks atomicas e executaveis com secao de testes (delegada ao QA expert).
+Gera tasks atomicas e executaveis. Testes sao delegados automaticamente ao agente `qa-staff-engineer`.
 
 ```
 /generate-tasks [Cole INTENT + SCOPE]
 ```
 
-### 4. `/generate-tests`
-
-Gera estrategia de testes completa ou testes por task.
-
-```
-/generate-tests docs/nome-feature/v1/scope.md
-/generate-tests docs/nome-feature/v1/tasks.md T1
-```
-
-### 5. `/code-review`
+### 4. `/code-review`
 
-Valida consistencia entre INTENT, SCOPE e TASKS.
+Delega review tecnico ao agente `tech-review-conformance`.
 
 ```
 /code-review docs/nome-feature/v1
 ```
 
-### 6. `/run-ministack-tasks`
+### 5. `/run-ministack-tasks`
 
-Executa tasks com maximo paralelismo.
+Orquestra execucao com gates QA + Tech Review (max 3 tentativas por task).
 
 ```
-/run-ministack-tasks docs/nome-feature/v1 [agente-opcional]
+/run-ministack-tasks docs/nome-feature/v1 go-expert
 ```
 
-### 7. `/run-ministack-withlinear`
+### 6. `/run-ministack-withlinear`
 
 Executa tasks com rastreamento automatico no Linear.
 
 ```
-/run-ministack-withlinear docs/nome-feature/v1 Backend [agente-opcional]
+/run-ministack-withlinear docs/nome-feature/v1 Backend go-expert
 ```
 
 ---
@@ -129,16 +148,12 @@ Para sincronizar tasks com o Linear sem executar:
 
 ## Templates
 
-Os templates oficiais estao dentro de cada skill:
-
 | Template | Skill | Caminho |
 |----------|-------|---------|
 | `intent-template.md` | `ministack-intent-expert` | `.claude/skills/ministack-intent-expert/templates/` |
 | `tech_direction-template.md` | `ministack-scope-expert` | `.claude/skills/ministack-scope-expert/templates/` |
 | `scope-template.md` | `ministack-scope-expert` | `.claude/skills/ministack-scope-expert/templates/` |
-| `tasks-template.md` | `ministack-expert` | `.claude/skills/ministack-expert/templates/` |
-| `test_strategy_template.md` | `ministack-qa-expert` | `.claude/skills/ministack-qa-expert/templates/` |
-| `task_tests_template.md` | `ministack-qa-expert` | `.claude/skills/ministack-qa-expert/templates/` |
+| `tasks-template.md` | `ministack-tasks-expert` | `.claude/skills/ministack-tasks-expert/templates/` |
 
 ---
 

package/frameworks/commands/ministack/code-review.md

@@ -1,67 +1,54 @@
 ---
-description: Executa review validando INTENT, SCOPE e TASKS da feature
-argument-hint: [caminho da pasta da feature ex: docs/auth/v1]
+description: "Code review do miniStack validando INTENT, SCOPE e TASKS. Param: caminho do task_plan.md"
+argument-hint: "<task_plan.md ex: docs/carrinho-compra/v1/task_plan.md>"
 ---
 
-Use a skill **ministack-expert** para executar o Code Review (ETAPA 4).
-
-## Contexto
-
-Voce deve seguir as regras e o processo da **ETAPA 4: CODE REVIEW** definida na skill ministack-expert.
+Voce e um **Coordenador de Review Tecnico**. Seu papel e orquestrar a validacao dos documentos da feature delegando ao agente `tech-review-conformance`.
 
 ## Processo
 
-1. Localize a pasta da feature fornecida no argumento
-2. Leia APENAS: `intent.md`, `scope.md`, `tasks.md`
-3. **NAO leia** arquivos de codigo fonte ou arquivos fora da pasta da feature
-4. Execute as 6 fases de analise (Coleta, Conformidade, Qualidade, Seguranca, Performance, Testabilidade)
-5. Gere o relatorio em `<pasta_feature>/code_review/code_review_report.md`
-6. Crie tasks de correcao em `<pasta_feature>/code_review/tasks/`
-7. Apresente o resumo ao usuario
-
-## Formato do Relatorio
-
-```markdown
-# Code Review Report - [NOME_DA_FEATURE]
+1. Leia o `task_plan.md` fornecido no argumento
+2. Extraia os caminhos de **Intent** e **Scope** da secao 1 (Identificacao) do task_plan
+3. Leia: intent.md, scope.md (dos caminhos extraidos) e cada `tasks/T[N].md` (no diretorio-base)
+3. Dispare o agente `tech-review-conformance` com o contexto completo
 
-**Data**: [DATA]
-**Revisor**: Claude Code Review Agent
-**Status Geral**: [APROVADO | APROVADO COM RESSALVAS | REPROVADO]
+## Disparar o Agente
 
-## 1. Resumo Executivo
-| Metrica | Valor |
-|---------|-------|
-| Cobertura INTENT no SCOPE | X% |
-| Cobertura SCOPE nas TASKS | X% |
-| Qualidade das TASKS | X% |
-| Issues Criticas | X |
+Lance o agente usando a ferramenta `Agent` com:
 
-## 2. Rastreabilidade entre Documentos
-[Tabelas INTENT->SCOPE, SCOPE->TASKS, Qualidade das TASKS]
+- **subagent_type**: `tech-review-conformance`
+- **description**: "Tech Review feature [nome]"
+- **prompt**:
 
-## 3. Issues Encontradas
-[Categorizadas: CR- Criticas, HI- Alta, MD- Media, LO- Baixa]
-
-## 4. Gaps de Seguranca
-## 5. Gaps de Performance
-## 6. Analise de Testabilidade
-## 7. Conclusao e Proximos Passos
+```
+Realize a revisao tecnica dos documentos da feature.
+
+## Documentos para Revisar
+- INTENT: [caminho]/intent.md
+- SCOPE: [caminho]/scope.md
+- TASK PLAN: [caminho]/task_plan.md
+- TASKS: [caminho]/tasks/T*.md (todos os arquivos individuais)
+
+## O que Validar
+1. **INTENT vs SCOPE**: O SCOPE cobre o que a INTENT precisa?
+2. **SCOPE vs TASKS**: As TASKS implementam tudo do SCOPE?
+3. **Qualidade das TASKS**: Criterios claros e verificaveis?
+4. **Seguranca**: Autenticacao, autorizacao, dados sensiveis, validacao de input
+5. **Performance**: Paginacao, cache, concorrencia
+6. **Testabilidade**: Criterios mensuraveis, cobertura de sucesso e erro
+
+Leia TODOS os documentos listados e retorne a revisao completa.
 ```
 
-## Formato de Task de Correcao
+## Saida
 
-```markdown
-# Task: [CR-XXX] Titulo da Correcao
-## Identificacao
-- ID: CR-XXX
-- Prioridade: CRITICA | ALTA | MEDIA | BAIXA
-## Contexto
-## Objetivo
-## Criterio de Conclusao
-```
+Apresente o resultado do agente ao usuario com:
+- Status: APROVADO | APROVADO COM RESSALVAS | REPROVADO
+- Issues encontradas categorizadas por severidade
+- Sugestoes de correcao
 
 ## Entrada
 
-Caminho da feature para code review:
+Caminho da feature para review:
 
 $ARGUMENTS

package/frameworks/commands/ministack/generate-intent.md

@@ -1,6 +1,6 @@
 ---
-description: Gera uma INTENT clara e validada a partir de uma descricao de feature
-argument-hint: [descricao da feature ou tarefa]
+description: "Gera INTENT do miniStack. Param: descricao da feature (ex: 'sistema de carrinho de compras com adicao e remocao de itens')"
+argument-hint: "<descricao da feature em texto livre>"
 ---
 
 Use a skill **ministack-intent-expert** para gerar a INTENT.
@@ -15,6 +15,29 @@ Voce deve atuar como um **Product Owner / PM experiente** e seguir as regras e o
 - **NUNCA** deduza escopo ou invente informacoes — na **DUVIDA PERGUNTE AO USUARIO**
 - Pense sempre no **O QUE** e **POR QUE**, nunca no **COMO**
 
+## Estado do Pipeline (ministack_state.yaml)
+
+Apos salvar a INTENT com sucesso, voce DEVE criar o arquivo `ministack_state.yaml` no mesmo diretorio da INTENT.
+
+```yaml
+feature: "<nome da feature extraido da INTENT>"
+current_step: intent
+steps:
+  intent:
+    status: completed
+    summary: "<objetivo em 1 frase curta>. Escopo: <itens principais>"
+  tech_direction:
+    status: pending
+  scope:
+    status: pending
+  task_plan:
+    status: pending
+  execution:
+    status: pending
+```
+
+Se o arquivo **ja existir** (ex: revisao da INTENT), atualize apenas o bloco `intent` e resete os steps posteriores para `pending`.
+
 ## Entrada
 
 $ARGUMENTS

package/frameworks/commands/ministack/generate-scope.md

@@ -1,6 +1,6 @@
 ---
-description: Define o escopo tecnico (dentro e fora) a partir de uma INTENT aprovada
-argument-hint: [INTENT aprovada] [DETALHES TECNICOS]
+description: "Gera SCOPE do miniStack a partir de INTENT aprovada. Param: caminho do intent.md"
+argument-hint: "<caminho intent.md ex: docs/carrinho-compra/v1/intent.md>"
 ---
 
 Use a skill **ministack-scope-expert** para gerar o SCOPE.
@@ -10,12 +10,13 @@ Use a skill **ministack-scope-expert** para gerar o SCOPE.
 Voce deve atuar como um **Arquiteto de Software Senior** e seguir as regras e o processo definidos na skill ministack-scope-expert.
 
 O $ARGUMENTS deve conter:
-1. **INTENT aprovada** (obrigatorio)
-2. **DETALHES TECNICOS** (obrigatorio)
+1. **caminho do intent.md** (obrigatorio) — ex: `docs/carrinho-compra/v1/intent.md`
+
+O scope.md sera gerado no mesmo diretorio do intent.md.
 
 ## Tech Direction (Opcional)
 
-Antes de iniciar, verifique se existe um arquivo `tech_direction.md` na pasta da feature (`docs/[nome-feature]/v1/tech_direction.md`).
+Antes de iniciar, verifique se existe um arquivo `tech_direction.md` no mesmo diretorio do intent.md.
 
 - Se existir, use como **ponto de partida** para decisoes tecnicas — nao como verdade absoluta
 - O arquivo contem decisoes ja tomadas, tecnologias sugeridas e padroes preferidos pelo dev
@@ -27,9 +28,32 @@ Antes de iniciar, verifique se existe um arquivo `tech_direction.md` na pasta da
 - **Claude Code**: use a ferramenta `AskUserQuestion` para esclarecer duvidas com o usuario
 - **NUNCA** deduza escopo ou invente informacoes — na **DUVIDA PERGUNTE AO USUARIO**
 - Pense sempre no **COMO** sera feito baseado na INTENT
-- **ANTES de definir o SCOPE**, pesquise as rules do projeto (`.claude/rules/`, `CLAUDE.md`) e as camadas existentes para propor a melhor solucao como um **arquiteto senior**
+- **ANTES de definir o SCOPE**, explore as camadas existentes do projeto para propor a melhor solucao como um **arquiteto senior**
 - Liste **TODOS** os arquivos envolvidos e as acoes (criar/modificar/remover) — economiza tokens e scans
 
+## Estado do Pipeline (ministack_state.yaml)
+
+Apos salvar o scope.md com sucesso, atualize o arquivo `ministack_state.yaml` no mesmo diretorio:
+
+```yaml
+# atualizar apenas estes campos:
+current_step: scope
+steps:
+  scope:
+    status: completed
+    summary: "<componentes novos>, <N endpoints>, tabelas: <lista tabelas>"
+```
+
+Se o usuario pulou o tech_direction, marque-o como `skipped`:
+
+```yaml
+steps:
+  tech_direction:
+    status: skipped
+```
+
+Se o `ministack_state.yaml` nao existir, nao crie — o generate-intent e responsavel por criar.
+
 ## Entrada
 
 Cole a INTENT aprovada: