@luanpdd/kit-mcp 1.34.0 → 1.36.0

package/kit/commands/sre.md

@@ -1,230 +1,230 @@
----
-name: sre
-description: Orquestrador da Suíte SRE (v1.10) — dispatch para agents (golden-signals-instrumenter, toil-auditor, postmortem-writer, prr-conductor) com sinônimos PT/EN.
-argument-hint: "<subcomando> [args...]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Grep
-  - Glob
-  - Task
-  - AskUserQuestion
----
-
-<objective>
-Orquestrador único da Suíte SRE (v1.10) — terceiro orquestrador da família após [`/supabase`](./supabase.md) (v1.8) e [`/observabilidade`](./observabilidade.md) (v1.9). Recebe subcomando + args, faz dispatch via `Task(subagent_type=...)` para o agent SRE correto. **Único ponto de chain de agents SRE** (anti-pitfall A10 mantido — agents permanecem função pura).
-
-**Subcomandos cobrem cap 3, 5, 6, 15, 32 do livro Google SRE:**
-- `golden-signals` — 4 signals universais (cap 6)
-- `auditar-toil`/`audit-toil` — eliminating toil (cap 5)
-- `postmortem` — blameless postmortem (cap 15)
-- `prr` — Production Readiness Review (cap 32)
-- `risk-budget`/`budget` — risk continuum (cap 3)
-
-**Cria/Atualiza:** o que cada agent invocado cria (patches OTel, TOIL-AUDIT.md, postmortem, PRR-REPORT.md, snapshot risk-budget).
-
-**Após:** o usuário tem o output do agent (instrumentação aplicada, audit, postmortem revisável, PRR scored, ou snapshot de budget).
-</objective>
-
-<execution_context>
-Skills consultadas pelos agents (Phase 36): [`kit/skills/sre-risk-management/SKILL.md`](../skills/sre-risk-management/SKILL.md), [`kit/skills/four-golden-signals/SKILL.md`](../skills/four-golden-signals/SKILL.md), [`kit/skills/eliminating-toil/SKILL.md`](../skills/eliminating-toil/SKILL.md), [`kit/skills/blameless-postmortems/SKILL.md`](../skills/blameless-postmortems/SKILL.md), [`kit/skills/production-readiness-review/SKILL.md`](../skills/production-readiness-review/SKILL.md) + glossário em [`kit/skills/_shared-sre/glossary.md`](../skills/_shared-sre/glossary.md).
-
-Agents disponíveis (Phase 37):
-- [`golden-signals-instrumenter`](../agents/golden-signals-instrumenter.md) — AGCORE-SRE-01
-- [`toil-auditor`](../agents/toil-auditor.md) — AGCORE-SRE-02
-- [`postmortem-writer`](../agents/postmortem-writer.md) — AGCORE-SRE-03
-- [`prr-conductor`](../agents/prr-conductor.md) — AGCORE-SRE-04
-
-**Subcomando `risk-budget`** é caso especial — comando direto (Plan 05 não usa agent); orquestrador delega aplicando skill [`sre-risk-management`](../skills/sre-risk-management/SKILL.md) inline ou re-encaminhando para `/risk-budget`.
-</execution_context>
-
-<context>
-**Argumentos:** `$ARGUMENTS` — primeiro token é o subcomando; restante é passado para o agent como prompt.
-
-**Subcomandos suportados (sinônimos PT-BR/EN):**
-
-| Subcomando | Sinônimos | Agent dispatched | Cap livro |
-|---|---|---|---|
-| `golden-signals` | `signals`, `4signals`, `golden` | `golden-signals-instrumenter` | 6 |
-| `auditar-toil` | `audit-toil`, `toil`, `auditar` | `toil-auditor` | 5 |
-| `postmortem` | `pm`, `post-mortem` | `postmortem-writer` | 15 |
-| `prr` | `production-readiness`, `readiness-review` | `prr-conductor` | 32 |
-| `risk-budget` | `budget`, `risk`, `continuum` | (comando direto — `/risk-budget`) | 3 |
-| `cascading` | `cascade`, `cascading-failures`, `auditar-cascading` | `cascading-failures-auditor` | 22 (v1.11) |
-| `load-shedding` | `shed`, `load-shed`, `loadshedding` | `load-shedding-instrumenter` | 22 (v1.11) |
-| `release` | `auditar-release`, `release-audit`, `pipeline` | `release-pipeline-auditor` | 8 (v1.11) |
-| `help` | `ajuda`, `?` | exibe esta tabela inline | — |
-
-**Roteamento de flags por subcomando:**
-
-- `golden-signals <target>` — args passados como `<target>` + flags `--service` `--saturation` `--runtime`
-- `auditar-toil` — flags `--time-window` `--team-size` `--output` `--runbooks-paths`
-- `postmortem` — flags **mutuamente exclusivas** `--from-investigation <id>` OU `--incident "<desc>"` + `--severity`
-- `prr` — flags **mutuamente exclusivas** `--service <name>` OU `--feature "<desc>"` + `--engagement` `--reviewer`
-- `risk-budget` — `[<slo_name>]` opcional + `--format` `--explain`
-
-**Exemplos:**
-
-```
-/sre golden-signals supabase/functions/process-emails    # instrumentar Edge Function
-/sre auditar-toil --time-window 6m                       # audit toil últimos 6 meses
-/sre postmortem --from-investigation incident-2026-05-06-1432-checkout-burn  # continuação de v1.9
-/sre prr --service orders-api --reviewer @sre-lead       # PRR de serviço existente
-/sre risk-budget checkout_success --explain              # budget + sabedoria 99.99% inline
-/sre help                                                # exibe tabela de subcomandos
-```
-</context>
-
-<process>
-
-## 1. Parsear subcomando
-
-```bash
-SUBCMD=$(echo "$ARGUMENTS" | awk '{print $1}')
-ARGS=$(echo "$ARGUMENTS" | cut -d' ' -f2-)
-```
-
-**Se `$ARGUMENTS` for vazio ou `SUBCMD` for `help`/`ajuda`/`?`:** exibir tabela de subcomandos inline + exemplo de uso. Sair.
-
-## 2. Resolver sinônimos para agent canônico
-
-```text
-golden-signals, signals, 4signals, golden          → golden-signals-instrumenter
-auditar-toil, audit-toil, toil, auditar            → toil-auditor
-postmortem, pm, post-mortem                        → postmortem-writer
-prr, production-readiness, readiness-review        → prr-conductor
-risk-budget, budget, risk, continuum               → (comando direto — /risk-budget)
-```
-
-**Se subcomando não resolve:** exibir erro inline com lista de subcomandos válidos. Sair.
-
-```
-✗ Subcomando desconhecido: '<SUBCMD>'
-
-Subcomandos válidos:
-  golden-signals    → instrumentar 4 signals OTel (Latency/Traffic/Errors/Saturation)
-  auditar-toil      → audit toil priorizado P0/P1/P2 + esforço de automação
-  postmortem        → postmortem blameless 9 seções (--from-investigation OU --incident)
-  prr               → Production Readiness Review 6 axes (--service OU --feature)
-  risk-budget       → error budget vs risk continuum + sabedoria 99.99%
-
-Uso: /sre <subcomando> <args...>
-Exemplo: /sre prr --service orders-api
-```
-
-## 3. Detectar `supabase/config.toml` (passar `project_id` para agents que usam MCP)
-
-```bash
-PROJECT_ID=""
-if [ -f supabase/config.toml ]; then
-  PROJECT_ID=$(grep -E '^project_id\s*=' supabase/config.toml | sed 's/.*= *"\(.*\)".*/\1/' | head -1)
-fi
-```
-
-Apenas `prr-conductor` usa `mcp__supabase__*` — outros 3 agents não precisam de `project_id` (instrumentação/audit/postmortem são filesystem only).
-
-## 4. Dispatch — caminhos por subcomando
-
-### 4a. `golden-signals` → `golden-signals-instrumenter`
-
-```text
-Task(
-  subagent_type="golden-signals-instrumenter",
-  prompt="
-${ARGS}
-
-Aplicar skill four-golden-signals. Gerar patches OTel para os 4 signals (Latency: histogram bucketed; Traffic: counter; Errors: counter por error.type; Saturation: gauge resource-specific).
-"
-)
-```
-
-### 4b. `auditar-toil` → `toil-auditor`
-
-```text
-Task(
-  subagent_type="toil-auditor",
-  prompt="
-project_root: .
-output_path: .planning/TOIL-AUDIT.md
-${ARGS}
-
-Aplicar skill eliminating-toil. Scan git log + scripts + runbooks; aplicar 6 critérios canônicos; priorizar P0/P1/P2; estimar esforço de automação L0-L4.
-"
-)
-```
-
-### 4c. `postmortem` → `postmortem-writer`
-
-Validar mutuamente exclusivos (`--from-investigation` E `--incident` ambos = ERROR; nenhum = AskUserQuestion sugerido).
-
-```text
-Task(
-  subagent_type="postmortem-writer",
-  prompt="
-${ARGS}
-
-Aplicar skill blameless-postmortems. Modo conforme flag (--from-investigation lê investigation v1.9; --incident standalone com 9 perguntas guiadas). 9 seções obrigatórias: Summary, Impact, Root Causes, Trigger, Resolution, Detection, Action Items, Lessons Learned, Timeline UTC. Foco em sistema/processo (NUNCA pessoas).
-"
-)
-```
-
-### 4d. `prr` → `prr-conductor`
-
-Validar mutuamente exclusivos (`--service` E `--feature` ambos = ERROR; nenhum = ERROR com sugestão). Se `--reviewer` ausente: AskUserQuestion (anti-pattern auto-PRR).
-
-```text
-Task(
-  subagent_type="prr-conductor",
-  prompt="
-${ARGS}
-${PROJECT_ID:+project_id: ${PROJECT_ID}}
-
-Aplicar skill production-readiness-review. Audit em 6 axes (System Architecture, Instrumentation, Emergency Response, Capacity Planning, Change Management, Performance) — todos obrigatórios. Engagement model conforme outage cost. Modo offline fallback graceful.
-"
-)
-```
-
-### 4e. `risk-budget` → comando direto `/risk-budget`
-
-Caso especial — não há agent. Re-encaminhar via shell ou aplicar skill `sre-risk-management` direto.
-
-```bash
-# PT-BR: invocar comando /risk-budget passando args
-# Em Claude Code, isso é equivalente a executar o comando file diretamente
-# (orquestrador apenas valida sinônimo e delega)
-/risk-budget ${ARGS}
-```
-
-Alternativa inline (se não há shell call): orquestrador lê `.planning/slos/*.md`, mapeia para tabela continuum (skill `sre-risk-management` Pattern 1), exibe tabela com status (OPTIMAL/OVER-SPEC/UNDER-SPEC/BUDGET-EXHAUSTED).
-
-## 5. Output
-
-Output do agent (ou do comando direto risk-budget) é o output do orquestrador. Sem post-processing — agent já formata estruturado.
-
-## 6. Sugestões de chains comuns (pós-output)
-
-Após dispatch, orquestrador pode sugerir chains comuns:
-
-| Subcomando rodado | Chain natural |
-|---|---|
-| `golden-signals` | `/sre prr --service <same>` (validar production-readiness) |
-| `auditar-toil` | `/observabilidade omm` (alimentar OMM Capacidade 3) |
-| `postmortem` | `/sre prr --service <affected>` OR `/observabilidade omm` (Capacidade 5 Incident Response) |
-| `prr` | (se Approved) deploy; (se Blocked) fechar P0s e re-PRR |
-| `risk-budget` | `/burn-rate-status` (live forecast) OR `/sre postmortem --incident "..."` se BUDGET-EXHAUSTED |
-
-</process>
-
-<success_criteria>
-- [ ] Subcomando resolvido para agent canônico (5 subcomandos × seus sinônimos)
-- [ ] `project_id` extraído de `supabase/config.toml` se presente (apenas relevante para `prr`)
-- [ ] Dispatch via `Task(subagent_type=...)` — único ponto de chain (anti-pitfall A10)
-- [ ] Subcomando `risk-budget` delega para comando direto `/risk-budget` (não usa Task)
-- [ ] Subcomando `postmortem` valida `--from-investigation` E `--incident` mutuamente exclusivos antes de dispatch
-- [ ] Subcomando `prr` valida `--service` E `--feature` mutuamente exclusivos + AskUserQuestion para reviewer (anti auto-PRR)
-- [ ] Subcomando inválido → mensagem clara com lista de 5 subcomandos válidos
-- [ ] Subcomando `help`/`ajuda`/`?` → exibe tabela inline com 6 linhas (5 + help)
-- [ ] Args após subcomando passam transparentemente para o agent
-- [ ] Sugestões de chains comuns na tabela final (5 chains documentadas)
-</success_criteria>
+---
+name: sre
+description: Orquestrador da Suíte SRE (v1.10) — dispatch para agents (golden-signals-instrumenter, toil-auditor, postmortem-writer, prr-conductor) com sinônimos PT/EN.
+argument-hint: "<subcomando> [args...]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+Orquestrador único da Suíte SRE (v1.10) — terceiro orquestrador da família após [`/supabase`](./supabase.md) (v1.8) e [`/observabilidade`](./observabilidade.md) (v1.9). Recebe subcomando + args, faz dispatch via `Task(subagent_type=...)` para o agent SRE correto. **Único ponto de chain de agents SRE** (anti-pitfall A10 mantido — agents permanecem função pura).
+
+**Subcomandos cobrem cap 3, 5, 6, 15, 32 do livro Google SRE:**
+- `golden-signals` — 4 signals universais (cap 6)
+- `auditar-toil`/`audit-toil` — eliminating toil (cap 5)
+- `postmortem` — blameless postmortem (cap 15)
+- `prr` — Production Readiness Review (cap 32)
+- `risk-budget`/`budget` — risk continuum (cap 3)
+
+**Cria/Atualiza:** o que cada agent invocado cria (patches OTel, TOIL-AUDIT.md, postmortem, PRR-REPORT.md, snapshot risk-budget).
+
+**Após:** o usuário tem o output do agent (instrumentação aplicada, audit, postmortem revisável, PRR scored, ou snapshot de budget).
+</objective>
+
+<execution_context>
+Skills consultadas pelos agents (Phase 36): [`kit/skills/sre-risk-management/SKILL.md`](../skills/sre-risk-management/SKILL.md), [`kit/skills/four-golden-signals/SKILL.md`](../skills/four-golden-signals/SKILL.md), [`kit/skills/eliminating-toil/SKILL.md`](../skills/eliminating-toil/SKILL.md), [`kit/skills/blameless-postmortems/SKILL.md`](../skills/blameless-postmortems/SKILL.md), [`kit/skills/production-readiness-review/SKILL.md`](../skills/production-readiness-review/SKILL.md) + glossário em [`kit/skills/_shared-sre/glossary.md`](../skills/_shared-sre/glossary.md).
+
+Agents disponíveis (Phase 37):
+- [`golden-signals-instrumenter`](../agents/golden-signals-instrumenter.md) — AGCORE-SRE-01
+- [`toil-auditor`](../agents/toil-auditor.md) — AGCORE-SRE-02
+- [`postmortem-writer`](../agents/postmortem-writer.md) — AGCORE-SRE-03
+- [`prr-conductor`](../agents/prr-conductor.md) — AGCORE-SRE-04
+
+**Subcomando `risk-budget`** é caso especial — comando direto (Plan 05 não usa agent); orquestrador delega aplicando skill [`sre-risk-management`](../skills/sre-risk-management/SKILL.md) inline ou re-encaminhando para `/risk-budget`.
+</execution_context>
+
+<context>
+**Argumentos:** `$ARGUMENTS` — primeiro token é o subcomando; restante é passado para o agent como prompt.
+
+**Subcomandos suportados (sinônimos PT-BR/EN):**
+
+| Subcomando | Sinônimos | Agent dispatched | Cap livro |
+|---|---|---|---|
+| `golden-signals` | `signals`, `4signals`, `golden` | `golden-signals-instrumenter` | 6 |
+| `auditar-toil` | `audit-toil`, `toil`, `auditar` | `toil-auditor` | 5 |
+| `postmortem` | `pm`, `post-mortem` | `postmortem-writer` | 15 |
+| `prr` | `production-readiness`, `readiness-review` | `prr-conductor` | 32 |
+| `risk-budget` | `budget`, `risk`, `continuum` | (comando direto — `/risk-budget`) | 3 |
+| `cascading` | `cascade`, `cascading-failures`, `auditar-cascading` | `cascading-failures-auditor` | 22 (v1.11) |
+| `load-shedding` | `shed`, `load-shed`, `loadshedding` | `load-shedding-instrumenter` | 22 (v1.11) |
+| `release` | `auditar-release`, `release-audit`, `pipeline` | `release-pipeline-auditor` | 8 (v1.11) |
+| `help` | `ajuda`, `?` | exibe esta tabela inline | — |
+
+**Roteamento de flags por subcomando:**
+
+- `golden-signals <target>` — args passados como `<target>` + flags `--service` `--saturation` `--runtime`
+- `auditar-toil` — flags `--time-window` `--team-size` `--output` `--runbooks-paths`
+- `postmortem` — flags **mutuamente exclusivas** `--from-investigation <id>` OU `--incident "<desc>"` + `--severity`
+- `prr` — flags **mutuamente exclusivas** `--service <name>` OU `--feature "<desc>"` + `--engagement` `--reviewer`
+- `risk-budget` — `[<slo_name>]` opcional + `--format` `--explain`
+
+**Exemplos:**
+
+```
+/sre golden-signals supabase/functions/process-emails    # instrumentar Edge Function
+/sre auditar-toil --time-window 6m                       # audit toil últimos 6 meses
+/sre postmortem --from-investigation incident-2026-05-06-1432-checkout-burn  # continuação de v1.9
+/sre prr --service orders-api --reviewer @sre-lead       # PRR de serviço existente
+/sre risk-budget checkout_success --explain              # budget + sabedoria 99.99% inline
+/sre help                                                # exibe tabela de subcomandos
+```
+</context>
+
+<process>
+
+## 1. Parsear subcomando
+
+```bash
+SUBCMD=$(echo "$ARGUMENTS" | awk '{print $1}')
+ARGS=$(echo "$ARGUMENTS" | cut -d' ' -f2-)
+```
+
+**Se `$ARGUMENTS` for vazio ou `SUBCMD` for `help`/`ajuda`/`?`:** exibir tabela de subcomandos inline + exemplo de uso. Sair.
+
+## 2. Resolver sinônimos para agent canônico
+
+```text
+golden-signals, signals, 4signals, golden          → golden-signals-instrumenter
+auditar-toil, audit-toil, toil, auditar            → toil-auditor
+postmortem, pm, post-mortem                        → postmortem-writer
+prr, production-readiness, readiness-review        → prr-conductor
+risk-budget, budget, risk, continuum               → (comando direto — /risk-budget)
+```
+
+**Se subcomando não resolve:** exibir erro inline com lista de subcomandos válidos. Sair.
+
+```
+✗ Subcomando desconhecido: '<SUBCMD>'
+
+Subcomandos válidos:
+  golden-signals    → instrumentar 4 signals OTel (Latency/Traffic/Errors/Saturation)
+  auditar-toil      → audit toil priorizado P0/P1/P2 + esforço de automação
+  postmortem        → postmortem blameless 9 seções (--from-investigation OU --incident)
+  prr               → Production Readiness Review 6 axes (--service OU --feature)
+  risk-budget       → error budget vs risk continuum + sabedoria 99.99%
+
+Uso: /sre <subcomando> <args...>
+Exemplo: /sre prr --service orders-api
+```
+
+## 3. Detectar `supabase/config.toml` (passar `project_id` para agents que usam MCP)
+
+```bash
+PROJECT_ID=""
+if [ -f supabase/config.toml ]; then
+  PROJECT_ID=$(grep -E '^project_id\s*=' supabase/config.toml | sed 's/.*= *"\(.*\)".*/\1/' | head -1)
+fi
+```
+
+Apenas `prr-conductor` usa `mcp__supabase__*` — outros 3 agents não precisam de `project_id` (instrumentação/audit/postmortem são filesystem only).
+
+## 4. Dispatch — caminhos por subcomando
+
+### 4a. `golden-signals` → `golden-signals-instrumenter`
+
+```text
+Task(
+  subagent_type="golden-signals-instrumenter",
+  prompt="
+${ARGS}
+
+Aplicar skill four-golden-signals. Gerar patches OTel para os 4 signals (Latency: histogram bucketed; Traffic: counter; Errors: counter por error.type; Saturation: gauge resource-specific).
+"
+)
+```
+
+### 4b. `auditar-toil` → `toil-auditor`
+
+```text
+Task(
+  subagent_type="toil-auditor",
+  prompt="
+project_root: .
+output_path: .planning/TOIL-AUDIT.md
+${ARGS}
+
+Aplicar skill eliminating-toil. Scan git log + scripts + runbooks; aplicar 6 critérios canônicos; priorizar P0/P1/P2; estimar esforço de automação L0-L4.
+"
+)
+```
+
+### 4c. `postmortem` → `postmortem-writer`
+
+Validar mutuamente exclusivos (`--from-investigation` E `--incident` ambos = ERROR; nenhum = AskUserQuestion sugerido).
+
+```text
+Task(
+  subagent_type="postmortem-writer",
+  prompt="
+${ARGS}
+
+Aplicar skill blameless-postmortems. Modo conforme flag (--from-investigation lê investigation v1.9; --incident standalone com 9 perguntas guiadas). 9 seções obrigatórias: Summary, Impact, Root Causes, Trigger, Resolution, Detection, Action Items, Lessons Learned, Timeline UTC. Foco em sistema/processo (NUNCA pessoas).
+"
+)
+```
+
+### 4d. `prr` → `prr-conductor`
+
+Validar mutuamente exclusivos (`--service` E `--feature` ambos = ERROR; nenhum = ERROR com sugestão). Se `--reviewer` ausente: AskUserQuestion (anti-pattern auto-PRR).
+
+```text
+Task(
+  subagent_type="prr-conductor",
+  prompt="
+${ARGS}
+${PROJECT_ID:+project_id: ${PROJECT_ID}}
+
+Aplicar skill production-readiness-review. Audit em 6 axes (System Architecture, Instrumentation, Emergency Response, Capacity Planning, Change Management, Performance) — todos obrigatórios. Engagement model conforme outage cost. Modo offline fallback graceful.
+"
+)
+```
+
+### 4e. `risk-budget` → comando direto `/risk-budget`
+
+Caso especial — não há agent. Re-encaminhar via shell ou aplicar skill `sre-risk-management` direto.
+
+```bash
+# PT-BR: invocar comando /risk-budget passando args
+# Em Claude Code, isso é equivalente a executar o comando file diretamente
+# (orquestrador apenas valida sinônimo e delega)
+/risk-budget ${ARGS}
+```
+
+Alternativa inline (se não há shell call): orquestrador lê `.planning/slos/*.md`, mapeia para tabela continuum (skill `sre-risk-management` Pattern 1), exibe tabela com status (OPTIMAL/OVER-SPEC/UNDER-SPEC/BUDGET-EXHAUSTED).
+
+## 5. Output
+
+Output do agent (ou do comando direto risk-budget) é o output do orquestrador. Sem post-processing — agent já formata estruturado.
+
+## 6. Sugestões de chains comuns (pós-output)
+
+Após dispatch, orquestrador pode sugerir chains comuns:
+
+| Subcomando rodado | Chain natural |
+|---|---|
+| `golden-signals` | `/sre prr --service <same>` (validar production-readiness) |
+| `auditar-toil` | `/observabilidade omm` (alimentar OMM Capacidade 3) |
+| `postmortem` | `/sre prr --service <affected>` OR `/observabilidade omm` (Capacidade 5 Incident Response) |
+| `prr` | (se Approved) deploy; (se Blocked) fechar P0s e re-PRR |
+| `risk-budget` | `/burn-rate-status` (live forecast) OR `/sre postmortem --incident "..."` se BUDGET-EXHAUSTED |
+
+</process>
+
+<success_criteria>
+- [ ] Subcomando resolvido para agent canônico (5 subcomandos × seus sinônimos)
+- [ ] `project_id` extraído de `supabase/config.toml` se presente (apenas relevante para `prr`)
+- [ ] Dispatch via `Task(subagent_type=...)` — único ponto de chain (anti-pitfall A10)
+- [ ] Subcomando `risk-budget` delega para comando direto `/risk-budget` (não usa Task)
+- [ ] Subcomando `postmortem` valida `--from-investigation` E `--incident` mutuamente exclusivos antes de dispatch
+- [ ] Subcomando `prr` valida `--service` E `--feature` mutuamente exclusivos + AskUserQuestion para reviewer (anti auto-PRR)
+- [ ] Subcomando inválido → mensagem clara com lista de 5 subcomandos válidos
+- [ ] Subcomando `help`/`ajuda`/`?` → exibe tabela inline com 6 linhas (5 + help)
+- [ ] Args após subcomando passam transparentemente para o agent
+- [ ] Sugestões de chains comuns na tabela final (5 chains documentadas)
+</success_criteria>

package/kit/file-manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.34.0",
-  "timestamp": "2026-06-05T16:59:58.501Z",
+  "version": "1.36.0",
+  "timestamp": "2026-06-05T20:25:11.147Z",
   "files": {
     "COMANDOS.md": "d24ec61a6ec35db314cc5f2ae287bfb927b794789c8f1d558c55862f5e6534b2",
     "COMPATIBILITY.md": "036423b40b94d2190b7341f39eff03e1d4270035d1712dc914d111e288712fa9",
@@ -78,6 +78,7 @@
     "agents/user-profiler.md": "a57d940c6d459de0d69ec73ac48fb2baffbae3067e163e8c9984c613a4d9c707",
     "agents/validador-evolucao-schema.md": "ff7eea2119a6f0df4cb53bb9dcb9fad45dd65e38972a5fb2bc71f4c7c58cd736",
     "agents/verifier.md": "351cbb2eb0e494e0894afe0cb5e22fa2c3b448c6a27e56a1dd2686c0f14124d2",
+    "agents/workflow-generator.md": "892328217612267d6158e61dc46e414de9555af1bf6af2907853a42e2d44ed1f",
     "commands/adicionar-backlog.md": "ed36584b63e3d7bada207f30453b7995b2dbf0fe011889cc08b846bd069b1ca9",
     "commands/adicionar-fase.md": "5c321dd74bb36a4baef52c81ef2dcf1ef37898031bc55149a1a0aea9cc1b26f4",
     "commands/adicionar-tarefa.md": "9bc704898eac7638f0cfa707349ce85a400c7031e618e182ddc1696d2ba2d4e7",
@@ -101,6 +102,7 @@
     "commands/caracterizar.md": "e05f9cf52689f032460fc3564ba41c3c481f44992402e713bbde5aedf88a54c2",
     "commands/concluir-marco.md": "bd8c8ad217af6e4ab0487d35d98fae94a9ec5a5ffd0a2199871e0d484cefd438",
     "commands/configuracoes.md": "7657ed72bca4e7eba30ac74a08d8eeca2136aefdcedf18e739e6a89b2417a8c0",
+    "commands/criar-workflow.md": "bab6e9697d75a0fd5f5252985563c3f5a6ff768c33f201c22b38ad8a55d875d2",
     "commands/dados-distribuidos.md": "c41949a399d29f04074a5b78fccd1cfbb240dde94140261ab8b9b878e61f0452",
     "commands/definir-perfil.md": "d1b73e411b94dad257bb3bac7ffc7f70deb92910442f8762f863076201b81f9b",
     "commands/definir-slo.md": "2f891393b6b46bffd28264d6cc340baf74297c7cd58be137d67c92313e942480",
@@ -329,6 +331,7 @@
     "skills/core-analysis-loop/SKILL.md": "298f27d1706abe0e64fa7dfa925eba3255328dccd03b24589be1e80d6d673dd3",
     "skills/crm-lead-pipeline-patterns/SKILL.md": "5bc38aa162017ee3889d7d6ecae10b4f3448a6492f9c9cee1499161eea55a5c5",
     "skills/distributed-tracing/SKILL.md": "7747bbd0563b28cba11b11064012c0b7a696ac04bd65c64debb42987781b26ff",
+    "skills/dynamic-workflow-authoring/SKILL.md": "3500b7f92ed28826132146e61c2dde9a79859bc0263972a16d536545fb26323b",
     "skills/eliminating-toil/SKILL.md": "451c7dfc5dd5af925f0b38657553ddbc1cc95923b3a572ac79d18201acb136cd",
     "skills/escolha-modelo-consistencia/SKILL.md": "3665cb38fd91871ed80d620307485754117fbbab30efe7c790ef1e768b67da3a",
     "skills/event-based-slos/SKILL.md": "6bf107d86cc409ab24773e16f26b4eca6e228dfd2db027de7b384e88a05bd50e",

package/kit/framework/references/output-style.md

@@ -1,22 +1,22 @@
-# Output Style — Caveman (compartilhado por todos os agentes framework)
-
-> Referenciado por agentes via `@./.claude/framework/references/output-style.md`. Agentes herdam essas regras automaticamente — não duplique o conteúdo no agente.
-
-**Estilo: caveman — compressão alta na fala, prosa normal em artefatos.**
-
-Em mensagens conversacionais, logs e relatórios ao orquestrador:
-- Cortar: filler (just/really/basically/actually/simply), pleasantries (claro/com certeza/feliz em ajudar), hedging desnecessário, artigos quando não compromete clareza
-- Fragments OK. Sinônimos curtos. Padrão: `[coisa] [ação] [razão]. [próximo passo].`
-- Termos técnicos exatos. Código inalterado. Erros citados literais.
-- NÃO: "Claro! O problema que você está enfrentando provavelmente é causado por..."
-- SIM: "Bug em auth middleware. Token expiry usa `<` em vez de `<=`. Fix:"
-
-**Auto-clarity — sair do caveman quando:**
-- Avisos de segurança ou ações destrutivas/irreversíveis
-- Sequências multi-passo onde fragmentar arrisca má interpretação
-- Usuário pediu clarificação ou está confuso
-
-**Boundary CRÍTICO — artefatos em `.planning/` mantêm formato completo:**
-PLAN.md, ROADMAP.md, REQUIREMENTS.md, CONTEXT.md, SUMMARY.md, VERIFICATION.md e qualquer outro artefato em `.planning/` é o **prompt de execução** ou registro auditável que outros agentes/humanos vão consumir. Esses DEVEM seguir prosa estruturada conforme template, com regras inequívocas, dependências explícitas e critérios completos. Caveman em artefatos = ambíguo = quebrado.
-
-**Caveman aplica-se SÓ ao raciocínio falado, logs de progresso e retorno ao orquestrador — NUNCA ao conteúdo de artefatos em `.planning/`.**
+# Output Style — Caveman (compartilhado por todos os agentes framework)
+
+> Referenciado por agentes via `@./.claude/framework/references/output-style.md`. Agentes herdam essas regras automaticamente — não duplique o conteúdo no agente.
+
+**Estilo: caveman — compressão alta na fala, prosa normal em artefatos.**
+
+Em mensagens conversacionais, logs e relatórios ao orquestrador:
+- Cortar: filler (just/really/basically/actually/simply), pleasantries (claro/com certeza/feliz em ajudar), hedging desnecessário, artigos quando não compromete clareza
+- Fragments OK. Sinônimos curtos. Padrão: `[coisa] [ação] [razão]. [próximo passo].`
+- Termos técnicos exatos. Código inalterado. Erros citados literais.
+- NÃO: "Claro! O problema que você está enfrentando provavelmente é causado por..."
+- SIM: "Bug em auth middleware. Token expiry usa `<` em vez de `<=`. Fix:"
+
+**Auto-clarity — sair do caveman quando:**
+- Avisos de segurança ou ações destrutivas/irreversíveis
+- Sequências multi-passo onde fragmentar arrisca má interpretação
+- Usuário pediu clarificação ou está confuso
+
+**Boundary CRÍTICO — artefatos em `.planning/` mantêm formato completo:**
+PLAN.md, ROADMAP.md, REQUIREMENTS.md, CONTEXT.md, SUMMARY.md, VERIFICATION.md e qualquer outro artefato em `.planning/` é o **prompt de execução** ou registro auditável que outros agentes/humanos vão consumir. Esses DEVEM seguir prosa estruturada conforme template, com regras inequívocas, dependências explícitas e critérios completos. Caveman em artefatos = ambíguo = quebrado.
+
+**Caveman aplica-se SÓ ao raciocínio falado, logs de progresso e retorno ao orquestrador — NUNCA ao conteúdo de artefatos em `.planning/`.**