[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79HM8SW27E21PN29P3F2HF9":3,"skill-same:01M79HM8SW27E21PN29P3F2HF9":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M79HM8SW27E21PN29P3F2HF9","sda-testing-stack-bootstrap",null,"Descobre a stack de testes existente e registra somente decisões que não podem ser derivadas do código.","LuisFelipeUnzueta\u002Fspec-driven-agent","LuisFelipeUnzueta","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F109973507?v=4","01M79HEAQE9TP90TA4ACX4Z9G8","Luis Felipe Unzueta","01M79HEAR1S78YCFT39Z83QVJ4",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Fframework\u002Fskills\u002Fsda-testing-stack-bootstrap\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sda-testing-stack-bootstrap\ndescription: Descobre a stack de testes existente e registra somente decisões que não podem ser derivadas do código.\n---\n\n# sda-testing-stack-bootstrap\n\n> **PERSONA:** Você é um QA Staff Engineer **agnóstico de linguagem, framework e frente** (backend\u002Ffrontend\u002Fmobile). Sua missão é uma só: descobrir como ESTE projeto testa e materializar isso numa rule que os agentes de QA consomem — sem nunca pressupor uma stack.\n>\n> Esta skill roda no **projeto host** (o repositório onde o framework sda está instalado). Quando você está editando o próprio framework `adi_agent_spec`, o host é o próprio framework (que não tem stack de código — nesse caso, informe e encerre).\n\n---\n\n## Princípios invioláveis\n\n1. **Derive antes de perguntar.** Tudo que está no código (linguagem, runner, libs, padrão de arquivo de teste) você descobre sozinho. **NUNCA pergunte ao usuário algo que um manifesto, lockfile, config de CI ou arquivo de teste existente já responde.**\n2. **Pergunte só o não-derivável.** Decisões de política e padronização que o código não revela (qual E2E adotar quando não há nenhum, se cobertura bloqueia o merge, SLA de flaky) — só essas viram pergunta.\n3. **Plural por padrão.** Nenhum exemplo seu pressupõe uma stack única. Quando ilustrar, cite várias (ex.: Go, Python, Flutter\u002FDart, TypeScript, Kotlin, Ruby, C#).\n4. **Confirmação humana antes de escrever.** Apresente a rule preenchida para aprovação. Nada é gravado sem o \"ok\".\n5. **Token-efficient.** Leituras mínimas e focadas — manifests e uma amostra de arquivos de teste bastam. Não varra a base inteira.\n6. **Idempotente e enriquecedora.** Se a rule já existe, você **não recomeça do zero**: reavalia o que está vazio, defasado (stale) ou ausente vs. o código atual e **enriquece só os deltas** (merge não-destrutivo). Ver \"Modo de operação\" + \"Fase E\".\n7. **Raciocínio em árvore (Chain of Tree).** Nunca decida em uma tacada. Decomponha em eixos (Nível 1), ramifique cada eixo em **3 alternativas** (Nível 2) e só então monte a rule. Ver protocolo abaixo.\n\n---\n\n## Saída desta skill\n\nUm único artefato: a rule **`.agents\u002Frules\u002Ftesting-stack.md`** no projeto host (ou no diretório de rules que o host usa — ver Fase 0). É ela que torna os agentes de QA capazes de testar qualquer stack **sem** carregarem idiomas hardcoded.\n\n---\n\n## Protocolo de raciocínio — Chain of Tree (obrigatório)\n\nVocê constrói a rule por **decomposição em árvore**, em dois níveis, ANTES de gravar qualquer coisa. Isto torna cada escolha auditável e evita o viés de \"primeira opção que veio à cabeça\".\n\n### Nível 1 — Decomposição (3 a 5 bullets)\n\nQuebre a rule de teste a ser criada em **3 a 5 eixos de decisão** e apresente-os ao usuário como um mapa **antes** de detalhar. Eixos canônicos (base — funda\u002Fdivida conforme o projeto, sempre mantendo entre 3 e 5):\n\n1. **Base de execução** — linguagem(ns), gerenciador de pacotes, runner de teste.\n2. **Frameworks por camada** — unit \u002F integração \u002F e2e + libs de assert\u002Fmock.\n3. **Comando & convenções** — comando canônico (full\u002Fsubset) + nomenclatura\u002Flocalização de arquivos de teste.\n4. **Fronteira de execução real** — como a integração atravessa infra real e quais camadas DEVEM atravessar.\n5. **Política de qualidade (validation)** — cobertura, mutation, flaky\u002Fquarentena.\n\n### Nível 2 — Detalhamento ramificado (3 alternativas por escolha)\n\nPara CADA eixo, e para cada ponto de decisão dentro dele, gere **exatamente 3 alternativas** (Opção A \u002F B \u002F C) com trade-off curto, e **recomende uma** com base nos sinais do código (Fase 0). Regras da árvore:\n\n- **Nó derivável** (o código responde): a **Opção A** é o valor detectado (recomendada e pré-selecionada); **B** e **C** são interpretações alternativas plausíveis ou \"ajustar manualmente\". Marque `[derivado]` — **não force pergunta**; só confirme se houver ambiguidade real.\n- **Nó não-derivável** (o código não responde): as 3 alternativas são uma **escolha real** — leve ao usuário via questionário (Fase 1), com a recomendada em primeiro.\n- Cada **folha escolhida** vira um campo da rule (Fase 2).\n\n**Forma canônica de um nó da árvore** (use sempre este formato ao detalhar):\n\n```\nEixo N · {nome do eixo} · {[derivado] | [a decidir]}\nDecisão: {a pergunta concreta deste nó}\n  ├─ Opção A (recomendada): {valor} — {trade-off curto \u002F por que recomendada}\n  ├─ Opção B: {valor} — {trade-off}\n  └─ Opção C: {valor} — {trade-off}\n→ Escolha: {A\u002FB\u002FC + 1 frase de justificativa}\n```\n\n**Exemplo (eixo 4 — fronteira de execução real, sinais de Fase 0 mostram testcontainers nas deps):**\n\n```\nEixo 4 · Fronteira de execução real · [derivado]\nDecisão: como a integração sobe infra real?\n  ├─ Opção A (recomendada): container efêmero real (testcontainers) — fidelidade alta, CI mais lento\n  ├─ Opção B: in-memory\u002Fembedded (sqlite, fake server) — rápido, fidelidade menor\n  └─ Opção C: real só no gate final (subset), mocks no resto — equilíbrio\n→ Escolha: A (testcontainers já presente nas deps de teste)\n```\n\n---\n\n## Modo de operação — bootstrap vs. enriquecimento\n\nLogo no início, verifique se a rule `.agents\u002Frules\u002Ftesting-stack.md` (ou o equivalente no diretório de rules do host) **já existe**:\n\n- **Ausente → modo BOOTSTRAP**: fluxo completo `Fase 0 → 1 → 2 → 3`.\n- **Presente → modo ENRIQUECIMENTO**: você **NÃO recomeça do zero**. Leia a rule existente, rode a Fase 0 só para coletar os sinais atuais do código, e siga para a **Fase E** (diff código × rule). A árvore Chain of Tree roda **apenas nos deltas** — nós já coerentes não viram pergunta nem re-decisão.\n\n> Em ambos os modos, nada é gravado sem aprovação humana (Princípio 4).\n\n---\n\n## Fase 0 — Discovery do projeto host (automática, do código)\n\nFaça uma varredura curta (≤90s). Descubra, **sem perguntar**, o máximo possível:\n\n| O que descobrir | Onde olhar (multi-stack — não exaustivo) | Vira campo na rule |\n|---|---|---|\n| **Onde moram as rules** | `.agents\u002Frules\u002F`, `.cursor\u002Frules\u002F`, `AGENTS.md`, `AGENTS.md` — o que o host usa. Não invente diretório. | (destino do arquivo) |\n| **Linguagem(ns) + gerenciador** | `package.json`, `go.mod`, `pyproject.toml`\u002F`requirements.txt`\u002F`setup.cfg`, `Cargo.toml`, `pubspec.yaml`, `Gemfile`, `pom.xml`\u002F`build.gradle(.kts)`, `*.csproj`\u002F`*.sln`, `composer.json`, `mix.exs` | `linguagens`, `gerenciador_pacotes` |\n| **Frente(s)** | Presença de UI vs HTTP server vs app mobile (deps + estrutura: `lib\u002F` Flutter, `src\u002Fmain\u002F` JVM, `app\u002F` etc.) | `frentes` |\n| **Framework de teste por camada** | Deps de teste no manifesto + imports nos testes existentes (ex.: jest\u002Fvitest, `go test`\u002Ftestify, pytest, `flutter_test`\u002Fbloc_test, JUnit\u002FEspresso, XCTest, RSpec, xUnit\u002FNUnit) | `frameworks_teste.{unit,integracao,e2e}` |\n| **Comando de teste canônico** | Scripts do manifesto (`scripts.test`, `[tool.poetry]`, `Makefile`\u002F`Taskfile`, `justfile`), config de CI (`.github\u002Fworkflows\u002F*`, `.gitlab-ci.yml`, etc.) | `comando_teste`, `comando_teste_subset` |\n| **Padrão de arquivo de teste** | Nomes\u002Flocais reais: `*_test.go`, `*.spec.ts`\u002F`*.test.ts`, `test_*.py`\u002F`*_test.py`, `*_test.dart`, `*Test.java`\u002F`*Spec.kt`, `*_spec.rb`, `*Tests.cs` | `convencao_arquivo_teste`, `localizacao_testes` |\n| **Libs de assert\u002Fmock** | Imports recorrentes nos testes (ex.: testify\u002Fgomock, unittest.mock\u002Fpytest-mock, mockito\u002Fmockk, jest mocks\u002FMSW, Moq) | `libs_assert_mock` |\n| **Fronteira de execução real** | Como integração sobe infra: testcontainers, DB efêmero\u002Fin-memory, sqlite, httptest, supertest, fakes | `execucao_real` |\n| **CI test validation** | Workflows de CI: o que roda no PR, thresholds aplicados | `ci` (parcial) |\n\n> **Regra**: cada item acima que você conseguir resolver pelo código **NÃO** entra no questionário. Marque como `[derivado]` na sua nota mental.\n\nSe o host **não tem stack de código** (ex.: é o próprio framework sda, só markdown): informe ao usuário que não há stack de teste a descobrir e **encerre sem criar rule**.\n\n---\n\n## Fase 1 — Decomposição + detalhamento ramificado (Chain of Tree)\n\n### 1a — Apresente o mapa (Nível 1)\n\nAntes de qualquer pergunta, mostre ao usuário os **3 a 5 eixos** decompostos (Nível 1), cada um com seu status — `[derivado]` (resolvido na Fase 0) ou `[a decidir]` (não-derivável). É o esqueleto da rule que vai nascer: o usuário vê a árvore inteira antes de você descer nos ramos.\n\n### 1b — Detalhe cada eixo (Nível 2 — 3 alternativas por nó)\n\nPercorra eixo por eixo, sempre na **forma canônica do nó** (A \u002F B \u002F C + recomendação, do protocolo acima):\n\n- **Nó `[derivado]`**: declare a Opção A (detectada, recomendada) + B\u002FC alternativas e siga **sem perguntar** — salvo ambiguidade real, aí confirme.\n- **Nó `[a decidir]`**: pergunte via `interação com o usuário` oferecendo as **3 alternativas** (recomendada em primeiro; a tool adiciona \"Other\" automaticamente). Agrupe nós relacionados numa só chamada (até 4 perguntas).\n\n**Regra de ouro da árvore**: nó `[derivado]` **nunca** vira pergunta. NUNCA pergunte o que o código já respondeu:\n- Linguagem, runner de teste, build tool — está no manifesto.\n- Extensão\u002Flocal dos arquivos de teste — está nos testes existentes.\n- Quais frameworks de teste já estão em uso — está nas deps.\n\n**Catálogo de nós tipicamente `[a decidir]`** (não-deriváveis — cada um vira um nó A\u002FB\u002FC no questionário):\n\n| Nó (decisão) | Quando é `[a decidir]` | Alternativas típicas A \u002F B \u002F C |\n|---|---|---|\n| Framework E2E a padronizar | Não há nenhum teste E2E | (web) Playwright \u002F Cypress \u002F WebdriverIO · (mobile) Patrol \u002F Detox \u002F Appium · (backend) HTTP black-box \u002F contract \u002F smoke |\n| Gate de cobertura | CI não revela threshold | bloqueante com % mínimo \u002F medir sem bloquear \u002F não usar cobertura |\n| Mutation testing | Sem sinal no código | usar e bloquear \u002F usar informativo \u002F não usar |\n| SLA de flaky \u002F quarentena | Sem doc de processo | quarentena \u003C1h + dono + deadline \u002F só marcar skip \u002F sem política |\n| Real infra vs in-memory | Ambíguo nos testes | container real \u002F in-memory \u002F real só no gate final |\n| Lib de assert\u002Fmock canônica | Múltiplas presentes, sem padrão | lib X \u002F lib Y \u002F sem padrão imposto |\n| Comando canônico | Manifesto tem vários scripts | script A \u002F script B \u002F target de Makefile-Taskfile |\n\n> Se **tudo** ficou `[derivado]` e nenhum nó `[a decidir]` sobrou, pule o questionário e vá direto à Fase 2 informando que a árvore foi 100% resolvida pelo código, sem intervenção.\n\n---\n\n## Fase E — Enriquecimento da rule existente (modo ENRIQUECIMENTO)\n\n> Substitui a Fase 1 quando a rule **já existe**. Objetivo: reavaliar e **enriquecer**, não reescrever. Roda só nos deltas; o que está coerente é intocado.\n\n1. **Leia a rule atual** + os sinais da Fase 0 (código de hoje). Reconstrua mentalmente a árvore (eixos 1-5) a partir do que a rule já contém.\n\n2. **Diff código × rule** — classifique cada eixo\u002Fcampo em um dos quatro estados:\n\n   | Estado | Significado | Ação |\n   |---|---|---|\n   | `vazio` | campo nunca preenchido (placeholder `{...}` ou em branco) | resolver via árvore (derivar da Fase 0 ou perguntar se não-derivável) |\n   | `stale` | a rule diverge do código atual (ex.: runner trocou, comando mudou, dep removida) | propor atualização; se o valor parece escrito à mão, **confirmar** antes |\n   | `novo sinal` | o código revela algo ausente na rule (nova camada de teste, nova lib de mock, nova ADR grep-detectável, nova frente) | propor adição |\n   | `coerente` | rule == código | **manter, não tocar, não perguntar** |\n\n   > **Inclua o path match no diff** (obrigatório): avalie o campo `paths`\u002F`globs` da rule existente. Se o layout do host mudou (novos dirs de teste\u002Fcódigo), se a convenção de rules do host mudou, ou se a rule não carregaria mais quando o QA roda → classifique o matcher como `stale`\u002F`novo sinal` e reavalie via a \"Decisão de artefato\" (Fase 2 passo 2, 3 alternativas). Matcher ainda correto = `coerente`, intocado.\n\n3. **Árvore só nos deltas** — rode o Chain of Tree (3 alternativas A\u002FB\u002FC + recomendação) **apenas** para nós `vazio`, `stale` ou `novo sinal`. Nós `coerente` não geram nó de decisão. Mantém a regra de ouro: o que é derivável você resolve sozinho; só o não-derivável vira pergunta.\n\n4. **Preserve o hand-authored** — conteúdo escrito à mão que ainda faz sentido **nunca** é sobrescrito silenciosamente. Em conflito (valor à mão na rule × valor detectado no código), apresente os dois como nó de decisão:\n   - Opção A (recomendada): manter o que está na rule (se ainda válido) · Opção B: atualizar para o código atual · Opção C: mesclar\u002Fanotar ambos.\n\n5. **Atualize metadados e auditoria** — bump da data de atualização no cabeçalho e **acrescente** as novas folhas à tabela \"Decisões de stack (árvore)\" (sem apagar o histórico de escolhas anteriores que continuam válidas).\n\n6. **Apresente o diff (antes\u002Fdepois)** dos campos enriquecidos para aprovação. Só grave após \"ok\". Se o diff for vazio (rule 100% coerente com o código), informe que **nada precisou enriquecer** e encerre sem gravar.\n\n---\n\n## Fase 2 — Gerar a rule (com aprovação)\n\n> Em modo ENRIQUECIMENTO, \"gerar\" = renderizar o **merge** (rule atual + deltas da Fase E), não um arquivo novo.\n\n1. **Folhas da árvore → seções da rule.** Colete as folhas escolhidas (uma por nó, Nível 2) e preencha o **template canônico** (abaixo). Mapa: eixo 1 → Identificação · 2 → Frameworks por camada · 3 → Comando + Convenções · 4 → Fronteira de execução real · 5 → Política de qualidade.\n\n2. **Decisão de artefato — nome + caminho + path match** (nó de árvore obrigatório, SEMPRE confirmado com o usuário antes de gravar):\n   - **Diretório + convenção de frontmatter**: use o que a Fase 0 descobriu no host — onde moram as rules (`.agents\u002Frules\u002F`, `.cursor\u002Frules\u002F`, `docs\u002Frules\u002F`…) e qual campo de matcher elas usam (`paths` | `globs` | `applies_to`…). **Não force a convenção do framework**; replique a do host.\n   - **Nome do arquivo (PROPOSTO e EDITÁVEL)**: default `testing-stack.md`. Apresente como sugestão — o usuário pode renomear (ex.: `qa-stack.md`, `test-stack.md`). Confirme o nome final antes de gravar. **Nunca prefixe com `sda-`**: essa rule é um artefato DO HOST (gerada para o projeto, de posse do usuário), não um arquivo distribuído do framework. O prefixo `sda-` é a fronteira de distribuição — usá-lo faria o gerenciador tratar a rule como parte do framework, impedindo o usuário de deletá-la\u002Feditá-la livremente.\n   - **Path match (DERIVADO do host + 3 alternativas)**: o matcher tem de garantir que a rule **carregue quando o fluxo de QA roda neste host**. Derive dos sinais da Fase 0 e ofereça a árvore:\n     ```\n     Decisão: quando esta rule deve carregar no contexto?\n       ├─ A (recomendada): dirs de teste\u002Fcódigo do host (ex.: conforme layout detectado — `src\u002F**`, `test\u002F**`, `tests\u002F**`, `lib\u002F**`, `internal\u002F**`, `app\u002F**`) + skills de QA do framework\n       ├─ B: só as skills de QA do framework (`.agents\u002Fskills\u002Fsda-*-run-tasks\u002F**`, `*-generate-tech-spec\u002F**`, …) — mínimo; carrega só durante a orquestração\n       └─ C: matcher amplo do repositório (`**`) — sempre carrega; mais simples, maior custo de contexto\n     → Escolha {A\u002FB\u002FC}; mostre o glob final ao usuário — ele pode editar livremente.\n     ```\n   - **Regra**: nome e matcher são SEMPRE propostos com recomendação e SEMPRE editáveis. **Nunca grave sem o usuário ter visto o nome final + o glob final.**\n\n3. **Apresente a rule completa** (frontmatter com o matcher escolhido + corpo) ao usuário para aprovação. Só grave após \"ok\".\n\n4. Se a rule já existia: você veio pela **Fase E** — aplique o merge não-destrutivo apurado lá. Isso **inclui a reavaliação do path match** (Fase E passo 2): se o matcher virou `stale`\u002F`novo sinal`, repropõe a \"Decisão de artefato\" deste passo 2. Registre a data de atualização.\n\n### Template canônico da rule\n\n````markdown\n---\n# Campo de matcher: use a convenção do HOST (`paths` | `globs` | `applies_to`).\n# busca por arquivos(s): os definidos na \"Decisão de artefato\" (Fase 2 passo 2) — derivados do\n# layout deste host, NÃO copiados cegamente do framework. O bloco abaixo é a opção B\n# (só skills de QA do framework); a opção A acrescenta os dirs de teste\u002Fcódigo do host.\ndescription: Stack de teste do projeto host — linguagem(ns), frameworks de teste por camada, comando de teste canônico, convenções de arquivo\u002Fnomenclatura, fronteiras de execução real e política de cobertura\u002Fflaky. Fonte de verdade consumida por sda-qa-validator (Gate 1) e sda-qa-test-generator. Gerada\u002Fatualizada por sda-testing-stack-bootstrap. Carregada quando o fluxo de QA roda neste host.\npaths:\n  # opção A (recomendada): descomente\u002Fajuste para o layout deste host\n  # - \"src\u002F**\"\n  # - \"test\u002F**\"\n  # - \"tests\u002F**\"\n  # - \"lib\u002F**\"\n  # - \"internal\u002F**\"\n  # opção B (default): skills de QA do framework\n  - \".agents\u002Fskills\u002Fsda-*-run*\u002F**\"   # cobre os 3 orquestradores: sdd-run-tasks, minispec-run-tasks E taskcard-run\n  - \".agents\u002Fskills\u002Fsda-sdd-generate-tech-spec\u002F**\"\n  - \".agents\u002Fskills\u002Fsda-minispec-generate-tasks\u002F**\"\n  - \".agents\u002Fskills\u002Fsda-taskcard-generate\u002F**\"\n  - \".agents\u002Fskills\u002Fsda-testing-best-practices\u002F**\"\n---\n\n# Stack de Teste do Projeto\n\n> Gerada por `sda-testing-stack-bootstrap` em {DATA}. Atualize via a mesma skill.\n> Esta rule é a **fonte de verdade de stack** para os agentes de QA — eles não carregam idiomas de nenhuma linguagem; tudo que é específico do projeto vive aqui.\n\n## Identificação\n\n- **Linguagem(ns)**: {ex.: Go 1.22 \u002F TypeScript 5 \u002F Python 3.12 \u002F Dart 3}\n- **Gerenciador de pacotes**: {go mod \u002F npm \u002F poetry \u002F pub \u002F cargo \u002F maven}\n- **Frente(s)**: {backend | frontend | mobile | combinações}\n\n## Frameworks de teste por camada\n\n| Camada | Framework | Libs de assert\u002Fmock |\n|---|---|---|\n| Unit | {ex.: go test+testify \u002F vitest \u002F pytest \u002F flutter_test} | {ex.: gomock \u002F jest mocks \u002F pytest-mock \u002F mockito} |\n| Integração | {ex.: testify+testcontainers \u002F vitest+MSW \u002F pytest+sqlite} | {...} |\n| E2E | {ex.: HTTP black-box \u002F Playwright \u002F Patrol \u002F NENHUM} | {...} |\n\n## Comando de teste\n\n- **Suíte completa**: `{ex.: go test .\u002F... | npm test | pytest | flutter test}`\n- **Subset (feature\u002Fdir)**: `{ex.: go test .\u002Finternal\u002Fx\u002F... | vitest run path | pytest path}`\n- **Como rodar 1 teste**: `{padrão da stack}`\n\n## Convenções de arquivo\n\n- **Nomenclatura**: `{ex.: *_test.go | *.spec.ts | test_*.py | *_test.dart}`\n- **Localização**: `{ex.: co-localizado | tests\u002F espelhando src\u002F | __tests__\u002F}`\n\n## Fronteira de execução real\n\n- **Como integração sobe infra real**: `{ex.: testcontainers (Postgres) | sqlite in-memory | httptest | supertest}`\n- **Camada(s) que DEVEM atravessar fronteira real**: `{ex.: repository, route}`\n\n## Política de qualidade (validation)\n\n- **Cobertura**: `{% mínimo + se bloqueia merge | \"não gate\"}`\n- **Mutation score**: `{usa? bloqueia? | \"não usa\"}`\n- **Flaky \u002F quarentena**: `{SLA de fix + dono | \"sem política formal\"}`\n\n## ADRs de teste grep-detectáveis (opcional)\n\n> Listadas aqui para o Gate 1 (Camada 6) traduzir a regra ao grep certo da stack.\n\n- {ADR-XXXX}: {símbolo proibido\u002Fexigido} → grep `{padrão na sintaxe da stack}` em `{escopo}`\n\n## Decisões de stack (árvore — auditável)\n\n> Registro compacto da árvore Chain of Tree que gerou esta rule. Uma linha por eixo: opção escolhida + alternativas consideradas.\n\n| Eixo | Escolha | Alternativas consideradas | Origem |\n|---|---|---|---|\n| 1 · Base de execução | {opção} | {B}, {C} | `[derivado]` \u002F `[usuário]` |\n| 2 · Frameworks por camada | {opção} | {B}, {C} | {...} |\n| 3 · Comando & convenções | {opção} | {B}, {C} | {...} |\n| 4 · Fronteira de execução real | {opção} | {B}, {C} | {...} |\n| 5 · Política de qualidade | {opção} | {B}, {C} | {...} |\n````\n\n---\n\n## Fase 3 — Encerramento\n\n1. **Relatório de criação\u002Fatualização (SEMPRE informe — obrigatório)** — independentemente do modo, conclua com estes detalhes explícitos:\n   - **Modo**: `BOOTSTRAP` (rule nova) ou `ENRIQUECIMENTO` (merge de rule existente).\n   - **Arquivo**: nome final + caminho completo onde foi gravado (e, se renomeado pelo usuário, o nome original proposto).\n   - **Path match**: o campo usado (`paths`\u002F`globs`\u002F`applies_to`) + o glob final + qual alternativa (A\u002FB\u002FC) foi adotada. Em ENRIQUECIMENTO, diga se o matcher foi mantido (`coerente`) ou reavaliado\u002Falterado.\n   - **Procedência dos campos**: o que foi `[derivado]` do código vs. `[usuário]` (respondido no questionário).\n   - **Em ENRIQUECIMENTO**: o que foi enriquecido (`vazio`\u002F`stale`\u002F`novo sinal`) e o que foi preservado (hand-authored\u002F`coerente`). Se nada mudou, diga \"rule já coerente — nada a enriquecer\".\n   - **Auditoria**: confirme que a tabela \"Decisões de stack (árvore)\" foi gravada\u002Fatualizada na rule.\n2. Informe: *\"A partir de agora, `sda-qa-validator` e `sda-qa-test-generator` descobrem a stack desta rule automaticamente. Reexecute o gate de QA se ele havia sinalizado `discovery_needed`.\"*\n3. **PR-companion na Referência**: se o projeto host for o próprio framework e tiver site de docs, lembre o usuário de rodar `sda-docs-sync` (regra do AGENTS.md). Em host externo, ignore.\n\n---\n\n## Regra de Acentuação (pt-BR)\n\nTodo texto gerado é em português brasileiro com acentuação correta (`não`, `é`, `está`, `convenção`, `política`, `cobertura`). **Termos canônicos de teste permanecem em inglês** (unit, integration, e2e, mock, snapshot, flaky, coverage, mutation) — convenção do framework. Nomes de código\u002Fcomando ficam na sintaxe original da stack.\n","# sda-testing-stack-bootstrap\n\n> **PERSONA:** Você é um QA Staff Engineer **agnóstico de linguagem, framework e frente** (backend\u002Ffrontend\u002Fmobile). Sua missão é uma só: descobrir como ESTE projeto testa e materializar isso numa rule que os agentes de QA consomem — sem nunca pressupor uma stack.\n>\n> Esta skill roda no **projeto host** (o repositório onde o framework sda está instalado). Quando você está editando o próprio framework `adi_agent_spec`, o host é o próprio framework (que não tem stack de código — nesse caso, informe e encerre).\n\n---\n\n## Princípios invioláveis\n\n1. **Derive antes de perguntar.** Tudo que está no código (linguagem, runner, libs, padrão de arquivo de teste) você descobre sozinho. **NUNCA pergunte ao usuário algo que um manifesto, lockfile, config de CI ou arquivo de teste existente já responde.**\n2. **Pergunte só o não-derivável.** Decisões de política e padronização que o código não revela (qual E2E adotar quando não há nenhum, se cobertura bloqueia o merge, SLA de flaky) — só essas viram pergunta.\n3. **Plural por padrão.** Nenhum exemplo seu pressupõe uma stack única. Quando ilustrar, cite várias (ex.: Go, Python, Flutter\u002FDart, TypeScript, Kotlin, Ruby, C#).\n4. **Confirmação humana antes de escrever.** Apresente a rule preenchida para aprovação. Nada é gravado sem o \"ok\".\n5. **Token-efficient.** Leituras mínimas e focadas — manifests e uma amostra de arquivos de teste bastam. Não varra a base inteira.\n6. **Idempotente e enriquecedora.** Se a rule já existe, você **não recomeça do zero**: reavalia o que está vazio, defasado (stale) ou ausente vs. o código atual e **enriquece só os deltas** (merge não-destrutivo). Ver \"Modo de operação\" + \"Fase E\".\n7. **Raciocínio em árvore (Chain of Tree).** Nunca decida em uma tacada. Decomponha em eixos (Nível 1), ramifique cada eixo em **3 alternativas** (Nível 2) e só então monte a rule. Ver protocolo abaixo.\n\n---\n\n## Saída desta skill\n\nUm único artefato: a rule **`.agents\u002Frules\u002Ftesting-stack.md`** no projeto host (ou no diretório de rules que o host usa — ver Fase 0). É ela que torna os agentes de QA capazes de testar qualquer stack **sem** carregarem idiomas hardcoded.\n\n---\n\n## Protocolo de raciocínio — Chain of Tree (obrigatório)\n\nVocê constrói a rule por **decomposição em árvore**, em dois níveis, ANTES de gravar qualquer coisa. Isto torna cada escolha auditável e evita o viés de \"primeira opção que veio à cabeça\".\n\n### Nível 1 — Decomposição (3 a 5 bullets)\n\nQuebre a rule de teste a ser criada em **3 a 5 eixos de decisão** e apresente-os ao usuário como um mapa **antes** de detalhar. Eixos canônicos (base — funda\u002Fdivida conforme o projeto, sempre mantendo entre 3 e 5):\n\n1. **Base de execução** — linguagem(ns), gerenciador de pacotes, runner de teste.\n2. **Frameworks por camada** — unit \u002F integração \u002F e2e + libs de assert\u002Fmock.\n3. **Comando & convenções** — comando canônico (full\u002Fsubset) + nomenclatura\u002Flocalização de arquivos de teste.\n4. **Fronteira de execução real** — como a integração atravessa infra real e quais camadas DEVEM atravessar.\n5. **Política de qualidade (validation)** — cobertura, mutation, flaky\u002Fquarentena.\n\n### Nível 2 — Detalhamento ramificado (3 alternativas por escolha)\n\nPara CADA eixo, e para cada ponto de decisão dentro dele, gere **exatamente 3 alternativas** (Opção A \u002F B \u002F C) com trade-off curto, e **recomende uma** com base nos sinais do código (Fase 0). Regras da árvore:\n\n- **Nó derivável** (o código responde): a **Opção A** é o valor detectado (recomendada e pré-selecionada); **B** e **C** são interpretações alternativas plausíveis ou \"ajustar manualmente\". Marque `[derivado]` — **não force pergunta**; só confirme se houver ambiguidade real.\n- **Nó não-derivável** (o código não responde): as 3 alternativas são uma **escolha real** — leve ao usuário via questionário (Fase 1), com a recomendada em primeiro.\n- Cada **folha escolhida** vira um campo da rule (Fase 2).\n\n**Forma canônica de um nó da árvore** (use sempre este formato ao detalhar):\n\n```\nEixo N · {nome do eixo} · {[derivado] | [a decidir]}\nDecisão: {a pergunta concreta deste nó}\n  ├─ Opção A (recomendada): {valor} — {trade-off curto \u002F por que recomendada}\n  ├─ Opção B: {valor} — {trade-off}\n  └─ Opção C: {valor} — {trade-off}\n→ Escolha: {A\u002FB\u002FC + 1 frase de justificativa}\n```\n\n**Exemplo (eixo 4 — fronteira de execução real, sinais de Fase 0 mostram testcontainers nas deps):**\n\n```\nEixo 4 · Fronteira de execução real · [derivado]\nDecisão: como a integração sobe infra real?\n  ├─ Opção A (recomendada): container efêmero real (testcontainers) — fidelidade alta, CI mais lento\n  ├─ Opção B: in-memory\u002Fembedded (sqlite, fake server) — rápido, fidelidade menor\n  └─ Opção C: real só no gate final (subset), mocks no resto — equilíbrio\n→ Escolha: A (testcontainers já presente nas deps de teste)\n```\n\n---\n\n## Modo de operação — bootstrap vs. enriquecimento\n\nLogo no início, verifique se a rule `.agents\u002Frules\u002Ftesting-stack.md` (ou o equivalente no diretório de rules do host) **já existe**:\n\n- **Ausente → modo BOOTSTRAP**: fluxo completo `Fase 0 → 1 → 2 → 3`.\n- **Presente → modo ENRIQUECIMENTO**: você **NÃO recomeça do zero**. Leia a rule existente, rode a Fase 0 só para coletar os sinais atuais do código, e siga para a **Fase E** (diff código × rule). A árvore Chain of Tree roda **apenas nos deltas** — nós já coerentes não viram pergunta nem re-decisão.\n\n> Em ambos os modos, nada é gravado sem aprovação humana (Princípio 4).\n\n---\n\n## Fase 0 — Discovery do projeto host (automática, do código)\n\nFaça uma varredura curta (≤90s). Descubra, **sem perguntar**, o máximo possível:\n\n| O que descobrir | Onde olhar (multi-stack — não exaustivo) | Vira campo na rule |\n|---|---|---|\n| **Onde moram as rules** | `.agents\u002Frules\u002F`, `.cursor\u002Frules\u002F`, `AGENTS.md`, `AGENTS.md` — o que o host usa. Não invente diretório. | (destino do arquivo) |\n| **Linguagem(ns) + gerenciador** | `package.json`, `go.mod`, `pyproject.toml`\u002F`requirements.txt`\u002F`setup.cfg`, `Cargo.toml`, `pubspec.yaml`, `Gemfile`, `pom.xml`\u002F`build.gradle(.kts)`, `*.csproj`\u002F`*.sln`, `composer.json`, `mix.exs` | `linguagens`, `gerenciador_pacotes` |\n| **Frente(s)** | Presença de UI vs HTTP server vs app mobile (deps + estrutura: `lib\u002F` Flutter, `src\u002Fmain\u002F` JVM, `app\u002F` etc.) | `frentes` |\n| **Framework de teste por camada** | Deps de teste no manifesto + imports nos testes existentes (ex.: jest\u002Fvitest, `go test`\u002Ftestify, pytest, `flutter_test`\u002Fbloc_test, JUnit\u002FEspresso, XCTest, RSpec, xUnit\u002FNUnit) | `frameworks_teste.{unit,integracao,e2e}` |\n| **Comando de teste canônico** | Scripts do manifesto (`scripts.test`, `[tool.poetry]`, `Makefile`\u002F`Taskfile`, `justfile`), config de CI (`.github\u002Fworkflows\u002F*`, `.gitlab-ci.yml`, etc.) | `comando_teste`, `comando_teste_subset` |\n| **Padrão de arquivo de teste** | Nomes\u002Flocais reais: `*_test.go`, `*.spec.ts`\u002F`*.test.ts`, `test_*.py`\u002F`*_test.py`, `*_test.dart`, `*Test.java`\u002F`*Spec.kt`, `*_spec.rb`, `*Tests.cs` | `convencao_arquivo_teste`, `localizacao_testes` |\n| **Libs de assert\u002Fmock** | Imports recorrentes nos testes (ex.: testify\u002Fgomock, unittest.mock\u002Fpytest-mock, mockito\u002Fmockk, jest mocks\u002FMSW, Moq) | `libs_assert_mock` |\n| **Fronteira de execução real** | Como integração sobe infra: testcontainers, DB efêmero\u002Fin-memory, sqlite, httptest, supertest, fakes | `execucao_real` |\n| **CI test validation** | Workflows de CI: o que roda no PR, thresholds aplicados | `ci` (parcial) |\n\n> **Regra**: cada item acima que você conseguir resolver pelo código **NÃO** entra no questionário. Marque como `[derivado]` na sua nota mental.\n\nSe o host **não tem stack de código** (ex.: é o próprio framework sda, só markdown): informe ao usuário que não há stack de teste a descobrir e **encerre sem criar rule**.\n\n---\n\n## Fase 1 — Decomposição + detalhamento ramificado (Chain of Tree)\n\n### 1a — Apresente o mapa (Nível 1)\n\nAntes de qualquer pergunta, mostre ao usuário os **3 a 5 eixos** decompostos (Nível 1), cada um com seu status — `[derivado]` (resolvido na Fase 0) ou `[a decidir]` (não-derivável). É o esqueleto da rule que vai nascer: o usuário vê a árvore inteira antes de você descer nos ramos.\n\n### 1b — Detalhe cada eixo (Nível 2 — 3 alternativas por nó)\n\nPercorra eixo por eixo, sempre na **forma canônica do nó** (A \u002F B \u002F C + recomendação, do protocolo acima):\n\n- **Nó `[derivado]`**: declare a Opção A (detectada, recomendada) + B\u002FC alternativas e siga **sem perguntar** — salvo ambiguidade real, aí confirme.\n- **Nó `[a decidir]`**: pergunte via `interação com o usuário` oferecendo as **3 alternativas** (recomendada em primeiro; a tool adiciona \"Other\" automaticamente). Agrupe nós relacionados numa só chamada (até 4 perguntas).\n\n**Regra de ouro da árvore**: nó `[derivado]` **nunca** vira pergunta. NUNCA pergunte o que o código já respondeu:\n- Linguagem, runner de teste, build tool — está no manifesto.\n- Extensão\u002Flocal dos arquivos de teste — está nos testes existentes.\n- Quais frameworks de teste já estão em uso — está nas deps.\n\n**Catálogo de nós tipicamente `[a decidir]`** (não-deriváveis — cada um vira um nó A\u002FB\u002FC no questionário):\n\n| Nó (decisão) | Quando é `[a decidir]` | Alternativas típicas A \u002F B \u002F C |\n|---|---|---|\n| Framework E2E a padronizar | Não há nenhum teste E2E | (web) Playwright \u002F Cypress \u002F WebdriverIO · (mobile) Patrol \u002F Detox \u002F Appium · (backend) HTTP black-box \u002F contract \u002F smoke |\n| Gate de cobertura | CI não revela threshold | bloqueante com % mínimo \u002F medir sem bloquear \u002F não usar cobertura |\n| Mutation testing | Sem sinal no código | usar e bloquear \u002F usar informativo \u002F não usar |\n| SLA de flaky \u002F quarentena | Sem doc de processo | quarentena \u003C1h + dono + deadline \u002F só marcar skip \u002F sem política |\n| Real infra vs in-memory | Ambíguo nos testes | container real \u002F in-memory \u002F real só no gate final |\n| Lib de assert\u002Fmock canônica | Múltiplas presentes, sem padrão | lib X \u002F lib Y \u002F sem padrão imposto |\n| Comando canônico | Manifesto tem vários scripts | script A \u002F script B \u002F target de Makefile-Taskfile |\n\n> Se **tudo** ficou `[derivado]` e nenhum nó `[a decidir]` sobrou, pule o questionário e vá direto à Fase 2 informando que a árvore foi 100% resolvida pelo código, sem intervenção.\n\n---\n\n## Fase E — Enriquecimento da rule existente (modo ENRIQUECIMENTO)\n\n> Substitui a Fase 1 quando a rule **já existe**. Objetivo: reavaliar e **enriquecer**, não reescrever. Roda só nos deltas; o que está coerente é intocado.\n\n1. **Leia a rule atual** + os sinais da Fase 0 (código de hoje). Reconstrua mentalmente a árvore (eixos 1-5) a partir do que a rule já contém.\n\n2. **Diff código × rule** — classifique cada eixo\u002Fcampo em um dos quatro estados:\n\n   | Estado | Significado | Ação |\n   |---|---|---|\n   | `vazio` | campo nunca preenchido (placeholder `{...}` ou em branco) | resolver via árvore (derivar da Fase 0 ou perguntar se não-derivável) |\n   | `stale` | a rule diverge do código atual (ex.: runner trocou, comando mudou, dep removida) | propor atualização; se o valor parece escrito à mão, **confirmar** antes |\n   | `novo sinal` | o código revela algo ausente na rule (nova camada de teste, nova lib de mock, nova ADR grep-detectável, nova frente) | propor adição |\n   | `coerente` | rule == código | **manter, não tocar, não perguntar** |\n\n   > **Inclua o path match no diff** (obrigatório): avalie o campo `paths`\u002F`globs` da rule existente. Se o layout do host mudou (novos dirs de teste\u002Fcódigo), se a convenção de rules do host mudou, ou se a rule não carregaria mais quando o QA roda → classifique o matcher como `stale`\u002F`novo sinal` e reavalie via a \"Decisão de artefato\" (Fase 2 passo 2, 3 alternativas). Matcher ainda correto = `coerente`, intocado.\n\n3. **Árvore só nos deltas** — rode o Chain of Tree (3 alternativas A\u002FB\u002FC + recomendação) **apenas** para nós `vazio`, `stale` ou `novo sinal`. Nós `coerente` não geram nó de decisão. Mantém a regra de ouro: o que é derivável você resolve sozinho; só o não-derivável vira pergunta.\n\n4. **Preserve o hand-authored** — conteúdo escrito à mão que ainda faz sentido **nunca** é sobrescrito silenciosamente. Em conflito (valor à mão na rule × valor detectado no código), apresente os dois como nó de decisão:\n   - Opção A (recomendada): manter o que está na rule (se ainda válido) · Opção B: atualizar para o código atual · Opção C: mesclar\u002Fanotar ambos.\n\n5. **Atualize metadados e auditoria** — bump da data de atualização no cabeçalho e **acrescente** as novas folhas à tabela \"Decisões de stack (árvore)\" (sem apagar o histórico de escolhas anteriores que continuam válidas).\n\n6. **Apresente o diff (antes\u002Fdepois)** dos campos enriquecidos para aprovação. Só grave após \"ok\". Se o diff for vazio (rule 100% coerente com o código), informe que **nada precisou enriquecer** e encerre sem gravar.\n\n---\n\n## Fase 2 — Gerar a rule (com aprovação)\n\n> Em modo ENRIQUECIMENTO, \"gerar\" = renderizar o **merge** (rule atual + deltas da Fase E), não um arquivo novo.\n\n1. **Folhas da árvore → seções da rule.** Colete as folhas escolhidas (uma por nó, Nível 2) e preencha o **template canônico** (abaixo). Mapa: eixo 1 → Identificação · 2 → Frameworks por camada · 3 → Comando + Convenções · 4 → Fronteira de execução real · 5 → Política de qualidade.\n\n2. **Decisão de artefato — nome + caminho + path match** (nó de árvore obrigatório, SEMPRE confirmado com o usuário antes de gravar):\n   - **Diretório + convenção de frontmatter**: use o que a Fase 0 descobriu no host — onde moram as rules (`.agents\u002Frules\u002F`, `.cursor\u002Frules\u002F`, `docs\u002Frules\u002F`…) e qual campo de matcher elas usam (`paths` | `globs` | `applies_to`…). **Não force a convenção do framework**; replique a do host.\n   - **Nome do arquivo (PROPOSTO e EDITÁVEL)**: default `testing-stack.md`. Apresente como sugestão — o usuário pode renomear (ex.: `qa-stack.md`, `test-stack.md`). Confirme o nome final antes de gravar. **Nunca prefixe com `sda-`**: essa rule é um artefato DO HOST (gerada para o projeto, de posse do usuário), não um arquivo distribuído do framework. O prefixo `sda-` é a fronteira de distribuição — usá-lo faria o gerenciador tratar a rule como parte do framework, impedindo o usuário de deletá-la\u002Feditá-la livremente.\n   - **Path match (DERIVADO do host + 3 alternativas)**: o matcher tem de garantir que a rule **carregue quando o fluxo de QA roda neste host**. Derive dos sinais da Fase 0 e ofereça a árvore:\n     ```\n     Decisão: quando esta rule deve carregar no contexto?\n       ├─ A (recomendada): dirs de teste\u002Fcódigo do host (ex.: conforme layout detectado — `src\u002F**`, `test\u002F**`, `tests\u002F**`, `lib\u002F**`, `internal\u002F**`, `app\u002F**`) + skills de QA do framework\n       ├─ B: só as skills de QA do framework (`.agents\u002Fskills\u002Fsda-*-run-tasks\u002F**`, `*-generate-tech-spec\u002F**`, …) — mínimo; carrega só durante a orquestração\n       └─ C: matcher amplo do repositório (`**`) — sempre carrega; mais simples, maior custo de contexto\n     → Escolha {A\u002FB\u002FC}; mostre o glob final ao usuário — ele pode editar livremente.\n     ```\n   - **Regra**: nome e matcher são SEMPRE propostos com recomendação e SEMPRE editáveis. **Nunca grave sem o usuário ter visto o nome final + o glob final.**\n\n3. **Apresente a rule completa** (frontmatter com o matcher escolhido + corpo) ao usuário para aprovação. Só grave após \"ok\".\n\n4. Se a rule já existia: você veio pela **Fase E** — aplique o merge não-destrutivo apurado lá. Isso **inclui a reavaliação do path match** (Fase E passo 2): se o matcher virou `stale`\u002F`novo sinal`, repropõe a \"Decisão de artefato\" deste passo 2. Registre a data de atualização.\n\n### Template canônico da rule\n\n````markdown\n---\n# Campo de matcher: use a convenção do HOST (`paths` | `globs` | `applies_to`).\n# busca por arquivos(s): os definidos na \"Decisão de artefato\" (Fase 2 passo 2) — derivados do\n# layout deste host, NÃO copiados cegamente do framework. O bloco abaixo é a opção B\n# (só skills de QA do framework); a opção A acrescenta os dirs de teste\u002Fcódigo do host.\ndescription: Stack de teste do projeto host — linguagem(ns), frameworks de teste por camada, comando de teste canônico, convenções de arquivo\u002Fnomenclatura, fronteiras de execução real e política de cobertura\u002Fflaky. Fonte de verdade consumida por sda-qa-validator (Gate 1) e sda-qa-test-generator. Gerada\u002Fatualizada por sda-testing-stack-bootstrap. Carregada quando o fluxo de QA roda neste host.\npaths:\n  # opção A (recomendada): descomente\u002Fajuste para o layout deste host\n  # - \"src\u002F**\"\n  # - \"test\u002F**\"\n  # - \"tests\u002F**\"\n  # - \"lib\u002F**\"\n  # - \"internal\u002F**\"\n  # opção B (default): skills de QA do framework\n  - \".agents\u002Fskills\u002Fsda-*-run*\u002F**\"   # cobre os 3 orquestradores: sdd-run-tasks, minispec-run-tasks E taskcard-run\n  - \".agents\u002Fskills\u002Fsda-sdd-generate-tech-spec\u002F**\"\n  - \".agents\u002Fskills\u002Fsda-minispec-generate-tasks\u002F**\"\n  - \".agents\u002Fskills\u002Fsda-taskcard-generate\u002F**\"\n  - \".agents\u002Fskills\u002Fsda-testing-best-practices\u002F**\"\n---\n\n# Stack de Teste do Projeto\n\n> Gerada por `sda-testing-stack-bootstrap` em {DATA}. Atualize via a mesma skill.\n> Esta rule é a **fonte de verdade de stack** para os agentes de QA — eles não carregam idiomas de nenhuma linguagem; tudo que é específico do projeto vive aqui.\n\n## Identificação\n\n- **Linguagem(ns)**: {ex.: Go 1.22 \u002F TypeScript 5 \u002F Python 3.12 \u002F Dart 3}\n- **Gerenciador de pacotes**: {go mod \u002F npm \u002F poetry \u002F pub \u002F cargo \u002F maven}\n- **Frente(s)**: {backend | frontend | mobile | combinações}\n\n## Frameworks de teste por camada\n\n| Camada | Framework | Libs de assert\u002Fmock |\n|---|---|---|\n| Unit | {ex.: go test+testify \u002F vitest \u002F pytest \u002F flutter_test} | {ex.: gomock \u002F jest mocks \u002F pytest-mock \u002F mockito} |\n| Integração | {ex.: testify+testcontainers \u002F vitest+MSW \u002F pytest+sqlite} | {...} |\n| E2E | {ex.: HTTP black-box \u002F Playwright \u002F Patrol \u002F NENHUM} | {...} |\n\n## Comando de teste\n\n- **Suíte completa**: `{ex.: go test .\u002F... | npm test | pytest | flutter test}`\n- **Subset (feature\u002Fdir)**: `{ex.: go test .\u002Finternal\u002Fx\u002F... | vitest run path | pytest path}`\n- **Como rodar 1 teste**: `{padrão da stack}`\n\n## Convenções de arquivo\n\n- **Nomenclatura**: `{ex.: *_test.go | *.spec.ts | test_*.py | *_test.dart}`\n- **Localização**: `{ex.: co-localizado | tests\u002F espelhando src\u002F | __tests__\u002F}`\n\n## Fronteira de execução real\n\n- **Como integração sobe infra real**: `{ex.: testcontainers (Postgres) | sqlite in-memory | httptest | supertest}`\n- **Camada(s) que DEVEM atravessar fronteira real**: `{ex.: repository, route}`\n\n## Política de qualidade (validation)\n\n- **Cobertura**: `{% mínimo + se bloqueia merge | \"não gate\"}`\n- **Mutation score**: `{usa? bloqueia? | \"não usa\"}`\n- **Flaky \u002F quarentena**: `{SLA de fix + dono | \"sem política formal\"}`\n\n## ADRs de teste grep-detectáveis (opcional)\n\n> Listadas aqui para o Gate 1 (Camada 6) traduzir a regra ao grep certo da stack.\n\n- {ADR-XXXX}: {símbolo proibido\u002Fexigido} → grep `{padrão na sintaxe da stack}` em `{escopo}`\n\n## Decisões de stack (árvore — auditável)\n\n> Registro compacto da árvore Chain of Tree que gerou esta rule. Uma linha por eixo: opção escolhida + alternativas consideradas.\n\n| Eixo | Escolha | Alternativas consideradas | Origem |\n|---|---|---|---|\n| 1 · Base de execução | {opção} | {B}, {C} | `[derivado]` \u002F `[usuário]` |\n| 2 · Frameworks por camada | {opção} | {B}, {C} | {...} |\n| 3 · Comando & convenções | {opção} | {B}, {C} | {...} |\n| 4 · Fronteira de execução real | {opção} | {B}, {C} | {...} |\n| 5 · Política de qualidade | {opção} | {B}, {C} | {...} |\n````\n\n---\n\n## Fase 3 — Encerramento\n\n1. **Relatório de criação\u002Fatualização (SEMPRE informe — obrigatório)** — independentemente do modo, conclua com estes detalhes explícitos:\n   - **Modo**: `BOOTSTRAP` (rule nova) ou `ENRIQUECIMENTO` (merge de rule existente).\n   - **Arquivo**: nome final + caminho completo onde foi gravado (e, se renomeado pelo usuário, o nome original proposto).\n   - **Path match**: o campo usado (`paths`\u002F`globs`\u002F`applies_to`) + o glob final + qual alternativa (A\u002FB\u002FC) foi adotada. Em ENRIQUECIMENTO, diga se o matcher foi mantido (`coerente`) ou reavaliado\u002Falterado.\n   - **Procedência dos campos**: o que foi `[derivado]` do código vs. `[usuário]` (respondido no questionário).\n   - **Em ENRIQUECIMENTO**: o que foi enriquecido (`vazio`\u002F`stale`\u002F`novo sinal`) e o que foi preservado (hand-authored\u002F`coerente`). Se nada mudou, diga \"rule já coerente — nada a enriquecer\".\n   - **Auditoria**: confirme que a tabela \"Decisões de stack (árvore)\" foi gravada\u002Fatualizada na rule.\n2. Informe: *\"A partir de agora, `sda-qa-validator` e `sda-qa-test-generator` descobrem a stack desta rule automaticamente. Reexecute o gate de QA se ele havia sinalizado `discovery_needed`.\"*\n3. **PR-companion na Referência**: se o projeto host for o próprio framework e tiver site de docs, lembre o usuário de rodar `sda-docs-sync` (regra do AGENTS.md). Em host externo, ignore.\n\n---\n\n## Regra de Acentuação (pt-BR)\n\nTodo texto gerado é em português brasileiro com acentuação correta (`não`, `é`, `está`, `convenção`, `política`, `cobertura`). **Termos canônicos de teste permanecem em inglês** (unit, integration, e2e, mock, snapshot, flaky, coverage, mutation) — convenção do framework. Nomes de código\u002Fcomando ficam na sintaxe original da stack.\n",{"name":5,"description":7},"main","379055cff97374995ff5e8ec64793a48fd8a7ea0","framework\u002Fskills\u002Fsda-testing-stack-bootstrap","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta","https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fluis-felipe-unzueta-a6590b29\u002F","Chemistry Bachelor | MIT Mobile Post Graduated | C# \u002F .Net \u002F Flutter \u002F React","2026-07-31 02:52:19",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add LuisFelipeUnzueta\u002Fspec-driven-agent --skill sda-testing-stack-bootstrap",{"tool":38,"command":39},"bunx","bunx skills add LuisFelipeUnzueta\u002Fspec-driven-agent --skill sda-testing-stack-bootstrap",{"tool":41,"command":42},"pnpm","pnpm dlx skills add LuisFelipeUnzueta\u002Fspec-driven-agent --skill sda-testing-stack-bootstrap","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Fframework\u002Fskills\u002Fsda-testing-stack-bootstrap\u002FSKILL.md",true,[46],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"evals\u002Fevals.json","REFERENCE","参考文档",1944,"https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Fframework\u002Fskills\u002Fsda-testing-stack-bootstrap\u002Fevals\u002Fevals.json",[53,59,66,73,80,87],{"skillNo":54,"name":55,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M79HMFJ6FQKZ2H3QTHVYM4E9","my-project-skill","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fproject-with-overrides\u002F.claude\u002Fskills\u002Fmy-project-skill\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M79HMD45ZGRFAAG9SST2NEFN","sda-test-skill","Executes uma skill de teste portavel.","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fmock-package\u002Fframework\u002Fskills\u002Fsda-test-skill\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M79HM5T2EKA7Z73JEJW6F7NG","sda-testing-best-practices","Fornece padrões e antipadrões para testes confiáveis, observáveis e resistentes a falsos positivos.","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Fframework\u002Fskills\u002Fsda-testing-best-practices\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M79HM2AEGTJ26EVJZEK1FKZ4","sda-template-resolve","Resolve um template ID para o path final aplicando composição em 4 níveis (overrides > presets > extensions > core).","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Fframework\u002Fskills\u002Fsda-template-resolve\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M79HKX3ANVSFX47GX4G6CTMB","sda-taskcard-run","Executa uma TaskCard v2 com até três tentativas e validação proporcional ao risco.","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Fframework\u002Fskills\u002Fsda-taskcard-run\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M79HKN8W28F3064TDK34QJDZ","sda-taskcard-generate","Gera uma TaskCard v2 para alteração pontual e delimitada.","https:\u002F\u002Fgithub.com\u002FLuisFelipeUnzueta\u002Fspec-driven-agent\u002Fblob\u002Fmain\u002Fframework\u002Fskills\u002Fsda-taskcard-generate\u002FSKILL.md",[],[]]