@jaimevalasek/aioson 1.21.4 → 1.21.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/README.md +25 -13
  2. package/bin/aioson.js +1 -1
  3. package/docs/en/1-understand/ecosystem-map.md +2 -2
  4. package/docs/en/1-understand/glossary.md +3 -3
  5. package/docs/en/1-understand/what-is-aioson.md +2 -2
  6. package/docs/en/1-understand/why-it-exists.md +1 -1
  7. package/docs/en/2-start/existing-project.md +4 -5
  8. package/docs/en/2-start/first-project.md +3 -3
  9. package/docs/en/2-start/initial-decisions.md +3 -3
  10. package/docs/en/3-recipes/README.md +2 -2
  11. package/docs/en/3-recipes/full-feature-with-sheldon.md +2 -2
  12. package/docs/en/5-reference/cli-reference.md +17 -17
  13. package/docs/en/5-reference/mcp.md +1 -1
  14. package/docs/en/README.md +2 -2
  15. package/docs/en/deyvin-subtask-scout/README.md +1 -1
  16. package/docs/en/deyvin-subtask-scout/sub-task-scout.md +1 -1
  17. package/docs/en/deyvin-subtask-scout/troubleshooting.md +1 -1
  18. package/docs/pt/1-entender/glossario.md +3 -3
  19. package/docs/pt/1-entender/mapa-do-ecossistema.md +2 -2
  20. package/docs/pt/1-entender/o-que-e-aioson.md +2 -2
  21. package/docs/pt/1-entender/por-que-existe.md +1 -1
  22. package/docs/pt/2-comecar/decisoes-iniciais.md +3 -3
  23. package/docs/pt/2-comecar/primeiro-projeto.md +3 -3
  24. package/docs/pt/2-comecar/projeto-existente.md +4 -5
  25. package/docs/pt/3-receitas/README.md +2 -2
  26. package/docs/pt/3-receitas/feature-completa-com-sheldon.md +2 -2
  27. package/docs/pt/3-receitas/landing-page.md +1 -1
  28. package/docs/pt/5-referencia/README.md +1 -1
  29. package/docs/pt/5-referencia/clientes-ai.md +15 -84
  30. package/docs/pt/5-referencia/comandos-cli.md +7 -7
  31. package/docs/pt/5-referencia/sdd-automation-scripts.md +1 -1
  32. package/docs/pt/5-referencia/skills.md +1 -2
  33. package/docs/pt/README.md +2 -2
  34. package/docs/pt/_arquivo/README.md +1 -1
  35. package/docs/pt/_arquivo/inicio-rapido.md +8 -13
  36. package/docs/pt/_arquivo/memoria-contexto.md +2 -2
  37. package/docs/pt/deyvin-subtask-scout/README.md +1 -1
  38. package/docs/pt/deyvin-subtask-scout/sub-task-scout.md +1 -1
  39. package/docs/pt/deyvin-subtask-scout/troubleshooting.md +1 -1
  40. package/docs/pt/living-memory/README.md +1 -1
  41. package/docs/pt/living-memory/autonomy-contract.md +6 -8
  42. package/docs/pt/living-memory/diagramas.md +16 -16
  43. package/docs/pt/living-memory/memoria-viva.md +1 -1
  44. package/docs/pt/living-memory/reflexao-in-harness.md +1 -1
  45. package/package.json +3 -3
  46. package/scripts/benchmark-optimizations.js +261 -0
  47. package/scripts/check-js.js +35 -0
  48. package/scripts/memory-budget-audit.js +112 -0
  49. package/scripts/smoke/genome-2.0-smoke.js +118 -0
  50. package/scripts/smoke-run-chain.js +786 -0
  51. package/scripts/testing/genome-2.0-rollout.js +247 -0
  52. package/src/agents.js +0 -4
  53. package/src/cli.js +19 -13
  54. package/src/commands/agent-export-skill.js +2 -2
  55. package/src/commands/agents.js +48 -12
  56. package/src/commands/artifact-validate.js +21 -14
  57. package/src/commands/feature-archive.js +11 -10
  58. package/src/commands/init.js +5 -5
  59. package/src/commands/install.js +1 -6
  60. package/src/commands/intake-ask.js +399 -0
  61. package/src/commands/mcp-doctor.js +1 -1
  62. package/src/commands/mcp-init.js +1 -6
  63. package/src/commands/runtime.js +62 -29
  64. package/src/commands/squad-agent-create.js +1 -1
  65. package/src/commands/squad-export.js +13 -24
  66. package/src/commands/squad-review.js +1 -1
  67. package/src/commands/state-save.js +4 -2
  68. package/src/commands/store-system.js +2 -2
  69. package/src/commands/update.js +1 -1
  70. package/src/commands/workflow-next.js +212 -63
  71. package/src/commands/workflow-plan.js +5 -5
  72. package/src/commands/workflow-status.js +41 -19
  73. package/src/constants.js +73 -77
  74. package/src/doctor.js +8 -70
  75. package/src/dossier/schema.js +5 -4
  76. package/src/gateway-pointer-merge.js +2 -3
  77. package/src/handoff-contract.js +98 -31
  78. package/src/i18n/messages/en.js +23 -31
  79. package/src/i18n/messages/es.js +14 -25
  80. package/src/i18n/messages/fr.js +14 -25
  81. package/src/i18n/messages/pt-BR.js +23 -32
  82. package/src/install-animation.js +5 -6
  83. package/src/install-profile.js +6 -10
  84. package/src/install-wizard.js +8 -10
  85. package/src/installer.js +5 -7
  86. package/src/lib/dev-resume.js +45 -32
  87. package/src/lib/tool-capabilities.js +2 -17
  88. package/src/locales.js +30 -22
  89. package/src/permissions-generator.js +17 -57
  90. package/src/preflight-engine.js +31 -16
  91. package/src/prompt-tool.js +1 -1
  92. package/src/runner/cli-launcher.js +6 -8
  93. package/src/sandbox.js +129 -81
  94. package/src/session-handoff.js +50 -20
  95. package/src/squad/agent-teams-adapter.js +1 -1
  96. package/src/squad/cross-ai-synthesizer.js +4 -9
  97. package/src/squad/preflight-context.js +20 -17
  98. package/template/.aioson/agents/analyst.md +5 -5
  99. package/template/.aioson/agents/briefing.md +74 -17
  100. package/template/.aioson/agents/copywriter.md +5 -3
  101. package/template/.aioson/agents/design-hybrid-forge.md +5 -3
  102. package/template/.aioson/agents/dev.md +11 -7
  103. package/template/.aioson/agents/deyvin.md +48 -75
  104. package/template/.aioson/agents/discover.md +1 -1
  105. package/template/.aioson/agents/discovery-design-doc.md +5 -5
  106. package/template/.aioson/agents/manifests/analyst.manifest.json +53 -26
  107. package/template/.aioson/agents/manifests/architect.manifest.json +40 -23
  108. package/template/.aioson/agents/manifests/committer.manifest.json +40 -23
  109. package/template/.aioson/agents/manifests/dev.manifest.json +113 -54
  110. package/template/.aioson/agents/manifests/deyvin.manifest.json +84 -41
  111. package/template/.aioson/agents/manifests/orchestrator.manifest.json +75 -30
  112. package/template/.aioson/agents/manifests/pm.manifest.json +58 -27
  113. package/template/.aioson/agents/manifests/product.manifest.json +39 -23
  114. package/template/.aioson/agents/manifests/qa.manifest.json +82 -41
  115. package/template/.aioson/agents/manifests/scope-check.manifest.json +61 -0
  116. package/template/.aioson/agents/manifests/setup.manifest.json +29 -20
  117. package/template/.aioson/agents/manifests/ux-ui.manifest.json +45 -24
  118. package/template/.aioson/agents/neo.md +2 -2
  119. package/template/.aioson/agents/orchestrator.md +67 -33
  120. package/template/.aioson/agents/pair.md +5 -3
  121. package/template/.aioson/agents/pentester.md +3 -1
  122. package/template/.aioson/agents/pm.md +21 -18
  123. package/template/.aioson/agents/product.md +77 -22
  124. package/template/.aioson/agents/qa.md +5 -4
  125. package/template/.aioson/agents/scope-check.md +164 -0
  126. package/template/.aioson/agents/setup.md +2 -2
  127. package/template/.aioson/agents/sheldon.md +35 -10
  128. package/template/.aioson/agents/site-forge.md +5 -3
  129. package/template/.aioson/agents/tester.md +33 -28
  130. package/template/.aioson/config/autonomy-protocol.json +163 -126
  131. package/template/.aioson/config.md +16 -7
  132. package/template/.aioson/docs/autonomy-protocol.md +3 -4
  133. package/template/.aioson/docs/product/prd-contract.md +1 -1
  134. package/template/.aioson/docs/squad/eval-gate.md +1 -1
  135. package/template/.aioson/mcp/servers.md +22 -23
  136. package/template/.aioson/schemas/squad-manifest.schema.json +1462 -886
  137. package/template/.aioson/skills/process/aioson-spec-driven/SKILL.md +5 -4
  138. package/template/.aioson/skills/process/aioson-spec-driven/references/approval-gates.md +1 -1
  139. package/template/.aioson/skills/process/prompt-sharpener/SKILL.md +116 -0
  140. package/template/.aioson/skills/process/prompt-sharpener/agents/openai.yaml +4 -0
  141. package/template/.aioson/skills/process/prompt-sharpener/references/prompt-diagnostics.md +51 -0
  142. package/template/.aioson/tasks/squad-eval.md +1 -1
  143. package/template/.claude/commands/aioson/agent/scope-check.md +20 -0
  144. package/template/AGENTS.md +36 -16
  145. package/template/CLAUDE.md +16 -6
  146. package/template/OPENCODE.md +13 -3
  147. package/template/.gemini/GEMINI.md +0 -13
  148. package/template/.gemini/commands/aios-analyst.toml +0 -7
  149. package/template/.gemini/commands/aios-architect.toml +0 -8
  150. package/template/.gemini/commands/aios-committer.toml +0 -7
  151. package/template/.gemini/commands/aios-copywriter.toml +0 -7
  152. package/template/.gemini/commands/aios-cypher.toml +0 -7
  153. package/template/.gemini/commands/aios-dev.toml +0 -9
  154. package/template/.gemini/commands/aios-deyvin.toml +0 -7
  155. package/template/.gemini/commands/aios-discover.toml +0 -6
  156. package/template/.gemini/commands/aios-discovery-design-doc.toml +0 -7
  157. package/template/.gemini/commands/aios-genome.toml +0 -7
  158. package/template/.gemini/commands/aios-neo.toml +0 -6
  159. package/template/.gemini/commands/aios-orache.toml +0 -7
  160. package/template/.gemini/commands/aios-orchestrator.toml +0 -9
  161. package/template/.gemini/commands/aios-pair.toml +0 -7
  162. package/template/.gemini/commands/aios-pm.toml +0 -9
  163. package/template/.gemini/commands/aios-product.toml +0 -6
  164. package/template/.gemini/commands/aios-qa.toml +0 -7
  165. package/template/.gemini/commands/aios-setup.toml +0 -6
  166. package/template/.gemini/commands/aios-sheldon.toml +0 -7
  167. package/template/.gemini/commands/aios-site-forge.toml +0 -7
  168. package/template/.gemini/commands/aios-squad.toml +0 -7
  169. package/template/.gemini/commands/aios-tester.toml +0 -7
  170. package/template/.gemini/commands/aios-ux-ui.toml +0 -9
  171. package/template/.gemini/commands/aios-validator.toml +0 -7
@@ -1,6 +1,6 @@
1
1
  # Usando AIOSON com diferentes CLIs de IA
2
2
 
3
- O AIOSON funciona com **Claude Code**, **Codex CLI**, **Gemini CLI** e **OpenCode**. Cada um tem uma forma diferente de ativar agentes — este guia explica como usar cada um sem confusão.
3
+ O AIOSON funciona com **Claude Code**, **Codex CLI** e **OpenCode**. Cada um tem uma forma diferente de ativar agentes — este guia explica como usar cada um sem confusão.
4
4
 
5
5
  Também funciona em qualquer IDE com terminal: VS Code, Google Antigravity, Cursor, Windsurf, JetBrains IDEs e Zed — basta abrir um dos clientes acima no terminal integrado.
6
6
 
@@ -8,13 +8,13 @@ Também funciona em qualquer IDE com terminal: VS Code, Google Antigravity, Curs
8
8
 
9
9
  ## Comparativo rápido
10
10
 
11
- | | Claude Code | Codex CLI | Gemini CLI | OpenCode |
12
- |---|---|---|---|---|
13
- | Arquivo de config | `CLAUDE.md` | `AGENTS.md` | `.gemini/GEMINI.md` | `OPENCODE.md` |
14
- | Comandos personalizados | `.claude/commands/` | não suporta | `.gemini/commands/*.toml` | ❌ não suporta |
15
- | Autocomplete de agentes | `/aioson/` + Tab | não suporta | `/aios-` + Tab | ❌ não suporta |
16
- | Como ativar agente | `/aioson/setup` | linguagem natural | `/aios-setup` | linguagem natural |
17
- | Lê contexto automático | Sim (CLAUDE.md injeta) | Sim (AGENTS.md injeta) | Sim (GEMINI.md injeta) | Sim (OPENCODE.md injeta) |
11
+ | | Claude Code | Codex CLI | OpenCode |
12
+ |---|---|---|---|
13
+ | Arquivo de config | `CLAUDE.md` | `AGENTS.md` | `OPENCODE.md` |
14
+ | Comandos personalizados | `.claude/commands/` | Nao suporta | Nao suporta |
15
+ | Autocomplete de agentes | `/aioson/` + Tab | Nao suporta | Nao suporta |
16
+ | Como ativar agente | `/aioson/setup` | linguagem natural | linguagem natural |
17
+ | Lê contexto automático | Sim (CLAUDE.md injeta) | Sim (AGENTS.md injeta) | Sim (OPENCODE.md injeta) |
18
18
 
19
19
  ---
20
20
 
@@ -181,83 +181,15 @@ Quando você menciona `@setup`, o Codex lê o arquivo correspondente e segue tod
181
181
 
182
182
  ---
183
183
 
184
- ## Gemini CLI
185
-
186
- ### Como funciona
187
-
188
- O Gemini CLI lê `.gemini/GEMINI.md` ao iniciar e reconhece comandos definidos em `.gemini/commands/*.toml`. Os agentes do AIOSON são registrados com o prefixo `aios-`.
189
-
190
- O nome humano do agente é **UI/UX**, mas o comando continua sendo `/aios-ux-ui`.
191
-
192
- ### Ativando agentes
193
-
194
- Digite `/aios-` para ver os comandos disponíveis no autocomplete:
195
-
196
- ```
197
- /aios-setup
198
- /aios-analyst
199
- /aios-architect
200
- /aios-deyvin
201
- /aios-ux-ui
202
- /aios-pm
203
- /aios-dev
204
- /aios-qa
205
- /aios-orchestrator
206
- ```
207
-
208
- ### Exemplos de uso
209
-
210
- ```
211
- /aios-setup
212
- ```
213
- > Inicia o onboarding do projeto.
214
-
215
- ```
216
- /aios-dev
217
- ```
218
- > Ativa o agente de desenvolvimento.
219
-
220
- ```
221
- /aios-deyvin
222
- ```
223
- > Ativa o agente de continuidade e pair programming.
224
-
225
- Alias compativel:
226
- ```text
227
- /aios-pair
228
- ```
229
-
230
- ```
231
- /aios-orchestrator
232
- ```
233
- > Inicia a orquestração da sessão atual.
234
-
235
- ### Estrutura dos comandos Gemini
236
-
237
- Cada arquivo `.gemini/commands/aios-*.toml` aponta para o agente correspondente usando o campo `prompt` e injeção de arquivo:
238
-
239
- ```toml
240
- description = "Project onboarding"
241
- prompt = """
242
- @{ .aioson/context/project.context.md }
243
- @{ .aioson/agents/setup.md }
244
-
245
- {{args}}
246
- """
247
- ```
248
-
249
- ---
250
-
251
- ## Qual CLI usar?
184
+ ## Qual CLI usar?
252
185
 
253
186
  Não há uma resposta única — depende do seu fluxo de trabalho. Algumas considerações:
254
187
 
255
- | Cenário | Recomendação |
256
- |---|---|
257
- | Quer autocomplete preciso com namespace isolado | Claude Code — `/aioson/*` |
258
- | Prefere conversa natural sem memória de comandos | Codex — `use @dev to...` |
259
- | usa Gemini CLI como ferramenta principal | Gemini `/aios-*` |
260
- | Projeto em equipe com múltiplos CLIs | Todos funcionam — o contexto em `.aioson/` é compartilhado |
188
+ | Cenário | Recomendação |
189
+ |---|---|
190
+ | Quer autocomplete preciso com namespace isolado | Claude Code — `/aioson/*` |
191
+ | Prefere conversa natural sem memória de comandos | Codex — `use @dev to...` |
192
+ | Projeto em equipe com múltiplos CLIs | Claude, Codex e OpenCode compartilham o contexto em `.aioson/` |
261
193
 
262
194
  ### O contexto é o mesmo independente do CLI
263
195
 
@@ -288,8 +220,7 @@ npx @jaimevalasek/aioson@latest update
288
220
  Isso atualiza:
289
221
  - `CLAUDE.md` e `.claude/commands/aioson/`
290
222
  - `AGENTS.md`
291
- - `.gemini/GEMINI.md` e `.gemini/commands/`
292
- - `OPENCODE.md`
223
+ - `OPENCODE.md`
293
224
  - Todos os agentes em `.aioson/agents/`
294
225
 
295
226
  ---
@@ -132,7 +132,7 @@
132
132
  | `runtime:session:log` | Adiciona um passo concluido na sessao direta ativa | Quando quer registrar cada tarefa concluida durante a sessao |
133
133
  | `runtime:session:finish` | Encerra a sessao direta ativa | Quando terminou a sessao ou vai fazer handoff |
134
134
  | `runtime:session:status` | Mostra o estado da sessao direta e os ultimos eventos | Quando quer saber se a sessao ainda esta aberta ou acompanhar com `--watch` |
135
- | `live:start` | Abre uma sessao viva rastreada para Codex, Claude, Gemini ou OpenCode | Quando quer iniciar o cliente externo a partir do AIOSON e manter status, agente ativo e logs no dashboard |
135
+ | `live:start` | Abre uma sessao viva rastreada para Codex, Claude ou OpenCode | Quando quer iniciar o cliente externo a partir do AIOSON e manter status, agente ativo e logs no dashboard |
136
136
  | `runtime:emit` | Registra eventos compactos da sessão viva atual; aceita `--worker-status`, `--verdict`, `--token-count`, `--progress-pct` | Quando quer marcar tarefa concluída, milestone, block ou step de plano sem abrir uma sessão paralela |
137
137
  | `live:status` | Mostra o estado da sessao viva e do processo filho | Quando quer acompanhar `active_agent`, progresso do plano e se o cliente ainda esta vivo |
138
138
  | `live:handoff` | Transfere a mesma sessao viva para outro agente AIOSON | Quando o agente atual precisa passar a continuidade para `@product`, `@architect`, `@dev` ou outro agente |
@@ -393,7 +393,7 @@ aioson context:pack . --agent=dev --goal="ajustar captions do YouTube" --module=
393
393
  aioson context:pack . --agent=qa --goal="validar regressao do checkout" --module=app --max-files=10
394
394
  ```
395
395
 
396
- Use quando você quer mandar para Codex, Claude Code, Gemini ou outro cliente só o contexto mais relevante para a tarefa atual.
396
+ Use quando você quer mandar para Codex, Claude Code ou outro cliente só o contexto mais relevante para a tarefa atual.
397
397
 
398
398
  O comando escreve `.aioson/context/context-pack.md` e normalmente seleciona:
399
399
 
@@ -521,8 +521,8 @@ Importante:
521
521
  - `scan:project` sozinho nao gera `discovery.md`
522
522
  - `scan:project` nunca gera `architecture.md`
523
523
  - 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
524
- - em projetos SMALL brownfield, o fluxo tipico depois do scan completo e `@analyst` -> `@architect` -> `@dev`
525
- - sem API LLM configurada, o fluxo local tambem e valido: `scan:project --folder=...` -> `@analyst` no seu Codex/Claude/Gemini -> `@architect` -> `@dev`
524
+ - em projetos SMALL brownfield, o fluxo tipico depois do scan completo e `@analyst` -> `@scope-check` -> `@architect` -> `@dev`
525
+ - sem API LLM configurada, o fluxo local tambem e valido: `scan:project --folder=...` -> `@analyst` no seu Codex/Claude -> `@scope-check` -> `@architect` -> `@dev`
526
526
 
527
527
  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.
528
528
 
@@ -574,8 +574,8 @@ Quando usar cada modo:
574
574
 
575
575
  Fluxos recomendados:
576
576
 
577
- - **Com API no aioson:** `scan:project --folder=src --with-llm --provider=...` -> `@analyst` -> `@architect` -> `@dev`
578
- - **Sem API no aioson:** `scan:project --folder=src` -> abrir seu AI CLI -> `@analyst` -> `@architect` -> `@dev`
577
+ - **Com API no aioson:** `scan:project --folder=src --with-llm --provider=...` -> `@analyst` -> `@scope-check` -> `@architect` -> `@dev`
578
+ - **Sem API no aioson:** `scan:project --folder=src` -> abrir seu AI CLI -> `@analyst` -> `@scope-check` -> `@architect` -> `@dev`
579
579
  - **Com contexto mínimo para tarefa específica:** `scan:project --folder=src` -> `context:pack --agent=dev --goal="..." --module=src`
580
580
  - 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
581
581
 
@@ -831,7 +831,7 @@ aioson live:status . --agent=product --watch=2
831
831
  aioson live:close . --agent=product --summary="Sessao encerrada com handoff e resumo final"
832
832
  ```
833
833
 
834
- Use esse fluxo quando voce quer iniciar Codex, Claude, Gemini ou OpenCode por fora do cliente, manter a mesma `session_key` viva entre varias tarefas e registrar no runtime:
834
+ Use esse fluxo quando voce quer iniciar Codex, Claude ou OpenCode por fora do cliente, manter a mesma `session_key` viva entre varias tarefas e registrar no runtime:
835
835
  - agente ativo atual
836
836
  - marcos compactos no SQLite
837
837
  - `state.json`, `events.ndjson` e `summary.md` em `.aioson/runtime/live/{session_key}/`
@@ -366,7 +366,7 @@ Monta e executa o plano de agentes para uma feature com base na classificação.
366
366
 
367
367
  | Flag | Descrição |
368
368
  |---|---|
369
- | `--tool=<tool>` | Ferramenta a usar (`claude`, `codex`, `gemini`) |
369
+ | `--tool=<tool>` | Ferramenta a usar (`claude`, `codex`, `opencode`) |
370
370
  | `--classification=<tier>` | Override manual da classificação |
371
371
  | `--dry-run` | Mostra o plano sem executar |
372
372
  | `--start-from=<agent>` | Pula agentes anteriores ao agente dado |
@@ -117,11 +117,10 @@ As skills instaladas são distribuídas automaticamente para as ferramentas de I
117
117
  | Cursor | `.cursor/skills/` | Acesso direto por path |
118
118
  | Windsurf | `.windsurf/skills/` | Acesso direto por path |
119
119
  | Codex | `AGENTS.md` | Via referência `@slug` no arquivo AGENTS.md |
120
- | Gemini CLI | `.aioson/installed-skills/` | Acesso direto por path |
121
120
 
122
121
  ### Nota sobre gitignore
123
122
 
124
- Mesmo que `.aioson/skills/` esteja no gitignore, todas as ferramentas (Claude Code, Gemini CLI, Codex) conseguem ler os arquivos via path direto no filesystem. O gitignore afeta apenas a descoberta automática do Codex via `@` — mas como as skills são referenciadas por path explícito nos agentes, isso não é um problema.
123
+ Mesmo que `.aioson/skills/` esteja no gitignore, todas as ferramentas (Claude Code, Codex) conseguem ler os arquivos via path direto no filesystem. O gitignore afeta apenas a descoberta automática do Codex via `@` — mas como as skills são referenciadas por path explícito nos agentes, isso não é um problema.
125
124
 
126
125
  ## Mapeamento framework → skill
127
126
 
package/docs/pt/README.md CHANGED
@@ -22,7 +22,7 @@ Esta é a porta de entrada da documentação em português. Não é um índice a
22
22
  ### Quero uma receita pronta para o meu caso
23
23
 
24
24
  **Trilhas canônicas — como features chegam ao dev:**
25
- 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`)
25
+ 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`)
26
26
  2. [Da ideia ao PRD via @briefing](./3-receitas/da-ideia-ao-prd-via-briefing.md) — quando a ideia ainda é vaga
27
27
  3. [Plans externos para @product](./3-receitas/plans-externos-para-product.md) — quando você planejou em ChatGPT/Claude.io e quer trazer
28
28
 
@@ -82,7 +82,7 @@ npx @jaimevalasek/aioson init meu-projeto
82
82
  # 2. Entre no projeto
83
83
  cd meu-projeto
84
84
 
85
- # 3. Abra seu cliente AI (Claude Code, Codex, Gemini, OpenCode) e digite:
85
+ # 3. Abra seu cliente AI (Claude Code, Codex e OpenCode) e digite:
86
86
  /aioson:agent:setup
87
87
  ```
88
88
 
@@ -112,7 +112,7 @@ Sem API LLM no `aioson`, ainda existe um caminho valido:
112
112
 
113
113
  - rode `scan:project . --folder=...` para gerar os mapas locais
114
114
  - rode `context:pack` se quiser entregar menos contexto e gastar menos tokens
115
- - abra Codex, Claude Code, Gemini CLI ou outro cliente de IA
115
+ - abra Codex, Claude Code ou outro cliente de IA
116
116
  - ative `@analyst`
117
117
  - o `@analyst` pode usar `scan-index.md`, `scan-folders.md`, `scan-<pasta>.md` e `scan-aioson.md` para escrever `discovery.md`
118
118
  - se o cliente permitir escolher modelo, prefira um modelo rapido/barato nessa etapa
@@ -16,7 +16,7 @@
16
16
 
17
17
  - Node.js 18+
18
18
  - Um projeto de software (existente ou novo)
19
- - Claude, Codex, Gemini ou OpenCode configurado no seu editor
19
+ - Claude, Codex ou OpenCode configurado no seu editor
20
20
 
21
21
  ---
22
22
 
@@ -24,7 +24,7 @@
24
24
 
25
25
  Ao rodar o `init` ou `install`, um **wizard interativo** aparece para você escolher:
26
26
 
27
- 1. **Quais ferramentas AI** usar (Claude Code, Codex, Gemini, OpenCode)
27
+ 1. **Quais ferramentas AI** usar (Claude Code, Codex e OpenCode)
28
28
  2. **Qual modo** (Development ou Development + Squads)
29
29
  3. **Design system** (opcional) — Clean SaaS UI, Aurora Command UI, Cognitive Core UI, etc.
30
30
  4. **Idioma dos agentes** — English, Português, Español, Français
@@ -58,7 +58,7 @@ npx @jaimevalasek/aioson install --all
58
58
  ```
59
59
 
60
60
  **O que o `--all` instala:**
61
- - Ferramentas: Claude Code, Codex, Gemini, OpenCode
61
+ - Ferramentas: Claude Code, Codex e OpenCode
62
62
  - Modo: Development + Squads
63
63
  - Design: nenhum
64
64
  - Idioma: English
@@ -125,7 +125,7 @@ Se você nao usa API LLM no `aioson`, o caminho manual tambem funciona:
125
125
 
126
126
  1. Rode `scan:project . --folder=src`
127
127
  2. Opcional: rode `context:pack . --agent=analyst --goal="consolidar discovery brownfield" --module=src`
128
- 3. Abra seu Codex, Claude Code, Gemini CLI ou cliente equivalente
128
+ 3. Abra seu Codex, Claude Code ou cliente equivalente
129
129
  4. Execute `@analyst`
130
130
  5. O `@analyst` usa os arquivos de scan para gerar `discovery.md`
131
131
 
@@ -172,14 +172,9 @@ No **Codex** (AGENTS.md já configurado — sem slash commands):
172
172
  use the @setup agent to onboard this project
173
173
  ```
174
174
 
175
- No **Gemini CLI** (`.gemini/commands/` configurado):
176
- ```
177
- /aios-setup
178
- ```
179
-
180
- O agente `@setup` detecta o framework, faz as perguntas e gera o `project.context.md`.
181
-
182
- > Cada CLI tem uma forma diferente de invocar agentes. Consulte o [Guia de CLIs de IA](./clientes-ai.md) para exemplos detalhados de Claude Code, Codex e Gemini.
175
+ O agente `@setup` detecta o framework, faz as perguntas e gera o `project.context.md`.
176
+
177
+ > Cada CLI tem uma forma diferente de invocar agentes. Consulte o [Guia de CLIs de IA](../5-referencia/clientes-ai.md) para exemplos detalhados de Claude Code, Codex e OpenCode.
183
178
 
184
179
  Se voce estiver entrando num projeto ja existente e quiser um companheiro tecnico para retomar uma sessao, diagnosticar algo pequeno ou implementar aos poucos, pode chamar `@deyvin` depois que o contexto minimo estiver pronto.
185
180
 
@@ -253,7 +248,7 @@ Exemplos:
253
248
  ## Próximos passos
254
249
 
255
250
  - [Referência completa dos comandos do CLI](./comandos-cli.md)
256
- - [Como usar com Claude Code, Codex e Gemini](./clientes-ai.md)
251
+ - [Como usar com Claude Code, Codex e OpenCode](../5-referencia/clientes-ai.md)
257
252
  - [Cenários completos com exemplos práticos](./cenarios.md)
258
253
  - [Guia de agentes: quando usar cada um](./agentes.md)
259
254
  - [Hardening do motor: gates, auto-cura e test briefing](./motor-hardening.md)
@@ -7,7 +7,7 @@
7
7
 
8
8
  # Memória e Contexto
9
9
 
10
- > Guia prático para entender quais arquivos o AIOSON gera, qual é a função de cada um e como montar contexto mínimo para trabalhar melhor com LLMs e CLIs como Codex, Claude Code e Gemini.
10
+ > Guia prático para entender quais arquivos o AIOSON gera, qual é a função de cada um e como montar contexto mínimo para trabalhar melhor com LLMs e CLIs como Codex, Claude Code e OpenCode.
11
11
 
12
12
  ## Visão geral
13
13
 
@@ -187,7 +187,7 @@ aioson context:pack . --agent=analyst --goal="consolidar discovery brownfield" -
187
187
 
188
188
  Depois:
189
189
 
190
- 1. Abra Codex, Claude Code ou Gemini CLI.
190
+ 1. Abra Codex, Claude Code ou OpenCode.
191
191
  2. Rode `@analyst`.
192
192
  3. Use os arquivos de scan ou o `context-pack.md` para escrever `discovery.md`.
193
193
  4. Depois passe para `@architect`.
@@ -21,7 +21,7 @@ Esta pasta documenta a feature completa — 3 fases, 3 verbos CLI, 1 check advis
21
21
  - Harness com suporte a sub-agentes: Claude Code (Agent tool) ou Codex (MultiAgentV2)
22
22
  - `.aioson/config/scout-engine.json` no projeto (copiado automaticamente pelo installer como `{}`, defaults ativos)
23
23
 
24
- > **Gemini CLI / OpenCode:** emitem `harness_unsupported` e caem automaticamente para o fluxo CLI-less inline do `deyvin.md`. Paridade de harness completa é V2.
24
+ > **OpenCode:** emitem `harness_unsupported` e caem automaticamente para o fluxo CLI-less inline do `deyvin.md`. Paridade de harness completa é V2.
25
25
 
26
26
  ---
27
27
 
@@ -83,7 +83,7 @@ Módulo puro `src/sub-task-engine.js`: template de prompt, validadores JSON hand
83
83
  Três verbos CLI (`scout:prep`, `scout:validate`, `scout:commit`) + estado com file-lock em `src/sub-task-state.js`. Template de config `template/.aioson/config/scout-engine.json` (vazio `{}`; defaults ativos). Sandbox path check: `scope_paths` fora do root do projeto são rejeitados.
84
84
 
85
85
  ### Fase 3 — `wiring-and-lifecycle`
86
- - `deyvin.md` (workspace + template byte-identical, 13611 bytes, abaixo do limite de 15360): nova seção "Sub-task scout invocation" com caminho CLI + fallback CLI-less por harness (Claude Code Agent tool, Codex MultiAgentV2, Gemini/OpenCode com mensagem `harness_unsupported`)
86
+ - `deyvin.md` (workspace + template byte-identical, 13611 bytes, abaixo do limite de 15360): nova seção "Sub-task scout invocation" com caminho CLI + fallback CLI-less por harness (Claude Code Agent tool, Codex MultiAgentV2/OpenCode com mensagem `harness_unsupported`)
87
87
  - `feature:close`: hook de arquivamento copia scouts com `feature_slug` correspondente para `.aioson/context/features/{slug}/scouts/`, appenda bullet no dossier
88
88
  - `memory:summary`: linha "Scouts dispatched: N (top topics: ...)" sempre presente — visível em cold-load de agente
89
89
  - `doctor`: check advisory `scouts_directory_pruning` (scouts órfãos >90d); `--fix` apaga; scouts com `feature_slug` **nunca** são podados
@@ -88,7 +88,7 @@ Você tem 1 retry (`max_retries_on_malformed_json=1`). Se o segundo também falh
88
88
 
89
89
  ## Harness sem suporte a sub-agentes (`harness_unsupported`)
90
90
 
91
- **Sintoma:** Gemini CLI ou OpenCode não suportam o Agent tool / sub-agent nativamente.
91
+ **Sintoma:** OpenCode não suportam o Agent tool / sub-agent nativamente.
92
92
 
93
93
  **O que acontece:** `scout:prep` retorna normalmente, mas o harness emite `harness_unsupported` ao tentar despachar o sub-agente.
94
94
 
@@ -61,7 +61,7 @@ Os comandos abaixo são o vocabulário mínimo da Memória Viva. Cada um tem um
61
61
  | `.aioson/config/autonomy-protocol.json` | Contrato canônico de autonomia (v1.1 com `tiers`) |
62
62
  | `.aioson/runtime/reflect-prompt.json` | Manifest pendente de reflexão (efêmero — apagado após commit) |
63
63
  | `.aioson/runtime/aios.sqlite` | Telemetria: eventos `memory_reflect_*`, `notify_*` |
64
- | `.claude/settings.json` + `.codex/`/`.gemini/`/`.opencode/` | Permissões nativas geradas a partir do protocol |
64
+ | `.claude/settings.json` + `.codex/`/`.opencode/` | Permissões nativas geradas a partir do protocol |
65
65
 
66
66
  ---
67
67
 
@@ -1,6 +1,6 @@
1
1
  # Autonomy Contract — 3 tiers de autonomia
2
2
 
3
- > O Autonomy Contract responde uma pergunta operacional: **o agente pode rodar este comando sozinho, ou precisa parar e pedir?** A resposta vive em `.aioson/config/autonomy-protocol.json` (schema v1.1) e é materializada nas configurações nativas de cada harness (Claude Code, Codex, Gemini, OpenCode).
3
+ > O Autonomy Contract responde uma pergunta operacional: **o agente pode rodar este comando sozinho, ou precisa parar e pedir?** A resposta vive em `.aioson/config/autonomy-protocol.json` (schema v1.1) e é materializada nas configurações nativas de cada harness (Claude Code, Codex e OpenCode).
4
4
 
5
5
  ## A ideia em uma linha
6
6
 
@@ -47,8 +47,7 @@ A invariante mais importante: **tier 3 nunca é materializado em allow list de t
47
47
  "tools": {
48
48
  "claude": { "mode": "trusted", "derived_from_tiers": ["tier1_silent", "tier2_notified"], "requires_tty": false, "max_auto_retries": 3 },
49
49
  "codex": { "mode": "trusted", "derived_from_tiers": ["tier1_silent", "tier2_notified"], "requires_tty": false, "max_auto_retries": 3 },
50
- "gemini": { "mode": "guarded", "derived_from_tiers": ["tier1_silent"], "requires_tty": true, "max_auto_retries": 1 },
51
- "opencode": { "mode": "guarded", "derived_from_tiers": ["tier1_silent"], "requires_tty": true, "max_auto_retries": 0 }
50
+ "opencode": { "mode": "guarded", "derived_from_tiers": ["tier1_silent"], "requires_tty": true, "max_auto_retries": 0 }
52
51
  },
53
52
  "agents": {
54
53
  "committer": { "max_mode": "guarded" }
@@ -56,18 +55,17 @@ A invariante mais importante: **tier 3 nunca é materializado em allow list de t
56
55
  }
57
56
  ```
58
57
 
59
- Cada tool opta nos tiers via `derived_from_tiers`. Claude e Codex podem rodar tier 1 e 2 sem perguntar. Gemini e OpenCode só rodam tier 1 (rest é guarded — pergunta antes).
58
+ Cada tool opta nos tiers via `derived_from_tiers`. Claude e Codex podem rodar tier 1 e 2 sem perguntar. OpenCode só roda tier 1 (rest é guarded — pergunta antes).
60
59
 
61
60
  ## Como vira permissão nativa por harness
62
61
 
63
- Toda vez que `aioson update` ou `aioson setup` roda, o `permissions-generator` lê o protocol e escreve 4 arquivos:
62
+ Toda vez que `aioson update` ou `aioson setup` roda, o `permissions-generator` lê o protocol e escreve os arquivos nativos:
64
63
 
65
64
  | Harness | Arquivo gerado | Formato | Merge |
66
65
  |---|---|---|---|
67
66
  | Claude Code | `.claude/settings.json` | JSON (`permissions.allow[]`) | Merge com entradas existentes (preserva customizações) |
68
67
  | Codex CLI | `.codex/permissions.json` | JSON nativo | Sobrescreve (com backup) |
69
- | Gemini CLI | `.gemini/permissions.toml` | TOML | Sobrescreve (com backup) |
70
- | OpenCode | `.opencode/permissions.yaml` | YAML | Sobrescreve (com backup) |
68
+ | OpenCode | `.opencode/permissions.yaml` | YAML | Sobrescreve (com backup) |
71
69
 
72
70
  A versão anterior é sempre salva em `.aioson/backups/{timestamp}/permissions/`.
73
71
 
@@ -105,7 +103,7 @@ Resultado típico para um claude trusted:
105
103
 
106
104
  Note que padrões tier 3 (`git push`, `npm publish`) **não estão na lista**. Cada vez que o agente tenta rodar um deles, Claude pergunta. Esse é o ponto.
107
105
 
108
- ### Gemini / OpenCode
106
+ ### OpenCode
109
107
 
110
108
  Modo `guarded` por padrão. Só tier 1 é auto-aprovado. Tudo o resto pergunta. Adequado para harnesses com TTY interativo onde o usuário acompanha cada ação.
111
109
 
@@ -15,7 +15,7 @@
15
15
 
16
16
 
17
17
  ┌──────────────────────────────────────────────────────────────────────────────┐
18
- │ Agente @dev (Claude Code / Codex / Gemini / OpenCode) │
18
+ │ Agente @dev (Claude Code / Codex / OpenCode) │
19
19
  │ ────────── │
20
20
  │ 1. Lê .aioson/config.md │
21
21
  │ 2. Lê .aioson/context/project.context.md │
@@ -148,21 +148,21 @@ aioson workflow:next . --complete=dev
148
148
  │ • UNION de shell_patterns + aioson_commands
149
149
  │ • HARD-REJECT tier3_blocking
150
150
 
151
- ┌─────────┼─────────┬─────────────┐
152
- ▼ ▼ ▼
153
- ┌────────┐ ┌──────┐ ┌────────┐ ┌──────────┐
154
- │ Claude │ │ Codex│ │ Gemini │ │ OpenCode │
155
- │ JSON │ │ JSON │ │ TOML │ │ YAML │
156
- │ (merge │ │ (over│ │ (over- │ │ (over-
157
- │ user) │ │ -wr) │ │ write) │ │ write)
158
- └────┬───┘ └──┬───┘ └───┬────┘ └────┬─────┘
159
- │ │
160
- │ │ backup do anterior
161
- │ │├──────────────────────┐
162
- ▼ ▼
163
- .claude/ .codex/ .gemini/ .opencode/ .aioson/backups/
164
- settings permis- permis- permis- {timestamp}/
165
- .json sions sions sions permissions/
151
+ ┌─────────┼─────────┐
152
+ ▼ ▼ ▼
153
+ ┌────────┐ ┌──────┐ ┌──────────┐
154
+ │ Claude │ │ Codex│ │ OpenCode │
155
+ │ JSON │ │ JSON │ │ YAML │
156
+ │ (merge │ │ (over│ │ (over- │
157
+ │ user) │ │ -wr) │ │ write) │
158
+ └────┬───┘ └──┬───┘ └────┬─────┘
159
+ │ │
160
+ │ │ │ backup do anterior
161
+ │ │ ├──────────────────────┐
162
+ ▼ ▼ ▼ ▼
163
+ .claude/ .codex/ .opencode/ .aioson/backups/
164
+ settings permis- permis- {timestamp}/
165
+ .json sions sions permissions/
166
166
  .json .toml .yaml └── <tool>/
167
167
  └── <file>
168
168
 
@@ -43,7 +43,7 @@ Quando um agente abre, ele lê esses 4 arquivos primeiro. Eles cabem na janela d
43
43
  ## Ciclo de vida de uma sessão
44
44
 
45
45
  ```
46
- 1. Você abre Claude Code / Codex / Gemini / OpenCode e ativa um agente:
46
+ 1. Você abre Claude Code / Codex / OpenCode e ativa um agente:
47
47
  /dev "vamos adicionar paginação em /api/posts"
48
48
 
49
49
  2. O agente lê:
@@ -1,6 +1,6 @@
1
1
  # Reflexão In-Harness — pipeline técnica
2
2
 
3
- > Por que "in-harness"? Porque a parte cara — interpretar diff e reescrever prosa — acontece **dentro da sessão do harness** (Claude Code, Codex, Gemini, OpenCode), usando o LLM que você já está pagando. O CLI nunca abre conexão com um provider de IA. Ele decide quando disparar, monta o pacote pro agente, e valida o resultado.
3
+ > Por que "in-harness"? Porque a parte cara — interpretar diff e reescrever prosa — acontece **dentro da sessão do harness** (Claude Code, Codex e OpenCode), usando o LLM que você já está pagando. O CLI nunca abre conexão com um provider de IA. Ele decide quando disparar, monta o pacote pro agente, e valida o resultado.
4
4
 
5
5
  ## Componentes
6
6
 
package/package.json CHANGED
@@ -1,13 +1,12 @@
1
1
  {
2
2
  "name": "@jaimevalasek/aioson",
3
- "version": "1.21.4",
3
+ "version": "1.21.6",
4
4
  "description": "AI operating framework for hyper-personalized software.",
5
5
  "keywords": [
6
6
  "ai",
7
7
  "agents",
8
8
  "claude",
9
9
  "codex",
10
- "gemini",
11
10
  "opencode",
12
11
  "cli",
13
12
  "framework"
@@ -24,6 +23,7 @@
24
23
  "files": [
25
24
  "bin/",
26
25
  "src/",
26
+ "scripts/",
27
27
  "template/",
28
28
  "docs/",
29
29
  "README.md",
@@ -41,7 +41,7 @@
41
41
  "test:genome-2.0-smoke": "node scripts/smoke/genome-2.0-smoke.js",
42
42
  "test:genome-2.0:block-a": "node scripts/smoke/genome-2.0-smoke.js && npm run test:genome && npm test && npm run lint",
43
43
  "test:genome-2.0:rollout": "node scripts/testing/genome-2.0-rollout.js",
44
- "lint": "node --check src/*.js src/commands/*.js src/i18n/*.js src/i18n/messages/*.js bin/*.js",
44
+ "lint": "node scripts/check-js.js",
45
45
  "sync:agents": "node src/commands/sync-agents-preflight.js && rsync -av --progress --exclude='config.md' --exclude='runtime/' --exclude='backups/' --exclude='mcp/servers.local.json' template/ ./",
46
46
  "ci": "npm run lint && npm test"
47
47
  },