adi_dev_workflow 1.0.0

package/bin/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { run } from '../src/cli.js';
+
+run(process.argv.slice(2)).catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/frameworks/commands/generate-prompt.md

@@ -0,0 +1,98 @@
+---
+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.
+
+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.
+
+---
+
+# 🎯 Suas responsabilidades
+
+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.
+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
+   - **Objetivo**: o que entregar, por que, resultado esperado
+   - **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
+6. Opcionalmente coletar:
+   - **Critérios de Aceite**: condições objetivas de sucesso
+   - **Exemplos**: entrada/saída esperada
+7. Quando o usuário não souber responder algo, ofereça 2 a 4 opções bem formuladas.
+8. Ao final, gerar o prompt completo usando o template oficial, sempre em Markdown.
+9. Salvar o prompt gerado em: `docs/prompts/[slug_da_tarefa]/[slug_da_tarefa]_prompt.md`
+
+---
+
+# 🚫 O que você NÃO deve fazer
+
+1. Nunca pular diretamente para o prompt final sem coletar as informações.
+2. Nunca assumir informações que o usuário não forneceu.
+3. Nunca fazer múltiplas perguntas de uma vez.
+4. Nunca gerar um prompt incompleto ou genérico.
+
+---
+
+# 📋 Fluxo de Perguntas
+
+## Seção 1 - Contexto
+Pergunte uma por vez:
+- Qual linguagem/framework está sendo utilizado?
+- Qual arquitetura/padrão o projeto segue?
+- Quem é o público-alvo da entrega?
+- Existem limitações ou restrições importantes?
+
+## Seção 2 - Objetivo
+Pergunte uma por vez:
+- O que exatamente precisa ser entregue?
+- Por que essa tarefa é necessária?
+- Qual o resultado esperado?
+
+## Seção 3 - Instruções Específicas
+Pergunte uma por vez:
+- Quais são os detalhes técnicos importantes?
+- Existem restrições de implementação?
+- Qual deve ser a estrutura lógica da solução?
+
+## Seção 4 - DEVE / NÃO DEVE
+Pergunte uma por vez:
+- O que a IA DEVE fazer obrigatoriamente? (pelo menos 3 itens)
+- O que a IA NÃO DEVE fazer de jeito nenhum? (pelo menos 3 itens)
+- Existe alguma atenção especial crítica?
+
+## Seção 5 - Formato da Resposta
+Pergunte uma por vez:
+- Qual estrutura você prefere para a resposta?
+- Existem limites de tamanho ou escopo?
+- Qual estilo deve ser usado?
+
+## Seção 6 - Persona / Tom
+Pergunte uma por vez:
+- Qual perspectiva a IA deve assumir?
+- Qual tom deve ter a explicação?
+- Qual nível de profundidade?
+
+## Seção 7 - Critérios de Aceite (opcional)
+- Quais critérios objetivos determinam se a resposta está correta?
+
+## Seção 8 - Exemplos (opcional)
+- Você tem exemplos de entrada/saída esperada?
+
+---
+
+# 🧱 Template oficial do Prompt (sempre use)
+
+@.claude/templates/prompt_template.md
+
+---
+
+# 📝 Resumo da tarefa do usuário
+
+$ARGUMENTS

package/frameworks/commands/ministack/README.md

@@ -0,0 +1,151 @@
+# miniStack — Guia de Uso
+
+**miniStack** e um framework estruturado para decomposicao e execucao de features de forma colaborativa.
+
+---
+
+## Skills Especializadas
+
+O miniStack utiliza **4 skills especializadas**, cada uma com uma persona e responsabilidade distinta:
+
+| 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 |
+
+---
+
+## 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
+```
+
+---
+
+## Comandos
+
+### 1. `/generate-intent`
+
+Gera INTENT clara e validada. Foco no O QUE e POR QUE.
+
+```
+/generate-intent Adicionar autenticacao OAuth2
+```
+
+### 1.5. Tech Direction (Opcional)
+
+Direcionamento tecnico criado **manualmente pelo dev** antes do `/generate-scope`. Contem decisoes tecnicas ja tomadas, tecnologias sugeridas e padroes preferidos.
+
+```
+# Criar manualmente na pasta da feature:
+docs/nome-feature/v1/tech_direction.md
+```
+
+- Template disponivel em: `.claude/skills/ministack-scope-expert/templates/tech_direction-template.md`
+- O scope-expert usa como **ponto de partida**, nao como verdade absoluta
+- Se nao existir, o fluxo segue normalmente
+
+### 2. `/generate-scope`
+
+Define escopo tecnico (COMO) baseado na INTENT aprovada.
+
+```
+/generate-scope [Cole a INTENT aqui]
+```
+
+### 3. `/generate-tasks`
+
+Gera tasks atomicas e executaveis com secao de testes (delegada ao QA expert).
+
+```
+/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`
+
+Valida consistencia entre INTENT, SCOPE e TASKS.
+
+```
+/code-review docs/nome-feature/v1
+```
+
+### 6. `/run-ministack-tasks`
+
+Executa tasks com maximo paralelismo.
+
+```
+/run-ministack-tasks docs/nome-feature/v1 [agente-opcional]
+```
+
+### 7. `/run-ministack-withlinear`
+
+Executa tasks com rastreamento automatico no Linear.
+
+```
+/run-ministack-withlinear docs/nome-feature/v1 Backend [agente-opcional]
+```
+
+---
+
+## Sincronizacao com Linear
+
+Para sincronizar tasks com o Linear sem executar:
+
+```
+/sync-tasks-to-linear docs/nome-feature/v1 MeuProjeto Backend
+```
+
+---
+
+## 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/` |
+
+---
+
+## Regras Importantes
+
+- Aprove cada etapa antes de avancar
+- Se algo nao estiver claro, refine antes de continuar
+- Claude so faz o que esta aprovado
+- Se houver desvio de escopo, o comando avisa
+- Na duvida, PERGUNTE ao usuario

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

@@ -0,0 +1,67 @@
+---
+description: Executa review validando INTENT, SCOPE e TASKS da feature
+argument-hint: [caminho da pasta da feature ex: docs/auth/v1]
+---
+
+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.
+
+## 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]
+
+**Data**: [DATA]
+**Revisor**: Claude Code Review Agent
+**Status Geral**: [APROVADO | APROVADO COM RESSALVAS | REPROVADO]
+
+## 1. Resumo Executivo
+| Metrica | Valor |
+|---------|-------|
+| Cobertura INTENT no SCOPE | X% |
+| Cobertura SCOPE nas TASKS | X% |
+| Qualidade das TASKS | X% |
+| Issues Criticas | X |
+
+## 2. Rastreabilidade entre Documentos
+[Tabelas INTENT->SCOPE, SCOPE->TASKS, Qualidade das TASKS]
+
+## 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
+```
+
+## Formato de Task de Correcao
+
+```markdown
+# Task: [CR-XXX] Titulo da Correcao
+## Identificacao
+- ID: CR-XXX
+- Prioridade: CRITICA | ALTA | MEDIA | BAIXA
+## Contexto
+## Objetivo
+## Criterio de Conclusao
+```
+
+## Entrada
+
+Caminho da feature para code review:
+
+$ARGUMENTS

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

@@ -0,0 +1,20 @@
+---
+description: Gera uma INTENT clara e validada a partir de uma descricao de feature
+argument-hint: [descricao da feature ou tarefa]
+---
+
+Use a skill **ministack-intent-expert** para gerar a INTENT.
+
+## Contexto
+
+Voce deve atuar como um **Product Owner / PM experiente** e seguir as regras e o processo definidos na skill ministack-intent-expert.
+
+## Regras Adicionais
+
+- **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 **O QUE** e **POR QUE**, nunca no **COMO**
+
+## Entrada
+
+$ARGUMENTS

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

@@ -0,0 +1,37 @@
+---
+description: Define o escopo tecnico (dentro e fora) a partir de uma INTENT aprovada
+argument-hint: [INTENT aprovada] [DETALHES TECNICOS]
+---
+
+Use a skill **ministack-scope-expert** para gerar o SCOPE.
+
+## Contexto
+
+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)
+
+## 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`).
+
+- 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
+- Voce pode complementar, ajustar ou questionar qualquer item
+- Se NAO existir, siga o fluxo normal
+
+## Regras Adicionais
+
+- **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**
+- Liste **TODOS** os arquivos envolvidos e as acoes (criar/modificar/remover) — economiza tokens e scans
+
+## Entrada
+
+Cole a INTENT aprovada:
+
+$ARGUMENTS

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

@@ -0,0 +1,25 @@
+---
+description: Gera tasks atomicas e executaveis a partir de INTENT e SCOPE aprovados
+argument-hint: [INTENT aprovada + SCOPE aprovado]
+---
+
+Use a skill **ministack-expert** para gerar as TASKS (ETAPA 3).
+
+## Contexto
+
+Voce deve seguir as regras e o processo da **ETAPA 3: TASKS** definida na skill ministack-expert.
+
+> **Nota**: A secao de testes de cada task sera delegada automaticamente ao subagente `ministack-qa-expert`. Voce nao precisa chamar `/generate-tests` separadamente — o ministack-expert ja coordena a delegacao QA internamente.
+
+## Regras Adicionais
+
+- **Claude Code**: use a ferramenta `AskUserQuestion` para esclarecer duvidas com o usuario
+- **NUNCA** deduza escopo ou invente informacoes — na **DUVIDA PERGUNTE AO USUARIO**
+- Liste **TODOS** os arquivos envolvidos e as acoes (criar/modificar/remover) em cada task — economiza tokens e scans
+- A secao de **testes** de cada task sera preenchida por um subagente QA especializado (`ministack-qa-expert`)
+
+## Entrada
+
+Cole a INTENT e SCOPE aprovados:
+
+$ARGUMENTS

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

@@ -0,0 +1,37 @@
+---
+description: Gera estrategia de testes completa com vies de QA Senior para uma feature ou task do miniStack
+argument-hint: [caminho do SCOPE ou descricao da task]
+---
+
+Use a skill **ministack-qa-expert** para gerar a estrategia de testes.
+
+## Contexto
+
+Voce deve atuar como um **QA Engineer Senior / SDET** e seguir todo o processo definido na skill ministack-qa-expert para gerar testes com qualidade profissional.
+
+## Modos de Uso
+
+### Modo 1: Estrategia completa para uma feature
+```
+/ministack:generate-tests docs/nome-feature/v1/scope.md
+```
+Gera a estrategia de testes completa (unitarios, integracao, e2e, cenarios de erro) baseada no SCOPE aprovado.
+
+### Modo 2: Testes para uma task especifica
+```
+/ministack:generate-tests docs/nome-feature/v1/tasks.md T1
+```
+Gera a secao de testes completa para uma task especifica (unitarios, integracao, e2e, cenarios de erro).
+
+## Regras Adicionais
+
+- **Claude Code**: use a ferramenta `AskUserQuestion` para esclarecer duvidas com o usuario
+- **NUNCA** gere testes genericos — cada teste deve ter cenario especifico e verificavel
+- **SEMPRE** pesquise padroes de teste existentes no projeto antes de gerar
+- **SEMPRE** mapeie criterios de aceite do SCOPE para testes
+- **SEMPRE** considere cenarios de erro, boundary values e edge cases
+- Todo fluxo de sucesso deve ter **pelo menos 2 cenarios de falha** correspondentes
+
+## Entrada
+
+$ARGUMENTS

package/frameworks/commands/ministack/run-ministack-tasks.md

@@ -0,0 +1,55 @@
+---
+description: Coordena sub-agentes para executar tasks aprovadas com maximo paralelismo
+argument-hint: [caminho da feature] [agente opcional ex: go-backend-implementer]
+---
+
+Use a skill **ministack-expert** para executar as TASKS (ETAPA 5).
+
+## Contexto
+
+Voce deve seguir as regras e o processo da **ETAPA 5: EXECUCAO** definida na skill ministack-expert.
+
+## Argumentos
+
+O `$ARGUMENTS` pode conter:
+
+1. **Caminho da feature** (obrigatorio) - Ex: `docs/nome-feature/v1`
+2. **Agente/Subagente** (opcional) - Nome do agente a ser usado para execucao
+
+**Formatos aceitos:**
+- `docs/minha-feature/v1` - Usa execucao padrao
+- `docs/minha-feature/v1 go-backend-implementer` - Usa agente especifico
+
+Se um agente for especificado, ele sera usado como `subagent_type` na ferramenta Task.
+Os agentes disponiveis podem ser encontrados em `.claude/agents/`.
+
+## Contexto Obrigatorio
+
+Antes de executar qualquer task, voce **DEVE** ler:
+
+1. **`intent.md`** - Define o objetivo e contexto da feature
+2. **`scope.md`** - Define o escopo aprovado e limites
+3. **`tasks.md`** - Contem as tasks aprovadas para execucao
+
+> Toda execucao deve respeitar a intent e os limites do scope.
+> Se uma task conflitar com estes documentos, **PARE e avise**.
+
+## Execucao em Paralelo
+
+- **Tasks independentes**: Lance multiplas chamadas Task em paralelo na mesma mensagem
+- **Tasks dependentes**: Execute sequencialmente, aguardando conclusao da anterior
+- **Maximo de paralelismo**: Priorize lancar o maior numero possivel de tasks simultaneas
+
+## Fluxo
+
+1. **Recepcao e Validacao** — Ler tasks, validar, analisar paralelismo
+2. **Execucao Tecnica** — Executar passos conforme descrito
+3. **Validacao de Testes** — Executar testes relevantes
+4. **Aceite Tecnico** — Validar criterio de conclusao
+5. **Reporte Final** — Resumo do que foi feito
+
+## Entrada
+
+**Formato:** `[caminho-feature] [agente-opcional]`
+
+$ARGUMENTS

package/frameworks/commands/ministack/run-ministack-withlinear.md

@@ -0,0 +1,94 @@
+---
+description: Executa tasks do miniStack com rastreamento no Linear
+argument-hint: [caminho da feature] [team no linear] [agente opcional]
+---
+
+Use a skill **ministack-expert** para executar as TASKS (ETAPA 5) e use o comando `/sync-tasks-to-linear` para sincronizar com o Linear.
+
+## Contexto
+
+Voce deve seguir as regras e o processo da **ETAPA 5: EXECUCAO** definida na skill ministack-expert, com rastreamento automatico no Linear.
+
+## Argumentos
+
+O `$ARGUMENTS` deve conter:
+
+1. **Caminho da feature** (obrigatorio) - Ex: `docs/nome-feature/v1`
+2. **Team no Linear** (obrigatorio) - Nome ou ID do time no Linear
+3. **Agente/Subagente** (opcional) - Nome do agente a ser usado para execucao
+
+**Formatos aceitos:**
+- `docs/minha-feature/v1 Backend` - Pasta com team
+- `docs/minha-feature/v1 Backend go-backend-implementer` - Com agente especifico
+
+## Fluxo de Execucao
+
+### Fase 1: Descoberta e Validacao
+- Ler intent.md, scope.md, tasks.md
+- Extrair nome da feature e lista de tasks
+- Validar contexto e dependencias
+
+### Fase 2: Criacao no Linear (Hierarquia)
+
+1. Obter status disponiveis do time
+2. **CRIAR ISSUE PRINCIPAL DA FEATURE** (pai de todas):
+   ```
+   title: "[FEATURE] {nome-da-feature}"
+   team: [time especificado]
+   state: "Todo"
+   ```
+3. **CRIAR ISSUES DAS TASKS** (subtasks):
+   ```
+   title: "[T{N}] Nome da Task"
+   parentId: [ID da issue da feature]
+   state: "Todo"
+   blockedBy: [dependencias]
+   ```
+
+### Fase 3: Execucao (Paralelo/Sequencial)
+
+1. Atualizar issue da feature para "In Progress"
+2. Para cada task:
+   - Atualizar issue para "In Progress"
+   - Executar a task
+   - Validar criterio de conclusao
+   - Atualizar issue para "Done"
+3. Atualizar issue da feature para "Done"
+
+### Fase 4: Relatorio Final
+
+Mostrar resumo de tasks executadas, issues no Linear, arquivos modificados e validacoes.
+
+## Tratamento de Bloqueios
+
+Se encontrar bloqueio:
+1. PARE IMEDIATAMENTE
+2. Atualizar issue da task para "Blocked"
+3. Atualizar issue da feature para "Blocked"
+4. Gerar relatorio parcial
+
+## Comandos Linear MCP Utilizados
+
+| Comando | Uso |
+|---------|-----|
+| `mcp__linear-server__list_teams` | Descobrir times |
+| `mcp__linear-server__list_issue_statuses` | Status validos |
+| `mcp__linear-server__create_issue` | Criar issues |
+| `mcp__linear-server__update_issue` | Atualizar status |
+| `mcp__linear-server__create_comment` | Comentarios |
+
+## Mapeamento de Status Linear
+
+| Estado Execucao | Status Linear |
+|-----------------|---------------|
+| Aguardando | Todo / Backlog |
+| Em execucao | In Progress |
+| Concluido | Done / Completed |
+| Bloqueado | Blocked |
+| Cancelado | Canceled |
+
+## Entrada
+
+**Formato:** `[caminho-feature] [team-linear] [agente-opcional]`
+
+$ARGUMENTS