@daniellins/power-claude 0.16.3 → 0.17.0

package/README.md

@@ -2,47 +2,67 @@
 
 Framework enxuto de agentes para Claude Code — **pods por job-to-be-done**, com budget de tokens como gate de qualidade.
 
-## Princípios
+Você o instala dentro de um projeto seu, e ele acrescenta ali agentes, regras, skills e verificações
+automáticas que o Claude Code passa a usar. Não substitui o Claude Code: dá forma ao que ele faz, e
+verifica o resultado em disco antes de você confiar nele.
 
-1. **Pods por job-to-be-done** — em vez de dezenas de agentes genéricos, cada pod resolve um trabalho concreto (criar conteúdo com autoridade, montar aulas, automatizar processos, desenvolver com IA, forjar novos pods). Você instala só o que usa.
-2. **Budget de tokens como gate** — todo agente declara `budget_tokens` no frontmatter e um validador determinístico (`scripts/validate-budgets.js`) bloqueia qualquer agente que estoure o próprio budget, o teto global (1.500 tokens) ou 150 linhas. Contexto enxuto não é convenção: é gate.
-3. **Enforcement determinístico** — regras críticas viram hooks e scripts, não pedidos educados no prompt. Exemplo: o hook `enforce-git-push-authority.cjs` bloqueia `git push` fora do fluxo autorizado, direto no `PreToolUse`.
-4. **Verificação adversarial embutida** — os pods incluem agentes críticos (red-team) que revisam o próprio output antes de você confiar nele.
-5. **Garantia por código, não por prosa** — um pod é dado declarativo (`workflows/wf-*.yaml` + templates de etapa + `squad-io.yaml`), executado por um runner determinístico (`scripts/pc-run-pod.cjs`, skill `pc-run-pod`) que verifica o artefato EM DISCO — existe, casa com o template, todas as `veto.assertions` passam — antes de liberar a etapa seguinte. A garantia de processo é código, não prosa no prompt do agente.
+## Para quem chega agora
 
-Documentação operacional de cada mecanismo (uso, não só decisão): `docs/mecanismos/`.
+Se esta é a sua primeira vez, o caminho mais curto é este, nesta ordem:
 
-## O que mudou na v0.3 (runner, memória evolutiva, migração)
+1. **[Comece aqui](docs/mecanismos/aprendizado/getting-started.md)** — instalar, conferir a instalação
+   com o `doctor` e rodar o primeiro comando. Poucos minutos, sem pré-requisito de leitura.
+2. **[Guia de conceitos](docs/mecanismos/aprendizado/guia-de-conceitos.md)** — os termos que o framework
+   usa o tempo todo (pod, workflow, etapa, veto, checkpoint, budget, skill), um parágrafo cada.
+3. **Um tutorial de ponta a ponta**, conforme o que você quer fazer primeiro:
+   - [rodar um pod do começo ao fim](docs/mecanismos/aprendizado/tutorial-rodar-um-pod.md);
+   - [levar uma story do pedido ao merge](docs/mecanismos/aprendizado/tutorial-ciclo-de-story.md);
+   - [criar um pod novo com o forge](docs/mecanismos/aprendizado/tutorial-criar-pod-com-forge.md).
 
-**Runner determinístico.** Todo workflow de pod roda por um contrato `wf-*.yaml` validado estaticamente (`scripts/validate-pod-workflow.cjs` — ciclos, handoffs abertos, vetos malformados, templates ausentes) e provado em runtime pelo smoke dinâmico (`scripts/smoke-pod-workflow.cjs`). O runner (`scripts/pc-run-pod.cjs`, skill `pc-run-pod`) despacha um subagente fresco por etapa, aplica checkpoints bloqueantes e retoma por run-id.
+Prefere perguntar a ler? Depois de instalar, digite `/power:tutor` no Claude Code — ele aponta o
+próximo passo certo para o seu caso, sem você ter que escolher sozinho por qual destes documentos
+começar.
 
-**Memória evolutiva dos pods.** Um pod aprende do próprio uso, sem virar ruído: log cru append-only + consolidado podado por budget de tokens (`scripts/pod-memory.cjs`), watcher heurístico que audita aderência ao consolidado (`scripts/watcher-audit.cjs`) e ingest inicial de memória com dedupe (`scripts/forge-ingest-memory.cjs`). O runner injeta só o consolidado no brief do agente — nunca o log cru.
+Se você prefere instalar antes de ler, vá direto para a seção **Instalação**, logo abaixo — o
+getting-started continua valendo depois.
 
-**`*migrate-squad` — migração squad legado → pod com gates completos.** Comando do `forge-chief` que leva um squad inteiro pelas fases F0 (inventário) → F1 (triagem, para no humano) → F2 (geração + gates por workflow) → F3 (fechamento), com raiz de confiança em código no manifest de migração (`scripts/migration-manifest.cjs`) e paridade decidida pela máquina entre G5-LITE (2 runs) e G5-FULL (5 runs) via `scripts/harness-g5-lite.cjs`.
+## Princípios
+
+1. **Pods por job-to-be-done** — em vez de dezenas de agentes genéricos, cada pod resolve um trabalho concreto (criar conteúdo com autoridade, montar aulas, automatizar processos, desenvolver com IA, forjar novos pods). Você instala só o que usa.
+2. **Budget de tokens como gate** — todo agente declara `budget_tokens` no frontmatter e um validador determinístico ([`scripts/validate-budgets.js`](scripts/validate-budgets.js)) bloqueia qualquer agente que estoure o próprio budget, o teto global (1.500 tokens) ou 150 linhas. Contexto enxuto não é convenção: é gate.
+3. **Enforcement determinístico** — regras críticas viram hooks e scripts, não pedidos educados no prompt. Exemplo: o hook [`enforce-git-push-authority.cjs`](template/.claude/hooks/enforce-git-push-authority.cjs) bloqueia `git push` fora do fluxo autorizado, direto no `PreToolUse`.
+4. **Verificação adversarial embutida** — os pods incluem agentes críticos (red-team) que revisam o próprio output antes de você confiar nele.
+5. **Garantia por código, não por prosa** — um pod é dado declarativo (`workflows/wf-*.yaml` + templates de etapa + `squad-io.yaml`), executado por um runner determinístico ([`scripts/pc-run-pod.cjs`](scripts/pc-run-pod.cjs), skill `pc-run-pod`) que verifica o artefato EM DISCO — existe, casa com o template, todas as `veto.assertions` passam — antes de liberar a etapa seguinte. A garantia de processo é código, não prosa no prompt do agente.
 
 ## Instalação
 
-Enquanto o pacote não está publicado no npm, instale direto do GitHub:
+O framework é distribuído pelo npm. Dentro do projeto onde você quer usá-lo:
 
 ```bash
 cd seu-projeto
-npx github:daniellins/power-claude install
+npx @daniellins/power-claude install --yes
 ```
 
-Quando publicado no npm:
+`--yes` é o modo não-interativo: instala todos os pods, assume os padrões e **nunca** sobrescreve nem
+remove arquivo seu. Para escolher quais pods entram e decidir sobre o `git init` com commit inicial,
+rode a forma interativa:
 
 ```bash
 npx @daniellins/power-claude install
 ```
 
-O instalador pergunta quais pods instalar, se deve inicializar git e registra tudo em `.power-claude/manifest.json`. Em modo não-interativo:
+Em qualquer um dos dois, o instalador registra o que colocou em `.power-claude/manifest.json` — é esse
+manifesto que dá base ao `update` e ao `uninstall`. Logo depois de instalar, confira a instalação:
 
 ```bash
-npx @daniellins/power-claude install --yes
+npx @daniellins/power-claude doctor
 ```
 
 O instalador **nunca sobrescreve** arquivos seus: conflitos são perguntados (interativo) ou preservados (`--yes`). O `.claude/settings.json` recebe merge aditivo em `hooks`/`permissions` (a entrada nova do template é acrescentada sem remover nem alterar o que você já tem); nas demais chaves, suas chaves vencem, as do template entram só onde faltam.
 
+O npm é o caminho de instalação — não `git clone`. Um clone do repositório serve para ler e auditar o
+código, nunca para instalar; o que o instalador copia é o que o pacote publica.
+
 ## Comandos do CLI
 
 | Comando | O que faz |
@@ -50,11 +70,12 @@ O instalador **nunca sobrescreve** arquivos seus: conflitos são perguntados (in
 | `power-claude install` | Instala o framework no diretório atual (default) |
 | `power-claude adopt` | Adota uma instalação montada à mão (sem manifest): classifica o disco contra o template (idêntico / modificado / ausente), gera o `.power-claude/manifest.json` sem sobrescrever nada e coloca a instalação ao alcance do `update` |
 | `power-claude update` | Atualiza; arquivos que você modificou são preservados (com diff resumido no modo interativo) |
-| `power-claude doctor` | Diagnóstico: integridade do manifest, hooks, `.gitignore`, gate de budgets, tamanho do CLAUDE.md |
+| `power-claude doctor` | Diagnóstico: integridade do manifest, hooks, `.gitignore`, gate de budgets, tamanho do CLAUDE.md e execução dos workflows dos pods instalados |
 | `power-claude uninstall` | Remove apenas o que o instalador colocou e continua intacto; o que você modificou fica |
 | `power-claude --help` / `--version` | Ajuda / versão |
 
-Flag global: `--yes` (`-y`) para modo não-interativo.
+Flags globais: `--yes` (`-y`) para modo não-interativo; `--scope motor`, só em `update`, restringe a
+atualização aos scripts do motor (ver a nota da próxima seção).
 
 ## Estrutura instalada
 
@@ -63,30 +84,50 @@ seu-projeto/
 ├── .claude/
 │   ├── CLAUDE.md                  # instruções enxutas (budget ~2.000 tokens)
 │   ├── settings.json              # hooks + permissions (merge com o seu)
+│   ├── agents/                    # papéis do ciclo (pc-planner, pc-dev, pc-qa, pc-devops, ...)
+│   ├── commands/                  # comandos /power:*
+│   ├── rules/                     # autoridade, orquestração, matriz de modelos, curadoria
+│   ├── skills/                    # pc-run-pod, pc-full-cycle, pc-pipeline, pc-arena, ...
 │   └── hooks/
-│       └── enforce-git-push-authority.cjs
+│       ├── enforce-git-push-authority.cjs
+│       ├── enforce-cycle-authority.cjs
+│       ├── enforce-ready-oracles.cjs
+│       └── context-budget.cjs
 ├── pods/
 │   ├── academy/                   # aulas, palestras, treinamentos
 │   ├── authority-content/         # conteúdo com voz própria e fact-check
 │   ├── automation/                # N8N + Langgraph
+│   ├── content-carousel/          # carrosséis a partir de uma fonte, com fact-check
 │   ├── dev-ia/                    # ciclo de desenvolvimento com IA
+│   ├── hormozi-method/            # oferta, aquisição e diagnóstico de escala
 │   └── squad-forge/               # cria novos agentes e pods
 ├── knowledge/
-│   └── voice-dna/                 # DNA de voz para conteúdo autoral
-├── scripts/
-│   └── validate-budgets.js        # gate de budget dos agentes
+│   ├── voice-dna/                 # DNA de voz para conteúdo autoral (opcional)
+│   └── analyst/                   # base de pesquisa compartilhada
+├── scripts/                       # motor: runner, memória, validadores, vetos
 └── .power-claude/
     └── manifest.json              # estado da instalação (base do update/uninstall)
 ```
 
-**Nota honesta sobre o runner/memória/migração:** `power-claude install` copia `template/` inteiro (inclui a skill `pc-run-pod` em `.claude/skills/`) mais `scripts/validate-budgets.js` avulso — **só isso é distribuído automaticamente** (`installer/install.js`/`copy.js`). Os scripts que o runner, a memória e o `*migrate-squad` invocam (`pc-run-pod.cjs`, `pod-memory.cjs`, `migration-manifest.cjs`, `validate-pod-workflow.cjs`, `smoke-pod-workflow.cjs`, `harness-g5-lite.cjs`, `watcher-audit.cjs`, `forge-*.cjs`, `validate-no-clone.cjs`) vivem só em `scripts/` na raiz deste repositório e **não são copiados para o projeto instalado**. Hoje essas capacidades operam via o próprio repositório do framework (dogfooding) ou por sync manual dos scripts para o projeto consumidor — gap registrado em `BACKLOG.md`.
+O catálogo dos pods, com o job-to-be-done de cada um, está em [`template/pods/README.md`](template/pods/README.md).
+
+**O que viaja para a sua instalação, e o que não viaja.** `install` copia o `template/` inteiro (o
+`.claude/` acima, com agentes, regras, skills, comandos e hooks, mais os pods que você escolheu) **e**
+os scripts do motor declarados em [`installer/motor-scripts.json`](installer/motor-scripts.json) — o
+runner, a memória evolutiva dos pods, os validadores de workflow e os vetos vão junto, em `scripts/`,
+com o mesmo contrato de preservação do template (o que você modificar não é sobrescrito; `update
+--scope motor` é a via explícita para atualizar só esses scripts). O que **não** viaja é o que só faz
+sentido no repositório do framework: testes, fixtures e um punhado de scripts nomeados na lista
+`exclude` do mesmo manifesto. A documentação também não entra no pacote npm (`package.json` →
+`files: ["bin","installer","template","scripts"]`) — ela vive neste repositório, que é o que você está
+lendo agora.
 
-## Personalização — opcional, em três degraus
+## Personalização
 
-**Nenhum pod exige que você construa um DNA de voz.** Os pods que assinam peças **em seu nome**
-perguntam quem é você — **uma vez, três campos** (nome, handle, uma linha de autoridade). Tudo o
-mais — voz, tom, léxico, objetivos — é opcional, tem default funcional, e vai se ajustando com o
-seu feedback durante o uso.
+Opcional, em três degraus — e **nenhum pod exige que você construa um DNA de voz.** Os pods que assinam
+peças **em seu nome** perguntam quem é você — **uma vez, três campos** (nome, handle, uma linha de
+autoridade). Tudo o mais — voz, tom, léxico, objetivos — é opcional, tem default funcional, e vai se
+ajustando com o seu feedback durante o uso.
 
 | Degrau | O que você fornece | Onde mora | O que muda |
 |---|---|---|---|
@@ -107,6 +148,29 @@ template distribui só os `*.example.*`, e um oráculo (`scripts/owner-layer.cjs
 ser um placeholder marcado. Passo a passo de instanciação: `knowledge/voice-dna/README.md` na sua
 instalação.
 
+## Para quem avalia o framework
+
+Se você já conhece o terreno e quer julgar profundidade em vez de aprender do zero:
+
+- **[Índice dos mecanismos](docs/mecanismos/README.md)** — a referência densa: uma página por
+  mecanismo entregue, agrupada por área funcional, com comandos reais e ligação para o "porquê".
+  É o melhor lugar para medir o que o framework realmente faz.
+- **[Releases do GitHub](../../releases)** — o histórico versão a versão, com o que entrou em cada
+  release; o corpo de cada Release deriva do `CHANGELOG.md` do repositório de desenvolvimento (privado
+  por decisão). Este README não mantém vitrine de novidades: quem responde por "o que mudou desde a
+  última vez que olhei" são as Releases.
+- **[Decisões arquiteturais (ADR)](docs/adr)** — cada decisão não trivial com alternativas
+  consideradas, o que foi medido e o que foi recusado. É onde ver o critério, não só o resultado.
+- **[Pesquisa e registros de investigação](docs/research)** — o que foi medido antes de decidir,
+  inclusive quando a medição derrubou a hipótese.
+
+**Sobre as referências a `docs/stories` e `docs/qa` que você vai encontrar nos ADRs e na pesquisa.** Elas
+apontam para o registro de execução do framework — as stories de desenvolvimento e os gates de qualidade que
+as aprovam. Esse registro é **privado por decisão explícita, não por descuido**: o que se publica aqui é o
+critério (o porquê e o que foi medido), enquanto o diário de execução, que carrega contexto operacional e
+pessoal de quem trabalha nele, fica fora. Um link quebrado para `docs/stories/...` ou `docs/qa/...` num ADR
+é, portanto, o comportamento esperado desta fronteira — não um arquivo perdido.
+
 ## Validação no repositório do framework
 
 ```bash
@@ -116,6 +180,6 @@ npm run validate   # budgets + branding + validate-no-clone
 
 ## Licença
 
-[MIT](./LICENSE) — Copyright (c) 2026 **Daniel Lins**.
+[MIT](LICENSE) — Copyright (c) 2026 **Daniel Lins**.
 
 Use, copie e adapte à vontade, mantendo a atribuição a Daniel Lins conforme a licença.

package/installer/motor-scripts.json

@@ -1,39 +1,203 @@
 {
   "scripts": [
-    { "path": "scripts/pc-run-pod.cjs",           "owner": "skill:pc-run-pod", "reason": "referenced" },
-    { "path": "scripts/pod-memory.cjs",           "owner": "skill:pc-run-pod", "reason": "referenced" },
-    { "path": "scripts/pod-memory-note.cjs",      "owner": "skill:pc-run-pod", "reason": "referenced", "requiredBy": "skill:pc-run-pod" },
-    { "path": "scripts/validate-pod-workflow.cjs", "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/smoke-pod-workflow.cjs",   "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/harness-g5-lite.cjs",      "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/migration-manifest.cjs",   "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/watcher-audit.cjs",        "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/validate-no-clone.cjs",    "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/forge-assess-tier.cjs",    "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/validate-fidelity-output.cjs", "owner": "squad-forge/mind-extractor", "reason": "referenced" },
-    { "path": "scripts/validate-source-audit.cjs",    "owner": "squad-forge/mind-extractor", "reason": "referenced" },
-    { "path": "scripts/arena.cjs",                    "owner": "skill:pc-arena", "reason": "referenced" },
-    { "path": "scripts/forge-generate.cjs",       "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/forge-ingest-memory.cjs",  "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/forge-upgrade-pod.cjs",    "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/forge-harden-learning.cjs", "owner": "pod:squad-forge", "reason": "referenced" },
-    { "path": "scripts/validate-branding.js",     "owner": "pod:squad-forge", "reason": "require-dependency", "requiredBy": "scripts/validate-no-clone.cjs" },
-    { "path": "scripts/validate-budgets.js",      "owner": "pods:*",          "reason": "referenced" },
-    { "path": "scripts/veto-checks/lexical-check.cjs", "owner": "veto:command_check", "reason": "referenced", "requiredBy": "scripts/pc-run-pod.cjs" },
-    { "path": "scripts/veto-checks/html-valid.cjs",    "owner": "veto:command_check", "reason": "referenced", "requiredBy": "scripts/pc-run-pod.cjs" },
-    { "path": "scripts/veto-checks/render-gate.cjs",   "owner": "veto:command_check", "reason": "referenced", "requiredBy": "scripts/pc-run-pod.cjs" },
-    { "path": "scripts/veto-checks/phash-gate.cjs",    "owner": "veto:command_check", "reason": "referenced", "requiredBy": "scripts/pc-run-pod.cjs" },
-    { "path": "scripts/veto-checks/render-png.cjs",    "owner": "veto:command_check", "reason": "referenced", "requiredBy": "scripts/pc-run-pod.cjs" },
-    { "path": "scripts/pc-run-pipeline.cjs",      "owner": "skill:pc-pipeline", "reason": "referenced", "requiredBy": "skill:pc-pipeline" },
-    { "path": "scripts/validate-pipeline.cjs",    "owner": "skill:pc-pipeline", "reason": "require-dependency", "requiredBy": "scripts/pc-run-pipeline.cjs" },
-    { "path": "scripts/pod-export-compile.cjs",   "owner": "skill:pc-export", "reason": "referenced", "requiredBy": "skill:pc-export" },
-    { "path": "scripts/pod-export-executor.cjs",  "owner": "skill:pc-export", "reason": "referenced", "requiredBy": "skill:pc-export" },
-    { "path": "scripts/pod-export-release.cjs",   "owner": "skill:pc-export", "reason": "referenced", "requiredBy": "skill:pc-export" },
-    { "path": "scripts/pod-export-tools.cjs",     "owner": "skill:pc-export", "reason": "require-dependency", "requiredBy": "scripts/pod-export-executor.cjs" },
-    { "path": "scripts/pod-export-postprocess.cjs", "owner": "skill:pc-export", "reason": "require-dependency", "requiredBy": "scripts/pod-export-executor.cjs" },
-    { "path": "scripts/pod-export-service.cjs",   "owner": "skill:pc-export", "reason": "referenced", "requiredBy": "skill:pc-export" },
-    { "path": "scripts/pod-export-ui.cjs",        "owner": "skill:pc-export", "reason": "referenced", "requiredBy": "skill:pc-export" },
-    { "path": "scripts/validate-story-acs.cjs",   "owner": "skill:pc-validate-story", "reason": "referenced" }
+    {
+      "path": "scripts/pc-run-pod.cjs",
+      "owner": "skill:pc-run-pod",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/pod-memory.cjs",
+      "owner": "skill:pc-run-pod",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/pod-memory-note.cjs",
+      "owner": "skill:pc-run-pod",
+      "reason": "referenced",
+      "requiredBy": "skill:pc-run-pod"
+    },
+    {
+      "path": "scripts/validate-pod-workflow.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/smoke-pod-workflow.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/harness-g5-lite.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/migration-manifest.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/watcher-audit.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/validate-no-clone.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/forge-assess-tier.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/validate-fidelity-output.cjs",
+      "owner": "squad-forge/mind-extractor",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/validate-source-audit.cjs",
+      "owner": "squad-forge/mind-extractor",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/arena.cjs",
+      "owner": "skill:pc-arena",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/forge-generate.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/forge-ingest-memory.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/forge-upgrade-pod.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/forge-harden-learning.cjs",
+      "owner": "pod:squad-forge",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/validate-branding.js",
+      "owner": "pod:squad-forge",
+      "reason": "require-dependency",
+      "requiredBy": "scripts/validate-no-clone.cjs"
+    },
+    {
+      "path": "scripts/validate-budgets.js",
+      "owner": "pods:*",
+      "reason": "referenced"
+    },
+    {
+      "path": "scripts/veto-checks/lexical-check.cjs",
+      "owner": "veto:command_check",
+      "reason": "referenced",
+      "requiredBy": "scripts/pc-run-pod.cjs"
+    },
+    {
+      "path": "scripts/veto-checks/html-valid.cjs",
+      "owner": "veto:command_check",
+      "reason": "referenced",
+      "requiredBy": "scripts/pc-run-pod.cjs"
+    },
+    {
+      "path": "scripts/veto-checks/render-gate.cjs",
+      "owner": "veto:command_check",
+      "reason": "referenced",
+      "requiredBy": "scripts/pc-run-pod.cjs"
+    },
+    {
+      "path": "scripts/veto-checks/phash-gate.cjs",
+      "owner": "veto:command_check",
+      "reason": "referenced",
+      "requiredBy": "scripts/pc-run-pod.cjs"
+    },
+    {
+      "path": "scripts/veto-checks/render-png.cjs",
+      "owner": "veto:command_check",
+      "reason": "referenced",
+      "requiredBy": "scripts/pc-run-pod.cjs"
+    },
+    {
+      "path": "scripts/pc-run-pipeline.cjs",
+      "owner": "skill:pc-pipeline",
+      "reason": "referenced",
+      "requiredBy": "skill:pc-pipeline"
+    },
+    {
+      "path": "scripts/validate-pipeline.cjs",
+      "owner": "skill:pc-pipeline",
+      "reason": "require-dependency",
+      "requiredBy": "scripts/pc-run-pipeline.cjs"
+    },
+    {
+      "path": "scripts/pod-export-compile.cjs",
+      "owner": "skill:pc-export",
+      "reason": "referenced",
+      "requiredBy": "skill:pc-export"
+    },
+    {
+      "path": "scripts/pod-export-executor.cjs",
+      "owner": "skill:pc-export",
+      "reason": "referenced",
+      "requiredBy": "skill:pc-export"
+    },
+    {
+      "path": "scripts/pod-export-release.cjs",
+      "owner": "skill:pc-export",
+      "reason": "referenced",
+      "requiredBy": "skill:pc-export"
+    },
+    {
+      "path": "scripts/pod-export-tools.cjs",
+      "owner": "skill:pc-export",
+      "reason": "require-dependency",
+      "requiredBy": "scripts/pod-export-executor.cjs"
+    },
+    {
+      "path": "scripts/pod-export-postprocess.cjs",
+      "owner": "skill:pc-export",
+      "reason": "require-dependency",
+      "requiredBy": "scripts/pod-export-executor.cjs"
+    },
+    {
+      "path": "scripts/pod-export-service.cjs",
+      "owner": "skill:pc-export",
+      "reason": "referenced",
+      "requiredBy": "skill:pc-export"
+    },
+    {
+      "path": "scripts/pod-export-ui.cjs",
+      "owner": "skill:pc-export",
+      "reason": "referenced",
+      "requiredBy": "skill:pc-export"
+    },
+    {
+      "path": "scripts/validate-story-acs.cjs",
+      "owner": "skill:pc-validate-story",
+      "reason": "referenced"
+    }
   ],
-  "exclude": ["*.test.cjs", "__tests__/", "__fixtures__/", "validate-install.js", "validate-adopt.js", "validate-update-scope-motor.js", "owner-layer.cjs", "derive-ready-transitions.cjs"]
+  "exclude": [
+    "*.test.cjs",
+    "__tests__/",
+    "__fixtures__/",
+    "validate-install.js",
+    "validate-adopt.js",
+    "validate-update-scope-motor.js",
+    "owner-layer.cjs",
+    "derive-ready-transitions.cjs",
+    "validate-git-vetor.cjs",
+    "build-public-tree.cjs",
+    "validate-spec-coverage.cjs"
+  ]
 }

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "@daniellins/power-claude",
-  "version": "0.16.3",
+  "version": "0.17.0",
   "description": "Lean, budget-gated agent framework for Claude Code — pods by job-to-be-done",
   "author": "Daniel Lins",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/daniellins/power-claude-core.git"
+  },
+  "homepage": "https://github.com/daniellins/power-claude-core#readme",
+  "bugs": {
+    "url": "https://github.com/daniellins/power-claude-core/issues"
+  },
   "bin": {
     "power-claude": "bin/cli.js"
   },
@@ -20,7 +28,7 @@
     "scripts"
   ],
   "scripts": {
-    "test": "node scripts/validate-install.js && node scripts/validate-adopt.js && node scripts/validate-update-scope-motor.js && node scripts/__tests__/validate-pod-workflow.test.cjs && node scripts/__tests__/pc-run-pod.test.cjs && node scripts/__tests__/pc-run-pod-counter.test.cjs && node scripts/pc-run-pod-countgte.test.cjs && node scripts/forge.test.cjs && node scripts/forge-assess-tier.test.cjs && node scripts/forge-additive.test.cjs && node scripts/forge-canonical.test.cjs && node scripts/migration-manifest.test.cjs && node scripts/migration-manifest-sf3.2.test.cjs && node scripts/migration-manifest-sf3.3.test.cjs && node scripts/migration-manifest-sf5.5.test.cjs && node scripts/validate-no-clone.test.cjs && node scripts/migrate-squad-orchestration.test.cjs && node scripts/pod-memory.test.cjs && node scripts/pod-memory-budget.test.cjs && node scripts/pod-memory-note.test.cjs && node scripts/forge-harden-learning.test.cjs && node scripts/harden-knowledge.test.cjs && node scripts/consolidate-knowledge-runner.test.cjs && node scripts/smoke-pod-workflow.cjs scripts/__fixtures__/smoke-canary/workflows/wf-canary.yaml && node scripts/smoke-sweep.test.cjs && node scripts/smoke-isolation.test.cjs && node scripts/harness-g5-lite.test.cjs && node scripts/__tests__/motor-scripts.test.cjs && node scripts/validate-fidelity-output.test.cjs && node scripts/validate-source-audit.test.cjs && node scripts/arena.test.cjs && node scripts/veto-checks.test.cjs && node scripts/phash-gate.test.cjs && node scripts/render-png.test.cjs && node scripts/hn-carousel-contrato-entrada.test.cjs && node scripts/anti-path.test.cjs && node scripts/brief-leitura-obrigatoria.test.cjs && node scripts/pc-run-pipeline.test.cjs && node scripts/pod-export-compile.test.cjs && node scripts/pod-export-executor.test.cjs && node scripts/pod-export-postprocess.test.cjs && node scripts/pod-export-release.test.cjs && node scripts/pod-export-service.test.cjs && node scripts/pod-export-ui.test.cjs && node scripts/pod-export-hardening.test.cjs && node scripts/pod-export-queue-race.test.cjs && node scripts/npm-scope-invocation.test.cjs && node scripts/default-funcional.test.cjs && node scripts/owner-layer.test.cjs && node scripts/__tests__/enforce-cycle-authority.test.cjs && node scripts/__tests__/enforce-git-push-authority.test.cjs && node scripts/__tests__/validate-story-acs.test.cjs && node scripts/__tests__/enforce-ready-oracles.test.cjs && node scripts/__tests__/derive-ready-transitions.test.cjs && node installer/__tests__/doctor-ready-oracles.test.cjs && node installer/__tests__/merge-settings.test.cjs",
-    "validate": "node scripts/validate-budgets.js template/pods template/.claude/agents && node scripts/validate-branding.js && node scripts/validate-no-clone.cjs template"
+    "test": "node scripts/validate-install.js && node scripts/validate-adopt.js && node scripts/validate-update-scope-motor.js && node scripts/__tests__/validate-pod-workflow.test.cjs && node scripts/__tests__/pc-run-pod.test.cjs && node scripts/__tests__/pc-run-pod-tokens.test.cjs && node scripts/__tests__/pc-run-pod-describe.test.cjs && node scripts/__tests__/pc-run-pod-resolve.test.cjs && node scripts/__tests__/pc-run-pod-render-criteria.test.cjs && node scripts/__tests__/pc-run-pod-apply-production.test.cjs && node scripts/__tests__/pc-run-pod-content-carousel.test.cjs && node scripts/__tests__/pc-run-pod-content-carousel-b2.test.cjs && node scripts/__tests__/pc-run-pod-non-carousel-b2.test.cjs && node scripts/__tests__/pc-run-pod-counter.test.cjs && node scripts/pc-run-pod-countgte.test.cjs && node scripts/forge.test.cjs && node scripts/forge-assess-tier.test.cjs && node scripts/forge-additive.test.cjs && node scripts/forge-canonical.test.cjs && node scripts/__tests__/forge-register-entry-point.test.cjs && node scripts/migration-manifest.test.cjs && node scripts/migration-manifest-sf3.2.test.cjs && node scripts/migration-manifest-sf3.3.test.cjs && node scripts/migration-manifest-sf5.5.test.cjs && node scripts/validate-no-clone.test.cjs && node scripts/migrate-squad-orchestration.test.cjs && node scripts/pod-memory.test.cjs && node scripts/pod-memory-budget.test.cjs && node scripts/pod-memory-note.test.cjs && node scripts/forge-harden-learning.test.cjs && node scripts/harden-knowledge.test.cjs && node scripts/consolidate-knowledge-runner.test.cjs && node scripts/smoke-pod-workflow.cjs scripts/__fixtures__/smoke-canary/workflows/wf-canary.yaml && node scripts/smoke-sweep.test.cjs && node scripts/smoke-isolation.test.cjs && node scripts/harness-g5-lite.test.cjs && node scripts/__tests__/motor-scripts.test.cjs && node scripts/validate-fidelity-output.test.cjs && node scripts/validate-source-audit.test.cjs && node scripts/arena.test.cjs && node scripts/veto-checks.test.cjs && node scripts/phash-gate.test.cjs && node scripts/render-png.test.cjs && node scripts/hn-carousel-contrato-entrada.test.cjs && node scripts/anti-path.test.cjs && node scripts/brief-leitura-obrigatoria.test.cjs && node scripts/pc-run-pipeline.test.cjs && node scripts/pod-export-compile.test.cjs && node scripts/pod-export-executor.test.cjs && node scripts/pod-export-postprocess.test.cjs && node scripts/pod-export-release.test.cjs && node scripts/pod-export-service.test.cjs && node scripts/pod-export-ui.test.cjs && node scripts/pod-export-hardening.test.cjs && node scripts/pod-export-queue-race.test.cjs && node scripts/npm-scope-invocation.test.cjs && node scripts/default-funcional.test.cjs && node scripts/owner-layer.test.cjs && node scripts/__tests__/enforce-cycle-authority.test.cjs && node scripts/__tests__/enforce-git-push-authority.test.cjs && node scripts/__tests__/validate-story-acs.test.cjs && node scripts/__tests__/validate-spec-coverage.test.cjs && node scripts/__tests__/spec-wf-criteria-sync.test.cjs && node scripts/__tests__/enforce-ready-oracles.test.cjs && node scripts/__tests__/derive-ready-transitions.test.cjs && node installer/__tests__/doctor-ready-oracles.test.cjs && node installer/__tests__/merge-settings.test.cjs",
+    "validate": "node scripts/validate-budgets.js template/pods template/.claude/agents && node scripts/validate-branding.js && node scripts/validate-no-clone.cjs template && node scripts/validate-git-vetor.cjs"
   }
 }

package/scripts/__fixtures__/sf17.3/criteria-baseline.json

@@ -0,0 +1,18 @@
+{
+  "mm-copy": {
+    "wf": "template/pods/hormozi-method/workflows/wf-money-model-design.yaml",
+    "criteria": "Conferência final do checklist de 8 itens: o retorno por cliente sobre o custo de aquisição é de pelo menos 3 para 1 (LTGP:CAC>=3:1); o caixa fica positivo em até 30 dias (30-day cash flow+); 5+ ofertas; existe uma oferta de continuidade (continuity presente); o preço está ancorado em pelo menos 3 vezes o valor (ancoragem 3x+); há um downsell (oferta de baixo custo para quem recusa a principal); a copy está completa, sem nenhuma peça faltando; a sequência do funil está desenhada (sequência mapeada). Esta etapa reconfere pela 2ª vez o que a Fase 4 do processo já produziu: os itens numéricos (retorno sobre custo, caixa em 30 dias) são conferidos aqui como cálculo e julgamento seu, não como veto automático da máquina."
+  },
+  "paid-criativos": {
+    "wf": "template/pods/hormozi-method/workflows/wf-paid-ads-campaign.yaml",
+    "criteria": "Os hooks estão distribuídos por todos os 5 níveis de consciência do público (awareness), sem concentrar 100% num único nível, seguindo a proporção 70-20-10; a fonte de inspiração criativa (swipe file) está documentada; e há congruência landing page × ad verificada (a landing page bate com o anúncio). Isto é uma avaliação qualitativa, um julgamento seu — nunca um veto automático da máquina: as duas condições de ter 100% num único awareness level e de a landing não bater com o anúncio são congruência qualitativa que só o seu olho decide. Já os dois volumes mínimos exigidos — Menos de 50 hooks e Menos de 150 combinações — esses SIM a máquina confere sozinha, de forma automática e sem exigir o seu julgamento, distintos do julgamento qualitativo acima."
+  },
+  "lg-handoff": {
+    "wf": "template/pods/automation/workflows/wf-langgraph-build.yaml",
+    "criteria": "Regra inegociável do pod, item 3 do guia do pod: o runbook (o documento de operação) tem de ser OPERÁVEL — precisa explicar o que a automação faz, como saber que ela quebrou, como reexecutar com segurança, trazer a configuração de checkpointer/persistência (o mecanismo que retoma de onde parou após uma falha) e dizer quem é o dono. Julgar se esse runbook está completo é decisão sua, um julgamento de completude — não uma checagem automática da máquina, nunca um veto. A única fatia objetiva que a máquina confere sozinha é a existência em disco do arquivo do entregável: entregável existe (todo o resto da lista acima é julgamento seu)."
+  },
+  "n8n-handoff": {
+    "wf": "template/pods/automation/workflows/wf-n8n-build.yaml",
+    "criteria": "Regra inegociável do pod, item 3 do guia do pod: o runbook (o documento de operação) tem de ser OPERÁVEL — precisa explicar o que a automação faz, como saber que ela quebrou (onde olhar quando falhar), como reexecutar com segurança, listar as credenciais necessárias e dizer quem é o dono. Julgar se esse runbook está completo e com qualidade é decisão sua, um julgamento humano — não uma checagem automática da máquina, nunca um veto. A única fatia objetiva que a máquina confere sozinha é a existência em disco do arquivo do entregável: o entregável existe (todo o resto da lista acima é julgamento seu)."
+  }
+}

package/scripts/__fixtures__/validate-spec-coverage/cli-com-orfao.spec.md

@@ -0,0 +1,7 @@
+# SPEC sintética — CLI exit 1 (fixture AC4, invocação single-arg)
+
+Sem story e sem waiver, o requisito é órfão ⇒ exit 1, nome impresso.
+
+**FR-1.** requisito sem cobertura e sem deferimento — órfão.
+
+**NFR-1.** segundo requisito órfão.

package/scripts/__fixtures__/validate-spec-coverage/cli-sem-orfao.spec.md

@@ -0,0 +1,11 @@
+# SPEC sintética — CLI exit 0 (fixture AC4, invocação single-arg)
+
+Todos os requisitos deferidos por marcador válido; sem story, `orfao` é vazio ⇒ exit 0.
+
+**FR-1.** um requisito deliberadamente deferido. _(Deferido: PA-1.)_
+
+**NFR-1.** outro deferido. _(Deferido: PA-1.)_
+
+## 8. Perguntas de produto abertas
+
+**PA-1.** a âncora que resolve os deferimentos acima.

package/scripts/__fixtures__/validate-spec-coverage/contract4-noorfao.spec.md

@@ -0,0 +1,11 @@
+# SPEC sintética — contrato de 4 conjuntos, SEM órfão (fixture AC14, 2ª SPEC)
+
+Idêntica à contract4.spec.md, mas sem o FR-2 órfão: exit 0, `deferido` ainda impresso.
+
+**FR-1.** requisito coberto (a story o cita).
+
+**NFR-1.** requisito com waiver válido. _(Deferido: ADR-999.)_
+
+## Referências
+
+ADR-999 é citado aqui, em outro ponto do fixture, para que a âncora do deferimento do NFR-1 resolva.

package/scripts/__fixtures__/validate-spec-coverage/contract4.spec.md

@@ -0,0 +1,11 @@
+# SPEC sintética — contrato de 4 conjuntos (fixture AC14)
+
+**FR-1.** requisito coberto (a story o cita).
+
+**FR-2.** requisito órfão (nenhuma story o cita, sem waiver).
+
+**NFR-1.** requisito com waiver válido. _(Deferido: ADR-999.)_
+
+## Referências
+
+ADR-999 é citado aqui, em outro ponto do fixture, para que a âncora do deferimento do NFR-1 resolva (não seja pendurada).

package/scripts/__fixtures__/validate-spec-coverage/contract4.story.md

@@ -0,0 +1,5 @@
+# Story sintética — cobre FR-1 (fixture AC14)
+
+## Acceptance Criteria
+
+1. **Cobre FR-1.** Exercita o comportamento de FR-1. _(Rastreio: FR-1.)_

package/scripts/__fixtures__/validate-spec-coverage/coverage3-a.story.md

@@ -0,0 +1,7 @@
+# Story sintética A — cobre FR-1 e NFR-1 (fixture AC3)
+
+## Acceptance Criteria
+
+1. **Cobre FR-1.** _(Rastreio: FR-1.)_
+
+2. **Cobre NFR-1.** _(Rastreio: NFR-1.)_

package/scripts/__fixtures__/validate-spec-coverage/coverage3-b.story.md

@@ -0,0 +1,5 @@
+# Story sintética B — cobre FR-2 (fixture AC3)
+
+## Acceptance Criteria
+
+1. **Cobre FR-2.** _(Rastreio: FR-2.)_

package/scripts/__fixtures__/validate-spec-coverage/coverage3.spec.md

@@ -0,0 +1,9 @@
+# SPEC sintética — checkCoverage nomeia cada órfã (fixture AC3)
+
+**FR-1.** primeiro.
+
+**FR-2.** segundo.
+
+**FR-3.** terceiro — ficará órfão (nenhuma story o cita).
+
+**NFR-1.** um não-funcional.

package/scripts/__fixtures__/validate-spec-coverage/deferido-mutant.spec.md

@@ -0,0 +1,7 @@
+# SPEC sintética — mutante de remoção do marcador (fixture AC13)
+
+**FR-1.** requisito deferido por marcador válido e resolvível. _(Deferido: PA-2.)_
+
+## 8. Perguntas de produto abertas
+
+**PA-2.** âncora que resolve o deferimento acima.

package/scripts/__fixtures__/validate-spec-coverage/deferido-positive.spec.md

@@ -0,0 +1,11 @@
+# SPEC sintética — extractDeferrals caso POSITIVO (fixture AC11)
+
+**FR-1.** requisito comum, sem marcador.
+
+**NFR-2.** portabilidade — deferida. _(Deferido: PA-2.)_
+
+**FR-3.** integração — deferida com razão livre. _(Deferido: ADR-005, razão livre)_
+
+## 8. Perguntas de produto abertas
+
+**PA-2.** âncora que resolve o deferimento do NFR-2. Ver também ADR-005 para o do FR-3.

package/scripts/__fixtures__/validate-spec-coverage/deferido-trip-a-no-marker.spec.md

@@ -0,0 +1,3 @@
+# Tripwire (a) — requisito SEM marcador (fixture AC12a)
+
+**FR-1.** requisito sem nenhum marcador de deferimento — permanece candidato a orfao, ausente do mapa de extractDeferrals.

package/scripts/__fixtures__/validate-spec-coverage/deferido-trip-b-empty.spec.md

@@ -0,0 +1,3 @@
+# Tripwire (b) — âncora VAZIA (fixture AC12b)
+
+**FR-1.** marcador presente mas sem âncora — não é waiver válido. _(Deferido: )_