@jaimevalasek/aioson 1.22.0 → 1.23.1

package/docs/en/5-reference/cli-reference.md

@@ -663,3 +663,88 @@ aioson scout:commit --input=<path> --json
 **Exit codes:** 0 = committed (or no-op); 1 = file not found, lock failure.
 
 See [Sub-task Scout — CLI reference](../deyvin-subtask-scout/cli-commands.md) for full details.
+
+---
+
+## harness:approve
+
+Approve a pending human gate in the self:loop (loop guardrails). Persists the decision (who, when) to `.aioson/plans/{slug}/gates/{id}.json` and resumes the loop.
+
+```bash
+aioson harness:approve . --slug=<feature> --gate=<gate-id>
+aioson harness:approve . --slug=checkout --gate=database_destructive_change-1
+```
+
+**Options:**
+- `--slug=<feature>` — **required**. Feature slug matching the harness contract.
+- `--gate=<id>` — **required**. Gate id shown in `harness:status` output.
+- `--by=<name>` — override the "decided by" field (defaults to `git config user.name`).
+
+**Idempotent:** re-approving an already-decided gate is a no-op with a warning.
+
+---
+
+## harness:reject
+
+Reject a pending human gate. Ends the current loop attempt with a summary. Requires `--reason`.
+
+```bash
+aioson harness:reject . --slug=<feature> --gate=<gate-id> --reason="needs revert"
+```
+
+**Options:**
+- `--slug`, `--gate` — same as `harness:approve`.
+- `--reason=<text>` — **required** on reject. Recorded in the gate decision file.
+
+---
+
+## harness:status
+
+Human-readable view of the current loop state for a feature.
+
+```bash
+aioson harness:status . --slug=<feature>
+aioson harness:status . --slug=checkout --json
+```
+
+**Shows:** circuit state (open/closed), current iteration / max, estimated token budget (used/ceiling), last-attempt checks (passed/failed), last failure signature, pending human gates, and recommended next action.
+
+**Options:**
+- `--slug=<feature>` — **required**.
+- `--json` — structured output.
+
+---
+
+## harness:retro
+
+Deterministically mine the failure trail of a feature and materialize a retrospective dossier at `.aioson/context/retro/{slug}.md`. LLM-free, network-free. Source files are never modified.
+
+```bash
+aioson harness:retro . --feature=<slug>
+aioson harness:retro . --last=<N>          # last N features by PASS date
+aioson harness:retro . --feature=checkout --json
+```
+
+**Options:**
+- `--feature=<slug>` — mine a specific feature (mutually exclusive with `--last`).
+- `--last=<N>` — mine the N most recently completed features.
+- `--json` — structured output; exit codes are propagated.
+- `--locale=<l>` — output locale (default: project `interaction_language`).
+
+**Exit codes:** 0 = success (including empty dossier); 1 = unexpected I/O error; 12 = input error (invalid slug, conflicting flags, feature not found).
+
+**Sources mined:** QA reports, correction plans, dossier FAIL→PASS cycles, execution events, attempt artifacts, failure signatures, devlogs.
+
+---
+
+## harness:preview
+
+Display a truncated, UTF-8-safe preview of an artifact file. Used in self:loop criteria-fail feedback to avoid dumping full file contents into the agent context.
+
+```bash
+aioson harness:preview <file>
+aioson harness:preview .aioson/context/retro/checkout.md
+```
+
+Read-only. Best-effort write for the preview artifact.
+

package/docs/pt/4-agentes/pm.md

@@ -1,9 +1,10 @@
-# @pm — Backlog e user stories para projetos MEDIUM
+# @pm — Backlog, user stories e plano de implementação (MEDIUM)
 
-> **Para quem é:** quem trabalha em projetos MEDIUM e precisa transformar requisitos em histórias de usuário priorizadas.
+> **Para quem é:** quem trabalha em features ou projetos MEDIUM e precisa transformar requisitos em histórias de usuário priorizadas e num plano de implementação aprovável.
 > **Tempo de leitura:** 3 min.
-> **O que você vai sair sabendo:**
+> **O que você vai saber:**
 > - Quando `@pm` é obrigatório e quando é dispensável
+> - Os dois contextos onde ele aparece (feature workflow e projeto)
 > - O que ele produz em no máximo 2 páginas
 
 ---
@@ -16,8 +17,27 @@ Sua regra interna de ouro: máximo 2 páginas. Se o output excede isso, ele est
 
 ---
 
+## Dois contextos de ativação
+
+### 1. Feature workflow MEDIUM (pré-dev — v1.22.0+)
+
+No workflow de feature MEDIUM, `@pm` aparece logo antes do `@dev` — após `@discovery-design-doc` e antes do `@scope-check` pré-dev. Aqui sua responsabilidade é produzir o `implementation-plan-{slug}.md` (Gate C) que o `@dev` precisa para começar.
+
+```
+@analyst → @scope-check → @architect → @discovery-design-doc → @pm → STOP → /dev
+```
+
+O Gate C só é aprovado com o plano pronto. Se o `@pm` for pulado em features MEDIUM, o `gate:check --gate=C` vai bloquear o `@dev`.
+
+### 2. Projeto MEDIUM (modo tradicional)
+
+Para o projeto completo (configuração inicial), `@pm` entra após `@ux-ui` e antes de `@orchestrator` — priorizando e sequenciando as histórias do backlog.
+
+---
+
 ## Quando invocar
 
+- Features MEDIUM (obrigatório no workflow — produz Gate C).
 - Projetos MEDIUM, após `@ux-ui` e antes de `@orchestrator`.
 - Quando a feature é grande o suficiente para ter múltiplas histórias de usuário independentes.
 - Quando você quer sequenciar entregas por prioridade (ex: MVP → iteração 2).
@@ -27,7 +47,7 @@ Sua regra interna de ouro: máximo 2 páginas. Se o output excede isso, ele est
 ## Quando NÃO invocar
 
 - Projetos MICRO → `@dev` lê o contexto direto.
-- Projetos SMALL → também desnecessário na maioria dos casos.
+- Features e projetos SMALL → desnecessário na maioria dos casos.
 - Você quer refinar produto, não backlog → use `@product`.
 
 ---
@@ -86,6 +106,12 @@ aioson workflow:status .
 
 ## Handoff típico
 
+**Feature MEDIUM (pré-dev):**
+- **Vem de:** `@discovery-design-doc`
+- **Produz:** `implementation-plan-{slug}.md` (Gate C)
+- **Vai para:** STOP — desenvolvedor faz `/clear` e ativa `/dev`
+
+**Projeto MEDIUM (modo completo):**
 - **Vem de:** `@ux-ui`
 - **Vai para:** `@orchestrator`
 
@@ -95,3 +121,4 @@ aioson workflow:status .
 
 - [Ficha do @orchestrator](./orchestrator.md)
 - [Ficha do @dev](./dev.md) — quem executa as histórias
+- [Autopilot Handoff](../5-referencia/autopilot-handoff.md) — como `@pm` se encadeia automaticamente quando `auto_handoff: true`

package/docs/pt/5-referencia/README.md

@@ -10,6 +10,9 @@
 
 | Documento | Descrição |
 |---|---|
+| [loop-guardrails.md](./loop-guardrails.md) | Contrato verificável para o self:loop: scope guard, budget, human gates, criteria evaluation (v1.22.0) |
+| [harness-retro.md](./harness-retro.md) | Minerar o histórico de falhas de uma feature sem LLM — dossiê retrospectivo + harness:preview (v1.23.0) |
+| [autopilot-handoff.md](./autopilot-handoff.md) | Encadeamento automático de agentes pré-dev e pós-dev — opt-in via auto_handoff: true (v1.21.x–v1.22.0) |
 | [feature-dossier.md](./feature-dossier.md) | Dossier de feature: ponto único de verdade (spec, plano, histórico, status) |
 | [agent-chain-continuity.md](./agent-chain-continuity.md) | Sistema de continuidade entre sessões — Fases 1–8 (dev-resume, drift detection, handoff v2) |
 | [sdd-framework.md](./sdd-framework.md) | Spec-Driven Development: Constitution, project-pulse, skill aioson-spec-driven, MICRO/SMALL/MEDIUM |

package/docs/pt/5-referencia/autopilot-handoff.md

@@ -0,0 +1,131 @@
+# Autopilot Handoff — Encadeamento automático de agentes
+
+> Protocolo opt-in que elimina confirmações manuais de handoff nos segmentos determinísticos do workflow de feature.
+
+Introduzido na v1.21.x, completado na v1.22.0 (com @pm no MEDIUM). Quando ativado, os agentes do pré-dev e do ciclo pós-dev se encadeiam automaticamente — cada um termina, emite um aviso de transição e invoca o próximo. As decisões genuinamente humanas (entrada no `@dev` e `feature:close`) permanecem manuais.
+
+---
+
+## Ativação
+
+O autopilot é opt-in. Para ativar, adicione ao `project.context.md`:
+
+```yaml
+auto_handoff: true
+```
+
+Sem essa flag (ou com `false`), o comportamento padrão é handoff manual — cada agente para e espera você invocar o próximo. O `aioson doctor` emite um aviso `context:auto_handoff_declared` se o protocolo estiver instalado mas a flag não for declarada.
+
+**Pré-requisitos adicionais para ativação de cada handoff:**
+1. O workflow de feature deve estar ativo (slug conhecido, classificação SMALL ou MEDIUM).
+2. O gate/verdict do agente atual deve ter passado.
+
+---
+
+## Dois segmentos
+
+### Segmento 1 — Cadeia pré-dev
+
+```
+@analyst → @scope-check → @architect → @discovery-design-doc
+        [→ @pm  (apenas MEDIUM)]
+              ↓
+        STOP — human entra com /dev
+```
+
+A cadeia pré-dev **sempre para antes do primeiro `@dev`**. O desenvolvedor faz `/clear` (limpa o contexto) e inicia a implementação numa janela de contexto fresca — `@dev` é pesado e se beneficia de contexto limpo.
+
+### Segmento 2 — Ciclo de revisão pós-dev (hub = @qa)
+
+Uma vez que o `@dev` inicial termina, o autopilot retoma automaticamente:
+
+| Agente atual | Condição | Próximo invocado |
+|---|---|---|
+| `@dev` (1ª passagem) | testes ok, sem correções abertas | `@qa` |
+| `@dev` (correções) | correções aplicadas, testes ok | `@qa` (re-verificação) |
+| `@qa` | FAIL (Critical/High) | `@dev` via ciclo de correções (cap 2) |
+| `@qa` | PASS + trigger `@tester` não executado | `@tester` |
+| `@qa` | PASS + trigger `@pentester` não executado | `@pentester` |
+| `@qa` | PASS + contrato harness presente + `@validator` não PASS | `@validator` |
+| `@qa` | PASS + sem pendências | **STOP** — recomenda `aioson feature:close` |
+| `@tester` | bloqueios do dev | `@dev` |
+| `@tester` | sem bloqueios | `@qa` (re-avaliação) |
+| `@pentester` | findings abertos do dev | `@dev` |
+| `@pentester` | sem findings do dev | `@qa` (re-avaliação) |
+| `@validator` | PASS | **STOP** — recomenda `aioson feature:close` |
+| `@validator` | FAIL | `@dev` |
+
+`@tester` e `@pentester` só executam quando os seus triggers disparam (`@qa` identifica gaps de cobertura → `@tester`; superfície sensível auth/secrets/data → `@pentester`).
+
+---
+
+## Condições de parada
+
+O autopilot interrompe a cadeia e emite o handoff manual normal quando:
+
+1. **`feature:close` / publish** — sempre gate humano. `@qa` PASS sem pendências ou `@validator` PASS → STOP, recomenda `aioson feature:close`.
+2. **Primeira entrada em `@dev`** — a cadeia pré-dev para aqui.
+3. **Cap de correções atingido** — ciclo `@qa` ↔ `@dev` limitado a 2 rounds.
+4. **Finding crítico de segurança** — keywords auth/secret/credential/session/password/token/PII detectados pelo gate de segurança do `@qa` → STOP, requer intervenção humana.
+5. **Verdict não passou** — `@scope-check` não aprovado, `@architect` Gate B bloqueado, `@discovery-design-doc` readiness bloqueado, `@pm` Gate C bloqueado, `@validator` FAIL sem caminho seguro → STOP, roteamento manual.
+6. **Orçamento de contexto** — uso ≥ `context_warning_threshold`: grava checkpoint em `last-handoff.json`, STOP, recomenda `/clear`. A próxima sessão reentra no autopilot automaticamente.
+7. **Ambiguidade** — estado do workflow indisponível ou qualquer decisão real requer input humano → STOP.
+
+O usuário pode interromper a qualquer momento com Ctrl+C. O autopilot nunca retenta uma invocação interrompida.
+
+---
+
+## Como os agentes se encadeiam
+
+Quando autopilot está ativo e nenhuma condição de parada aplica:
+
+1. O agente termina suas responsabilidades (artefatos em disco, gate, dossier, `pulse:update`, `agent:done`).
+2. Emite: `Autopilot: @<atual> done → invocando @<próximo> (Ctrl+C para interromper)`.
+3. Invoca `Skill(aioson:agent:<próximo>)` com contexto `"continue feature {slug} — autopilot handoff from @<atual>"`.
+
+O roteamento é **determinístico** — nunca escolhido pelo modelo. O próximo agente vem do state machine do workflow (`workflow.state.json` ou `aioson workflow:status .`), não de julgamento do LLM.
+
+---
+
+## Rastreamento via CLI
+
+```bash
+# Ver estado atual do workflow (qual agente está ativo)
+aioson workflow:status .
+
+# Avançar manualmente (quando autopilot está desligado)
+aioson workflow:next .
+
+# Ver handoff preparado pelo agente anterior
+cat .aioson/context/last-handoff.json
+```
+
+---
+
+## Exemplo: feature MEDIUM com autopilot ativo
+
+```
+Você > /analyst  (start)
+
+@analyst  → scope + domain → STOP pré-dev (autopilot para @analyst)
+@scope-check → pre-dev check → autopilot: invocando @architect
+@architect   → Gate B PASS → autopilot: invocando @discovery-design-doc
+@discovery-design-doc → readiness ok → autopilot: invocando @pm (MEDIUM)
+@pm          → Gate C PASS → STOP — "Recomendo /clear e /dev"
+
+Você > /clear
+Você > /dev  (implementação manual — contexto limpo)
+
+@dev → testes ok → autopilot retoma: invocando @qa
+@qa  → PASS + nenhum trigger → STOP — "Execute: aioson feature:close . --feature=..."
+
+Você > aioson feature:close . --feature=minha-feature
+```
+
+---
+
+## Próximos passos
+
+- [SDD Framework](./sdd-framework.md) — sequência completa MICRO/SMALL/MEDIUM
+- [Comandos CLI](./comandos-cli.md) — `workflow:next`, `workflow:status`, `workflow:heal`
+- [Motor Hardening](./motor-hardening.md) — gates técnicos e auto-cura

package/docs/pt/5-referencia/comandos-cli.md

@@ -298,12 +298,24 @@ Três comandos de inteligência de sistema para otimizar tokens, gerar contexto
 | `brief:gen` | Lê uma fase do plano de implementação + `architecture.md` + `spec.md` e gera um brief 100% autocontido para um worker | Antes de entregar uma fase a um executor de squad — garante que o worker tem tudo que precisa sem buscar contexto adicional. Veja [Geração de Brief](#40-gerar-brief-de-worker-briefgen) |
 | `verify:gate` | Verificação de olhos frescos: compara spec vs artefato entregue sem histórico de conversa; emite `PASS`, `PASS_WITH_NOTES`, `FAIL_WITH_ISSUES` ou `BLOCKED` | Após cada entrega de fase — detecta bugs que o agente gerador não consegue ver por viés de contexto. Veja [Verify Gate](#41-verificar-entrega-verifygate) |
 
+### Loop Guardrails e harness
+
+Controle do loop autônomo `self:loop` com scope guard, budget enforcement, human gates e retrospectiva. Veja [Loop Guardrails](./loop-guardrails.md) e [harness:retro](./harness-retro.md).
+
+| Comando | O que faz | Quando usar |
+|---|---|---|
+| `harness:approve` | Aprova um gate humano pendente no loop (persiste decisão auditável) | Quando o loop pausou em `HUMAN_GATE` e você quer retomá-lo |
+| `harness:reject` | Rejeita um gate humano (encerra a tentativa com resumo; requer `--reason`) | Quando quer cancelar a tentativa atual após revisão humana |
+| `harness:status` | Visão do estado do loop: circuito, iteração N/M, budget, checks, gates pendentes, próxima ação | Sempre que quiser saber o que o loop está fazendo ou por que parou |
+| `harness:retro` | Minera deterministicamente o histórico de falhas de uma feature e gera dossiê retrospectivo — sem LLM | Após features com múltiplas iterações, antes de `@qa` ou `@validator` |
+| `harness:preview` | Exibe prévia de um artefato com truncação segura (usado no feedback de critério do loop) | Quando quer inspecionar um artefato sem despejar conteúdo no contexto |
+
 ### Git e committer
 
 | Comando | O que faz | Quando usar |
 |---|---|---|
 | `commit:prepare` | Coleta diff staged, roda `git:guard`, gera `commit-prep.json` com tipo, escopo e descrição candidata | Antes de ativar `@committer` — automatiza a preparação e aplica guardrails de segurança |
-| `git:guard` | Verifica stage proibido (`node_modules/`, secrets, build artifacts) e pode instalar pre-commit hook | Antes de qualquer commit; use `--install-hook` para proteção contínua |
+| `git:guard` | Verifica stage proibido (`node_modules/`, secrets, build artifacts); integra `forbidden_files` do contrato ativo e pode instalar pre-commit hook | Antes de qualquer commit; use `--install-hook` para proteção contínua |
 
 ### Feature Dossier
 
@@ -1711,11 +1723,14 @@ aioson workflow:execute . \
   --classification=SMALL \
   --dry-run
 
-# Executar de verdade
-aioson workflow:execute . --feature=checkout --tool=claude
-
-# Retomar do dev (pular product e analyst)
-aioson workflow:execute . \
+# Executar de verdade
+aioson workflow:execute . --feature=checkout --tool=claude
+
+# Executar com política agentica persistida para o gateway
+aioson workflow:execute . --feature=checkout --tool=codex --agentic --max-dev-qa-cycles=3
+
+# Retomar do dev (pular product e analyst)
+aioson workflow:execute . \
   --feature=checkout \
   --tool=claude \
   --start-from=dev
@@ -1812,6 +1827,57 @@ Regras do guard:
 
 ---
 
+### 56. Controlar o self:loop com guardrails
+
+O `self:loop` agora suporta contrato verificável. Veja [Loop Guardrails](./loop-guardrails.md) para o guia completo.
+
+```bash
+# Ver estado atual do loop de uma feature
+aioson harness:status . --slug=checkout
+aioson harness:status . --slug=checkout --json
+
+# Aprovar gate humano (ex: mudança em migrations detectada automaticamente)
+aioson harness:approve . --slug=checkout --gate=database_destructive_change-1
+
+# Rejeitar gate (cancela tentativa atual)
+aioson harness:reject . --slug=checkout --gate=database_destructive_change-1 --reason="revert necessário"
+```
+
+**Campos novos no harness-contract.json:**
+```json
+{
+  "contract_mode": "safe",
+  "allowed_files": ["src/modules/checkout/**"],
+  "human_gate": { "required_for": ["database_destructive_change"] }
+}
+```
+
+Use `contract_mode: "safe"` para loops conservadores (10 steps, 200k tokens), `"builder"` para desenvolvimento ativo, `"autopilot"` para loops longos.
+
+---
+
+### 57. Retrospectiva de falhas com harness:retro
+
+```bash
+# Dossiê da feature checkout
+aioson harness:retro . --feature=checkout
+
+# Dossiê das últimas 5 features (ordenadas por data de PASS)
+aioson harness:retro . --last=5
+
+# Formato JSON (com exit codes propagados)
+aioson harness:retro . --feature=checkout --json
+```
+
+Saída em `.aioson/context/retro/checkout.md`. Fontes mineradas: QA reports, planos de correção, trilha FAIL→PASS do dossier, eventos de execução, tentativas, assinaturas de falha e devlogs. Operação de leitura — arquivos-fonte nunca são alterados.
+
+```bash
+# Exibir prévia de um artefato com truncação segura
+aioson harness:preview .aioson/context/retro/checkout.md
+```
+
+---
+
 ## Atalhos úteis
 
 ```bash

package/docs/pt/5-referencia/harness-retro.md

@@ -0,0 +1,133 @@
+# harness:retro — Dossiê retrospectivo de loop
+
+> Minera deterministicamente o histórico de falhas de uma feature e materializa um dossiê retrospectivo — sem LLM, sem rede.
+
+Introduzido na v1.23.0 como parte do **RHO-lite** (Retrospective Harness Optimization). Resolve um problema comum após loops com múltiplas tentativas: entender o que falhou, quantos ciclos FAIL→PASS aconteceram e quais correções foram aplicadas, sem precisar ler dezenas de arquivos espalhados.
+
+---
+
+## Quando usar
+
+- Após a conclusão de uma feature com iterações do `self:loop` para entender o histórico de falhas.
+- Antes de iniciar `@qa` ou `@validator` em features que passaram por correções — o dossiê é um insumo de contexto.
+- Para identificar padrões recorrentes entre features (`--last=N`).
+
+---
+
+## Comandos
+
+### harness:retro
+
+```bash
+# Dossiê de uma feature específica
+aioson harness:retro . --feature=<slug>
+
+# Dossiê das N features mais recentes (ordenadas por data de PASS)
+aioson harness:retro . --last=<N>
+
+# Output JSON (propagando exit codes para automação)
+aioson harness:retro . --feature=<slug> --json
+
+# Locale específico
+aioson harness:retro . --feature=<slug> --locale=pt-BR
+```
+
+**Exit codes:**
+
+| Código | Significado |
+|---|---|
+| 0 | Sucesso (inclusive dossiê vazio — sem falhas mineradas) |
+| 1 | Erro de I/O inesperado |
+| 12 | Erro de input (slug inválido, flags conflitantes, feature inexistente) |
+
+**Saída:** `.aioson/context/retro/{slug}.md` (ou `window-last-{N}.md`). A operação é de **leitura**, exceto pela escrita do dossiê — os arquivos-fonte nunca são alterados.
+
+### harness:preview
+
+```bash
+# Exibir prévia de um artefato (com truncação segura)
+aioson harness:preview <arquivo>
+```
+
+Usado principalmente na interface de feedback do `self:loop` quando um critério falha — exibe o conteúdo do artefato relevante sem despejar o arquivo inteiro no contexto do agente. Truncação UTF-8-safe, best-effort write, modo read-only.
+
+---
+
+## Fontes mineradas
+
+O `harness:retro` lê sete fontes por feature:
+
+| Fonte | O que captura |
+|---|---|
+| Relatórios QA | Falhas e severidades de `@qa` |
+| Planos de correção | Correções aplicadas por ciclo |
+| Trilha do dossier | Ciclos FAIL→PASS do Agent Trail |
+| `execution_events` | Eventos de telemetria do loop |
+| Diretório de tentativas | Artefatos de cada iteração (`attempts/`) |
+| Assinaturas de falha | Padrões de erro recorrentes |
+| Devlogs | Resumos de sessão escritos manualmente |
+
+---
+
+## Estrutura do dossiê
+
+O arquivo gerado tem frontmatter YAML e três seções principais:
+
+```markdown
+---
+feature: minha-feature
+generated_at: ...
+schema_version: "1.0"
+sources:
+  qa_reports: 2
+  corrections: 1
+  dossier_trail: 8
+  attempts: 3
+---
+
+## Propostas candidatas
+<!-- Falhas de severidade high com múltiplas ocorrências ou ciclo FAIL→PASS -->
+
+### feature::C-01
+- Âncora, severidade, ocorrências, correções aplicadas, custo de retrabalho
+
+## Observações
+<!-- Falhas de severidade medium/low que não atingiram a promoção a candidato -->
+
+## Trilha minerada
+<!-- Paths, contagens por fonte, avisos de degradação -->
+```
+
+**Promoção a candidato (REQ-2):** uma falha vira "proposta candidata" quando atinge a barra de severidade ou ocorrência definida no schema. As demais ficam em "observações".
+
+---
+
+## Segurança
+
+O texto livre minerado (títulos de findings, descrições de correções) passa por `neutralizeText()` antes de ser renderizado no dossiê. Isso remove caracteres de controle, bidi e zero-width que poderiam injetar estrutura Markdown num dossiê compartilhado com `@sheldon`. O comportamento é byte-stable em texto limpo.
+
+---
+
+## Exemplos práticos
+
+```bash
+# Após fechar a feature checkout, gerar retrospectiva
+aioson harness:retro . --feature=checkout
+
+# Ver o dossiê gerado
+aioson harness:preview .aioson/context/retro/checkout.md
+
+# Retrospectiva das 5 features mais recentes
+aioson harness:retro . --last=5
+
+# Passar para @sheldon como contexto
+# Abra uma sessão @sheldon e carregue .aioson/context/retro/checkout.md
+```
+
+---
+
+## Próximos passos
+
+- [Loop Guardrails](./loop-guardrails.md) — contrato verificável que gera os artefatos que o retro minera
+- [Motor Hardening](./motor-hardening.md) — gates técnicos e auto-cura
+- [Feature Dossier](./feature-dossier.md) — ponto único de verdade de uma feature