adi_dev_workflow 1.0.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/index.js +0 -0
- package/frameworks/agents/qa-staff-engineer.md +311 -0
- package/frameworks/agents/qa-validation-expert.md +458 -0
- package/frameworks/agents/tech-review-conformance.md +200 -0
- package/frameworks/commands/generate-project-profile.md +68 -0
- package/frameworks/commands/generate-prompt.md +33 -98
- package/frameworks/commands/ministack/README.md +61 -46
- package/frameworks/commands/ministack/code-review.md +36 -49
- package/frameworks/commands/ministack/generate-intent.md +25 -2
- package/frameworks/commands/ministack/generate-scope.md +30 -6
- package/frameworks/commands/ministack/generate-tasks.md +191 -6
- package/frameworks/commands/ministack/generate-tech-direction.md +43 -0
- package/frameworks/commands/ministack/run-ministack-tasks.md +352 -33
- package/frameworks/commands/ministack/run-ministack-withlinear.md +23 -22
- package/frameworks/commands/ministack/status.md +153 -0
- package/frameworks/commands/sdd/code-review.md +10 -10
- package/frameworks/commands/sdd/generate-prd.md +32 -2
- package/frameworks/commands/sdd/generate-task-plan.md +199 -5
- package/frameworks/commands/sdd/generate-tech-direction.md +43 -0
- package/frameworks/commands/sdd/generate-tech-spec.md +218 -0
- package/frameworks/commands/sdd/generate-tests.md +2 -2
- package/frameworks/commands/sdd/run_tasks.md +391 -43
- package/frameworks/commands/sdd/run_tasks_withlinear.md +276 -37
- package/frameworks/commands/sdd/status.md +160 -0
- package/frameworks/commands/sdd/validate-sdd.md +18 -2
- package/frameworks/commands/sync-tasks-to-linear.md +588 -588
- package/frameworks/commands/taskcard/generate-taskcard.md +113 -25
- package/frameworks/commands/taskcard/run-taskcard.md +203 -34
- package/frameworks/skills/ministack-intent-expert/SKILL.md +16 -3
- package/frameworks/skills/ministack-intent-expert/templates/intent-template.md +1 -1
- package/frameworks/skills/ministack-scope-expert/SKILL.md +19 -11
- package/frameworks/skills/ministack-scope-expert/templates/scope-template.md +1 -1
- package/frameworks/skills/ministack-tasks-expert/SKILL.md +204 -0
- package/frameworks/skills/ministack-tasks-expert/templates/task_plan_template.md +78 -0
- package/frameworks/skills/ministack-tasks-expert/templates/task_template.md +103 -0
- package/frameworks/skills/ministack-tech-direction-expert/SKILL.md +230 -0
- package/frameworks/skills/ministack-tech-direction-expert/evals/evals.json +1 -0
- package/frameworks/skills/ministack-tech-direction-expert/templates/tech_direction-template.md +17 -0
- package/frameworks/skills/prompt-engineer-expert/SKILL.md +232 -0
- package/frameworks/skills/prompt-engineer-expert/templates/prompt_template.md +139 -0
- package/frameworks/skills/sdd-prd-expert/SKILL.md +155 -95
- package/frameworks/skills/sdd-prd-expert/evals/evals.json +59 -0
- package/frameworks/skills/sdd-prd-expert/templates/prd_template.md +46 -46
- package/frameworks/skills/sdd-prd-expert/templates/tech_direction-template.md +23 -0
- package/frameworks/skills/sdd-task-plan-expert/SKILL.md +191 -201
- package/frameworks/skills/sdd-task-plan-expert/evals/evals.json +109 -0
- package/frameworks/skills/sdd-task-plan-expert/templates/task_plan_template.md +33 -33
- package/frameworks/skills/sdd-task-plan-expert/templates/task_template.md +58 -32
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/benchmark.json +99 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/benchmark.md +64 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/eval_metadata.json +12 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/outputs/response.md +134 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/outputs/transcript.md +68 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/with_skill/timing.json +5 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/without_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/without_skill/outputs/response.md +525 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/without_skill/outputs/transcript.md +30 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-1-happy-path/without_skill/timing.json +5 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/eval_metadata.json +12 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/with_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/with_skill/outputs/response.md +1126 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/with_skill/outputs/transcript.md +131 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/with_skill/timing.json +5 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/without_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/without_skill/outputs/response.md +452 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/without_skill/outputs/transcript.md +78 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-2-spec-simples/without_skill/timing.json +5 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/eval_metadata.json +12 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/with_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/with_skill/outputs/response.md +101 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/with_skill/outputs/transcript.md +133 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/with_skill/timing.json +5 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/without_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/without_skill/outputs/response.md +248 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/without_skill/outputs/transcript.md +49 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/eval-3-sem-user-stories/without_skill/timing.json +5 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-1/review.html +1325 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/benchmark.json +94 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/benchmark.md +67 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/eval_metadata.json +12 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/outputs/response.md +117 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/outputs/transcript.md +91 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/with_skill/timing.json +1 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/without_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/without_skill/outputs/response.md +694 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/without_skill/outputs/transcript.md +45 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-1-happy-path/without_skill/timing.json +1 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/eval_metadata.json +12 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/with_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/with_skill/outputs/response.md +1087 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/with_skill/outputs/transcript.md +124 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/with_skill/timing.json +1 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/without_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/without_skill/outputs/response.md +458 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/without_skill/outputs/transcript.md +84 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-2-spec-simples/without_skill/timing.json +1 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/eval_metadata.json +12 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/with_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/with_skill/outputs/response.md +70 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/with_skill/outputs/transcript.md +148 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/with_skill/timing.json +1 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/without_skill/grading.json +32 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/without_skill/outputs/response.md +249 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/without_skill/outputs/transcript.md +80 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/eval-3-sem-user-stories/without_skill/timing.json +1 -0
- package/frameworks/skills/sdd-task-plan-expert-workspace/iteration-2/review.html +1325 -0
- package/frameworks/skills/sdd-tech-direction-expert/SKILL.md +235 -0
- package/frameworks/skills/sdd-tech-direction-expert/evals/evals.json +1 -0
- package/frameworks/skills/sdd-tech-direction-expert/templates/tech_direction-template.md +23 -0
- package/frameworks/skills/sdd-tech-spec-expert/SKILL.md +317 -0
- package/frameworks/skills/sdd-tech-spec-expert/evals/evals.json +199 -0
- package/frameworks/skills/sdd-tech-spec-expert/templates/spec_tech_template.md +290 -0
- package/frameworks/skills/sdd-tech-spec-expert/templates/tech_direction-template.md +23 -0
- package/frameworks/skills/taskcard-expert/SKILL.md +40 -77
- package/frameworks/skills/taskcard-expert/templates/template.md +0 -2
- package/frameworks/templates/prompt_template.md +44 -1
- package/package.json +1 -1
- package/frameworks/commands/ministack/generate-tests.md +0 -37
- package/frameworks/commands/sdd/generate-spec-tech.md +0 -37
- package/frameworks/commands/taskcard/generate-tests.md +0 -37
- package/frameworks/skills/ministack-expert/SKILL.md +0 -415
- package/frameworks/skills/ministack-expert/templates/tasks-template.md +0 -141
- package/frameworks/skills/ministack-qa-expert/SKILL.md +0 -273
- package/frameworks/skills/ministack-qa-expert/templates/task_tests_template.md +0 -24
- package/frameworks/skills/ministack-qa-expert/templates/test_strategy_template.md +0 -75
- package/frameworks/skills/sdd-qa-expert/SKILL.md +0 -284
- package/frameworks/skills/sdd-qa-expert/templates/task_tests_template.md +0 -24
- package/frameworks/skills/sdd-qa-expert/templates/test_strategy_template.md +0 -75
- package/frameworks/skills/sdd-spec-tech-expert/SKILL.md +0 -387
- package/frameworks/skills/sdd-spec-tech-expert/templates/spec_tech_template.md +0 -246
- package/frameworks/skills/sdd-spec-tech-expert/templates/tech_direction-template.md +0 -23
- package/frameworks/skills/taskcard-qa-expert/SKILL.md +0 -265
- package/frameworks/skills/taskcard-qa-expert/templates/task_tests_template.md +0 -78
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Analisa o projeto e gera perfil completo (CLAUDE.md + project-profile.md)
|
|
3
|
+
---
|
|
4
|
+
Voce e um analisador de projetos. Sua missao e garantir que o perfil do projeto esteja completo em dois arquivos:
|
|
5
|
+
|
|
6
|
+
## Parte 1: Completar CLAUDE.md (informacoes estaveis)
|
|
7
|
+
|
|
8
|
+
### 1. Ler o CLAUDE.md atual
|
|
9
|
+
Identifique o que ja esta documentado: stack, arquitetura, camadas, convencoes, comandos.
|
|
10
|
+
|
|
11
|
+
### 2. Detectar o que falta
|
|
12
|
+
Explore o projeto para encontrar informacoes de stack/arquitetura **ausentes**:
|
|
13
|
+
|
|
14
|
+
| Informacao | Como detectar |
|
|
15
|
+
|-----------|---------------|
|
|
16
|
+
| Linguagem + versao | go.mod, package.json, pubspec.yaml, requirements.txt, Cargo.toml |
|
|
17
|
+
| Framework | Imports, estrutura de pastas, configs |
|
|
18
|
+
| Banco de dados | Migracoes, config, conexoes |
|
|
19
|
+
| ORM / Query builder | Imports, arquivos gerados, configs |
|
|
20
|
+
| DI framework | Imports, configuracao |
|
|
21
|
+
| Arquitetura | Estrutura de pastas, separacao de camadas |
|
|
22
|
+
| Camadas e diretorios | Explorar arvore de diretorios |
|
|
23
|
+
|
|
24
|
+
### 3. Completar CLAUDE.md
|
|
25
|
+
Se houver informacoes de stack/arquitetura faltando, adicione-as nas secoes apropriadas do CLAUDE.md.
|
|
26
|
+
- NAO reescreva secoes existentes
|
|
27
|
+
- NAO duplique informacoes
|
|
28
|
+
- Apenas adicione o que esta faltando
|
|
29
|
+
|
|
30
|
+
## Parte 2: Gerar `.claude/rules/project-profile.md` (informacoes dinamicas)
|
|
31
|
+
|
|
32
|
+
### 4. Mapear padroes de teste
|
|
33
|
+
- Framework de teste (testify, jest, pytest, flutter_test, etc.)
|
|
34
|
+
- Padrao de mock (testify/mock, gomock, mockito, jest.mock, etc.)
|
|
35
|
+
- Localizacao dos testes (mesmo diretorio, pasta separada, etc.)
|
|
36
|
+
- Naming convention (TestFunc_Scenario, test_func, etc.)
|
|
37
|
+
- Helpers e fixtures reutilizaveis
|
|
38
|
+
|
|
39
|
+
### 5. Gerar/Atualizar `.claude/rules/project-profile.md`
|
|
40
|
+
|
|
41
|
+
Escreva o arquivo com o template abaixo. Se ja existir, faca merge inteligente.
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
# Perfil do Projeto
|
|
45
|
+
> Gerado por /generate-project-profile em [DATA]
|
|
46
|
+
> Auto-carregado no contexto via .claude/rules/
|
|
47
|
+
|
|
48
|
+
## Padroes de Teste
|
|
49
|
+
- Framework: [detectado]
|
|
50
|
+
- Mock: [padrao detectado]
|
|
51
|
+
- Localizacao: [mesmo diretorio / pasta separada / etc.]
|
|
52
|
+
- Naming: [padrao detectado]
|
|
53
|
+
- Helpers: [helpers encontrados ou N/A]
|
|
54
|
+
|
|
55
|
+
### Mapeamento de Testes por Camada
|
|
56
|
+
| Camada | Tipo de Teste | O que testar | Mock de |
|
|
57
|
+
|--------|--------------|-------------|---------|
|
|
58
|
+
| [camada real] | [unitario/integracao/e2e] | [o que] | [mock de] |
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## Regras
|
|
62
|
+
- Detecte TUDO automaticamente — NAO pergunte ao usuario
|
|
63
|
+
- Priorize informacoes do CLAUDE.md — NAO duplique entre os dois arquivos
|
|
64
|
+
- Se os arquivos ja existirem, faca merge (nao reescreva do zero)
|
|
65
|
+
- CLAUDE.md = stack/arquitetura (estavel). project-profile.md = padroes de teste (estavel)
|
|
66
|
+
- NAO inclua lista de modulos implementados — a skill descobre via Glob quando precisar
|
|
67
|
+
|
|
68
|
+
$ARGUMENTS
|
|
@@ -1,98 +1,33 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Gera um prompt 5 estrelas completo a partir de um resumo da tarefa
|
|
3
|
-
argument-hint: [resumo ou descrição da tarefa]
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
- **
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
# 🚫 O que você NÃO deve fazer
|
|
35
|
-
|
|
36
|
-
1. Nunca pular diretamente para o prompt final sem coletar as informações.
|
|
37
|
-
2. Nunca assumir informações que o usuário não forneceu.
|
|
38
|
-
3. Nunca fazer múltiplas perguntas de uma vez.
|
|
39
|
-
4. Nunca gerar um prompt incompleto ou genérico.
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
# 📋 Fluxo de Perguntas
|
|
44
|
-
|
|
45
|
-
## Seção 1 - Contexto
|
|
46
|
-
Pergunte uma por vez:
|
|
47
|
-
- Qual linguagem/framework está sendo utilizado?
|
|
48
|
-
- Qual arquitetura/padrão o projeto segue?
|
|
49
|
-
- Quem é o público-alvo da entrega?
|
|
50
|
-
- Existem limitações ou restrições importantes?
|
|
51
|
-
|
|
52
|
-
## Seção 2 - Objetivo
|
|
53
|
-
Pergunte uma por vez:
|
|
54
|
-
- O que exatamente precisa ser entregue?
|
|
55
|
-
- Por que essa tarefa é necessária?
|
|
56
|
-
- Qual o resultado esperado?
|
|
57
|
-
|
|
58
|
-
## Seção 3 - Instruções Específicas
|
|
59
|
-
Pergunte uma por vez:
|
|
60
|
-
- Quais são os detalhes técnicos importantes?
|
|
61
|
-
- Existem restrições de implementação?
|
|
62
|
-
- Qual deve ser a estrutura lógica da solução?
|
|
63
|
-
|
|
64
|
-
## Seção 4 - DEVE / NÃO DEVE
|
|
65
|
-
Pergunte uma por vez:
|
|
66
|
-
- O que a IA DEVE fazer obrigatoriamente? (pelo menos 3 itens)
|
|
67
|
-
- O que a IA NÃO DEVE fazer de jeito nenhum? (pelo menos 3 itens)
|
|
68
|
-
- Existe alguma atenção especial crítica?
|
|
69
|
-
|
|
70
|
-
## Seção 5 - Formato da Resposta
|
|
71
|
-
Pergunte uma por vez:
|
|
72
|
-
- Qual estrutura você prefere para a resposta?
|
|
73
|
-
- Existem limites de tamanho ou escopo?
|
|
74
|
-
- Qual estilo deve ser usado?
|
|
75
|
-
|
|
76
|
-
## Seção 6 - Persona / Tom
|
|
77
|
-
Pergunte uma por vez:
|
|
78
|
-
- Qual perspectiva a IA deve assumir?
|
|
79
|
-
- Qual tom deve ter a explicação?
|
|
80
|
-
- Qual nível de profundidade?
|
|
81
|
-
|
|
82
|
-
## Seção 7 - Critérios de Aceite (opcional)
|
|
83
|
-
- Quais critérios objetivos determinam se a resposta está correta?
|
|
84
|
-
|
|
85
|
-
## Seção 8 - Exemplos (opcional)
|
|
86
|
-
- Você tem exemplos de entrada/saída esperada?
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
# 🧱 Template oficial do Prompt (sempre use)
|
|
91
|
-
|
|
92
|
-
@.claude/templates/prompt_template.md
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
96
|
-
# 📝 Resumo da tarefa do usuário
|
|
97
|
-
|
|
98
|
-
$ARGUMENTS
|
|
1
|
+
---
|
|
2
|
+
description: Gera um prompt 5 estrelas completo a partir de um resumo da tarefa
|
|
3
|
+
argument-hint: [resumo ou descrição da tarefa]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Acione a skill `prompt-engineer-expert` para gerar o prompt.
|
|
7
|
+
|
|
8
|
+
Contexto da tarefa do usuário: $ARGUMENTS
|
|
9
|
+
|
|
10
|
+
## Pós-geração: Seção de Testes (opcional)
|
|
11
|
+
|
|
12
|
+
Após o prompt ser gerado e salvo pela skill, pergunte ao usuário:
|
|
13
|
+
|
|
14
|
+
> Deseja que eu gere a seção de testes de unidade para este prompt? Isso aciona um agente especialista em QA que analisa o codebase e produz cenários de teste específicos.
|
|
15
|
+
|
|
16
|
+
Se o usuário responder **SIM**:
|
|
17
|
+
|
|
18
|
+
1. Use a ferramenta `Agent` com `subagent_type="qa-staff-engineer"` para delegar a geração.
|
|
19
|
+
2. No prompt do subagente, envie todas as informações do prompt gerado:
|
|
20
|
+
- Contexto técnico (linguagem, framework, arquitetura)
|
|
21
|
+
- Objetivo da tarefa
|
|
22
|
+
- Instruções específicas e restrições
|
|
23
|
+
- Regras DEVE / NÃO DEVE
|
|
24
|
+
- Arquivos envolvidos (se coletados)
|
|
25
|
+
- Padrões de teste do projeto (disponíveis no CLAUDE.md e project-profile)
|
|
26
|
+
3. Instrua o subagente a retornar no formato da Seção 10 do template:
|
|
27
|
+
- **Escopo dos testes**: camadas a testar
|
|
28
|
+
- **Cenários obrigatórios**: sucesso, erro, edge cases
|
|
29
|
+
- **Padrão de testes**: convenções (table-driven, mocks, nomenclatura)
|
|
30
|
+
- **Arquivo de referência**: testes existentes como modelo
|
|
31
|
+
4. Incorpore o resultado na Seção 10 do prompt final já salvo.
|
|
32
|
+
|
|
33
|
+
Se o usuário responder **NÃO**, encerre normalmente.
|
|
@@ -4,41 +4,69 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Arquitetura
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
### Skills (definem O QUE)
|
|
10
10
|
|
|
11
11
|
| Skill | Persona | Responsabilidade |
|
|
12
12
|
|-------|---------|-----------------|
|
|
13
13
|
| `ministack-intent-expert` | Product Owner / PM | Gera INTENT (O QUE e POR QUE) |
|
|
14
|
-
| `ministack-scope-expert` | Arquiteto de Software Senior | Gera SCOPE (COMO sera feito) |
|
|
15
|
-
| `ministack-expert` | Engenheiro de Software | TASKS
|
|
16
|
-
|
|
14
|
+
| `ministack-scope-expert` | Arquiteto de Software Senior | Gera SCOPE (COMO sera feito) + project-profile.md |
|
|
15
|
+
| `ministack-tasks-expert` | Engenheiro de Software Senior | Gera TASKS atomicas e executaveis |
|
|
16
|
+
|
|
17
|
+
### Agentes (validam)
|
|
18
|
+
|
|
19
|
+
| Agente | Papel | Quando |
|
|
20
|
+
|--------|-------|--------|
|
|
21
|
+
| `qa-staff-engineer` | QA Engineer Senior | Gera testes (no generate-tasks) + valida pos-implementacao (Gate 1) |
|
|
22
|
+
| `tech-review-conformance` | Tech Reviewer | Valida conformidade arquitetural (Gate 2) + code review |
|
|
23
|
+
|
|
24
|
+
### Comandos (orquestram COMO)
|
|
25
|
+
|
|
26
|
+
| Comando | Descricao |
|
|
27
|
+
|---------|-----------|
|
|
28
|
+
| `/generate-intent` | Gera INTENT via skill intent-expert |
|
|
29
|
+
| `/generate-scope` | Gera SCOPE via skill scope-expert |
|
|
30
|
+
| `/generate-tasks` | Gera TASKS via skill tasks-expert + delega testes ao qa-staff-engineer |
|
|
31
|
+
| `/code-review` | Delega review ao agente tech-review-conformance |
|
|
32
|
+
| `/run-ministack-tasks` | Orquestra execucao com gates QA + Tech Review |
|
|
33
|
+
| `/run-ministack-withlinear` | Execucao com rastreamento no Linear |
|
|
17
34
|
|
|
18
35
|
---
|
|
19
36
|
|
|
20
37
|
## Fluxo Completo
|
|
21
38
|
|
|
22
39
|
```
|
|
23
|
-
Descricao
|
|
24
|
-
|
|
25
|
-
/generate-intent
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
/generate-scope
|
|
31
|
-
|
|
32
|
-
/generate-tasks
|
|
33
|
-
|
|
34
|
-
/
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
40
|
+
Descricao da Feature
|
|
41
|
+
|
|
|
42
|
+
/generate-intent skill: ministack-intent-expert
|
|
43
|
+
| (INTENT aprovada)
|
|
44
|
+
|
|
|
45
|
+
+-- tech_direction.md (OPCIONAL - criado manualmente pelo dev)
|
|
46
|
+
|
|
|
47
|
+
/generate-scope skill: ministack-scope-expert
|
|
48
|
+
| (SCOPE aprovado) (gera project-profile.md se nao existe)
|
|
49
|
+
/generate-tasks skill: ministack-tasks-expert
|
|
50
|
+
| (TASKS aprovadas) comando delega testes ao qa-staff-engineer
|
|
51
|
+
/run-ministack-tasks COMANDO ORQUESTRADOR
|
|
52
|
+
|
|
|
53
|
+
[Para cada Task]:
|
|
54
|
+
|
|
|
55
|
+
Executor (agent_name) sub-agente implementa
|
|
56
|
+
|
|
|
57
|
+
qa-staff-engineer Gate 1 (VALIDAR_IMPLEMENTACAO)
|
|
58
|
+
|
|
|
59
|
+
├─ REJEITADO → Fix Loop → volta ao Gate 1
|
|
60
|
+
└─ APROVADO ↓
|
|
61
|
+
|
|
|
62
|
+
tech-review-conformance Gate 2
|
|
63
|
+
|
|
|
64
|
+
├─ rejected → Fix Loop → volta ao Gate 1
|
|
65
|
+
└─ approved → Task Concluida
|
|
66
|
+
|
|
|
67
|
+
(max 3 tentativas → Blocked + escalar)
|
|
68
|
+
|
|
|
69
|
+
Feature Implementada
|
|
42
70
|
```
|
|
43
71
|
|
|
44
72
|
---
|
|
@@ -76,43 +104,34 @@ Define escopo tecnico (COMO) baseado na INTENT aprovada.
|
|
|
76
104
|
|
|
77
105
|
### 3. `/generate-tasks`
|
|
78
106
|
|
|
79
|
-
Gera tasks atomicas e executaveis
|
|
107
|
+
Gera tasks atomicas e executaveis. Testes sao delegados automaticamente ao agente `qa-staff-engineer`.
|
|
80
108
|
|
|
81
109
|
```
|
|
82
110
|
/generate-tasks [Cole INTENT + SCOPE]
|
|
83
111
|
```
|
|
84
112
|
|
|
85
|
-
### 4. `/
|
|
86
|
-
|
|
87
|
-
Gera estrategia de testes completa ou testes por task.
|
|
88
|
-
|
|
89
|
-
```
|
|
90
|
-
/generate-tests docs/nome-feature/v1/scope.md
|
|
91
|
-
/generate-tests docs/nome-feature/v1/tasks.md T1
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
### 5. `/code-review`
|
|
113
|
+
### 4. `/code-review`
|
|
95
114
|
|
|
96
|
-
|
|
115
|
+
Delega review tecnico ao agente `tech-review-conformance`.
|
|
97
116
|
|
|
98
117
|
```
|
|
99
118
|
/code-review docs/nome-feature/v1
|
|
100
119
|
```
|
|
101
120
|
|
|
102
|
-
###
|
|
121
|
+
### 5. `/run-ministack-tasks`
|
|
103
122
|
|
|
104
|
-
|
|
123
|
+
Orquestra execucao com gates QA + Tech Review (max 3 tentativas por task).
|
|
105
124
|
|
|
106
125
|
```
|
|
107
|
-
/run-ministack-tasks docs/nome-feature/v1
|
|
126
|
+
/run-ministack-tasks docs/nome-feature/v1 go-expert
|
|
108
127
|
```
|
|
109
128
|
|
|
110
|
-
###
|
|
129
|
+
### 6. `/run-ministack-withlinear`
|
|
111
130
|
|
|
112
131
|
Executa tasks com rastreamento automatico no Linear.
|
|
113
132
|
|
|
114
133
|
```
|
|
115
|
-
/run-ministack-withlinear docs/nome-feature/v1 Backend
|
|
134
|
+
/run-ministack-withlinear docs/nome-feature/v1 Backend go-expert
|
|
116
135
|
```
|
|
117
136
|
|
|
118
137
|
---
|
|
@@ -129,16 +148,12 @@ Para sincronizar tasks com o Linear sem executar:
|
|
|
129
148
|
|
|
130
149
|
## Templates
|
|
131
150
|
|
|
132
|
-
Os templates oficiais estao dentro de cada skill:
|
|
133
|
-
|
|
134
151
|
| Template | Skill | Caminho |
|
|
135
152
|
|----------|-------|---------|
|
|
136
153
|
| `intent-template.md` | `ministack-intent-expert` | `.claude/skills/ministack-intent-expert/templates/` |
|
|
137
154
|
| `tech_direction-template.md` | `ministack-scope-expert` | `.claude/skills/ministack-scope-expert/templates/` |
|
|
138
155
|
| `scope-template.md` | `ministack-scope-expert` | `.claude/skills/ministack-scope-expert/templates/` |
|
|
139
|
-
| `tasks-template.md` | `ministack-expert` | `.claude/skills/ministack-expert/templates/` |
|
|
140
|
-
| `test_strategy_template.md` | `ministack-qa-expert` | `.claude/skills/ministack-qa-expert/templates/` |
|
|
141
|
-
| `task_tests_template.md` | `ministack-qa-expert` | `.claude/skills/ministack-qa-expert/templates/` |
|
|
156
|
+
| `tasks-template.md` | `ministack-tasks-expert` | `.claude/skills/ministack-tasks-expert/templates/` |
|
|
142
157
|
|
|
143
158
|
---
|
|
144
159
|
|
|
@@ -1,67 +1,54 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
3
|
-
argument-hint:
|
|
2
|
+
description: "Code review do miniStack validando INTENT, SCOPE e TASKS. Param: caminho do task_plan.md"
|
|
3
|
+
argument-hint: "<task_plan.md ex: docs/carrinho-compra/v1/task_plan.md>"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
## Contexto
|
|
9
|
-
|
|
10
|
-
Voce deve seguir as regras e o processo da **ETAPA 4: CODE REVIEW** definida na skill ministack-expert.
|
|
6
|
+
Voce e um **Coordenador de Review Tecnico**. Seu papel e orquestrar a validacao dos documentos da feature delegando ao agente `tech-review-conformance`.
|
|
11
7
|
|
|
12
8
|
## Processo
|
|
13
9
|
|
|
14
|
-
1.
|
|
15
|
-
2.
|
|
16
|
-
3.
|
|
17
|
-
|
|
18
|
-
5. Gere o relatorio em `<pasta_feature>/code_review/code_review_report.md`
|
|
19
|
-
6. Crie tasks de correcao em `<pasta_feature>/code_review/tasks/`
|
|
20
|
-
7. Apresente o resumo ao usuario
|
|
21
|
-
|
|
22
|
-
## Formato do Relatorio
|
|
23
|
-
|
|
24
|
-
```markdown
|
|
25
|
-
# Code Review Report - [NOME_DA_FEATURE]
|
|
10
|
+
1. Leia o `task_plan.md` fornecido no argumento
|
|
11
|
+
2. Extraia os caminhos de **Intent** e **Scope** da secao 1 (Identificacao) do task_plan
|
|
12
|
+
3. Leia: intent.md, scope.md (dos caminhos extraidos) e cada `tasks/T[N].md` (no diretorio-base)
|
|
13
|
+
3. Dispare o agente `tech-review-conformance` com o contexto completo
|
|
26
14
|
|
|
27
|
-
|
|
28
|
-
**Revisor**: Claude Code Review Agent
|
|
29
|
-
**Status Geral**: [APROVADO | APROVADO COM RESSALVAS | REPROVADO]
|
|
15
|
+
## Disparar o Agente
|
|
30
16
|
|
|
31
|
-
|
|
32
|
-
| Metrica | Valor |
|
|
33
|
-
|---------|-------|
|
|
34
|
-
| Cobertura INTENT no SCOPE | X% |
|
|
35
|
-
| Cobertura SCOPE nas TASKS | X% |
|
|
36
|
-
| Qualidade das TASKS | X% |
|
|
37
|
-
| Issues Criticas | X |
|
|
17
|
+
Lance o agente usando a ferramenta `Agent` com:
|
|
38
18
|
|
|
39
|
-
|
|
40
|
-
|
|
19
|
+
- **subagent_type**: `tech-review-conformance`
|
|
20
|
+
- **description**: "Tech Review feature [nome]"
|
|
21
|
+
- **prompt**:
|
|
41
22
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
##
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
23
|
+
```
|
|
24
|
+
Realize a revisao tecnica dos documentos da feature.
|
|
25
|
+
|
|
26
|
+
## Documentos para Revisar
|
|
27
|
+
- INTENT: [caminho]/intent.md
|
|
28
|
+
- SCOPE: [caminho]/scope.md
|
|
29
|
+
- TASK PLAN: [caminho]/task_plan.md
|
|
30
|
+
- TASKS: [caminho]/tasks/T*.md (todos os arquivos individuais)
|
|
31
|
+
|
|
32
|
+
## O que Validar
|
|
33
|
+
1. **INTENT vs SCOPE**: O SCOPE cobre o que a INTENT precisa?
|
|
34
|
+
2. **SCOPE vs TASKS**: As TASKS implementam tudo do SCOPE?
|
|
35
|
+
3. **Qualidade das TASKS**: Criterios claros e verificaveis?
|
|
36
|
+
4. **Seguranca**: Autenticacao, autorizacao, dados sensiveis, validacao de input
|
|
37
|
+
5. **Performance**: Paginacao, cache, concorrencia
|
|
38
|
+
6. **Testabilidade**: Criterios mensuraveis, cobertura de sucesso e erro
|
|
39
|
+
|
|
40
|
+
Leia TODOS os documentos listados e retorne a revisao completa.
|
|
49
41
|
```
|
|
50
42
|
|
|
51
|
-
##
|
|
43
|
+
## Saida
|
|
52
44
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
-
|
|
57
|
-
- Prioridade: CRITICA | ALTA | MEDIA | BAIXA
|
|
58
|
-
## Contexto
|
|
59
|
-
## Objetivo
|
|
60
|
-
## Criterio de Conclusao
|
|
61
|
-
```
|
|
45
|
+
Apresente o resultado do agente ao usuario com:
|
|
46
|
+
- Status: APROVADO | APROVADO COM RESSALVAS | REPROVADO
|
|
47
|
+
- Issues encontradas categorizadas por severidade
|
|
48
|
+
- Sugestoes de correcao
|
|
62
49
|
|
|
63
50
|
## Entrada
|
|
64
51
|
|
|
65
|
-
Caminho da feature para
|
|
52
|
+
Caminho da feature para review:
|
|
66
53
|
|
|
67
54
|
$ARGUMENTS
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: Gera
|
|
3
|
-
argument-hint:
|
|
2
|
+
description: "Gera INTENT do miniStack. Param: descricao da feature (ex: 'sistema de carrinho de compras com adicao e remocao de itens')"
|
|
3
|
+
argument-hint: "<descricao da feature em texto livre>"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
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
|
|
|
15
15
|
- **NUNCA** deduza escopo ou invente informacoes — na **DUVIDA PERGUNTE AO USUARIO**
|
|
16
16
|
- Pense sempre no **O QUE** e **POR QUE**, nunca no **COMO**
|
|
17
17
|
|
|
18
|
+
## Estado do Pipeline (ministack_state.yaml)
|
|
19
|
+
|
|
20
|
+
Apos salvar a INTENT com sucesso, voce DEVE criar o arquivo `ministack_state.yaml` no mesmo diretorio da INTENT.
|
|
21
|
+
|
|
22
|
+
```yaml
|
|
23
|
+
feature: "<nome da feature extraido da INTENT>"
|
|
24
|
+
current_step: intent
|
|
25
|
+
steps:
|
|
26
|
+
intent:
|
|
27
|
+
status: completed
|
|
28
|
+
summary: "<objetivo em 1 frase curta>. Escopo: <itens principais>"
|
|
29
|
+
tech_direction:
|
|
30
|
+
status: pending
|
|
31
|
+
scope:
|
|
32
|
+
status: pending
|
|
33
|
+
task_plan:
|
|
34
|
+
status: pending
|
|
35
|
+
execution:
|
|
36
|
+
status: pending
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Se o arquivo **ja existir** (ex: revisao da INTENT), atualize apenas o bloco `intent` e resete os steps posteriores para `pending`.
|
|
40
|
+
|
|
18
41
|
## Entrada
|
|
19
42
|
|
|
20
43
|
$ARGUMENTS
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
3
|
-
argument-hint:
|
|
2
|
+
description: "Gera SCOPE do miniStack a partir de INTENT aprovada. Param: caminho do intent.md"
|
|
3
|
+
argument-hint: "<caminho intent.md ex: docs/carrinho-compra/v1/intent.md>"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
Use a skill **ministack-scope-expert** para gerar o SCOPE.
|
|
@@ -10,12 +10,13 @@ Use a skill **ministack-scope-expert** para gerar o SCOPE.
|
|
|
10
10
|
Voce deve atuar como um **Arquiteto de Software Senior** e seguir as regras e o processo definidos na skill ministack-scope-expert.
|
|
11
11
|
|
|
12
12
|
O $ARGUMENTS deve conter:
|
|
13
|
-
1. **
|
|
14
|
-
|
|
13
|
+
1. **caminho do intent.md** (obrigatorio) — ex: `docs/carrinho-compra/v1/intent.md`
|
|
14
|
+
|
|
15
|
+
O scope.md sera gerado no mesmo diretorio do intent.md.
|
|
15
16
|
|
|
16
17
|
## Tech Direction (Opcional)
|
|
17
18
|
|
|
18
|
-
Antes de iniciar, verifique se existe um arquivo `tech_direction.md`
|
|
19
|
+
Antes de iniciar, verifique se existe um arquivo `tech_direction.md` no mesmo diretorio do intent.md.
|
|
19
20
|
|
|
20
21
|
- Se existir, use como **ponto de partida** para decisoes tecnicas — nao como verdade absoluta
|
|
21
22
|
- 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
|
|
|
27
28
|
- **Claude Code**: use a ferramenta `AskUserQuestion` para esclarecer duvidas com o usuario
|
|
28
29
|
- **NUNCA** deduza escopo ou invente informacoes — na **DUVIDA PERGUNTE AO USUARIO**
|
|
29
30
|
- Pense sempre no **COMO** sera feito baseado na INTENT
|
|
30
|
-
- **ANTES de definir o SCOPE**,
|
|
31
|
+
- **ANTES de definir o SCOPE**, explore as camadas existentes do projeto para propor a melhor solucao como um **arquiteto senior**
|
|
31
32
|
- Liste **TODOS** os arquivos envolvidos e as acoes (criar/modificar/remover) — economiza tokens e scans
|
|
32
33
|
|
|
34
|
+
## Estado do Pipeline (ministack_state.yaml)
|
|
35
|
+
|
|
36
|
+
Apos salvar o scope.md com sucesso, atualize o arquivo `ministack_state.yaml` no mesmo diretorio:
|
|
37
|
+
|
|
38
|
+
```yaml
|
|
39
|
+
# atualizar apenas estes campos:
|
|
40
|
+
current_step: scope
|
|
41
|
+
steps:
|
|
42
|
+
scope:
|
|
43
|
+
status: completed
|
|
44
|
+
summary: "<componentes novos>, <N endpoints>, tabelas: <lista tabelas>"
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Se o usuario pulou o tech_direction, marque-o como `skipped`:
|
|
48
|
+
|
|
49
|
+
```yaml
|
|
50
|
+
steps:
|
|
51
|
+
tech_direction:
|
|
52
|
+
status: skipped
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Se o `ministack_state.yaml` nao existir, nao crie — o generate-intent e responsavel por criar.
|
|
56
|
+
|
|
33
57
|
## Entrada
|
|
34
58
|
|
|
35
59
|
Cole a INTENT aprovada:
|