heimdall-agent 1.2.0 → 1.5.0
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.
- package/README.md +108 -30
- package/README.pt-BR.md +109 -31
- package/agents/frontend-designer.md +6 -1
- package/agents/modernizer.md +4 -1
- package/agents/orchestrator.md +2 -1
- package/agents/reviewer.md +1 -1
- package/config/agents.json +166 -4
- package/config/mcp.resolved.json +74 -0
- package/config/mcp.template.json +85 -0
- package/config/models.json +70 -0
- package/config/profiles.json +4 -3
- package/config/skills.json +911 -762
- package/docs/SKILLS.md +82 -21
- package/docs/designs/old/2026-11-16 upstream-skill-sync-and-provenance-links.md +60 -0
- package/doctrine/AGENTS.md +3 -3
- package/hooks/heimdall-hook.cjs +16 -1
- package/hooks/hooks.json +11 -0
- package/lib/hud-sync.cjs +187 -0
- package/lib/model-context.cjs +50 -1
- package/lib/model-router.cjs +294 -0
- package/package.json +1 -1
- package/playbooks/05-canonical-plan-template.md +5 -12
- package/playbooks/06-model-registry-matrix.md +27 -19
- package/readme.html +1006 -0
- package/setup.mjs +583 -220
- package/skills/communication-doctrine/SKILL.md +2 -2
- package/skills/handoff/SKILL.md +13 -0
- package/skills/mcp-cleanup/SKILL.md +61 -0
- package/skills/mcp-sync/SKILL.md +58 -0
- package/skills/modern-web-guidance/SKILL.md +90 -0
- package/skills/ruminate/SKILL.md +140 -0
- package/skills/taste-skill/SKILL.md +367 -534
- package/skills/upstream-skill-sync/SKILL.md +46 -0
- package/skills/writing-plans/SKILL.md +1 -1
- package/tools/heimdall-hud.mjs +283 -0
package/README.pt-BR.md
CHANGED
|
@@ -4,13 +4,13 @@
|
|
|
4
4
|
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License: MIT" /></a>
|
|
5
5
|
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-339933.svg?style=flat-square&logo=node.js&logoColor=white" alt="Node >= 18" /></a>
|
|
6
6
|
<a href="#10-personas-de-agentes-predefinidas"><img src="https://img.shields.io/badge/agents-10%20predefinidos-orange.svg?style=flat-square" alt="Agentes: 10 Predefinidos" /></a>
|
|
7
|
-
<a href="#inventario-de-skills-
|
|
7
|
+
<a href="#inventario-de-skills-69-modulos-em-30-toolkits"><img src="https://img.shields.io/badge/skills-30%20toolkits%20%2869%20m%C3%B3dulos%29-blueviolet.svg?style=flat-square" alt="Skills: 30 Toolkits (69 Módulos)" /></a>
|
|
8
8
|
<a href="#ferramentas-e-runtimes-suportados"><img src="https://img.shields.io/badge/runtimes-Antigravity%20%7C%20Claude%20%7C%20Codex%20%7C%20Hermes%20%7C%20OpenClaw-black.svg?style=flat-square" alt="Runtimes" /></a>
|
|
9
9
|
</p>
|
|
10
10
|
|
|
11
11
|
🌐 **Idioma / Language:** [English](README.md) | **Português (Brasil)**
|
|
12
12
|
|
|
13
|
-
O Heimdall é um toolkit portátil de bootstrap e sentinela de qualidade para engenharia de software multi-agente. Ele impõe portões de planejamento antes da geração de código, previne *AI slop* (código e texto genérico de IA), isola fronteiras de módulos e sincroniza **10 personas de agentes especializados** e **
|
|
13
|
+
O Heimdall é um toolkit portátil de bootstrap e sentinela de qualidade para engenharia de software multi-agente. Ele impõe portões de planejamento antes da geração de código, previne *AI slop* (código e texto genérico de IA), isola fronteiras de módulos e sincroniza **10 personas de agentes especializados** e **69 skills modulares** entre **Google Antigravity**, **Claude Code**, **OpenAI Codex CLI**, **Hermes Agent**, **OpenClaw**, **OpenDesign** e **Claude Desktop**.
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
@@ -31,10 +31,10 @@ O Heimdall é um toolkit portátil de bootstrap e sentinela de qualidade para en
|
|
|
31
31
|
<a id="1-o-que-e-o-heimdall"></a>
|
|
32
32
|
## 1. O que é o Heimdall?
|
|
33
33
|
|
|
34
|
-
O **Heimdall** é um bootstrapper de ambiente e camada de coordenação multi-agente para ferramentas de programação com IA.
|
|
34
|
+
O **Heimdall** é um bootstrapper de ambiente e camada de coordenação multi-agente para ferramentas de programação com IA. Mais do que um agregador de skills, ele instala uma **maneira completa e opinativa de trabalhar e programar**—combinando comunicação estruturada, prova empírica, contenção cirúrgica de código e hooks de segurança em tempo de execução para construir um ambiente de engenharia determinístico e verificado.
|
|
35
35
|
|
|
36
36
|
Em vez de manter manualmente instruções customizadas, prompts de sistema e arquivos de configuração espalhados em diferentes clientes de IA, o Heimdall fornece uma fonte única da verdade (*Single Source of Truth*):
|
|
37
|
-
* **Skills Modulares**:
|
|
37
|
+
* **Skills Modulares**: 69 capacidades ativadas sob demanda por tarefa (como modelagem de banco de dados, auditoria de segurança, aplicação de design tokens, divulgação progressiva e depuração sistemática) que carregam apenas quando necessário, economizando tokens de contexto.
|
|
38
38
|
* **Personas de Agentes Especializados**: 10 papéis predefinidos com janelas de contexto isoladas (`orchestrator`, `tester`, `frontend-designer`, `mobile-designer`, `reviewer`, `security-auditor`, `database-architect`, `code-sentinel`, `modernizer`, `cloud-engineer`).
|
|
39
39
|
* **Doutrina Universal**: Regras centrais (`AGENTS.md`) sincronizadas em todas as ferramentas, exigindo portões de planejamento, desenvolvimento orientado a testes (TDD) e edições cirúrgicas mínimas.
|
|
40
40
|
|
|
@@ -56,16 +56,44 @@ O Heimdall transforma assistentes de código comuns em equipes de engenharia mul
|
|
|
56
56
|
5. **Revisão de Código Adversarial**: Despacha revisores sem viés de contexto conversacional para inspecionar `git diffs` em busca de casos de borda, regressões silenciosas e falhas não tratadas.
|
|
57
57
|
6. **Intercepta Operações Perigosas**: Avalia comandos shell e mutações de arquivos por meio de hooks de ciclo de vida para bloquear exclusões destrutivas na raiz e *force-pushes* em branches protegidas.
|
|
58
58
|
|
|
59
|
+
### A Forma de Trabalhar do Heimdall (Além de um Agregador de Skills)
|
|
60
|
+
|
|
61
|
+
Skills isoladas não constroem software confiável—**disciplina de engenharia constrói**. O Heimdall incorpora uma metodologia operacional completa em cada sessão:
|
|
62
|
+
|
|
63
|
+
1. **Arquitetura de Comunicação BLUF (*Bottom Line Up Front*)** (`communication-doctrine`):
|
|
64
|
+
- Elimina rodeios e conclusões escondidas no final da resposta. Todo relatório de status, plano de implementação, veredito de revisão e handoff entre subagentes abre com a decisão, o veredito e o raio de impacto (*blast radius*) nas **primeiras 1–2 frases**.
|
|
65
|
+
- Cabeçalhos padronizados (`Subagent BLUF`, `Review Verdict`, `Plan BLUF`) permitem que coordenadores e engenheiros humanos leiam o resultado em segundos.
|
|
66
|
+
2. **Inglês Técnico Simplificado ASD-STE100**:
|
|
67
|
+
- Passos procedimentais começam com **verbos imperativos ativos** (`Create`, `Modify`, `Assert`, `Verify`, `Run`), respeitam limites rígidos de tamanho (**≤ 20 palavras por passo**) e nomeiam objetos explicitamente (sem pronomes ambíguos como *"it"* ou *"this"*).
|
|
68
|
+
- Impõe um **Léxico de Zero Ambiguidade** que proíbe qualificadores vagos (*"ensure"*, *"properly"*, *"appropriately"*, *"gracefully"*, *"as needed"*, *"robustly"*, *"etc."*), substituindo-os por condições exatas e testáveis.
|
|
69
|
+
3. **Poteto (`pstack` / `brainmaxxing`) e Artesania de Alto Rigor**:
|
|
70
|
+
- **`pstack-discipline`** (de Lauren Tan / `@poteto`): Impõe *"Prove Que Funciona"* (prova empírica antes de declarar concluído), *"Corrija Causas-Raiz"* (sem guardas que mascaram sintomas), *"Teste Comportamento, Não Implementação"*, *"Subtraia Antes de Adicionar"* e *"Sequencie o Trabalho em Unidades Verificáveis"*.
|
|
71
|
+
- **`ruminate`** (inspirado em `poteto/brainmaxxing`): Minera transcrições históricas de sessões Claude e Gemini em busca de correções do usuário, instruções repetidas, falhas de ativação de skills e desvios de doutrina—transformando atrito passado em arquivos de memória permanentes e emendas de skills.
|
|
72
|
+
- Combinado com **`thermo`** (auditorias de manutenibilidade "Code Judo"), **`karpathy-guidelines`** (edições cirúrgicas mínimas), **`clean-code`** (`ub-mode`), **`ponytail`** (Escada de Decisão de Dietrich Gebert) e **`modern-web-guidance`** (`GoogleChrome/modern-web-guidance`).
|
|
73
|
+
4. **Sessões Auto-Evolutivas e Continuidade de Contexto (`ruminate` + `handoff` + Sentinela de Contexto)**:
|
|
74
|
+
- O Heimdall aprende com o próprio histórico: regras no `handoff` (handoff automático ao detectar queda de coerência) e no `writing-plans` (portão de completude de especificação) foram extraídas diretamente de **187 sessões históricas via `/ruminate`**.
|
|
75
|
+
- Durante sessões ativas, o **Sentinela de Contexto** ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) monitora turnos e uso estimado de tokens contra a janela do modelo ativo (alertando em 75% ou 40 turnos) para que o `handoff` persista o estado limpo antes da degradação do contexto.
|
|
76
|
+
5. **Roteamento Dinâmico Multi-Família de Modelos (`lib/model-router.cjs` + `heimdall sync-models`)**:
|
|
77
|
+
- As personas usam `model: inherit` sem aprisionamento a fornecedor. O `heimdall sync-models` e [`lib/model-router.cjs`](lib/model-router.cjs) classificam capacidades dinamicamente, mapeiam personas para níveis de capacidade (`deep_reasoning`, `surgical_restraint`, `adversarial_diff_eval`) e escolhem **revisores de famílias distintas** (ex.: Gemini auditado por Claude, Codex, GLM, Hunyuan ou MiMo).
|
|
78
|
+
6. **Contenção de Tokens, Cerimônia e Diffs (`progressive-disclosure` + `caveman` + `ponytail`)**:
|
|
79
|
+
- `progressive-disclosure` carrega skills sob demanda para reduzir o custo de prompt, `caveman` remove cerimônia conversacional e `ponytail` (*Modo Dev Sênior Preguiçoso*, `lite` / `full` / `ultra`) garante o menor diff completo e uma resposta direta que um engenheiro ocupado entende em uma leitura.
|
|
80
|
+
7. **Pipeline Matt Pocock ([`mattpocock/skills`](https://github.com/mattpocock/skills)) e os 4 Pilares de Karpathy (`karpathy-guidelines`)**:
|
|
81
|
+
- **Pré-código → Arquitetura → Tickets**: `grill-me` (Árvore de Decisão) → `wayfinder` (resolvido vs. fronteira vs. névoa) → `domain-modeling` (`GLOSSARY.md` e ADRs) → `to-spec` (invariantes) → `to-tickets` (tickets tracer-bullet) → `codebase-design` / `improve-codebase-architecture` (módulos profundos) → `handoff`.
|
|
82
|
+
- **4 Pilares de Karpathy**: *Pensar Antes de Programar* (expor premissas), *Simplicidade Primeiro* (sem helpers especulativos), *Edições Cirúrgicas* (alterar apenas linhas da tarefa) e *Execução Orientada a Metas* (critérios verificáveis antes de editar), reforçados pelo hook `PreToolUse (Write)` de 800 linhas.
|
|
83
|
+
8. **Sincronização Controlada de Skills Upstream (`upstream-skill-sync`)**:
|
|
84
|
+
- Classifica cada skill em `config/skills.json` como `mirror`, `adapted` ou `native` e separa atualizações em **Nível 1 (Seguro 1:1)**, **Nível 2 (Merge Seletivo)** ou **Nível 3 (Rejeitar)** após checagem `snyk-agent-scan`.
|
|
85
|
+
|
|
59
86
|
### Comparação: IA Padrão vs. Com Heimdall
|
|
60
87
|
|
|
61
88
|
| Área | IA Padrão (Vanilla) | Com Heimdall |
|
|
62
89
|
| :--- | :--- | :--- |
|
|
63
90
|
| **Prompt Inicial** | A IA gera imediatamente 300 linhas de código não verificado. | **Portão Interativo**: A IA pausa, questiona casos de borda e apresenta 2 opções arquiteturais. |
|
|
64
|
-
| **
|
|
65
|
-
| **
|
|
66
|
-
| **
|
|
67
|
-
| **
|
|
68
|
-
| **
|
|
91
|
+
| **Comunicação** | Prosa prolixa, vereditos escondidos e passos vagos (*"garanta que funcione bem"*). | **BLUF + ASD-STE100**: Veredito nas linhas 1–2; passos imperativos e testáveis com ≤20 palavras. |
|
|
92
|
+
| **Revisão de Código** | A IA aprova o próprio código com elogios superficiais. | **Revisão Cega ao Contexto**: Revisor Goldfish independente analisa o diff sem viés da conversa. |
|
|
93
|
+
| **Contenção de Código** | Wrappers inchados, código defensivo desnecessário, opções especulativas. | **Disciplina Karpathy & `pstack`**: Subtraia antes de adicionar, corrija causas-raiz, apenas edições cirúrgicas. |
|
|
94
|
+
| **Verificação** | A IA diz "pronto!" sem testar ou usa checagens superficiais. | **TDD & Playwright**: Teste falhando primeiro; prova empírica via testes e asserções de DOM no navegador. |
|
|
95
|
+
| **Segurança Operacional** | A IA pode abrir dev servers travados, rodar `rm -rf` ou dar force push na `main`. | **Hooks de Ciclo de Vida**: Bloqueia dev servers, comandos destrutivos, segredos e force pushes em runtime e no Git. |
|
|
96
|
+
| **Configuração** | Arquivos de prompt espalhados e desatualizados entre várias ferramentas. | **Fonte Única da Verdade**: Vinculada via junctions/symlinks nativos em 1 segundo; autoauditada via `ruminate`. |
|
|
69
97
|
|
|
70
98
|
[↑ Voltar ao topo](#indice)
|
|
71
99
|
|
|
@@ -82,7 +110,7 @@ Durante o bootstrap, o Heimdall cria *junctions* (Windows) ou *symlinks* (POSIX)
|
|
|
82
110
|
|
|
83
111
|
| Origem no Heimdall | Local Implantado | Finalidade |
|
|
84
112
|
| :--- | :--- | :--- |
|
|
85
|
-
| `skills/` | `~/.<ferramenta>/skills/` |
|
|
113
|
+
| `skills/` | `~/.<ferramenta>/skills/` | 69 toolkits de domínio carregados progressivamente sob demanda. |
|
|
86
114
|
| `agents/` | `~/.<ferramenta>/agents/` | 10 definições de personas de agentes especializados. |
|
|
87
115
|
| `hooks/` | `~/.claude/hooks/` | Hooks de ciclo de vida orientados a eventos para o Claude Code CLI. |
|
|
88
116
|
| `hooks/git/` | `.git/hooks/` (opcional) | Hook Git `pre-push` nativo universal para todas as ferramentas. |
|
|
@@ -107,18 +135,20 @@ O Heimdall adota a divisão central de trabalho do [`google/elephant-goldfish-mo
|
|
|
107
135
|
|
|
108
136
|
### 3. Hooks de Ciclo de Vida Orientados a Eventos
|
|
109
137
|
|
|
110
|
-
O Heimdall inclui hooks de execução sem dependências externas ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) registrados em `~/.claude/settings.json`:
|
|
138
|
+
O Heimdall inclui hooks de execução sem dependências externas ([`hooks/heimdall-hook.cjs`](hooks/heimdall-hook.cjs)) declarados em [`hooks/hooks.json`](hooks/hooks.json) e registrados em `~/.claude/settings.json`:
|
|
111
139
|
|
|
140
|
+
* **`UserPromptSubmit`**:
|
|
141
|
+
- **Injeção da Doutrina de Comunicação**: Reforça BLUF (conclusão nas primeiras 1–2 frases) e regras ASD-STE100 (verbo imperativo primeiro, ≤20 palavras/passo, zero qualificadores proibidos) a cada prompt.
|
|
112
142
|
* **`PreToolUse` (Bash/PowerShell)**:
|
|
113
143
|
- **Bloqueia Comandos Destrutivos**: Interrompe operações como `rm -rf /` ou `rmdir /s /q C:\` (exit code 2).
|
|
144
|
+
- **Política Estrita de Zero Dev-Server**: Bloqueia comandos de dev server (`npm run dev`, `vite`, `next dev`, `uvicorn`, `python manage.py runserver`) e exige verificações terminantes não interativas.
|
|
114
145
|
- **Proteção de Force Push Sensível à Branch**: Bloqueia `git push --force` direcionado a `main`, `master`, `release` ou `production` (explicitamente ou quando posicionado nessas branches). Force pushes em branches de trabalho (`feature/*`, `bugfix/*`) são permitidos com aviso.
|
|
115
146
|
- **Bloqueia Commits de Segredos**: Impede o stage de arquivos `.env`, `id_rsa` ou `*.pem` não criptografados.
|
|
147
|
+
- **Sentinela de Contexto (*Context Sentinel*)**: Rastreia turnos da sessão e estimativa de tokens contra o limite do modelo ativo, emitindo alerta em 75% da capacidade ou 40 turnos.
|
|
116
148
|
* **`PreToolUse` (Write)**:
|
|
117
|
-
- **Aviso de Contenção Karpathy**: Emite alerta caso a IA tente gerar um único arquivo com mais de 800 linhas.
|
|
118
|
-
* **`PostToolUse` (Edit/Write)**:
|
|
119
|
-
- **Lembrete de Verificação**: Lembra o agente de rodar suítes de teste automatizadas ou verificação no navegador antes de concluir.
|
|
149
|
+
- **Aviso de Contenção Karpathy**: Emite alerta caso a IA tente gerar um único arquivo com mais de 800 linhas (isentando artefatos HTML/SVG/canvas OpenDesign) e atualiza o rastreamento do Sentinela de Contexto.
|
|
120
150
|
* **`PreCompact`**:
|
|
121
|
-
- **
|
|
151
|
+
- **Reset e Lembrete Pré-Compactação**: Limpa o estado temporário da sessão e lembra o agente de salvar tarefas ativas, decisões e itens pendentes em disco antes da compressão de contexto.
|
|
122
152
|
* **Hook Git Pre-Push Nativo Universal** ([`hooks/git/pre-push`](hooks/git/pre-push)):
|
|
123
153
|
- Hook shell instalável em qualquer repositório (`.git/hooks/pre-push`) que bloqueia pushes non-fast-forward para `main`/`master` em todas as ferramentas de IA e terminais.
|
|
124
154
|
|
|
@@ -152,10 +182,10 @@ Escolha o perfil de acordo com sua máquina e fluxo de trabalho:
|
|
|
152
182
|
|
|
153
183
|
| Perfil | Skills | Agentes Predefinidos | Descrição | Ideal Para |
|
|
154
184
|
| :--- | :---: | :---: | :--- | :--- |
|
|
155
|
-
| **`full`** *(Padrão)* |
|
|
185
|
+
| **`full`** *(Padrão)* | 69 | 10 | Suíte completa de engenharia: planejamento, design, segurança, banco de dados e higiene. | Desenvolvimento diário em todas as ferramentas |
|
|
156
186
|
| **`minimal`** | 16 | 4 | Núcleo enxuto: `orchestrator`, `tester`, `code-sentinel`, `reviewer`. | Notebooks leves, janelas de contexto menores |
|
|
157
187
|
| **`security`** | 12 | 4 | Suíte AppSec: `orchestrator`, `security-auditor`, `tester`, `reviewer`. | Pentest e auditorias pré-deploy |
|
|
158
|
-
| **`design`** |
|
|
188
|
+
| **`design`** | 13 | 4 | Frontend e mobile: `orchestrator`, `frontend-designer`, `mobile-designer`, `code-sentinel`. | Design de UI/UX e design systems |
|
|
159
189
|
|
|
160
190
|
Para implantar um perfil específico:
|
|
161
191
|
```powershell
|
|
@@ -177,6 +207,41 @@ O Heimdall detecta e configura automaticamente as ferramentas de IA instaladas:
|
|
|
177
207
|
| **OpenDesign** | `open-design` no PATH / `.opendesign` | Modo automático de canvas visual: dispensa portões de perguntas no turno 1, preserva atributos `data-od-*` e aplica `taste-skill` + `antislop-ui` |
|
|
178
208
|
| **Claude Desktop** | `%APPDATA%\Claude` | Configura automaticamente o MCP Context7 e playbooks no `claude_desktop_config.json` |
|
|
179
209
|
|
|
210
|
+
### Arquitetura de servidores MCP
|
|
211
|
+
|
|
212
|
+
O Heimdall gerencia servidores Model Context Protocol (MCP) por meio de um resolvedor baseado em templates que elimina a multiplicação de processos do `npx` no Windows e mantém a configuração consistente em todos os harnesses instalados.
|
|
213
|
+
|
|
214
|
+
#### Como funciona
|
|
215
|
+
|
|
216
|
+
1. **Instalação global de pacotes**: durante a instalação (`node setup.mjs`), o Heimdall instala automaticamente os pacotes MCP necessários via `npm install -g`:
|
|
217
|
+
* `@upstash/context7-mcp` para consultas atualizadas de documentação de bibliotecas
|
|
218
|
+
* `chrome-devtools-mcp` para automação de navegador e profiling de performance
|
|
219
|
+
|
|
220
|
+
2. **Resolução de templates**: o template portátil em `config/mcp.template.json` declara definições de servidores com tokens `{{PLACEHOLDER}}` e hints de resolução. O script resolvedor (`scripts/resolve-mcp.mjs`) detecta caminhos locais em tempo de execução e gera `config/mcp.resolved.json` com entrypoints diretos via `node.exe`.
|
|
221
|
+
|
|
222
|
+
3. **Detecção dinâmica de harnesses**: o resolvedor sincroniza com cada harness instalado verificando a existência do arquivo de configuração. Ele não usa uma lista fixa de alvos:
|
|
223
|
+
* Gemini escreve em `~/.gemini/config/mcp_config.json` (JSON)
|
|
224
|
+
* Claude Code escreve em `~/.claude/settings.json` (JSON)
|
|
225
|
+
* Codex CLI escreve em `~/.codex/config.toml` (TOML `[mcp_servers.*]`)
|
|
226
|
+
* Hermes escreve em `%LOCALAPPDATA%\hermes\config.yaml` (YAML `mcp_servers:`)
|
|
227
|
+
* Qualquer harness futuro adicionado ao resolvedor é detectado automaticamente na próxima sincronização
|
|
228
|
+
|
|
229
|
+
4. **Invocação direta via `node.exe`**: as configurações resolvidas usam `C:\Program Files\nodejs\node.exe <entrypoint.js>` em vez de `npx`, criando exatamente 1 processo por servidor por sessão, sem wrappers `cmd.exe` e sem multiplicação de órfãos ao fechar a sessão.
|
|
230
|
+
|
|
231
|
+
#### Comandos diários de MCP
|
|
232
|
+
|
|
233
|
+
```powershell
|
|
234
|
+
# Re-resolve caminhos e sincroniza com todos os harnesses instalados (após ativar/desativar servidores ou atualizar pacotes)
|
|
235
|
+
/mcp-sync
|
|
236
|
+
|
|
237
|
+
# Mata processos MCP órfãos deixados por sessões que travaram
|
|
238
|
+
/mcp-cleanup
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
#### Desativar servidores pesados
|
|
242
|
+
|
|
243
|
+
Edite `config/mcp.template.json` e defina `"disabled": true` no servidor desejado (por exemplo, `chrome-devtools`) para impedir que ele seja iniciado em novas sessões. Execute `/mcp-sync` após editar.
|
|
244
|
+
|
|
180
245
|
[↑ Voltar ao topo](#indice)
|
|
181
246
|
|
|
182
247
|
---
|
|
@@ -198,6 +263,11 @@ heimdall audit
|
|
|
198
263
|
# Atualizar o catálogo dinâmico de modelos a partir do seu provedor/proxy ativo
|
|
199
264
|
heimdall sync-models
|
|
200
265
|
|
|
266
|
+
# Ativar, desativar ou escolher o tema da statusline Heimdall HUD (2 linhas)
|
|
267
|
+
heimdall hud
|
|
268
|
+
heimdall hud --on --theme night-blue
|
|
269
|
+
heimdall hud --off
|
|
270
|
+
|
|
201
271
|
# Navegar pelo catálogo canônico de skills e repositórios upstream
|
|
202
272
|
heimdall skills
|
|
203
273
|
|
|
@@ -214,7 +284,9 @@ heimdall uninstall
|
|
|
214
284
|
| Flag | Padrão | Descrição | Exemplo |
|
|
215
285
|
| :--- | :---: | :--- | :--- |
|
|
216
286
|
| `--profile <nome>` | `full` | Perfil de skills: `full`, `minimal`, `security` ou `design`. | `heimdall --profile minimal` |
|
|
217
|
-
| `--agents <alvos>` | `all` | Lista de ferramentas separadas por vírgula: `claude`, `gemini`, `codex`, `desktop`, `all`. | `heimdall --agents claude,
|
|
287
|
+
| `--agents <alvos>` | `all` | Lista de ferramentas separadas por vírgula: `claude`, `gemini`, `codex`, `hermes`, `openclaw`, `vscode`, `desktop`, `all`. | `heimdall --agents claude,vscode` |
|
|
288
|
+
| `--theme <nome>` | `night-blue` | Tema de cores do HUD: `night-blue`, `heimdall`, `claude-warm` ou `titanium`. | `heimdall hud --theme claude-warm` |
|
|
289
|
+
| `--no-hud` | `false` | Pula a configuração da statusline Heimdall HUD durante a instalação ou sincronização. | `heimdall --no-hud` |
|
|
218
290
|
| `--link` | `true` (rec.) | Implanta skills usando junctions NTFS (Windows) ou symlinks POSIX (macOS/Linux). | `heimdall --link` |
|
|
219
291
|
| `--clean` | `false` | Limpa skills antigas do diretório de destino antes de implantar. | `heimdall --clean` |
|
|
220
292
|
| `--dry-run` | `false` | Simula a execução e exibe as ações sem modificar o sistema de arquivos. | `heimdall --dry-run` |
|
|
@@ -288,28 +360,28 @@ Todas as personas declaram `model: inherit` para rodar em qualquer modelo ou pro
|
|
|
288
360
|
|
|
289
361
|
| Persona | Nível de Capacidade | Papel e Responsabilidades | Skills Vinculadas |
|
|
290
362
|
| :--- | :--- | :--- | :--- |
|
|
291
|
-
| **`orchestrator`** | `deep_reasoning` | Guardião do planejamento (`/grill-me`), questionamento de requisitos, decomposição modular de tarefas, exigência de verificação Playwright E2E e coordenação de subagentes. | `grill-me`, `brainstorming`, `writing-plans`, `to-spec`, `to-tickets`, `wayfinder`, `domain-modeling`, `handoff`, `pstack-discipline`, `subagent-driven-development`, `dispatching-parallel-agents`, `using-git-worktrees`, `writing-skills`, `executing-plans`, `herdr` |
|
|
292
|
-
| **`frontend-designer`** | `high_polish_vision` | Define leitura de design, hierarquia tipográfica, mapeamento de tokens e estética de UI anti-slop para web. | `taste-skill`, `brandkit`, `minimalist-skill`, `brutalist-skill`, `soft-skill`, `antislop-ui`, `antislop-human`, `stitch-skill`, `image-to-code-skill`, `imagegen-frontend-web`, `redesign-skill` |
|
|
363
|
+
| **`orchestrator`** | `deep_reasoning` | Guardião do planejamento (`/grill-me`), questionamento de requisitos, decomposição modular de tarefas, exigência de verificação Playwright E2E e coordenação de subagentes. | `grill-me`, `brainstorming`, `writing-plans`, `to-spec`, `to-tickets`, `wayfinder`, `domain-modeling`, `handoff`, `pstack-discipline`, `subagent-driven-development`, `dispatching-parallel-agents`, `using-git-worktrees`, `writing-skills`, `executing-plans`, `herdr`, `upstream-skill-sync` |
|
|
364
|
+
| **`frontend-designer`** | `high_polish_vision` | Define leitura de design, hierarquia tipográfica, mapeamento de tokens e estética de UI anti-slop para web. | `taste-skill`, `brandkit`, `minimalist-skill`, `brutalist-skill`, `soft-skill`, `antislop-ui`, `antislop-human`, `stitch-skill`, `image-to-code-skill`, `imagegen-frontend-web`, `redesign-skill`, `modern-web-guidance` |
|
|
293
365
|
| **`mobile-designer`** | `responsive_flex_safety` | Segurança de viewport mobile (320px–430px), alvos de toque de 48px, containers flex sem corte de overflow e assets responsivos. | `antislop-layoutmobile`, `antislop-human`, `antislop-ui`, `imagegen-frontend-mobile`, `taste-skill` |
|
|
294
366
|
| **`tester`** | `fast_verification` | Impõe TDD estrito e verificação real em navegador (Playwright). Rejeita pseudo-verificação (`curl`, `grep`, `tsc`). | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `executing-plans` |
|
|
295
367
|
| **`security-auditor`** | `deep_assurance_audit` | Sondagem HTTP diferencial dinâmica entre níveis de autenticação, defesas OWASP Top 10 e detecção de padrões inseguros da Trail of Bits. | `strix-security`, `security-audit-sweep`, `owasp-security`, `cloudflare-security-audit`, `snyk-agent-scan`, `trailofbits-audit-context`, `trailofbits-insecure-defaults`, `trailofbits-triage-brocards` |
|
|
296
368
|
| **`database-architect`** | `schema_migration_safety` | Governa migrações não destrutivas, normalização, auditoria de planos de query (`EXPLAIN ANALYZE`) e pool de conexões (Postgres/Supabase, SQLite, MySQL). | `postgres-best-practices`, `systematic-debugging`, `karpathy-guidelines` |
|
|
297
|
-
| **`code-sentinel`** | `surgical_restraint` | Simplicidade Karpathy: escreve código cirúrgico mínimo, remove comentários redundantes, elimina código morto defensivo, exige módulos profundos e aplica padrões anti-slop. | `karpathy-guidelines`, `clean-code`, `codebase-design`, `ponytail`, `antislop`, `antislop-code`, `antislop-copywriting`, `antislop-human`, `finishing-a-development-branch` |
|
|
369
|
+
| **`code-sentinel`** | `surgical_restraint` | Simplicidade Karpathy: escreve código cirúrgico mínimo, remove comentários redundantes, elimina código morto defensivo, exige módulos profundos e aplica padrões anti-slop. | `communication-doctrine`, `karpathy-guidelines`, `clean-code`, `codebase-design`, `ponytail`, `antislop`, `antislop-code`, `antislop-copywriting`, `antislop-human`, `finishing-a-development-branch` |
|
|
298
370
|
| **`reviewer`** | `adversarial_diff_eval` | Realiza análise adversarial de diffs, audita profundidade de módulos e abstrações rasas, captura regressões silenciosas, executa auditorias thermo e coordena revisões cruzadas entre modelos. | `communication-doctrine`, `thermo`, `codebase-design`, `requesting-code-review`, `receiving-code-review`, `claude-collaborator`, `gemini-collaborator`, `codex-collaborator`, `using-superpowers`, `diagnosing-superpowers`, `output-skill` |
|
|
299
|
-
| **`modernizer`** | `legacy_migration_safety` | Executa transformações de código legado, upgrades de runtime, desacoplamento de dependências e migrações Strangler Fig protegidas por testes de caracterização Golden Master. | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `improve-codebase-architecture`, `codebase-design`, `karpathy-guidelines`, `project-hygiene`, `output-skill` |
|
|
371
|
+
| **`modernizer`** | `legacy_migration_safety` | Executa transformações de código legado, upgrades de runtime, desacoplamento de dependências e migrações Strangler Fig protegidas por testes de caracterização Golden Master. | `test-driven-development`, `verification-before-completion`, `systematic-debugging`, `improve-codebase-architecture`, `codebase-design`, `karpathy-guidelines`, `project-hygiene`, `output-skill`, `modern-web-guidance`, `upstream-skill-sync` |
|
|
300
372
|
| **`cloud-engineer`** | `infra_container_safety` | Governa conteinerização (Docker, Compose), manifestos Kubernetes, Infraestrutura como Código (Terraform), proxies reversos (Caddy, Nginx), CI/CD e verificação terminante. | `communication-doctrine`, `karpathy-guidelines`, `clean-code`, `systematic-debugging`, `project-hygiene`, `progressive-disclosure` |
|
|
301
373
|
|
|
302
374
|
---
|
|
303
375
|
|
|
304
|
-
<a id="inventario-de-skills-
|
|
305
|
-
### Inventário de Skills (
|
|
376
|
+
<a id="inventario-de-skills-69-modulos-em-30-toolkits"></a>
|
|
377
|
+
### Inventário de Skills (69 Módulos em 30 Toolkits)
|
|
306
378
|
|
|
307
|
-
O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 módulos)** e **
|
|
379
|
+
O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 módulos)** e **24 Toolkits Independentes (24 módulos)**:
|
|
308
380
|
|
|
309
381
|
#### Suítes Multi-Skill Principais (6 Suítes / 45 Módulos)
|
|
310
382
|
|
|
311
383
|
<details open>
|
|
312
|
-
<summary><b>1. Suíte de Engenharia Superpowers (15 módulos) —
|
|
384
|
+
<summary><b>1. Suíte de Engenharia Superpowers (15 módulos) — <a href="https://github.com/obra/superpowers">obra/superpowers</a></b></summary>
|
|
313
385
|
|
|
314
386
|
- `brainstorming`: Expõe premissas implícitas e explora alternativas antes de travar o design.
|
|
315
387
|
- `writing-plans`: Estrutura tarefas modulares e objetivas com critérios verificáveis de conclusão.
|
|
@@ -330,7 +402,7 @@ O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 mó
|
|
|
330
402
|
</details>
|
|
331
403
|
|
|
332
404
|
<details>
|
|
333
|
-
<summary><b>2. Estúdio de Design e Estética Taste (10 módulos)</b></summary>
|
|
405
|
+
<summary><b>2. Estúdio de Design e Estética Taste (10 módulos) — <a href="https://github.com/Leonxlnx/taste-skill">Leonxlnx/taste-skill</a></b></summary>
|
|
334
406
|
|
|
335
407
|
- `taste-skill`: Impõe leitura coesa de design, tipografia intencional e lógica de cores orientada à marca.
|
|
336
408
|
- `brandkit`: Gerencia design tokens, ativos invariantes de marca e temas multi-paleta.
|
|
@@ -346,7 +418,7 @@ O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 mó
|
|
|
346
418
|
</details>
|
|
347
419
|
|
|
348
420
|
<details>
|
|
349
|
-
<summary><b>3. Suíte de Qualidade Anti-Slop (6 módulos) —
|
|
421
|
+
<summary><b>3. Suíte de Qualidade Anti-Slop (6 módulos) — <a href="https://github.com/miqdadbadjuber/anti-slop">miqdadbadjuber/anti-slop</a></b></summary>
|
|
350
422
|
|
|
351
423
|
- `antislop`: Guardrail central que proíbe enrolação genérica de IA, chavões vazios e excessos decorativos.
|
|
352
424
|
- `antislop-code`: Proíbe comentários redundantes, código morto defensivo e abstrações especulativas.
|
|
@@ -367,7 +439,7 @@ O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 mó
|
|
|
367
439
|
</details>
|
|
368
440
|
|
|
369
441
|
<details>
|
|
370
|
-
<summary><b>5. Suíte AppSec de Alta Confiabilidade Trail of Bits (3 módulos) —
|
|
442
|
+
<summary><b>5. Suíte AppSec de Alta Confiabilidade Trail of Bits (3 módulos) — <a href="https://github.com/trailofbits/skills">trailofbits/skills</a></b></summary>
|
|
371
443
|
|
|
372
444
|
- `trailofbits-audit-context`: Mapeamento de premissas, garantias de código e dependências arquiteturais críticas.
|
|
373
445
|
- `trailofbits-insecure-defaults`: Detecção de configurações padrão inseguras, padrões *fail-open* e permissões excessivas.
|
|
@@ -376,7 +448,7 @@ O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 mó
|
|
|
376
448
|
</details>
|
|
377
449
|
|
|
378
450
|
<details>
|
|
379
|
-
<summary><b>6. Suíte de Engenharia Real Matt Pocock (8 módulos) —
|
|
451
|
+
<summary><b>6. Suíte de Engenharia Real Matt Pocock (8 módulos) — <a href="https://github.com/mattpocock/skills">mattpocock/skills</a></b></summary>
|
|
380
452
|
|
|
381
453
|
- `codebase-design`: Modela módulos profundos — interfaces enxutas que encapsulam alta complexidade interna —, aplica o teste de deleção e elimina camadas superficiais de abstração.
|
|
382
454
|
- `domain-modeling`: Modela a linguagem ubíqua da aplicação, estrutura glossários de termos de negócio e formaliza Registros de Decisão Arquitetural (ADRs) para evitar divergências conceituais.
|
|
@@ -389,7 +461,7 @@ O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 mó
|
|
|
389
461
|
|
|
390
462
|
</details>
|
|
391
463
|
|
|
392
|
-
#### Toolkits Independentes (
|
|
464
|
+
#### Toolkits Independentes (24 Toolkits Curados / 24 Módulos)
|
|
393
465
|
|
|
394
466
|
<details open>
|
|
395
467
|
<summary><b>Explorar Toolkits Independentes</b></summary>
|
|
@@ -413,6 +485,11 @@ O Heimdall organiza as capacidades em **6 Suítes Multi-Skill Principais (45 mó
|
|
|
413
485
|
- **`progressive-disclosure`**: Padrão de divulgação progressiva em 3 camadas alinhado à Anthropic e Google, cortando o uso de tokens de prompt em >80% e prevenindo a proliferação desordenada de subagentes.
|
|
414
486
|
- **`project-hygiene`**: Varre repositórios em busca de código morto, exports não utilizados, dependências circulares e caches de build obsoletos.
|
|
415
487
|
- **`output-skill`**: Garante saídas completas do modelo sem reticências (`...`), blocos de código truncados ou omissões.
|
|
488
|
+
- **`ruminate`**: Minera transcrições históricas de sessões Claude e Gemini em busca de padrões de correção, preferências repetidas, falhas de ativação de skills, violações de doutrina e desvios de consistência entre agentes. Escreve descobertas como arquivos de memória ou emendas de skills. Inspirado em [poteto/brainmaxxing](https://github.com/poteto/brainmaxxing).
|
|
489
|
+
- **`modern-web-guidance`**: Pacote oficial de skills de plataforma web moderna do Google Chrome (`GoogleChrome/modern-web-guidance`). Orienta agentes a usar APIs nativas HTML/CSS/JS compatíveis com Baseline, boas práticas de Core Web Vitals (LCP/INP/CLS) e modernização frontend via `legacy-scan`.
|
|
490
|
+
- **`mcp-cleanup`**: Encerra processos órfãos de servidores MCP deixados por sessões encerradas ou travadas.
|
|
491
|
+
- **`mcp-sync`**: Resolve o template MCP do Heimdall para caminhos locais e sincroniza com os harnesses instalados.
|
|
492
|
+
- **`upstream-skill-sync`**: Audita repositórios upstream em `config/skills.json` e classifica atualizações em Seguro 1:1, Merge Seletivo ou Rejeitar.
|
|
416
493
|
|
|
417
494
|
</details>
|
|
418
495
|
|
|
@@ -430,6 +507,7 @@ Para programação em par entre múltiplos dispositivos, monitoramento mobile e
|
|
|
430
507
|
* **[Moshi (`getmoshi.app`)](https://getmoshi.app/)**: Cliente mobile (iOS/Android) pareado com sua sessão de terminal. Envia notificações push quando um agente atinge um portão interativo de planejamento e permite aprovação remota.
|
|
431
508
|
* **[Graphify (`github.com/Graphify-Labs/graphify`)](https://github.com/Graphify-Labs/graphify)**: Construtor local de grafos de conhecimento de código. Usa análise AST via Tree-sitter em mais de 40 linguagens para gerar mapas determinísticos de dependência sem custo de API de LLM, exportando diretamente para cofres do Obsidian.
|
|
432
509
|
* **[Obsidian (`obsidian.md`)](https://obsidian.md/)**: Base de conhecimento local em Markdown. Combinado com cofres gerados pelo Graphify (`[[wikilinks]]`), funciona como memória externa persistente para agentes de IA, carregando contexto arquitetural imediato na inicialização sem varreduras pesadas em tokens.
|
|
510
|
+
* **Heimdall HUD ([`tools/heimdall-hud.mjs`](tools/heimdall-hud.mjs))**: Statusline nativa de 2 linhas para terminal no **Claude Code** e **Google Antigravity (`agy`)**, exibindo modelo, barra de contexto colorida, branch Git e arquivos modificados, consumo de tokens, custo e duração da sessão em 4 temas (`night-blue` padrão, `heimdall`, `claude-warm`, `titanium`). No **Codex CLI** (que não executa scripts externos de `statusLine`), o `heimdall hud` configura os itens nativos `[tui] status_line` em `~/.codex/config.toml`.
|
|
433
511
|
|
|
434
512
|
[↑ Voltar ao topo](#indice)
|
|
435
513
|
|
|
@@ -16,6 +16,7 @@ skills:
|
|
|
16
16
|
- image-to-code-skill
|
|
17
17
|
- imagegen-frontend-web
|
|
18
18
|
- redesign-skill
|
|
19
|
+
- modern-web-guidance
|
|
19
20
|
---
|
|
20
21
|
|
|
21
22
|
# Heimdall Frontend & UI Design Engineer
|
|
@@ -41,4 +42,8 @@ You are the **Frontend Designer**. Your mandate is to design and implement disti
|
|
|
41
42
|
|
|
42
43
|
4. **Visual Canvas & OpenDesign Compatibility**:
|
|
43
44
|
- When editing or generating OpenDesign / canvas prototypes, preserve all `data-od-id` and `data-od-*` attributes on DOM nodes.
|
|
44
|
-
- If a `DESIGN.md` specification exists in the workspace, map its typography, color, and spacing tokens directly into the Design Read.
|
|
45
|
+
- If a `DESIGN.md` specification exists in the workspace, map its typography, color, and spacing tokens directly into the Design Read.
|
|
46
|
+
|
|
47
|
+
5. **Modern Web Platform & Core Web Vitals (`modern-web-guidance`)**:
|
|
48
|
+
- Query `modern-web-guidance` before implementing HTML/CSS/client-side JS UI patterns (dialogs, popovers, anchor positioning, view transitions, scroll-driven animations, forms, CWV).
|
|
49
|
+
- Prefer Baseline-safe native platform APIs over custom JavaScript wrappers or polyfills.
|
package/agents/modernizer.md
CHANGED
|
@@ -14,6 +14,8 @@ skills:
|
|
|
14
14
|
- karpathy-guidelines
|
|
15
15
|
- project-hygiene
|
|
16
16
|
- output-skill
|
|
17
|
+
- modern-web-guidance
|
|
18
|
+
- upstream-skill-sync
|
|
17
19
|
---
|
|
18
20
|
|
|
19
21
|
# Heimdall Code Modernization Specialist
|
|
@@ -34,7 +36,8 @@ You operate under the principles of Anthropic's *Code Modernization Playbook* an
|
|
|
34
36
|
Before proposing or changing code:
|
|
35
37
|
1. Map the input/output boundaries of the subsystem using improve-codebase-architecture to detect circular imports, coupled modules, and structural knots.
|
|
36
38
|
2. Trace all callers, dependencies, global states, and database schemas.
|
|
37
|
-
3. Identify hidden assumptions, serialization formats, and implicit type coercions.
|
|
39
|
+
3. Identify hidden assumptions, serialization formats, and implicit type coercions.
|
|
40
|
+
4. For broad frontend/web modernization audits, run `npx -y modern-web-guidance@latest legacy-scan <path> --json` (per `modern-web-guidance`) to detect outdated web platform patterns and retrieve Baseline-safe replacements.
|
|
38
41
|
|
|
39
42
|
### Step 2: Golden Master (Characterization) Test Baseline
|
|
40
43
|
Before touching a single line of legacy implementation:
|
package/agents/orchestrator.md
CHANGED
|
@@ -21,6 +21,7 @@ skills:
|
|
|
21
21
|
- writing-skills
|
|
22
22
|
- executing-plans
|
|
23
23
|
- herdr
|
|
24
|
+
- upstream-skill-sync
|
|
24
25
|
---
|
|
25
26
|
|
|
26
27
|
# Heimdall Orchestrator & Architecture Sentinel
|
|
@@ -70,7 +71,7 @@ You are the **Orchestrator**. Your mandate is to lead software engineering tasks
|
|
|
70
71
|
- Save a lean handoff document to `$env:TEMP` containing only pointers (plan/ADR links, branch name, commit hash) with zero duplicate code dumps.
|
|
71
72
|
- Mandate a `### Suggested Skills for Next Agent` section to direct the child agent's initial execution.
|
|
72
73
|
- When routing tasks to peer review or pre-commit gates:
|
|
73
|
-
- **Cross-Model Path (Herdr Multiplexing)**: When `$env:HERDR_ENV = "1"`, orchestrate peer models (Claude, Codex, Gemini) natively using the `herdr` skill. Re-use existing idle agents first (`herdr agent list`). When spawning new agents, batch pane creation and agent startup in a single script block rather than multi-turn polling.
|
|
74
|
+
- **Cross-Model Path (Herdr Multiplexing)**: When `$env:HERDR_ENV = "1"`, orchestrate peer models across distinct families (Claude, Codex/GPT, Gemini, GLM, Hunyuan, MiMo, or any live model in `config/models.json` / `config/agents.json`) natively using the `herdr` skill. Re-use existing idle agents first (`herdr agent list`). When spawning new agents, batch pane creation and agent startup in a single script block rather than multi-turn polling.
|
|
74
75
|
- **Graceful Fallback (Stateless Goldfish Subagent)**: If outside Herdr or peer agents are unavailable, spawn a fresh child subagent on the **same native harness and model** (e.g. `invoke_subagent` in Antigravity, Agent tool in Claude Code) with zero conversation history. The Goldfish isolation invariant is strictly preserved.
|
|
75
76
|
|
|
76
77
|
6. **Modular Plan Decomposition & Specification**:
|
package/agents/reviewer.md
CHANGED
|
@@ -43,7 +43,7 @@ Project-specific review guidelines take absolute precedence over general stylist
|
|
|
43
43
|
|
|
44
44
|
### Step 2: Adaptive Execution Engine (Herdr Multiplexing vs. Same-Model Fallback)
|
|
45
45
|
Check if running inside Herdr (`$env:HERDR_ENV = "1"`):
|
|
46
|
-
- **When in Herdr**: Dispatch cross-
|
|
46
|
+
- **When in Herdr**: Dispatch cross-family blinded reviews directly via native Herdr commands (`herdr agent prompt <reviewer-agent> "..." --wait`) using a distinct model family from `config/models.json` / `config/agents.json` (e.g., Anthropic, Google, OpenAI, GLM, Hunyuan, MiMo) to achieve genuine multi-model adversarial validation.
|
|
47
47
|
- **When NOT in Herdr / Unavailable**: Gracefully fall back to spawning a fresh child subagent on the **same model / native harness** (e.g., `invoke_subagent` in Antigravity, Agent tool in Claude Code) with zero parent conversation context. The stateless Goldfish invariant is strictly preserved either way.
|
|
48
48
|
|
|
49
49
|
### Step 3: Stateless Context Blinding
|