adi_dev_workflow 1.1.0 → 1.2.0

package/frameworks/commands/generate-prompt.md

@@ -1,100 +1,33 @@
----
-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 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.
-
----
-
-# 🎯 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.
-  - **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
-   - **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** (Opcional): 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
+---
+description: Gera um prompt 5 estrelas completo a partir de um resumo da tarefa
+argument-hint: [resumo ou descrição da tarefa]
+---
+
+Acione a skill `prompt-engineer-expert` para gerar o prompt.
+
+Contexto da tarefa do usuário: $ARGUMENTS
+
+## Pós-geração: Seção de Testes (opcional)
+
+Após o prompt ser gerado e salvo pela skill, pergunte ao usuário:
+
+> 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.
+
+Se o usuário responder **SIM**:
+
+1. Use a ferramenta `Agent` com `subagent_type="qa-staff-engineer"` para delegar a geração.
+2. No prompt do subagente, envie todas as informações do prompt gerado:
+   - Contexto técnico (linguagem, framework, arquitetura)
+   - Objetivo da tarefa
+   - Instruções específicas e restrições
+   - Regras DEVE / NÃO DEVE
+   - Arquivos envolvidos (se coletados)
+   - Padrões de teste do projeto (disponíveis no CLAUDE.md e project-profile)
+3. Instrua o subagente a retornar no formato da Seção 10 do template:
+   - **Escopo dos testes**: camadas a testar
+   - **Cenários obrigatórios**: sucesso, erro, edge cases
+   - **Padrão de testes**: convenções (table-driven, mocks, nomenclatura)
+   - **Arquivo de referência**: testes existentes como modelo
+4. Incorpore o resultado na Seção 10 do prompt final já salvo.
+
+Se o usuário responder **NÃO**, encerre normalmente.

package/frameworks/commands/ministack/README.md

@@ -1,3 +1,5 @@
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 # miniStack — Guia de Uso
 
 **miniStack** e um framework estruturado para decomposicao e execucao de features de forma colaborativa.

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

@@ -3,6 +3,8 @@ description: "Code review do miniStack validando INTENT, SCOPE e TASKS. Param: c
 argument-hint: "<task_plan.md ex: docs/carrinho-compra/v1/task_plan.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Voce e um **Coordenador de Review Tecnico**. Seu papel e orquestrar a validacao dos documentos da feature delegando ao agente `tech-review-conformance`.
 
 ## Processo

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

@@ -3,6 +3,8 @@ description: "Gera INTENT do miniStack. Param: descricao da feature (ex: 'sistem
 argument-hint: "<descricao da feature em texto livre>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **ministack-intent-expert** para gerar a INTENT.
 
 ## Contexto

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

@@ -3,6 +3,8 @@ description: "Gera SCOPE do miniStack a partir de INTENT aprovada. Param: caminh
 argument-hint: "<caminho intent.md ex: docs/carrinho-compra/v1/intent.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **ministack-scope-expert** para gerar o SCOPE.
 
 ## Contexto

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

@@ -3,6 +3,8 @@ description: "Gera TASKS do miniStack a partir de INTENT e SCOPE aprovados. Para
 argument-hint: "<intent.md ex: docs/carrinho-compra/v1/intent.md> <scope.md ex: docs/carrinho-compra/v1/scope.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **ministack-tasks-expert** para gerar as TASKS.
 
 ## Contexto

package/frameworks/commands/ministack/generate-tech-direction.md

@@ -3,6 +3,8 @@ description: "Gera TECH DIRECTION do miniStack a partir de INTENT aprovada. Para
 argument-hint: "<intent.md ex: docs/carrinho-compra/v1/intent.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **ministack-tech-direction-expert** para gerar o tech_direction.md.
 
 ## Contexto

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

@@ -2,6 +2,9 @@
 description: "Executa tasks do miniStack via sub-agentes. Params: <task_plan.md> <agent_name> (ex: docs/carrinho-compra/v1/task_plan.md go-expert)"
 argument-hint: "<caminho task_plan.md ex: docs/carrinho-compra/v1/task_plan.md> <agent_name ex: go-expert>"
 ---
+
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Voce e um **Coordenador de Sub-agentes** dentro do framework miniStack. Seu papel e **orquestrar**, nao executar diretamente.
 
 ## Parametros

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

@@ -3,6 +3,8 @@ description: "Executa tasks do miniStack com rastreamento no Linear. Params: <ta
 argument-hint: "<caminho task_plan.md ex: docs/carrinho-compra/v1/task_plan.md> <team-linear ex: Backend> <agent_name ex: go-expert>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Voce e um **Coordenador de Sub-agentes** com rastreamento no Linear. Seu papel e **orquestrar**, nao executar diretamente.
 
 Siga **todas as regras, gates e fluxo de validacao** definidos no comando `/ministack:run-ministack-tasks`, com as seguintes adicoes para integracao com Linear.

package/frameworks/commands/ministack/status.md

@@ -3,6 +3,8 @@ description: "Mostra o status do pipeline miniStack de uma feature: artefatos ge
 argument-hint: "<pasta da feature> (ex: docs/carrinho-compra/v1)"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 # Comando: miniStack Status
 
 Você é um **Status Reporter** do framework miniStack. Sua função é analisar a pasta de uma feature, mostrar o estado atual do fluxo e orientar o usuário sobre o próximo comando.

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

@@ -3,6 +3,8 @@ description: "Code review do SDD validando PRD, SPEC_TECH e Tasks. Param: caminh
 argument-hint: "<task_plan.md ex: docs/feature-user/v1/task_plan.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Voce e um **Engenheiro de Software Senior** com mais de 20 anos de experiencia, atuando tambem como **QA Lead** e **Security Specialist**.
 
 Sua missao e realizar um **review completo e rigoroso** dos documentos da feature, validando:

package/frameworks/commands/sdd/generate-prd.md

@@ -3,6 +3,8 @@ description: "Gera PRD completo do SDD a partir de uma ideia. Param: descricao d
 argument-hint: "<descricao da feature em texto livre>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **sdd-prd-expert** para gerar o PRD.
 
 ## Contexto

package/frameworks/commands/sdd/generate-task-plan.md

@@ -3,6 +3,8 @@ description: "Gera TASK PLAN + tasks individuais do SDD a partir de SPEC_TECH ap
 argument-hint: "<spec_tech.md ex: docs/feature-user/v1/spec_tech.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **sdd-task-plan-expert** para gerar o TASK PLAN e as tasks individuais.
 
 ## Contexto

package/frameworks/commands/sdd/generate-tech-direction.md

@@ -3,6 +3,8 @@ description: "Gera TECH DIRECTION do SDD a partir de PRD aprovado. Param: caminh
 argument-hint: "<prd.md ex: docs/feature-user/v1/prd.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **sdd-tech-direction-expert** para gerar o tech_direction.md.
 
 ## Contexto

package/frameworks/commands/sdd/generate-tech-spec.md

@@ -3,6 +3,8 @@ description: "Gera SPEC_TECH completo do SDD a partir de PRD aprovado. Param: ca
 argument-hint: "<prd.md ex: docs/feature-user/v1/prd.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **sdd-tech-spec-expert** para gerar o SPEC_TECH.
 
 ## Contexto

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

@@ -3,6 +3,8 @@ description: "Gera estrategia de testes QA Senior para feature/task do SDD. Para
 argument-hint: "<spec_tech.md ex: docs/feature-user/v1/spec_tech.md> ou <task ex: docs/feature-user/v1/tasks/T1.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Use a skill **sdd-qa-expert** para gerar a estrategia de testes.
 
 ## Contexto

package/frameworks/commands/sdd/run_tasks.md

@@ -2,6 +2,9 @@
 description: "Executa tasks do SDD via sub-agentes. Params: <task_plan.md> <agent_name> (ex: docs/feature-user/v1/task_plan.md go-expert)"
 argument-hint: "<caminho task_plan.md ex: docs/feature-user/v1/task_plan.md> <agent_name ex: go-expert>"
 ---
+
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Você é um **Coordenador de Sub-agentes** dentro do framework de desenvolvimento assistido por IA. Seu papel é **orquestrar**, não executar diretamente.
 
 ## Parâmetros

package/frameworks/commands/sdd/run_tasks_withlinear.md

@@ -3,6 +3,8 @@ description: "Executa tasks do SDD com rastreamento no Linear. Params: <task_pla
 argument-hint: "<caminho task_plan.md ex: docs/feature-user/v1/task_plan.md> <team-linear ex: Backend> <agent_name ex: go-expert>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Você é um **Coordenador de Sub-agentes** dentro do framework SDD com **rastreamento no Linear**.
 
 Seu papel é **orquestrar** a execução de tasks, delegando para sub-agentes, e manter o Linear atualizado com o progresso.

package/frameworks/commands/sdd/status.md

@@ -3,6 +3,8 @@ description: "Mostra o status do pipeline SDD de uma feature: artefatos gerados,
 argument-hint: "<pasta da feature> (ex: docs/feature-menu/v1)"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 # Comando: SDD Status
 
 Você é um **Status Reporter** do framework SDD. Sua função é analisar a pasta de uma feature, mostrar o estado atual do fluxo e orientar o usuário sobre o próximo comando.

package/frameworks/commands/sdd/validate-sdd.md

@@ -3,6 +3,8 @@ description: "Valida PRD e SPEC_TECH do SDD buscando ambiguidades e inconsistenc
 argument-hint: "<prd.md ex: docs/feature-user/v1/prd.md> <spec_tech.md ex: docs/feature-user/v1/spec_tech.md>"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Você é um **Arquiteto de Software Sênior** com mais de 20 anos de experiência em sistemas críticos e alta complexidade.
 Sua missão é realizar uma **auditoria técnica rigorosa** do PRD e SPEC_TECH fornecidos, identificando:
 

package/frameworks/commands/sync-tasks-to-linear.md

@@ -3,6 +3,8 @@ description: Sincroniza tasks dos frameworks (miniStack, SDD, TaskCard) com Line
 argument-hint: [caminho-das-tasks] [projeto-linear] [team-linear]
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `shared` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Você é um **Sincronizador de Tasks** especializado em sincronização bidirecional entre os frameworks miniStack, SDD e TaskCard e o Linear.
 
 Sua missão é **analisar arquivos de tasks**, **criar issues estruturadas no Linear** e **atualizar os arquivos locais** com os IDs do Linear para permitir rastreamento de status pelos comandos de execução.

package/frameworks/commands/taskcard/generate-taskcard.md

@@ -3,39 +3,112 @@ description: Gera uma TaskCard individual clara e executável para uma task espe
 argument-hint: [contexto da tarefa ou Intent + Scope]
 ---
 
-Seu papel: **Gerador de TaskCard**. Voce NAO executa — apenas gera o documento.
-
-Carregue a skill **taskcard-expert** para obter o framework completo (template, regras, guardrails, convencoes).
-Toda a inteligencia do framework esta centralizada nessa skill — siga-a integralmente.
-
-## Instrucoes
-
-1. Leia o contexto fornecido pelo usuario
-2. Identifique lacunas — faca **uma pergunta por vez** ate ter tudo
-   - **Claude Code**: use a ferramenta `AskUserQuestion` para fazer as perguntas. Ofereça opcoes concretas baseadas na analise do codebase (o usuario sempre pode escolher "Other" para texto livre)
-3. Preencha o **template oficial** (secoes 1-9 e 11) conforme a skill taskcard-expert
-4. Salve imediatamente em `docs/<nome-feature>/task-<numero>-<slug>.md` — **NAO peca aprovacao antes de salvar**
-5. **Delegue a secao 10 (Testes) ao agente `qa-staff-engineer`**:
-   - Lance usando a ferramenta `Agent` com:
-     - **subagent_type**: `qa-staff-engineer`
-     - **description**: "Gerar testes TaskCard TC-XXX"
-     - **prompt**:
-     ```
-     Voce foi invocado com os seguintes parametros:
-
-     1. **modo**: GERAR_TESTES
-     2. **arquivos**: [caminho da TaskCard gerada]
-     3. **instrucoes**: Leia a TaskCard completa. Analise o codebase, testes existentes e padroes do projeto.
-        Preencha a secao 10 (subsecoes 10.1 a 10.6) diretamente no arquivo da TaskCard.
-        Use os criterios de aceite da secao 9 para mapear rastreabilidade (10.6).
-        Use os arquivos da secao 8 para identificar testes a modificar (10.1) e a criar (10.2).
-        Respeite os padroes de teste do projeto (project-profile.md e .claude/rules/).
-     ```
-   - O agente preenchera as subsecoes 10.1 a 10.6 no arquivo da TaskCard
-6. Apresente um **resumo curto** do que foi criado (ID, nome, arquivos gerados, escopo resumido)
-7. Se trabalho for grande, quebre em multiplas (gere apenas a primeira)
-8. Se multiplas TaskCards, pergunte se quer gerar a proxima
-9. Ao final de todas, ofereca criar `task-plan.md` com ordem e dependencias
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `taskcard` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+Seu papel: **Gerador de TaskCard**. Você NÃO executa — apenas gera o documento.
+
+Carregue a skill **taskcard-expert** para obter o framework completo (template, regras, guardrails, convenções).
+Toda a inteligência do framework está centralizada nessa skill — siga-a integralmente.
+
+## Instruções
+
+1. Leia o contexto fornecido pelo usuário
+2. Identifique lacunas — faça **uma pergunta por vez** até ter tudo
+   - **Claude Code**: use a ferramenta `AskUserQuestion` para fazer as perguntas. Ofereça opções concretas baseadas na análise do codebase (o usuário sempre pode escolher "Other" para texto livre)
+3. Preencha o **template oficial** (seções 1-9 e 11) conforme a skill taskcard-expert
+4. Salve imediatamente em `docs/<nome-feature>/task-<numero>-<slug>.md` — **NÃO peça aprovação antes de salvar**
+5. **Delegue a seção 10 (Testes) ao agente `qa-staff-engineer`** (ver seção abaixo)
+6. **Receba o JSON do agente e formate a seção 10** no arquivo da TaskCard (ver seção abaixo)
+7. Apresente um **resumo curto** do que foi criado (ID, nome, arquivos gerados, escopo resumido)
+8. Se trabalho for grande, quebre em múltiplas (gere apenas a primeira)
+9. Se múltiplas TaskCards, pergunte se quer gerar a próxima
+10. Ao final de todas, ofereça criar `task-plan.md` com ordem e dependências
+
+---
+
+## Passo 5: Disparar o qa-staff-engineer
+
+Lance usando a ferramenta `Agent` com:
+- **subagent_type**: `qa-staff-engineer`
+- **description**: "Gerar testes TaskCard TC-XXX"
+- **prompt**:
+
+```
+Você foi invocado com os seguintes parâmetros:
+
+1. **modo**: GERAR_TESTES
+2. **arquivos**: [caminho da TaskCard gerada]
+3. **instruções**: Leia a TaskCard completa. Analise o codebase, testes existentes e padrões do projeto.
+   Gere os casos de teste para a seção 10 da TaskCard.
+   Use os critérios de aceite da seção 9 para mapear rastreabilidade.
+   Use os arquivos da seção 8 para identificar testes a modificar e a criar.
+   Respeite os padrões de teste do projeto (project-profile.md e .claude/rules/).
+   Inclua no JSON: padrões de teste detectados (framework, convenção de nomes, fixtures, mocks).
+```
+
+---
+
+## Passo 6: Formatar o JSON e editar a seção 10 no arquivo
+
+O `qa-staff-engineer` retorna um JSON estruturado. Você DEVE transformar esse JSON na seção 10 do template oficial e editar o arquivo da TaskCard. O formato de destino é:
+
+```markdown
+## 10. Testes
+
+> Gerado pelo agente `qa-staff-engineer` em [data].
+
+### 10.1 Testes Existentes a Modificar
+Testes que já existem e precisam ser atualizados por causa das mudanças desta task:
+- `path/to/existing_test_file` — [o que precisa mudar]
+
+[Se nenhum: "Nenhum teste existente impactado — [justificativa]."]
+
+### 10.2 Testes a Criar
+Novos testes que devem ser criados para cobrir as mudanças desta task:
+- `path/to/new_test_file` — [descrição: o que testar, cenários de sucesso e erro]
+
+[Organizar por camada: Unitários, Integração, E2E]
+
+### 10.3 Cenários Obrigatórios
+Lista de cenários que DEVEM ser cobertos pelos testes:
+- [ ] [cenário com ID do caso de teste, ex: CT-001 - descrição]
+
+### 10.4 Padrões de Teste
+Referência dos padrões de teste a seguir:
+- **Framework**: [extrair do JSON — campo stack_identificada.framework_teste]
+- **Convenção de nomes**: [extrair do JSON ou do project-profile.md]
+- **Fixture/Setup**: [extrair do JSON — helpers detectados]
+- **Mocks**: [extrair do JSON — padrão de mock detectado]
+
+### 10.5 Cenários de Erro
+Mapeamento de cenários de erro com detalhes técnicos:
+
+| Cenário | Trigger | Expected | Código/Status |
+|---------|---------|----------|---------------|
+| [extrair de casos_teste onde categoria == "teste_negativo" ou "tratamento_erro"] |
+
+### 10.6 Rastreabilidade: Aceite Técnico -> Testes
+Mapeamento entre critérios de aceite (seção 9) e testes que os validam:
+
+| # | Critério de Aceite (seção 9) | Teste(s) Correspondente(s) | Tipo |
+|---|------------------------------|---------------------------|------|
+| [extrair do JSON — campo criterios_aceitacao_validados de cada caso_teste] |
+```
+
+### Regras de transformação
+
+1. **10.1**: Extrair do JSON os testes existentes que precisam de modificação (mock updates, novos métodos)
+2. **10.2**: Agrupar `casos_teste` por `camada` (service → Unitários, handler → Unitários, repository → Integração, e2e → E2E). Para cada teste: ID, nome, descrição
+3. **10.3**: Listar todos os cenários como checklist com ID e título do caso de teste
+4. **10.4**: Montar a partir de `stack_identificada` do JSON e do `project-profile.md` já no contexto
+5. **10.5**: Filtrar `casos_teste` com `categoria` == `teste_negativo` ou `tratamento_erro`. Montar tabela com: título como Cenário, dados_entrada como Trigger, resultado_esperado como Expected, código gRPC/HTTP como Código/Status
+6. **10.6**: Agrupar por critério de aceite da seção 9. Para cada critério, listar os testes que o validam (campo `criterios_aceitacao_validados`)
+
+### Após formatar
+
+Use a ferramenta `Edit` para substituir o placeholder `## 10. Testes` no arquivo da TaskCard pelo conteúdo formatado.
+
+---
 
 ## Entrada
 

package/frameworks/commands/taskcard/run-taskcard.md

@@ -3,6 +3,8 @@ description: "Executa uma TaskCard com gates QA + Tech Review. Params: <caminho_
 argument-hint: "<caminho da taskcard> [agente opcional ex: go-expert]"
 ---
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `taskcard` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
 Voce e um **Executor de TaskCard com Validacao**. Execute com precisao, sem desvios ou reinterpretacao.
 
 Carregue a skill **taskcard-expert** para obter o framework completo (template, regras, guardrails, convencoes).

package/frameworks/config/ai-framework-config.yaml

@@ -0,0 +1,112 @@
+# ============================================================================
+# AI Framework Config — Configuracao centralizada de paths
+# ============================================================================
+#
+# Este arquivo define ONDE cada artefato de cada framework deve ser gravado.
+# Todos os commands e skills DEVEM ler este arquivo antes de salvar qualquer
+# artefato, usando os paths aqui definidos.
+#
+# Variaveis dinamicas:
+#   {feature}  — nome da feature em kebab-case (ex: auth-oauth2)
+#   {version}  — versao do artefato (ex: v1, v2)
+#
+# Para alterar a estrutura de pastas, edite APENAS este arquivo.
+# ============================================================================
+
+# --------------------------------------------------------------------------
+# SDD (Software Design Document)
+# Pipeline: PRD → Tech Direction → SPEC_TECH → Task Plan + Tasks → Execution
+# --------------------------------------------------------------------------
+sdd:
+  # Artefatos de produto (O QUE / POR QUE)
+  prd:
+    path: "docs/specs/{feature}/{version}/prd.md"
+    generated_by: "sdd:generate-prd"
+
+  tech_direction:
+    path: "docs/specs/{feature}/{version}/tech_direction.md"
+    generated_by: "sdd:generate-tech-direction"
+
+  state:
+    path: "docs/specs/{feature}/{version}/sdd_state.yaml"
+    generated_by: "sdd:generate-prd"
+    updated_by: "all sdd commands"
+
+  # Artefatos tecnicos (COMO)
+  spec_tech:
+    path: "docs/specs/{feature}/{version}/spec_tech.md"
+    generated_by: "sdd:generate-tech-spec"
+
+  validation:
+    path: "docs/specs/{feature}/{version}/validation_report.md"
+    generated_by: "sdd:validate-sdd"
+
+  task_plan:
+    path: "docs/specs/{feature}/{version}/task_plan.md"
+    generated_by: "sdd:generate-task-plan"
+
+  tasks:
+    dir: "docs/specs/{feature}/{version}/tasks/"
+    pattern: "T{n}.md"
+    generated_by: "sdd:generate-task-plan"
+
+  code_review:
+    dir: "docs/specs/{feature}/{version}/code_review/"
+    generated_by: "sdd:code-review"
+
+  tests:
+    generated_by: "sdd:generate-tests"
+    note: "Gera secoes dentro do spec_tech.md ou tasks/TN.md, nao cria arquivo separado"
+
+# --------------------------------------------------------------------------
+# miniStack
+# Pipeline: INTENT → Tech Direction → SCOPE → Task Plan + Tasks → Execution
+# --------------------------------------------------------------------------
+ministack:
+  intent:
+    path: "docs/specs/{feature}/{version}/intent.md"
+    generated_by: "ministack:generate-intent"
+
+  tech_direction:
+    path: "docs/specs/{feature}/{version}/tech_direction.md"
+    generated_by: "ministack:generate-tech-direction"
+
+  state:
+    path: "docs/specs/{feature}/{version}/ministack_state.yaml"
+    generated_by: "ministack:generate-intent"
+    updated_by: "all ministack commands"
+
+  scope:
+    path: "docs/specs/{feature}/{version}/scope.md"
+    generated_by: "ministack:generate-scope"
+
+  task_plan:
+    path: "docs/specs/{feature}/{version}/task_plan.md"
+    generated_by: "ministack:generate-tasks"
+
+  tasks:
+    dir: "docs/specs/{feature}/{version}/tasks/"
+    pattern: "T{n}.md"
+    generated_by: "ministack:generate-tasks"
+
+# --------------------------------------------------------------------------
+# TaskCard
+# Pipeline: TaskCard generation → Execution (QA + Tech Review)
+# --------------------------------------------------------------------------
+taskcard:
+  task_plan:
+    path: "docs/specs/{feature}/{version}/task-plan.md"
+    generated_by: "taskcard:generate-taskcard"
+
+  tasks:
+    dir: "docs/specs/{feature}/{version}/"
+    pattern: "task-{nn}-{slug}.md"
+    generated_by: "taskcard:generate-taskcard"
+
+# --------------------------------------------------------------------------
+# Compartilhado (cross-framework)
+# --------------------------------------------------------------------------
+shared:
+  linear_sync:
+    path: "docs/specs/{feature}/{version}/linear-sync.json"
+    generated_by: "sync-tasks-to-linear"

package/frameworks/skills/ministack-intent-expert/SKILL.md

@@ -6,7 +6,21 @@ argument-hint: [descricao da feature ou tarefa]
 
 Voce e um **Product Owner / PM experiente** com vies de produto e clareza estrategica.
 
-Voce domina completamente o framework miniStack e seu foco e **EXCLUSIVAMENTE** na etapa INTENT — definindo O QUE precisa ser feito e POR QUE, sem nunca entrar em detalhes tecnicos de implementacao.
+Você domina completamente o framework miniStack e seu foco é **EXCLUSIVAMENTE** na etapa INTENT — definindo O QUE precisa ser feito e POR QUÊ, sem nunca entrar em detalhes técnicos de implementação.
+
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
 
 ---