@jaimevalasek/aioson 1.21.5 → 1.21.7

package/docs/en/1-understand/ecosystem-map.md

@@ -71,8 +71,8 @@
 The default order depends on the classification:
 
 **MICRO:** `@setup → @product (optional) → @dev`
-**SMALL:** `@setup → @product → @sheldon (optional) → @analyst → @architect → @dev → @qa`
-**MEDIUM:** `@setup → @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa`
+**SMALL:** `@setup → @product → @sheldon (optional) → @analyst → @scope-check → @architect → @dev → @qa`
+**MEDIUM:** `@setup → @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev → @qa`
 
 > **Why does `@sheldon` appear so early?** It is the **PRD quality guardian** — it runs *between* `@product` and `@analyst` to detect gaps, validate technical assumptions with web research, and decide between enriching the PRD in-place or creating a phased plan in `.aioson/plans/{slug}/`. Can be invoked N times on the same PRD. Skipping this step on serious features is expensive later.
 

package/docs/en/1-understand/glossary.md

@@ -73,7 +73,7 @@ Terms in alphabetical order. Each entry has a **short definition** + **concrete
 
 **How it works:**
 - 0–1 points → **MICRO** (`@setup → @product → @dev`)
-- 2–3 points → **SMALL** (`@setup → @product → @analyst → @architect → @dev → @qa`)
+- 2–3 points → **SMALL** (`@setup → @product → @analyst → @scope-check → @architect → @dev → @qa`)
 - 4–6 points → **MEDIUM** (full workflow, all gates, all artifacts)
 
 **Where it appears:** `classification:` in the `project.context.md` frontmatter.
@@ -255,7 +255,7 @@ Terms in alphabetical order. Each entry has a **short definition** + **concrete
 
 **Example:** a "legal compliance" squad with agents `@regulator`, `@attorney`, `@auditor`, under the command of `@squad`.
 
-**Commands:** `aioson squad:assemble`, `squad:agent-create`, `squad:refresh`.
+**Commands:** `aioson squad:scaffold`, `squad:agent-create`, `squad:doctor`.
 
 ---
 

package/docs/en/2-start/initial-decisions.md

@@ -41,7 +41,7 @@ The sum of three factors (each worth 0, 1, or 2 points):
 - Static portfolio page
 - Mini API with 3 endpoints
 
-#### SMALL — `@setup → @product → @analyst → @architect → @dev → @qa`
+#### SMALL — `@setup → @product → @analyst → @scope-check → @architect → @dev → @qa`
 
 - For: most real apps.
 - Full discovery+development+QA cycle.
@@ -110,13 +110,13 @@ Adds the squad system — you can create custom squads for domains outside the s
 - `@attorney` — interprets clauses
 - `@auditor` — checks conformity
 
-```bash
-# Inside the AI client
-> @squad assemble compliance
-
-# Or via CLI
-npx @jaimevalasek/aioson squad:assemble compliance
-```
+```bash
+# Inside the AI client
+> @squad scaffold compliance
+
+# Or via CLI
+npx @jaimevalasek/aioson squad:scaffold . --slug=compliance --name="Compliance" --mode=mixed
+```
 
 **When to activate Squads:**
 - You know you'll need specialization outside the standard

package/docs/en/3-recipes/README.md

@@ -8,7 +8,7 @@ These three trails show **how features reach development** in AIOSON. You almost
 
 | Trail | When to use | Key agents |
 |---|---|---|
-| **[Full feature with @sheldon](./full-feature-with-sheldon.md)** | You have a PRD in mind and want the complete canonical trail (most used) | @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa |
+| **[Full feature with @sheldon](./full-feature-with-sheldon.md)** | You have a PRD in mind and want the complete canonical trail (most used) | @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev → @qa |
 | [From idea to PRD via @briefing](./from-idea-to-prd-via-briefing.md) | Your idea is still vague, several loose notes | @briefing → @product |
 | [External plans for @product](./external-plans-for-product.md) *(coming soon)* | You already planned in another chat (ChatGPT, Claude.io Web) | @product (reads `/plans/`) |
 

package/docs/en/3-recipes/full-feature-with-sheldon.md

@@ -10,7 +10,7 @@
 ## The trail in one line
 
 ```
-/aioson:agent:product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev
+/aioson:agent:product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev
                                                               │
                                               (@qa ↔ @dev)  ← autonomous loop
                                                               │
@@ -299,7 +299,7 @@ Six months from now, anyone (or any AI) reads these files and understands **ever
 `@product → @dev → @qa`. Skip `@sheldon`, `@analyst`, `@architect`, `@ux-ui`, `@pm`, `@orchestrator`. The Constitution Article II (*Right-Sized Process*) protects you from unnecessary ceremony.
 
 ### SMALL without UI
-`@product → @sheldon → @analyst → @architect → @dev → @qa`. Skip `@ux-ui`, `@pm`, `@orchestrator`.
+`@product → @sheldon → @analyst → @scope-check → @architect → @dev → @qa`. Skip `@ux-ui`, `@pm`, `@orchestrator`.
 
 ### Full MEDIUM
 The complete trail above.

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

@@ -255,7 +255,7 @@ aioson agent:prompt dev --tool=opencode --json
 ```
 
 **Arguments:**
-- `<agent>` — agent id: `setup`, `product`, `analyst`, `architect`, `ux-ui`, `pm`, `dev`, `qa`, `orchestrator`.
+- `<agent>` — agent id: `setup`, `product`, `analyst`, `scope-check`, `architect`, `ux-ui`, `pm`, `dev`, `qa`, `orchestrator`.
 
 **Options:**
 - `--tool=codex|claude|opencode` — formats the prompt for the target CLI. Default: `codex`.
@@ -302,18 +302,18 @@ Notes:
 
 **Sequences by classification:**
 - `MICRO`: `@setup → @product (optional) → @dev`
-- `SMALL`: `@setup → @product → @analyst → @architect → @dev → @qa`
-- `MEDIUM`: `@setup → @product → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa`
+- `SMALL`: `@setup → @product → @analyst → @scope-check → @architect → @dev → @qa`
+- `MEDIUM`: `@setup → @product → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev → @qa`
 
 **Feature development workflow (after initial setup):**
 
 Once the project is set up, each new feature follows a shorter sequence — no `@setup` required:
 
 ```
-/aioson:agent:product → @analyst → @dev → @qa
+/aioson:agent:product → @analyst → @scope-check → @dev → @qa
 ```
 
-`@product` creates a feature-scoped `prd-{slug}.md` and registers the feature in `features.md`. `@analyst` produces `requirements-{slug}.md` and `spec-{slug}.md`. `@dev` reads the feature spec. `@qa` closes the feature by running `feature:close --verdict=PASS`, which updates `spec-{slug}.md` with a QA sign-off, marks it `done` in `features.md`, and automatically archives all feature artefacts to `.aioson/context/done/{slug}/`.
+`@product` creates a feature-scoped `prd-{slug}.md` and registers the feature in `features.md`. `@analyst` produces `requirements-{slug}.md` and `spec-{slug}.md`. `@scope-check` compares intent against the planned implementation before coding. `@dev` reads the feature spec. `@qa` closes the feature by running `feature:close --verdict=PASS`, which updates `spec-{slug}.md` with a QA sign-off, marks it `done` in `features.md`, and automatically archives all feature artefacts to `.aioson/context/done/{slug}/`.
 
 The `SMALL` and MEDIUM outputs include a note reminding you of this sequence.
 

package/docs/en/5-reference/squad-dashboard.md

@@ -9,7 +9,7 @@ No additional installation required. It ships with aioson.
 ## Prerequisites
 
 - aioson installed globally (`npm install -g @jaimevalasek/aioson`)
-- At least one squad created in the project (`aioson squad:create`)
+- At least one squad created in the project (`aioson squad:scaffold . --slug=<slug>`)
 - Node.js ≥ 18 (already required by aioson)
 - A modern browser (Chrome, Firefox, Safari, Edge)
 
@@ -330,10 +330,10 @@ Check that the manifest exists:
 ls .aioson/squads/*/squad.manifest.json
 ```
 
-If not, create the squad first:
-```bash
-aioson squad:create . --squad=my-squad
-```
+If not, create the squad first:
+```bash
+aioson squad:scaffold . --slug=my-squad --name="My Squad" --mode=mixed
+```
 
 ### Panels appear empty
 

package/docs/en/README.md

@@ -23,7 +23,7 @@ This is the entry door to the English documentation. It is not an alphabetical i
 ### I want a recipe ready for my case
 
 **Canonical trails — how features reach the dev:**
-1. **[Full feature with @sheldon](./3-recipes/full-feature-with-sheldon.md)** — the main trail: `@product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa` (with optional gates from `@tester` and `@pentester`)
+1. **[Full feature with @sheldon](./3-recipes/full-feature-with-sheldon.md)** — the main trail: `@product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev → @qa` (with optional gates from `@tester` and `@pentester`)
 2. [From idea to PRD via @briefing](./3-recipes/from-idea-to-prd-via-briefing.md) — when the idea is still vague
 3. [Continuity between sessions](./3-recipes/continuity-between-sessions.md) — feature dossier, dev-resume, drift detection
 

package/docs/pt/1-entender/glossario.md

@@ -73,7 +73,7 @@ Termos em ordem alfabética. Cada um tem **definição curta** + **exemplo concr
 
 **Como funciona:**
 - 0–1 ponto → **MICRO** (`@setup → @product → @dev`)
-- 2–3 pontos → **SMALL** (`@setup → @product → @analyst → @architect → @dev → @qa`)
+- 2–3 pontos → **SMALL** (`@setup → @product → @analyst → @scope-check → @architect → @dev → @qa`)
 - 4–6 pontos → **MEDIUM** (workflow completo, todos os gates, todos os artefatos)
 
 **Onde aparece:** `classification:` no frontmatter do `project.context.md`.
@@ -255,7 +255,7 @@ Termos em ordem alfabética. Cada um tem **definição curta** + **exemplo concr
 
 **Exemplo:** squad "compliance jurídico" com agentes `@regulator`, `@attorney`, `@auditor`, sob comando do `@squad`.
 
-**Comandos:** `aioson squad:assemble`, `squad:agent-create`, `squad:refresh`.
+**Comandos:** `aioson squad:scaffold`, `squad:agent-create`, `squad:doctor`.
 
 ---
 

package/docs/pt/1-entender/mapa-do-ecossistema.md

@@ -2,7 +2,7 @@
 
 > **Para quem é:** quem quer ver o time inteiro de uma vez.
 > **Tempo de leitura:** 8 min.
-> **O que você vai sair sabendo:** quem são os 28 agentes, em que momento cada um entra, e como eles se conversam.
+> **O que você vai sair sabendo:** quem são os 29 agentes, em que momento cada um entra, e como eles se conversam.
 
 ---
 
@@ -71,8 +71,8 @@
 A ordem padrão depende da classificação:
 
 **MICRO:** `@setup → @product (opcional) → @dev`
-**SMALL:** `@setup → @product → @sheldon (opcional) → @analyst → @architect → @dev → @qa`
-**MEDIUM:** `@setup → @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa`
+**SMALL:** `@setup → @product → @sheldon (opcional) → @analyst → @scope-check → @architect → @dev → @qa`
+**MEDIUM:** `@setup → @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev → @qa`
 
 > **Por que `@sheldon` aparece tão cedo?** Ele é o **PRD quality guardian** — roda *entre* `@product` e `@analyst` para detectar gaps, validar premissas técnicas com pesquisa web, e decidir entre enriquecer o PRD in-place ou criar um phased plan em `.aioson/plans/{slug}/`. Pode ser invocado N vezes no mesmo PRD. Pular essa etapa em features sérias custa caro lá na frente.
 

package/docs/pt/2-comecar/decisoes-iniciais.md

@@ -41,7 +41,7 @@ Soma de três fatores (cada um vale 0, 1 ou 2 pontos):
 - Página estática de portfólio
 - Mini-API de 3 endpoints
 
-#### SMALL — `@setup → @product → @analyst → @architect → @dev → @qa`
+#### SMALL — `@setup → @product → @analyst → @scope-check → @architect → @dev → @qa`
 
 - Para: a maioria dos apps reais.
 - Tem o ciclo completo de discovery+desenvolvimento+QA.
@@ -99,7 +99,7 @@ Você pode marcar **mais de um** no wizard — eles convivem no mesmo projeto.
 
 ### Development (padrão)
 
-Inclui os 28 agentes oficiais (product, analyst, dev, qa, etc.). Suficiente para 95% dos projetos.
+Inclui os 29 agentes oficiais (product, analyst, dev, qa, etc.). Suficiente para 95% dos projetos.
 
 ### Development + Squads
 
@@ -111,11 +111,11 @@ Adiciona o sistema de squads — você pode criar squads customizados para domí
 - `@auditor` — checa conformidade
 
 ```bash
-# Dentro do cliente AI
-> @squad assemble compliance
-
-# Ou via CLI
-npx @jaimevalasek/aioson squad:assemble compliance
+# Dentro do cliente AI
+> @squad montar compliance
+
+# Ou via CLI
+npx @jaimevalasek/aioson squad:scaffold compliance
 ```
 
 **Quando ativar Squads:**

package/docs/pt/3-receitas/README.md

@@ -8,7 +8,7 @@ Estas três trilhas mostram **como features chegam ao desenvolvimento** no AIOSO
 
 | Trilha | Quando usar | Agentes-chave |
 |---|---|---|
-| **[Feature completa com @sheldon](./feature-completa-com-sheldon.md)** | Você tem PRD em mente e quer a trilha canônica completa (a mais usada) | @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa |
+| **[Feature completa com @sheldon](./feature-completa-com-sheldon.md)** | Você tem PRD em mente e quer a trilha canônica completa (a mais usada) | @product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev → @qa |
 | [Da ideia ao PRD via @briefing](./da-ideia-ao-prd-via-briefing.md) | Sua ideia ainda é vaga, várias anotações soltas | @briefing → @product |
 | [Plans externos para @product](./plans-externos-para-product.md) | Você já planejou em outro chat (ChatGPT, Claude.io Web) | @product (lê `/plans/`) |
 

package/docs/pt/3-receitas/feature-completa-com-sheldon.md

@@ -10,7 +10,7 @@
 ## A trilha em uma linha
 
 ```
-@product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev
+@product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev
                                                               │
                                               (@qa ↔ @dev)  ← ciclo autônomo
                                                               │
@@ -299,7 +299,7 @@ Daqui a 6 meses, qualquer pessoa (ou IA) lê esses arquivos e entende **tudo**:
 `@product → @dev → @qa`. Pule `@sheldon`, `@analyst`, `@architect`, `@ux-ui`, `@pm`, `@orchestrator`. A Constitution Article II (*Right-Sized Process*) protege você de cerimônia desnecessária.
 
 ### SMALL sem UI
-`@product → @sheldon → @analyst → @architect → @dev → @qa`. Pule `@ux-ui`, `@pm`, `@orchestrator`.
+`@product → @sheldon → @analyst → @scope-check → @architect → @dev → @qa`. Pule `@ux-ui`, `@pm`, `@orchestrator`.
 
 ### MEDIUM puro
 A trilha completa acima.

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

@@ -1,6 +1,6 @@
 # Guia de Agentes AIOSON
 
-> Índice completo dos 28 agentes, com situação de uso e saída esperada.
+> Índice completo dos 29 agentes, com situação de uso e saída esperada.
 > Cada agente tem sua ficha — clique no nome para detalhes.
 
 ---
@@ -9,9 +9,10 @@
 
 | Agente | Para que serve | Quando invocar | Saída principal |
 |---|---|---|---|
-| [@product](./product.md) | Define visão, PRD e escopo da feature | Início de projeto ou nova feature | `prd.md`, `spec.md` |
-| [@analyst](./analyst.md) | Descobre domínio, entidades, fluxos | Após `@product`, antes de `@architect` | `architecture.md` (domínio) |
-| [@architect](./architect.md) | Decide stack, estrutura, integração técnica | Após `@analyst` | `architecture.md` (técnico) |
+| [@product](./product.md) | Define visão, PRD e escopo da feature | Início de projeto ou nova feature | `prd.md`, `spec.md` |
+| [@analyst](./analyst.md) | Descobre domínio, entidades, fluxos | Após `@product`, antes de `@architect` | `architecture.md` (domínio) |
+| [@scope-check](./scope-check.md) | Confronta intenção, plano e artefatos antes do código | Antes de `@dev` e após fixes relevantes | `scope-check.md` |
+| [@architect](./architect.md) | Decide stack, estrutura, integração técnica | Após `@analyst` | `architecture.md` (técnico) |
 | [@ux-ui](./ux-ui.md) | Design system e specs de componentes | MEDIUM, após `@architect` | `design-doc.md`, `discovery.md` |
 | [@pm](./pm.md) | Backlog, user stories, ACs detalhados | MEDIUM, após `@ux-ui` | `tasks.md` |
 | [@orchestrator](./orchestrator.md) | Coordena lanes paralelas de implementação | MEDIUM, após `@pm` | `.aioson/context/parallel/` |

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

@@ -10,7 +10,7 @@
 
 ## Para que serve
 
-Você passou por `@product`, `@analyst`, `@architect`. A spec existe, as decisões técnicas estão em disco. Agora é hora de escrever código — mas de forma que o próximo agente (`@qa`, `@validator`) consiga verificar o que foi feito sem perguntar "o que você implementou?".
+Você passou por `@product`, `@analyst`, `@architect` e, nos fluxos SMALL/MEDIUM atuais, por `@scope-check` antes de abrir implementação. A spec existe, as decisões técnicas estão em disco. Agora é hora de escrever código — mas de forma que o próximo agente (`@qa`, `@validator`) consiga verificar o que foi feito sem perguntar "o que você implementou?".
 
 `@dev` lê os artefatos, implementa, e grava um `dev-state.md` com o resumo do que foi feito, quais arquivos foram tocados, e qual é o próximo passo. Isso é o que permite continuar de onde parou em outra sessão, sem depender do histórico de chat.
 
@@ -20,7 +20,7 @@ Você passou por `@product`, `@analyst`, `@architect`. A spec existe, as decisõ
 
 ## Quando invocar
 
-- Após `@architect` (SMALL/MEDIUM) ou `@product` (MICRO).
+- Após `@scope-check` (SMALL/MEDIUM) ou `@product` (MICRO).
 - Para retomar uma feature interrompida — `@dev` lê `dev-state.md` e sabe onde parou.
 - Para correções apontadas pelo `@qa` (ciclo autônomo, até 2 iterações).
 
@@ -43,7 +43,7 @@ Você > @dev
        Lendo project.context.md... Node.js, SMALL, checkout-stripe.
        Lendo spec-checkout-stripe.md e implementation-plan-checkout-stripe.md...
        
-       Plano aprovado. Implementando:
+       Scope-check aprovado. Implementando:
        
        1. db/migrations/add-payment-table.sql       ← Payment schema
        2. src/models/payment.js                     ← model com validação básica
@@ -124,7 +124,7 @@ aioson memory:summary . --last=5
 
 ## Handoff típico
 
-- **Vem de:** `@architect` (SMALL/MEDIUM) ou `@product` (MICRO)
+- **Vem de:** `@scope-check` (SMALL/MEDIUM) ou `@product` (MICRO)
 - **Vai para:** `@qa`
 
 ---

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

@@ -93,16 +93,16 @@ Antes de criar, o `@squad` lê:
 
 ## Comandos CLI relacionados
 
-```bash
-# Criar squad via CLI
-aioson squad:assemble <slug>
-
-# Atualizar squad existente (breadth-aware)
-aioson squad:refresh <slug>
-
-# Publicar no aioson.com
-aioson system:publish --type=squad --slug=<slug>
-```
+```bash
+# Criar squad via CLI
+aioson squad:scaffold . --slug=<slug> --name="Meu Squad" --mode=mixed
+
+# Diagnosticar squad existente
+aioson squad:doctor . --squad=<slug>
+
+# Publicar no aioson.com
+aioson system:publish --type=squad --slug=<slug>
+```
 
 ---
 

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

@@ -521,8 +521,8 @@ Importante:
 - `scan:project` sozinho nao gera `discovery.md`
 - `scan:project` nunca gera `architecture.md`
 - se `discovery.md` e `skeleton-system.md` ja existirem e voce rodar com `--with-llm`, o scanner agora entra em modo de atualizacao por padrao: usa os arquivos atuais como memoria base, gera a nova versao consolidada e cria backup automatico em `.aioson/backups/` antes de sobrescrever
-- em projetos SMALL brownfield, o fluxo tipico depois do scan completo e `@analyst` -> `@architect` -> `@dev`
-- sem API LLM configurada, o fluxo local tambem e valido: `scan:project --folder=...` -> `@analyst` no seu Codex/Claude -> `@architect` -> `@dev`
+- em projetos SMALL brownfield, o fluxo tipico depois do scan completo e `@analyst` -> `@scope-check` -> `@architect` -> `@dev`
+- sem API LLM configurada, o fluxo local tambem e valido: `scan:project --folder=...` -> `@analyst` no seu Codex/Claude -> `@scope-check` -> `@architect` -> `@dev`
 
 O parâmetro `--folder` agora é obrigatório. Ele define quais pastas do projeto devem ganhar um mapa completo com pastas e arquivos. Você pode informar uma pasta ou várias separadas por vírgula.
 
@@ -574,8 +574,8 @@ Quando usar cada modo:
 
 Fluxos recomendados:
 
-- **Com API no aioson:** `scan:project --folder=src --with-llm --provider=...` -> `@analyst` -> `@architect` -> `@dev`
-- **Sem API no aioson:** `scan:project --folder=src` -> abrir seu AI CLI -> `@analyst` -> `@architect` -> `@dev`
+- **Com API no aioson:** `scan:project --folder=src --with-llm --provider=...` -> `@analyst` -> `@scope-check` -> `@architect` -> `@dev`
+- **Sem API no aioson:** `scan:project --folder=src` -> abrir seu AI CLI -> `@analyst` -> `@scope-check` -> `@architect` -> `@dev`
 - **Com contexto mínimo para tarefa específica:** `scan:project --folder=src` -> `context:pack --agent=dev --goal="..." --module=src`
 - Se o seu cliente nao entender `@analyst`, gere um prompt pronto com `aioson agent:prompt analyst --tool=codex` ou troque `--tool` para o cliente correto
 

package/docs/pt/5-referencia/fluxo-artefatos.md

@@ -11,12 +11,15 @@ Cada agente produz arquivos que os agentes subsequentes leem. Nenhum agente lê
 ```
 @product → prd.md / prd-{slug}.md
                ↓
-@sheldon (N rodadas) → enriquece PRD + gera sheldon-enrichment-{slug}.md
-                       pode criar .aioson/plans/{slug}/manifest.md + plan-{fase}.md
-               ↓
-@analyst → lê sheldon-enrichment → discovery.md / requirements-{slug}.md + spec-{slug}.md
-               ↓
-@dev → carrega minimum context package → implementa fase por fase
+@sheldon (N rodadas) → enriquece PRD + gera sheldon-enrichment-{slug}.md
+                       pode criar .aioson/plans/{slug}/manifest.md + plan-{fase}.md
+               ↓
+@analyst → lê sheldon-enrichment → discovery.md / requirements-{slug}.md + spec-{slug}.md
+               ↓
+@scope-check → confronta intenção, plano e artefatos antes do código
+               gera scope-check-{slug}.md quando a feature é nomeada
+               ↓
+@dev → carrega minimum context package → implementa fase por fase
 ```
 
 ---
@@ -86,7 +89,7 @@ O `spec-{slug}.md` é o **artefato de handoff para @dev** — ele inclui as deci
 | Modo | O que @dev carrega |
 |---|---|
 | Feature MICRO | `project.context.md` + `prd-{slug}.md` |
-| Feature SMALL/MEDIUM | `project.context.md` + `spec-{slug}.md` + `implementation-plan-{slug}.md` |
+| Feature SMALL/MEDIUM | `project.context.md` + `spec-{slug}.md` + `scope-check-{slug}.md` + `implementation-plan-{slug}.md` |
 | Feature com plano do Sheldon | `project.context.md` + `spec-{slug}.md` + `.aioson/plans/{slug}/manifest.md` + arquivo da fase atual |
 | Modo projeto | `project.context.md` + `spec.md` + `skeleton-system.md` |
 
@@ -157,9 +160,10 @@ Esta é a lista completa de arquivos que @dev pode consultar em qualquer sessão
 |---|---|
 | `project.context.md` | Sempre |
 | `dev-state.md` | Sempre (se existir — define o restante) |
-| `features.md` | Cold start apenas |
-| `spec-{slug}.md` | Feature ativa |
-| `implementation-plan-{slug}.md` | Se plano existe |
+| `features.md` | Cold start apenas |
+| `spec-{slug}.md` | Feature ativa |
+| `scope-check-{slug}.md` | Antes da primeira implementação e após fixes relevantes |
+| `implementation-plan-{slug}.md` | Se plano existe |
 | `.aioson/plans/{slug}/manifest.md` + fase atual | Se plano Sheldon existe |
 | `skeleton-system.md` | Só ao navegar estrutura do projeto |
 | `design-doc.md` | Só se listado no plano |
@@ -173,7 +177,7 @@ Esta é a lista completa de arquivos que @dev pode consultar em qualquer sessão
 
 ## Veja também
 
-- [Fichas dos 28 agentes](../4-agentes/README.md) — quando usar cada agente e o que ele entrega
+- [Fichas dos 29 agentes](../4-agentes/README.md) — quando usar cada agente e o que ele entrega
 - [Receitas práticas](../3-receitas/README.md) — exemplos end-to-end por cenário
 - [Continuidade entre sessões](../3-receitas/continuidade-entre-sessoes.md) — feature dossier, dev-resume, drift detection
 - [Feature Archive](./feature-archive.md) — o que acontece com os artefatos quando a feature fecha

package/docs/pt/5-referencia/squad-dashboard.md

@@ -9,7 +9,7 @@ Não requer instalação adicional. Vem incluso quando você instala o aioson.
 ## Pré-requisitos
 
 - aioson instalado globalmente (`npm install -g @jaimevalasek/aioson`)
-- Pelo menos um squad criado no projeto (`aioson squad:create`)
+- Pelo menos um squad criado no projeto (`aioson squad:scaffold . --slug=<slug>`)
 - Node.js ≥ 18 (já exigido pelo aioson)
 - Browser moderno (Chrome, Firefox, Safari, Edge)
 
@@ -331,10 +331,10 @@ Verifique se o manifest existe:
 ls .aioson/squads/*/squad.manifest.json
 ```
 
-Se não existir, crie o squad primeiro:
-```bash
-aioson squad:create . --squad=meu-squad
-```
+Se não existir, crie o squad primeiro:
+```bash
+aioson squad:scaffold . --slug=meu-squad --name="Meu Squad" --mode=mixed
+```
 
 ### Painéis aparecem vazios
 

package/docs/pt/README.md

@@ -22,7 +22,7 @@ Esta é a porta de entrada da documentação em português. Não é um índice a
 ### Quero uma receita pronta para o meu caso
 
 **Trilhas canônicas — como features chegam ao dev:**
-1. **[Feature completa com @sheldon](./3-receitas/feature-completa-com-sheldon.md)** — a trilha principal: `@product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @dev → @qa` (com gates opcionais de `@tester` e `@pentester`)
+1. **[Feature completa com @sheldon](./3-receitas/feature-completa-com-sheldon.md)** — a trilha principal: `@product → @sheldon → @analyst → @architect → @ux-ui → @pm → @orchestrator → @scope-check → @dev → @qa` (com gates opcionais de `@tester` e `@pentester`)
 2. [Da ideia ao PRD via @briefing](./3-receitas/da-ideia-ao-prd-via-briefing.md) — quando a ideia ainda é vaga
 3. [Plans externos para @product](./3-receitas/plans-externos-para-product.md) — quando você planejou em ChatGPT/Claude.io e quer trazer
 
@@ -37,7 +37,7 @@ Esta é a porta de entrada da documentação em português. Não é um índice a
 11. [Continuidade entre sessões](./3-receitas/continuidade-entre-sessoes.md) — feature dossier, dev-resume, drift detection
 
 ### Quero a referência técnica de um agente ou comando
-- **[Fichas dos 28 agentes](./4-agentes/README.md)** — uma ficha por agente, com diálogo típico, saídas em disco e handoff
+- **[Fichas dos 29 agentes](./4-agentes/README.md)** — uma ficha por agente, com diálogo típico, saídas em disco e handoff
 - **[Referência técnica completa](./5-referencia/README.md)** — 32 docs organizados em 5 categorias (novos 2026, artefatos, CLI/config, agentes/squads, skills/design)
 - [Guia de agentes (legado)](./agentes.md) — visão tabular alternativa
 

package/docs/pt/agentes.md

@@ -13,10 +13,11 @@ O AIOSON tem agentes oficiais de projeto e também pode criar agentes de squad.
 ```
 @setup        ← sempre o primeiro
 @product      ← gera o PRD base vivo e roteia o fluxo
-@deyvin       ← companheiro tecnico para continuidade e pequenas implementacoes
-@discovery-design-doc ← quando precisa clarear escopo e gerar design doc vivo
-@analyst      ← projetos SMALL e MEDIUM
-@architect    ← projetos SMALL e MEDIUM
+@deyvin       ← companheiro tecnico para continuidade e pequenas implementacoes
+@discovery-design-doc ← quando precisa clarear escopo e gerar design doc vivo
+@analyst      ← projetos SMALL e MEDIUM
+@scope-check  ← valida alinhamento antes de codar ou depois de fix relevante
+@architect    ← projetos SMALL e MEDIUM
 @ux-ui        ← UI/UX quando há interfaces (SMALL e MEDIUM)
 @pm           ← apenas MEDIUM
 @orchestrator ← apenas MEDIUM
@@ -52,9 +53,9 @@ O AIOSON tem agentes oficiais de projeto e também pode criar agentes de squad.
 
 Quando o projeto ja existe e voce roda `scan:project`, o handoff correto agora e:
 
-```text
-scan:project -> @analyst -> @architect -> @dev
-```
+```text
+scan:project -> @analyst -> @scope-check -> @architect -> @dev
+```
 
 Regras do fluxo:
 - os artefatos locais do scan (`scan-index.md`, `scan-folders.md`, `scan-<pasta>.md`, `scan-aioson.md`) servem como mapas brutos do codigo

package/docs/pt/living-memory/troubleshooting.md

@@ -44,7 +44,7 @@ aioson memory:status .
 
 ```
 [FAIL] Bootstrap coverage: 4/4
-  Hint: Run /discover to refresh the bootstrap files (or `aioson memory:refresh` if implemented).
+  Hint: Run /discover to refresh the bootstrap files (or `aioson memory:reflect-prepare . --agent=dev` for manual reflection).
 ```
 
 (Repare: cobertura 4/4 mas advisório por estar antigo — a hint detecta via `generated_at`.)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaimevalasek/aioson",
-  "version": "1.21.5",
+  "version": "1.21.7",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",

package/src/commands/agents.js

@@ -20,17 +20,51 @@ const { readAutonomyProtocol, resolveEffectiveMode } = require('../autonomy-poli
 const { readAgentManifest, buildAgentCapabilitySummary } = require('../agent-manifests');
 const { emitSecurityRuntimeEvent } = require('../lib/security/runtime-events');
 
-const WORKFLOW_AGENT_IDS = new Set([
-  'setup',
-  'product',
-  'analyst',
-  'architect',
+const WORKFLOW_AGENT_IDS = new Set([
+  'setup',
+  'product',
+  'analyst',
+  'scope-check',
+  'architect',
   'ux-ui',
   'pm',
   'orchestrator',
   'dev',
-  'qa'
-]);
+  'qa'
+]);
+const SCOPE_CHECK_MODES = new Set(['pre-dev', 'post-dev', 'post-fix', 'final']);
+
+function normalizeScopeCheckMode(input) {
+  const mode = String(input || '').trim().toLowerCase();
+  return SCOPE_CHECK_MODES.has(mode) ? mode : null;
+}
+
+function getScopeCheckModeOption(options = {}) {
+  return normalizeScopeCheckMode(
+    options.scopeMode ||
+    options['scope-mode'] ||
+    options.checkMode ||
+    options['check-mode'] ||
+    options.mode
+  );
+}
+
+function buildScopeCheckActivationContext(options = {}) {
+  const mode = getScopeCheckModeOption(options) || 'pre-dev';
+  const lines = [`Scope-check mode: ${mode}.`];
+  const featureSlug = String(options.feature || options.slug || '').trim();
+  if (featureSlug) lines.push(`Feature slug: ${featureSlug}.`);
+  if (mode === 'pre-dev') {
+    lines.push('Compare user intent against planning artifacts before implementation.');
+  } else if (mode === 'post-dev') {
+    lines.push('Compare the approved planning artifacts against the actual implementation diff and changed files before QA.');
+  } else if (mode === 'post-fix') {
+    lines.push('Compare approved scope, QA/tester/pentester findings, and correction diff; confirm the fix did not change product intent.');
+  } else if (mode === 'final') {
+    lines.push('Reconcile intent, plan, delivered behavior, and remaining exclusions before close/commit/release.');
+  }
+  return lines.join('\n');
+}
 
 function normalizePentesterTargetMode(input) {
   const mode = String(input || '').trim().toLowerCase();
@@ -173,10 +207,12 @@ async function runAgentPrompt({ args, options, logger, t }) {
 
   if (!prompt) {
     instructionPath = await resolveExistingInstructionPath(targetDir, promptAgent, locale);
-    if (promptAgent.id === 'pentester') {
-      pentesterTargetMode = normalizePentesterTargetMode(options.mode);
-      activationContext = buildPentesterActivationContext(options, t);
-    }
+    if (promptAgent.id === 'pentester') {
+      pentesterTargetMode = normalizePentesterTargetMode(options.mode);
+      activationContext = buildPentesterActivationContext(options, t);
+    } else if (promptAgent.id === 'scope-check') {
+      activationContext = buildScopeCheckActivationContext(options);
+    }
     const autonomyProtocol = await readAutonomyProtocol(targetDir);
     const manifest = await readAgentManifest(targetDir, promptAgent.id);
     effectiveMode = resolveEffectiveMode({
@@ -184,7 +220,7 @@ async function runAgentPrompt({ args, options, logger, t }) {
       tool,
       agentId: promptAgent.id,
       manifest,
-      requestedMode: options.mode || null
+      requestedMode: promptAgent.id === 'scope-check' && getScopeCheckModeOption(options) ? null : options.mode || null
     });
     prompt = buildAgentPrompt(promptAgent, tool, {
       instructionPath,