@hybridlabor-api/aos 4.11.0 → 4.12.1
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.de.md +296 -725
- package/README.md +294 -831
- package/README.pt.md +316 -677
- package/bin/aos-store.mjs +29 -59
- package/installer.js +39 -2
- package/lib/ecc-store-index.json +1 -1
- package/lib/store-shared.mjs +133 -0
- package/lib/store-ui/index.html +150 -0
- package/lib/store-ui/server.mjs +180 -0
- package/package.json +2 -2
- package/scripts/build-ecc-store-index.mjs +17 -1
- package/scripts/build-plugin-manifest.mjs +3 -3
- package/skills/bdb-aos/SKILL.md +46 -0
- package/skills/global_config/aos-store/SKILL.md +71 -0
package/README.pt.md
CHANGED
|
@@ -1,818 +1,457 @@
|
|
|
1
1
|
|
|
2
2
|
|
|
3
|
-
🌐 **
|
|
3
|
+
🌐 **Language / Sprache / Idioma**: [ 🇬🇧 English ](README.md) | [ 🇩🇪 Deutsch ](README.de.md) | **Português**
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
```text
|
|
8
|
-
█████▄ ████▄ █████▄ ▄████▄ ▄████ ██████ ███ ██ ██████ ▄████▄ ▄█████
|
|
9
|
-
██▄▄██ ██ ██ ██▄▄██ ██▄▄██ ██ ▄▄▄ ██▄▄ ██ ▀▄██ ██ ██ ██ ▀▀▀▄▄▄
|
|
10
|
-
██▄▄█▀ ████▀ ██▄▄█▀ ██ ██ ▀███▀ ██▄▄▄▄ ██ ██ ██ ▀████▀ █████▀
|
|
11
|
-
|
|
12
|
-
──────────────────────────── N O D E F O R G E ─────────────────────────────
|
|
13
|
-
|
|
14
|
-
BDB AGENT OS · CORE KERNEL · AOS - v4.0.0
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
# 🚀 AOS — BDB Agent OS · Pacote Otimizado de Skills Criativas e Full-Stack
|
|
5
|
+
# AOS — BDB Agent OS
|
|
18
6
|
|
|
19
|
-
[](https://github.com/hybridlabor-api/aos/actions)
|
|
20
7
|
[](https://www.npmjs.com/package/@hybridlabor-api/aos)
|
|
21
|
-
[](https://www.npmjs.com/package/@hybridlabor-api/aos)
|
|
9
|
+
[](https://github.com/hybridlabor-api/aos/stargazers)
|
|
10
|
+
[](https://github.com/hybridlabor-api/aos/commits/main)
|
|
11
|
+
[](https://github.com/hybridlabor-api/aos/actions)
|
|
22
12
|
[](LICENSE)
|
|
23
|
-
[](package.json)
|
|
14
|
+
[](#skills)
|
|
15
|
+
[](#servidores-mcp)
|
|
16
|
+
[](#harnesses-suportados)
|
|
24
17
|
[](https://github.com/NVIDIA/SkillSpector)
|
|
25
18
|
|
|
26
|
-
|
|
19
|
+
AOS instala uma biblioteca de skills curada, um roster de subagentes, hooks de portão e um pipeline multi-agente executável em todos os harnesses de agentes de código da sua máquina.
|
|
27
20
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
> 🎙 **Audio Deep Dive: "Give AI Agents Control of Creative Software"**
|
|
33
|
-
> <video src="assets/Give_AI_Agents_Control_of_Creative_Software.mp4" controls></video>
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
### 🔨 O que muda na v4.0.0 "AOS"
|
|
38
|
-
|
|
39
|
-
Este release move o pipeline multi-agente de prosa para uma máquina de estado executável e fortalece o instalador ao seu redor.
|
|
40
|
-
|
|
41
|
-
- **Um grafo dispatcher que realmente executa.** Sete nós, predicados de aresta explícitos, um loop de reparo do Revisor com guarda contra falta de progresso e escalonamento automático para um humano quando o loop para de progredir. [Detalhes abaixo](#-aos-o-grafo-dispatcher).
|
|
42
|
-
- **Três variantes de pipeline** (`/startcycle`, `/startcycle-graph`, `/startcycle-graph-user`) para que o maquinário corresponda à tarefa em vez de forçar cerimônia completa em uma alteração de dois arquivos.
|
|
43
|
-
- **Um portão GO imposto mecanicamente.** `git push`, `npm publish`, `npm version` e `rm` recursivo são bloqueados por um hook `PreToolUse` a menos que sua mensagem imediatamente anterior seja literalmente a palavra **GO** — fiscalização que sobrevive a alterações de modo de permissão, pois é um hook em vez de uma regra que o agente deve seguir.
|
|
44
|
-
- **Inicialização de daemon verificada.** O instalador não relata mais "serviço iniciado" por fé; ele conecta à porta e avisa se o daemon nunca subir. O mesmo para a tabela de status do ecossistema, que agora compara versões com precedência semver real em cada dist-tag em vez de desigualdade de strings contra `latest`.
|
|
45
|
-
- **Stores MCP separados por harness.** Claude Desktop e Claude Code leem arquivos diferentes; a instalação para um não pula mais silenciosamente o outro. Servidores existentes em ambos os arquivos são mesclados, não sobrescritos.
|
|
46
|
-
- **Instalações programáveis, não interativas.** `--platforms=<n[,n]>` seleciona alvos sem o menu, para que uma máquina que apenas roda Claude Code possa ser provisionada em CI sem herdar o padrão focado no Antigravity.
|
|
47
|
-
|
|
48
|
-
### 🪐 Universal Agent Harness
|
|
49
|
-
O instalador agora possui um motor Universal Sync totalmente automatizado. Ele varre seu sistema em busca do **Claude Desktop, Cursor, Windsurf, Aider, Roo/Cline** e injeta a configuração MCP curada e as regras de Godmode em todos os ambientes simultaneamente.
|
|
50
|
-
- **Local Project Harness:** Em vez de instalar globalmente em `$HOME`, os desenvolvedores podem injetar o contrato `.agents`, os hooks de portão e o workflow do dispatcher diretamente em um único projeto — `npx @hybridlabor-api/aos --project-harness`.
|
|
51
|
-
|
|
52
|
-
### 🧩 Integrações do Ecossistema
|
|
53
|
-
Este pacote atua como a ponte para quatro grandes capacidades upstream:
|
|
54
|
-
- **BDB AO — Agent Orchestrator:** A camada de orquestração para agentes de IA paralelos. Inicie múltiplas sessões de agentes isoladas via Git-Worktrees com controle de terminal ao vivo, loops de feedback CI/CD automáticos e roteamento de revisão de PR. Envia um binário pré-compilado hoje (macOS, Apple Silicon); outras plataformas compilam a partir do código-fonte. Substitui o agora arquivado repositório `bdb-os-agent-workspace` — não instale o antigo.
|
|
55
|
-
- **BDB Creator Extension:** O pipeline de mídia agêntica de alta capacidade. Fornece aos agentes capacidades MCP locais do ComfyUI (FLUX, SDXL), geração Image-to-3D (TripoSR, TRELLIS) e produção de vídeo automatizada através do OpenMontage e Remotion.
|
|
56
|
-
- **BDB Synapse:** Visualização de Codebase 3D & Replay de Sessões de Agentes. Renderiza seu repositório como uma cidade de código interativa e repete as sessões de agentes como rastros de luz, mostrando quais arquivos foram lidos, editados e onde ocorreu atrito.
|
|
57
|
-
- **BDB Hardware & PCB:** Módulo de design elétrico/PCB opcional. Dois servidores MCP locais (KiCad, OpenSCAD) expondo 55 ferramentas, mais 5 skills cobrindo captura de esquemas, layout/roteamento e aprovação DFM. Instale de forma isolada ou através do seletor de módulo opcional do instalador; acoplado com a persona central `godmode-hardware-pcb`.
|
|
58
|
-
|
|
59
|
-
### 🔗 Plugins Complementares Recomendados (Claude Code)
|
|
60
|
-
Nenhum destes vem dentro deste pacote — são plugins do Claude Code independentes e mantidos pela comunidade que combinam naturalmente com o padrão de delegação `agy` que o [`/startcycle-graph-user`](#-aos-o-grafo-dispatcher) já usa. Instale-os separadamente se quiser o mesmo roteamento disponível fora de uma execução `/startcycle`.
|
|
61
|
-
|
|
62
|
-
- **[antigravity-for-claude-code](https://github.com/yuting0624/antigravity-for-claude-code)**
|
|
63
|
-
— executa a CLI do Antigravity (`agy`, Gemini) como um sub-agente colaborador com roteamento de modelo inteligente em todo o ciclo de vida de software (SDLC).
|
|
64
|
-
```bash
|
|
65
|
-
claude plugin marketplace add yuting0624/antigravity-for-claude-code
|
|
66
|
-
claude plugin install antigravity@antigravity-for-claude-code
|
|
67
|
-
```
|
|
68
|
-
- **[opencode-plugin-cc](https://github.com/tasict/opencode-plugin-cc)** — adiciona
|
|
69
|
-
comandos slash `/opencode:review` / `/opencode:adversarial-review`, permitindo que o Claude Code
|
|
70
|
-
delegue um trabalho assíncrono para o OpenCode e configure um portão de revisão que bloqueia o progresso até que
|
|
71
|
-
a revisão do OpenCode retorne limpa.
|
|
72
|
-
```bash
|
|
73
|
-
claude plugin marketplace add https://github.com/tasict/opencode-plugin-cc.git
|
|
74
|
-
claude plugin install opencode@tasict-opencode-plugin-cc
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
> [!CAUTION]
|
|
78
|
-
> Se você também tiver um marketplace `antigravity-plugin-cc` antigo instalado, desative-o e
|
|
79
|
-
> limpe o cache de plugins primeiro — dois plugins de roteamento `agy` ativos ao mesmo tempo causam um conflito de ativação dupla onde nenhum inicializa de forma limpa.
|
|
80
|
-
|
|
81
|
-
## Visão Geral
|
|
82
|
-
|
|
83
|
-
Este repositório entrega três coisas: uma biblioteca curada de skills para agentes de código, um
|
|
84
|
-
instalador que conecta eles (mais 19 wrappers MCP locais) em qualquer harness
|
|
85
|
-
que você use, e um grafo dispatcher que os orquestra como um pipeline de
|
|
86
|
-
build multi-agente. Veja [AOS: O Grafo Dispatcher](#-aos-o-grafo-dispatcher)
|
|
87
|
-
abaixo para entender como o próprio pipeline funciona.
|
|
88
|
-
|
|
89
|
-
## 🌟 184 Skills Otimizadas
|
|
90
|
-
|
|
91
|
-
Começamos com um conjunto massivo de mais de 1.400 skills de IA brutas. Após rigorosos testes, filtragem e refinamento, destilamo-las em um conjunto hipercurado de **184 Skills Otimizadas** (apresentando um motor nativo de documentação OpenWiki, o **cérebro de memória semântica local memB** e agora a **sincronização Universal Agent Harness na v4.0.0**).
|
|
92
|
-
|
|
93
|
-
Essas skills são projetadas com precisão para garantir que os agentes não percam tempo com tarefas redundantes e, em vez disso, operem com máxima autonomia, restrições arquitetônicas rígidas e robusta consciência de contexto.
|
|
94
|
-
|
|
95
|
-
### 🛡️ Os 7 Godmodes (Camada Apex)
|
|
96
|
-
Em vez de deixar os agentes vagando por instruções genéricas, o nível superior deste repositório impõe sete **Godmodes Hipercurados**. Eles atuam como os guardiões definitivos para sua base de código:
|
|
97
|
-
- **`godmode-engineering`**: Impõe Domain-Driven Design, verificações rígidas de TypeScript, Clean Architecture e depuração sistemática.
|
|
98
|
-
- **`godmode-ui-ux`**: O padrão de ouro do frontend. Impõe princípios "Anti-Slop" da BDB, acessibilidade e dinâmicas de movimento fluidas.
|
|
99
|
-
- **`godmode-shipping`**: O guardião final para lançamentos em produção. Impõe Spec-Driven Development, verificações pré-lançamento e rollbacks seguros.
|
|
100
|
-
- **`godmode-eventtech`**: O livro de regras supremo para o BDB Creator Engine, governando 3D, Mídia e 19 wrappers MCP de tecnologia criativa.
|
|
101
|
-
- **`godmode-3d-creation`**: Controla o pipeline 3D agêntico (TripoSR, TRELLIS) para modelos generativos e estruturas CAD.
|
|
102
|
-
- **`godmode-media-creation`**: Orquestra a produção automatizada de vídeo, narrativa e loops de geração do ComfyUI.
|
|
103
|
-
|
|
104
|
-
### 💻 Além dos Eventos: Agentes Web & Software Full-Stack
|
|
105
|
-
Embora fortemente otimizado para a indústria de tecnologia criativa, estas skills estão profundamente enraizadas na engenharia de software central:
|
|
106
|
-
- **Operações Web Autônomas**: Suíte completa de agentes especializados movidos a Firecrawl para extração estruturada de dados, interação web automatizada e operações complexas de scraping.
|
|
107
|
-
- **Desenvolvimento Full-Stack**: Criação de boilerplates Next.js App Router, construção de microsserviços Node.js escaláveis e desenvolvimento de frontends interativos.
|
|
108
|
-
- **Desenvolvimento de Aplicações**: Arquitetura de bancos de dados com Prisma/Drizzle, design de APIs REST/GraphQL e construção de aplicações web e mobile do zero.
|
|
109
|
-
- **Design & Garantia de Qualidade**: Auditoria de padrões de UI/UX (utilizando `ui-ux-pro-max`), aplicação de princípios de código limpo e configuração de pipelines CI/CD rígidos.
|
|
21
|
+
```bash
|
|
22
|
+
npx -y @hybridlabor-api/aos@latest
|
|
23
|
+
```
|
|
110
24
|
|
|
111
|
-
|
|
25
|
+
Construído para pessoas que já executam **Claude Code, Google Antigravity, Codex CLI, OpenCode, Cursor, Windsurf, Roo Code / Cline ou Aider** e querem que todos eles se comportem da mesma forma.
|
|
112
26
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
Abaixo está a visão geral completa de todas as skills curadas de agentes incluídas neste pacote. Elas são implantadas automaticamente na área de trabalho do seu agente pelo instalador interativo.
|
|
116
|
-
|
|
117
|
-
<details>
|
|
118
|
-
<summary><strong>👑 Core Godmodes</strong></summary>
|
|
119
|
-
|
|
120
|
-
| Nome da Skill | Descrição |
|
|
121
|
-
|------------|-------------|
|
|
122
|
-
| `godmode-3d-creation` | Skill mestre de orquestração para todas as tarefas de geração, modelagem e reconstrução 3D. Atua como o cérebro 3D para a BDB Creator Extension. |
|
|
123
|
-
| `godmode-engineering` | BDB Engineering Godmode. Impõe Domain-Driven Design rigoroso, estrito TypeScript, Clean Architecture e triagem sistemática de depuração em 5 etapas. |
|
|
124
|
-
| `godmode-eventtech` | BDB EventTech Godmode. O livro de regras supremo para o BDB Creator Engine, governando Godmode-3D, Godmode-Media e os 19 wrappers MCP de tecnologia criativa. |
|
|
125
|
-
| `godmode-media-creation` | Skill mestre de orquestração para todas as tarefas de criação de mídia (Vídeo, Áudio, Imagem, Motion Design). Atua como o cérebro para a BDB Creator Extension. |
|
|
126
|
-
| `godmode-shipping` | BDB Shipping Godmode. O guardião final para lançamentos em produção. Impõe Spec-Driven Development, rigorosas verificações pré-lançamento, feature flags e estratégias de rollback. |
|
|
127
|
-
| `godmode-ui-ux` | BDB UI/UX Godmode. O padrão de ouro absoluto para design frontend. Impõe princípios Anti-Slop, acessibilidade corporativa, dinâmicas de movimento fluidas e geração de design orientada a dados em todos os harnesses de agentes. |
|
|
128
|
-
|
|
129
|
-
</details>
|
|
130
|
-
|
|
131
|
-
<details>
|
|
132
|
-
<summary><strong>⚙️ Sistema & Configuração</strong></summary>
|
|
133
|
-
|
|
134
|
-
#### 🤖 Agentes & Automação
|
|
135
|
-
| Nome da Skill | Descrição |
|
|
136
|
-
|------------|-------------|
|
|
137
|
-
| `agent-manager-skill` | Gerencia múltiplos agentes CLI locais via sessões tmux (iniciar/parar/monitorar/atribuir) com agendamento amigável para cron. |
|
|
138
|
-
| `agent-memory-mcp` | Um sistema de memória híbrida que fornece gerenciamento de conhecimento persistente e pesquisável para agentes de IA (Arquitetura, Padrões, Decisões). |
|
|
139
|
-
| `agent-orchestrator` | Meta-skill que orquestra todos os agentes do ecossistema. Scan automatico de skills, match por capacidades, coordenacao de workflows multi-skill e registry management. |
|
|
140
|
-
| `agent-pipeline` | Referência para o ciclo de vida do BDB (define → plan → build → verify/review → ship) que o grafo dispatcher do `/startcycle-graph` realmente executa. |
|
|
141
|
-
| `agent-tool-builder` | Ferramentas são como os agentes de IA interagem com o mundo. Uma ferramenta bem projetada é a diferença entre um agente que funciona e um que alucina, falha silenciosamente ou custa 10x mais tokens do que o necessário. Esta skill abrange o design de ferramentas desde o esquema até o tratamento de erros. |
|
|
142
|
-
| `ai-agent-development` | Fluxo de trabalho de desenvolvimento de agentes de IA para construir agentes autônomos, sistemas multi-agentes e orquestração de agentes com CrewAI, LangGraph e agentes personalizados. |
|
|
143
|
-
| `apify-lead-generation` | Raspar leads de múltiplas plataformas usando Apify Actors. |
|
|
144
|
-
| `apify-ultimate-scraper` | Extração de dados orientada por IA de mais de 55 Actors nas principais plataformas. Esta skill seleciona automaticamente o melhor Actor para a sua tarefa. |
|
|
145
|
-
| `bdbrainstorm` | Combina brainstorming multi-agente, o comando slash /grill-me, subagent-driven-development e ui-ux-pro-max para forçar um fluxo de trabalho abrangente de ideação multi-agente e design de UI/UX. |
|
|
146
|
-
| `browser-automation` | A automação de navegador potencializa testes web, raspagem e interações de agentes de IA. A diferença entre um script instável e um sistema confiável se resume a entender seletores, estratégias de espera e padrões anti-detecção. |
|
|
147
|
-
| `crewai` | Especialista em CrewAI - o principal framework multi-agente baseado em funções usado por 60% das empresas Fortune 500. |
|
|
148
|
-
| `documentation` | Fluxo de trabalho de geração de documentação abrangendo docs de API, docs de arquitetura, arquivos README, comentários de código e escrita técnica. |
|
|
149
|
-
| `git-advanced-workflows` | Domine técnicas avançadas de Git para manter um histórico limpo, colaborar efetivamente e se recuperar de qualquer situação com confiança. |
|
|
150
|
-
| `github-actions-templates` | Padrões de fluxo de trabalho do GitHub Actions prontos para produção para testar, compilar e implantar aplicações. |
|
|
151
|
-
| `github-repo` | Padrões e fluxos de trabalho para escrever, formatar, higienizar e publicar repositórios GitHub de alta qualidade, complementando a skill openwiki-skill. |
|
|
152
|
-
| `github-workflow-automation` | Padrões para automatizar fluxos de trabalho do GitHub com assistência de IA, inspirados pelo [Gemini CLI](https://github.com/google-gemini/gemini-cli) e práticas modernas de DevOps. |
|
|
153
|
-
| `go-playwright` | Capacidade especialista para automação de navegador robusta, furtiva e eficiente usando Playwright Go. |
|
|
154
|
-
| `n8n-code-javascript` | Escreva código JavaScript em nós Code do n8n. Use ao escrever JavaScript no n8n, usando sintaxe $input/$json/$node, fazendo requisições HTTP com $helpers, trabalhando com datas usando DateTime, solucionando erros de nó Code, ou escolhendo entre modos de nó Code. |
|
|
155
|
-
| `n8n-code-python` | Escreva código Python em nós Code do n8n. Use ao escrever Python no n8n, usando sintaxe _input/_json/_node, trabalhando com a biblioteca padrão, ou quando precisar entender as limitações do Python em nós Code do n8n. |
|
|
156
|
-
| `n8n-expression-syntax` | Valide a sintaxe de expressões n8n e corrija erros comuns. Use ao escrever expressões n8n, usando sintaxe {{}}, acessando variáveis $json/$node, solucionando erros de expressão, ou trabalhando com dados de webhook em fluxos de trabalho. |
|
|
157
|
-
| `n8n-mcp-tools-expert` | Guia especialista para usar ferramentas MCP n8n-mcp de forma eficaz. Use ao procurar nós, validar configurações, acessar templates, gerenciar fluxos de trabalho, ou usar qualquer ferramenta n8n-mcp. Fornece orientação de seleção de ferramentas, formatos de parâmetros e padrões comuns. |
|
|
158
|
-
| `n8n-workflow-patterns` | Padrões arquiteturais comprovados para construir fluxos de trabalho n8n. |
|
|
159
|
-
| `notion-automation` | Automatize tarefas do Notion via Rube MCP (Composio): páginas, bancos de dados, blocos, comentários, usuários. Sempre pesquise nas ferramentas primeiro para obter esquemas atuais. |
|
|
160
|
-
| `os-scripting` | Fluxo de trabalho de solução de problemas de sistema operacional e shell scripting para Linux, macOS e Windows. Abrange bash scripting, administração de sistemas, depuração e automação. |
|
|
161
|
-
| `rag-implementation` | Fluxo de trabalho de implementação de RAG (Retrieval-Augmented Generation) cobrindo seleção de embeddings, configuração de banco de dados vetorial, estratégias de chunking e otimização de recuperação. |
|
|
162
|
-
| `slack-automation` | Automatize operações do workspace Slack incluindo mensagens, busca, gerenciamento de canais e fluxos de trabalho de reações através do toolkit Slack da Composio. |
|
|
163
|
-
| `subagent-driven-development` | Use ao executar planos de implementação com tarefas independentes na sessão atual. |
|
|
164
|
-
| `tdd-workflow` | Princípios de fluxo de trabalho de Desenvolvimento Orientado a Testes (Test-Driven Development). Ciclo RED-GREEN-REFACTOR. |
|
|
165
|
-
| `tmux` | Especialista em gerenciamento de sessões, janelas e painéis tmux para multiplexação de terminal, fluxos de trabalho remotos persistentes e automação de shell scripting. |
|
|
166
|
-
|
|
167
|
-
#### 🎨 Frontend & UI/UX
|
|
168
|
-
| Nome da Skill | Descrição |
|
|
169
|
-
|------------|-------------|
|
|
170
|
-
| `mcp-manage` | Gerencia os servidores MCP especializados da BDB incluindo Unreal Engine, Rhino 7/8, DaVinci Resolve, grandMA3, Resolume, GitHub, Chrome DevTools e TouchDesigner. |
|
|
171
|
-
| `api-design-principles` | Domine princípios de design de API REST e GraphQL para construir APIs intuitivas, escaláveis e de fácil manutenção que encantam os desenvolvedores e resistem ao teste do tempo. |
|
|
172
|
-
| `api-patterns` | Princípios de design de API e tomada de decisões. Seleção entre REST vs GraphQL vs tRPC, formatos de resposta, versionamento, paginação. |
|
|
173
|
-
| `database-design` | Princípios de design de banco de dados e tomada de decisões. Design de esquema, estratégia de indexação, seleção de ORM, bancos de dados serverless. |
|
|
174
|
-
| `design-taste-frontend` | Use ao construir interfaces frontend de alta agência com gosto de design rigoroso, cores calibradas, layout responsivo e regras de movimento. |
|
|
175
|
-
| `drizzle-orm-expert` | Especialista em Drizzle ORM para TypeScript — design de esquema, consultas relacionais, migrações e integração de banco de dados serverless. Use ao construir camadas de banco de dados type-safe com Drizzle. |
|
|
176
|
-
| `frontend-design` | Você é um engenheiro-designer frontend, não um gerador de layouts. |
|
|
177
|
-
| `frontend-dev-guidelines` | Você é um engenheiro frontend sênior operando sob rigorosos padrões arquiteturais e de desempenho. Use ao criar componentes ou páginas, adicionar novas features, ou buscar e mutar dados. |
|
|
178
|
-
| `landing-page-generator` | Gera landing pages de alta conversão Next.js/React com Tailwind CSS. Usa frameworks PAS, AIDA e BAB para copy/componentes otimizados (Heroes, Features, Pricing). Foca em Core Web Vitals/SEO. |
|
|
179
|
-
| `llm-application-dev-ai-assistant` | Você é um especialista em desenvolvimento de assistentes de IA especializado em criar interfaces conversacionais inteligentes, chatbots e aplicações movidas a IA. Crie soluções de assistente de IA abrangentes com natur |
|
|
180
|
-
| `nextjs-app-router-patterns` | Padrões abrangentes para arquitetura Next.js 14+ App Router, Server Components e desenvolvimento full-stack React moderno. |
|
|
181
|
-
| `nextjs-best-practices` | Princípios do Next.js App Router. Server Components, busca de dados, padrões de roteamento. |
|
|
182
|
-
| `openapi-spec-generation` | Gere e mantenha especificações OpenAPI 3.1 a partir de código, especificações design-first e padrões de validação. Use ao criar documentação de API, gerar SDKs ou garantir conformidade com contratos de API. |
|
|
183
|
-
| `postgres-best-practices` | Otimização de desempenho e melhores práticas de Postgres da Supabase. Use esta skill ao escrever, revisar ou otimizar consultas Postgres, designs de esquema ou configurações de banco de dados. |
|
|
184
|
-
| `postgresql` | Projete um esquema específico para PostgreSQL. Abrange melhores práticas, tipos de dados, indexação, restrições, padrões de desempenho e recursos avançados. |
|
|
185
|
-
| `prisma-expert` | Você é um especialista em Prisma ORM com profundo conhecimento em design de esquemas, migrações, otimização de consultas, modelagem de relações e operações de banco de dados em PostgreSQL, MySQL e SQLite. |
|
|
186
|
-
| `programmatic-seo` | Projete e avalie estratégias de programmatic SEO para criar páginas orientadas a SEO em escala usando templates e dados estruturados. |
|
|
187
|
-
| `react-best-practices` | Guia abrangente de otimização de desempenho para aplicações React e Next.js, mantido pela Vercel. Use ao escrever novos componentes React ou páginas Next.js, implementar busca de dados (client ou server-side), ou revisar código em busca de problemas de desempenho. |
|
|
188
|
-
| `react-component-performance` | Diagnostique componentes React lentos e sugira correções de desempenho direcionadas. |
|
|
189
|
-
| `react-patterns` | Padrões e princípios modernos do React. Hooks, composição, desempenho, melhores práticas de TypeScript. |
|
|
190
|
-
| `schema-markup` | Projete, valide e otimize dados estruturados schema.org para elegibilidade, correção e impacto de SEO mensurável. |
|
|
191
|
-
| `senior-frontend` | Skill de desenvolvimento frontend para aplicações React, Next.js, TypeScript e Tailwind CSS. Use ao construir componentes React, otimizar desempenho Next.js, analisar tamanhos de bundle, criar boilerplates de projetos frontend, implementar acessibilidade ou revisar a qualidade do código frontend. |
|
|
192
|
-
| `shadcn` | Gerencia componentes e projetos shadcn/ui, fornecendo contexto, documentação e padrões de uso para construir sistemas de design modernos. |
|
|
193
|
-
| `software-architecture` | Guia para arquitetura de software focada em qualidade. Esta skill deve ser usada quando os usuários quiserem escrever código, projetar arquitetura, analisar código, em qualquer caso relacionado ao desenvolvimento de software. |
|
|
194
|
-
| `spline-3d-integration` | Use ao adicionar cenas 3D interativas do Spline.design a projetos web, incluindo incorporação React e API de controle de tempo de execução. |
|
|
195
|
-
| `tailwind-patterns` | Princípios do Tailwind CSS v4. Configuração CSS-first, container queries, padrões modernos, arquitetura de design tokens. |
|
|
196
|
-
| `tanstack-query-expert` | Especialista em TanStack Query (React Query) — gerenciamento de estado assíncrono. Abrange busca de dados, configuração de tempo de expiração (stale time), mutações, atualizações otimistas e integração com Next.js App Router (SSR). |
|
|
197
|
-
| `ui-component` | Gere um novo componente de UI que siga as convenções do StyleSeed Toss para estrutura, tokens, acessibilidade e ergonomia de componente. |
|
|
198
|
-
| `ui-page` | Crie a estrutura de uma nova página mobile-first usando padrões de layout do StyleSeed Toss, ritmo de seção e componentes de shell existentes. |
|
|
199
|
-
| `ui-pattern` | Gere padrões de UI reutilizáveis como seções de cartões, grades, listas, formulários e invólucros de gráficos usando primitivos do StyleSeed Toss. |
|
|
200
|
-
| `ui-review` | Revise o código de UI quanto à conformidade com o sistema de design StyleSeed, acessibilidade, ergonomia mobile, disciplina de espaçamento e qualidade de implementação. |
|
|
201
|
-
| `ui-tokens` | Liste, adicione e atualize design tokens StyleSeed mantendo fontes JSON, variáveis CSS e valores de modo escuro perfeitamente sincronizados. |
|
|
202
|
-
| `ui-ux-pro-max` | Guia de design abrangente para aplicações web e mobile. Use ao projetar novos componentes de UI ou páginas, escolher paletas de cores e tipografia, ou revisar código em busca de problemas de UX. |
|
|
203
|
-
| `ux-audit` | Audite telas em relação às heurísticas de Nielsen e melhores práticas de UX mobile usando a linguagem de design StyleSeed Toss como contexto de implementação. |
|
|
204
|
-
| `ux-feedback` | Adicione estados de feedback de carregamento, vazio, erro e sucesso a componentes e páginas StyleSeed com regras práticas mobile-first. |
|
|
205
|
-
| `ux-flow` | Projete fluxos de usuários e estrutura de tela usando padrões de UX StyleSeed como divulgação progressiva, navegação hub-and-spoke e pirâmides de informação. |
|
|
206
|
-
| `ux-persuasion-engineer` | Uma frase - o que esta skill faz e quando invocá-la. |
|
|
207
|
-
| `vercel-ai-sdk-expert` | Especialista no Vercel AI SDK. Abrange Core API (generateText, streamText), hooks de UI (useChat, useCompletion), chamada de ferramentas e streaming de componentes de UI com React e Next.js. |
|
|
208
|
-
| `wcag-audit-patterns` | Guia abrangente para auditar conteúdo web contra diretrizes WCAG 2.2 com estratégias de remediação acionáveis. |
|
|
209
|
-
| `web-artifacts-builder` | Para construir artefatos frontend claude.ai poderosos, siga estes passos: |
|
|
210
|
-
| `zustand-store-ts` | Crie stores Zustand seguindo padrões estabelecidos com tipos TypeScript adequados e middlewares. |
|
|
211
|
-
|
|
212
|
-
#### 🗄️ Backend & Bancos de Dados
|
|
213
|
-
| Nome da Skill | Descrição |
|
|
214
|
-
|------------|-------------|
|
|
215
|
-
| `gemini-api-dev` | A Gemini API fornece acesso aos modelos de IA mais avançados do Google. As principais capacidades incluem: |
|
|
216
|
-
| `gemini-api-integration` | Use ao integrar a Google Gemini API em projetos. Abrange seleção de modelo, entradas multimodais, streaming, chamadas de função e melhores práticas de produção. |
|
|
217
|
-
| `github` | Use a CLI `gh` para issues, pull requests, execuções do Actions e consultas à GitHub API. |
|
|
218
|
-
| `go-concurrency-patterns` | Domine simultaneidade Go com goroutines, canais, primitivas sync e contexto. Use ao construir aplicações Go simultâneas, implementar pools de trabalhadores ou depurar condições de corrida. |
|
|
219
|
-
| `golang-pro` | Domine Go 1.22+ com padrões modernos, simultaneidade avançada, otimização de desempenho e microsserviços prontos para produção. |
|
|
220
|
-
| `llm-structured-output` | Obtenha JSON, enums e objetos tipados confiáveis de LLMs usando response_format, tool_use e decodificação com restrição de esquema em APIs OpenAI, Anthropic e Google. |
|
|
221
|
-
| `microservices-patterns` | Domine padrões de arquitetura de microsserviços incluindo limites de serviço, comunicação inter-serviços, gerenciamento de dados e padrões de resiliência para construir sistemas distribuídos. |
|
|
222
|
-
| `neon-postgres` | Padrões especialistas para Postgres serverless Neon, branching, pool de conexões e integração Prisma/Drizzle. |
|
|
223
|
-
| `python-patterns` | Princípios de desenvolvimento em Python e tomada de decisões. Seleção de framework, padrões assíncronos, dicas de tipo (type hints), estrutura de projeto. Ensina a pensar, não a copiar. |
|
|
224
|
-
| `python-performance-optimization` | Faça perfil e otimize código Python usando cProfile, profilers de memória e melhores práticas de desempenho. Use ao depurar código Python lento, otimizar gargalos ou melhorar o desempenho de aplicações. |
|
|
225
|
-
| `python-pro` | Domine Python 3.12+ com recursos modernos, programação assíncrona, otimização de desempenho e práticas prontas para produção. Especialista no ecossistema Python mais recente, incluindo uv, ruff, pydantic e FastAPI. |
|
|
226
|
-
| `rag-engineer` | Especialista em construir sistemas de Retrieval-Augmented Generation. Domina modelos de embedding, bancos de dados vetoriais, estratégias de chunking e otimização de recuperação para aplicações LLM. |
|
|
227
|
-
| `using-neon` | Neon é uma plataforma Postgres serverless que separa computação e armazenamento para oferecer dimensionamento automático, ramificação (branching), restauração instantânea e scale-to-zero. É totalmente compatível com Postgres e funciona com qualquer linguagem, framework ou ORM que suporte Postgres. |
|
|
228
|
-
| `vector-database-engineer` | Especialista em bancos de dados vetoriais, estratégias de embedding e implementação de busca semântica. Domina Pinecone, Weaviate, Qdrant, Milvus e pgvector para aplicações RAG, sistemas de recomendação e similares. |
|
|
229
|
-
| `web-scraper` | Web scraping inteligente multi-estrategia. Extrai dados estruturados de paginas web (tabelas, listas, precos). Paginacao, monitoramento e export CSV/JSON. |
|
|
230
|
-
| `webapp-testing` | Para testar aplicações web locais, escreva scripts nativos Python Playwright. |
|
|
231
|
-
|
|
232
|
-
#### 🚀 DevOps & Infraestrutura
|
|
233
|
-
| Nome da Skill | Descrição |
|
|
234
|
-
|------------|-------------|
|
|
235
|
-
| `bash-linux` | Padrões de terminal Bash/Linux. Comandos críticos, pipes, tratamento de erros, scripts. Use ao trabalhar em sistemas macOS ou Linux. |
|
|
236
|
-
| `cloudflare-workers-expert` | Especialista em Cloudflare Workers e ecossistema de Edge Computing. Abrange Wrangler, KV, D1, Durable Objects e armazenamento R2. |
|
|
237
|
-
| `docker-expert` | Você é um especialista avançado em conteinerização Docker com conhecimento prático e abrangente sobre otimização de contêineres, endurecimento de segurança, construções em múltiplas etapas, padrões de orquestração e estratégias de implantação em produção baseadas nas melhores práticas atuais da indústria. |
|
|
238
|
-
| `git-pr-review` | Gere uma descrição de PR concisa e estruturada a partir do histórico de commits com uso mínimo de tokens. |
|
|
239
|
-
| `llm-app-patterns` | Padrões prontos para produção para construir aplicações LLM, inspirados pelo [Dify](https://github.com/langgenius/dify) e pelas melhores práticas da indústria. |
|
|
240
|
-
| `local-llm-expert` | Domine a inferência LLM local, seleção de modelo, otimização de VRAM e implantação local usando Ollama, llama.cpp, vLLM e LM Studio. Especialista em formatos de quantização (GGUF, EXL2) e privacidade em IA local. |
|
|
241
|
-
| `posix-shell-pro` | Especialista em scripts POSIX sh estritos para máxima portabilidade em sistemas tipo Unix. Especializa-se em shell scripts que rodam em qualquer shell compatível com POSIX (dash, ash, sh, bash --posix). |
|
|
242
|
-
| `turborepo-caching` | Configure o Turborepo para builds eficientes de monorepo com cache local e remoto. Use ao configurar Turborepo, otimizar pipelines de build ou implementar cache distribuído. |
|
|
243
|
-
| `vercel-deployment` | Conhecimento especialista para implantar na Vercel com Next.js. |
|
|
244
|
-
|
|
245
|
-
#### 🧠 IA & LLM
|
|
246
|
-
| Nome da Skill | Descrição |
|
|
247
|
-
|------------|-------------|
|
|
248
|
-
| `ai-product` | Todo produto será impulsionado por IA. A questão é se você o construirá direito ou lançará uma demo que desmorona em produção. |
|
|
249
|
-
| `llm-prompt-optimizer` | Use ao melhorar prompts para qualquer LLM. Aplica técnicas comprovadas de engenharia de prompt para aumentar a qualidade da saída, reduzir alucinações e cortar uso de tokens. |
|
|
250
|
-
| `openwiki-skill` | Integração nativa do Gemini com o OpenWiki para gerenciamento autônomo e de alta agência de documentação e manutenção de notas de lançamento (release notes). |
|
|
251
|
-
| `prompt-engineer` | Transforma prompts de usuário em prompts otimizados usando frameworks (RTF, RISEN, Chain of Thought, RODES, Chain of Density, RACE, RISE, STAR, SOAP, CLEAR, GROW). |
|
|
252
|
-
| `prompt-engineering-patterns` | Domine técnicas avançadas de engenharia de prompt para maximizar o desempenho, a confiabilidade e a controlabilidade do LLM. |
|
|
253
|
-
|
|
254
|
-
#### 📝 Documentação & Planejamento
|
|
255
|
-
| Nome da Skill | Descrição |
|
|
256
|
-
|------------|-------------|
|
|
257
|
-
| `architect-review` | Mestre arquiteto de software especializado em arquitetura moderna. |
|
|
258
|
-
| `concise-planning` | Use quando um usuário pede um plano para uma tarefa de código, para gerar um checklist claro, acionável e atômico. |
|
|
259
|
-
| `copywriting` | Escreva copy de marketing rigoroso e focado em conversão para landing pages e e-mails. Impõe confirmação breve e regras estritas de não-fabricação. |
|
|
260
|
-
| `deep-research` | Execute tarefas autônomas de pesquisa que planejam, buscam, leem e sintetizam informações em relatórios abrangentes. |
|
|
261
|
-
| `executing-plans` | Use quando você tiver um plano de implementação escrito para executar em uma sessão separada com checkpoints de revisão. |
|
|
262
|
-
| `linear-claude-skill` | Gerencie issues, projetos e equipes no Linear. |
|
|
263
|
-
| `memb-skill` | Motor de memória local de longo prazo da BDB (memB). Consulte, lembre-se e adapte preferências, arquiteturas de código e padrões de desenvolvedor entre tarefas. |
|
|
264
|
-
| `modern-javascript-patterns` | Guia abrangente para dominar os recursos modernos do JavaScript (ES6+), padrões de programação funcional e melhores práticas para escrever código limpo, sustentável e de alto desempenho. |
|
|
265
|
-
| `planning-with-files` | Trabalhe como o Manus: Use arquivos markdown persistentes como sua "memória de trabalho em disco". |
|
|
266
|
-
| `product-manager-toolkit` | Ferramentas e frameworks essenciais para o gerenciamento de produtos moderno, da descoberta à entrega. |
|
|
267
|
-
| `readme` | Você é um redator técnico especialista na criação de documentação abrangente de projetos. Seu objetivo é escrever um README.md que seja absurdamente completo — o tipo de documentação que você gostaria que todo projeto tivesse. |
|
|
268
|
-
| `test-driven-development` | Use ao implementar qualquer recurso ou correção de bug, antes de escrever o código de implementação. |
|
|
269
|
-
| `writing-plans` | Use quando você tiver uma especificação ou requisitos para uma tarefa de múltiplas etapas, antes de tocar no código. |
|
|
270
|
-
|
|
271
|
-
#### 🧊 3D & Motion
|
|
272
|
-
| Nome da Skill | Descrição |
|
|
273
|
-
|------------|-------------|
|
|
274
|
-
| `remotion` | Gere vídeos de passo a passo de projetos Stitch usando Remotion com transições suaves, zoom e sobreposições de texto. |
|
|
275
|
-
| `threejs-skills` | Crie cenas 3D, experiências interativas e efeitos visuais usando Three.js. Use quando o usuário solicitar gráficos 3D, experiências WebGL, visualizações 3D, animações ou elementos 3D interativos. |
|
|
276
|
-
|
|
277
|
-
#### 📈 SEO & Marketing
|
|
278
|
-
| Nome da Skill | Descrição |
|
|
279
|
-
|------------|-------------|
|
|
280
|
-
| `geo-fundamentals` | Otimização de Motor Generativo (Generative Engine Optimization) para motores de busca de IA (ChatGPT, Claude, Perplexity). |
|
|
281
|
-
| `seo` | Execute uma auditoria SEO ampla abrangendo SEO técnico, SEO on-page, schema, sitemaps, qualidade de conteúdo, prontidão para busca por IA e GEO. Use como a skill guarda-chuva quando o usuário pedir uma análise ou estratégia completa de SEO. |
|
|
282
|
-
| `seo-audit` | Diagnostique e audite problemas de SEO que afetam crawlability, indexação, classificações e desempenho orgânico. |
|
|
283
|
-
| `seo-technical` | Audite o SEO técnico abrangendo crawlability, indexabilidade, segurança, URLs, mobile, Core Web Vitals, dados estruturados, renderização JavaScript e sinais de plataforma relacionados como robots.txt e acesso de crawler de IA. |
|
|
284
|
-
|
|
285
|
-
#### 🔧 Programação Central & Depuração
|
|
286
|
-
| Nome da Skill | Descrição |
|
|
287
|
-
|------------|-------------|
|
|
288
|
-
| `clean-code` | Esta skill incorpora os princípios do "Clean Code" de Robert C. Martin (Uncle Bob). Use-a para transformar "código que funciona" em "código que é limpo". |
|
|
289
|
-
| `debugger` | Especialista em depuração de erros, falhas de teste e comportamentos inesperados. Use proativamente ao encontrar quaisquer problemas. |
|
|
290
|
-
| `playwright-skill` | IMPORTANTE - Resolução de Caminho: Esta skill pode ser instalada em locais diferentes (sistema de plugin, instalação manual, global ou específico do projeto). Antes de executar qualquer comando, determine o diretório da skill com base em onde você carregou este arquivo SKILL.md, e use esse caminho em todos os comandos abaixo. |
|
|
291
|
-
| `simplify-code` | Revise um diff para buscar clareza e simplificações seguras e, opcionalmente, aplique correções de baixo risco. |
|
|
292
|
-
| `systematic-debugging` | Use ao encontrar qualquer bug, falha de teste ou comportamento inesperado, antes de propor correções. |
|
|
293
|
-
| `typescript-pro` | Domine TypeScript com tipos avançados, generics e estrita segurança de tipos. Lida com sistemas de tipos complexos, decorators e padrões de nível corporativo. |
|
|
294
|
-
|
|
295
|
-
#### 📦 Outros Utilitários
|
|
296
|
-
| Nome da Skill | Descrição |
|
|
297
|
-
|------------|-------------|
|
|
298
|
-
| `bdb-updater` | Verifique proativamente e instale atualizações no pacote BDB Antigravity Skills via NPM. |
|
|
299
|
-
| `monorepo-management` | Construa monorepos eficientes e escaláveis que possibilitem compartilhamento de código, ferramentas consistentes e alterações atômicas em múltiplos pacotes e aplicações. |
|
|
300
|
-
| `obsidian-markdown` | Crie e edite Obsidian Flavored Markdown com wikilinks, embeds, callouts, propriedades e outras sintaxes específicas do Obsidian. Use ao trabalhar com arquivos .md no Obsidian, ou quando o usuário mencionar wikilinks, callouts, frontmatter, tags, embeds ou notas Obsidian. |
|
|
301
|
-
| `token-saver-config` | Motor de compressão de saída de janela de contexto para comandos CLI (60-99% de redução de tokens). |
|
|
302
|
-
| `web-performance-optimization` | Otimize o desempenho de sites e aplicações web, incluindo velocidade de carregamento, Core Web Vitals, tamanho de bundle, estratégias de cache e desempenho de tempo de execução. |
|
|
303
|
-
|
|
304
|
-
</details>
|
|
305
|
-
|
|
306
|
-
<details>
|
|
307
|
-
<summary><strong>🌀 Ecossistema & Metodologias BDB</strong></summary>
|
|
308
|
-
|
|
309
|
-
| Nome da Skill | Descrição |
|
|
310
|
-
|------------|-------------|
|
|
311
|
-
| `bdbmediastorm` | O motor definitivo para brainstorming tecnológico criativo e controle de shows. Orquestra a ideação multi-agente focada em fluxo de sinais, restrições de hardware, protocolos e integrações MCP da BDB. Agora rigorosamente governada pelos 3 Core Godmodes (engineering, ui-ux, shipping). |
|
|
312
|
-
| `bdbrainstorm` | Combina brainstorming multi-agente, o comando slash /grill-me e os 3 Core Godmodes (godmode-engineering, godmode-ui-ux, godmode-shipping) para forçar um fluxo de trabalho abrangente de ideação multi-agente e design técnico. |
|
|
313
|
-
| `github-repo` | Padrões e fluxos de trabalho para escrever, formatar, higienizar e publicar repositórios GitHub de alta qualidade, complementando a skill openwiki-skill. |
|
|
314
|
-
| `memb-ingest` | Varredura profunda e ingestão de arquivos de projeto (.md, .json, AGENTS.md, .openwiki) e logs de conversas passadas para o motor de memória vetorial local memB. |
|
|
315
|
-
|
|
316
|
-
</details>
|
|
317
|
-
|
|
318
|
-
<details>
|
|
319
|
-
<summary><strong>🔥 Agentes Especializados de Workspace</strong></summary>
|
|
320
|
-
|
|
321
|
-
#### 🤖 Agentes & Automação
|
|
322
|
-
| Nome da Skill | Descrição |
|
|
323
|
-
|------------|-------------|
|
|
324
|
-
| `firecrawl-agent` | Extração de dados autônoma alimentada por IA que navega em sites complexos e retorna JSON estruturado. Use esta skill quando o usuário quiser dados estruturados de sites, precisar extrair tabelas de preços, listagens de produtos, entradas de diretório ou qualquer dado como JSON com um esquema. Acionado por "extrair dados estruturados", "obter todos os produtos", "puxar informações de preços", "extrair como JSON" ou quando o usuário fornece um esquema JSON para dados do site. Mais poderoso que a raspagem simples para extração estruturada de múltiplas páginas. |
|
|
325
|
-
| `firecrawl-build-onboarding` | Adicione credenciais Firecrawl e configuração do SDK em um projeto. Use quando um aplicativo precisa de `FIRECRAWL_API_KEY`, quando um agente deve adicionar Firecrawl ao `.env`, quando o usuário deseja autenticar o Firecrawl para o código do aplicativo ou ao escolher a primeira documentação e SDK para uma nova integração Firecrawl. Esta skill inclui seu próprio fluxo de autenticação de navegador, portanto, não depende da skill de integração do site. |
|
|
326
|
-
| `firecrawl-build-search` | Integre o `/search` do Firecrawl em código de produto e fluxos de trabalho de agentes. Use quando um aplicativo precisar de descoberta antes da extração, quando a feature iniciar com uma query em vez de uma URL, ou quando o sistema precisar pesquisar na web e opcionalmente hidratar o conteúdo do resultado. |
|
|
327
|
-
|
|
328
|
-
#### 🗄️ Backend & Bancos de Dados
|
|
329
|
-
| Nome da Skill | Descrição |
|
|
330
|
-
|------------|-------------|
|
|
331
|
-
| `firecrawl-build` | Integre o Firecrawl no código de produto para scraping, crawling, buscas e interações web. Use esta skill quando uma aplicação precisar acessar dados web, extrair conteúdo ou automatizar interações web. |
|
|
332
|
-
| `firecrawl-build-interact` | Integre o `/interact` do Firecrawl em código de produto para páginas dinâmicas e ações de navegador após scraping. Use quando uma feature precisar de cliques, preenchimentos de formulário, paginação, fluxos com reconhecimento de autenticação, ou outras interações de múltiplas etapas que um simples `/scrape` não consegue completar. |
|
|
333
|
-
| `firecrawl-download` | Baixe um site inteiro como arquivos locais — markdown, capturas de tela, ou múltiplos formatos por página. Use esta skill quando o usuário quiser salvar um site localmente, baixar documentação para uso offline, salvar páginas em lote como arquivos, ou disser "baixar o site", "salvar como arquivos locais", "cópia offline", "baixar todas as docs", ou "salvar para referência". Combina mapeamento de site e scraping em diretórios locais organizados. |
|
|
334
|
-
| `firecrawl-interact` | Controle e interaja com uma sessão de navegador ao vivo em qualquer página raspada — clique em botões, preencha formulários, navegue em fluxos e extraia dados usando prompts em linguagem natural ou código. Use quando o usuário precisar interagir com uma página da web além da raspagem simples: fazendo login em um site, enviando formulários, clicando através de paginação, lidando com rolagem infinita, navegando no checkout ou fluxos de assistente de múltiplos passos, ou quando uma raspagem regular falhar porque o conteúdo está por trás da interação JavaScript. Também útil para raspagem autenticada via perfis. É ativada em comandos como "interagir", "clicar", "preencher o formulário", "fazer login em", "entrar", "enviar", "paginada", "próxima página", "rolagem infinita", "interagir com a página", "navegar para", "abrir uma sessão", ou "falha na raspagem". |
|
|
335
|
-
|
|
336
|
-
#### 🚀 DevOps & Infraestrutura
|
|
337
|
-
| Nome da Skill | Descrição |
|
|
338
|
-
|------------|-------------|
|
|
339
|
-
| `firecrawl` | Pesquise, raspe e interaja com a web através da CLI do Firecrawl. Use esta skill sempre que o usuário quiser buscar na web, encontrar artigos, pesquisar um tópico, procurar algo online, raspar uma página da web, capturar conteúdo de uma URL, obter dados de um site, fazer crawl de documentação, baixar um site ou interagir com páginas que precisam de cliques ou logins. Use também quando eles disserem "busque esta página", "puxe o conteúdo de", "obter a página em https://" ou referenciarem sites externos. Isso provê pesquisa web em tempo real com conteúdo completo da página e capacidades interativas — além do que o Claude pode fazer nativamente com as ferramentas embutidas. NÃO acione para operações de arquivos locais, comandos git, implantações ou tarefas de edição de código. |
|
|
340
|
-
|
|
341
|
-
#### 🧠 IA & LLM
|
|
342
|
-
| Nome da Skill | Descrição |
|
|
343
|
-
|------------|-------------|
|
|
344
|
-
| `firecrawl-scrape` | Extraia markdown limpo de qualquer URL, incluindo SPAs renderizados em JavaScript. Use esta skill sempre que o usuário fornecer uma URL e quiser seu conteúdo, disser "raspar", "pegar", "buscar", "puxar", "obter a página", "extrair desta URL", ou "ler esta página da web". Lida com páginas renderizadas em JS, múltiplas URLs simultâneas e retorna markdown otimizado para LLM. Use esta em vez do WebFetch para qualquer extração de conteúdo de página web. |
|
|
345
|
-
|
|
346
|
-
#### 📝 Documentação & Planejamento
|
|
347
|
-
| Nome da Skill | Descrição |
|
|
348
|
-
|------------|-------------|
|
|
349
|
-
| `firecrawl-crawl` | Extraia conteúdo em massa de um site inteiro ou seção de site. Use esta skill quando o usuário quiser fazer crawl de um site, extrair todas as páginas de uma seção de documentação, raspar várias páginas em lote seguindo links, ou disser "crawl", "obter todas as páginas", "extrair tudo em /docs", "extrair em lote", ou precisar de conteúdo de muitas páginas no mesmo site. Lida com limites de profundidade, filtragem de rotas e extração concorrente. |
|
|
350
|
-
|
|
351
|
-
#### 📦 Outros Utilitários
|
|
352
|
-
| Nome da Skill | Descrição |
|
|
353
|
-
|------------|-------------|
|
|
354
|
-
| `firecrawl-build-scrape` | Integre o `/scrape` do Firecrawl em código de produto para extração de página única. Use quando um aplicativo já tiver uma URL e precisar de markdown, HTML, links, capturas de tela, metadados ou saída de página estruturada. Prefira esta skill sobre padrões de crawl mais amplos quando a funcionalidade for ao nível da página. |
|
|
355
|
-
| `firecrawl-map` | Descubra e liste todas as URLs em um site, com filtragem de pesquisa opcional. Use esta skill quando o usuário quiser encontrar uma página específica em um site grande, listar todas as URLs, ver a estrutura do site, encontrar onde algo está em um domínio, ou disser "mapear o site", "encontrar a URL para", "quais páginas estão em", ou "listar todas as páginas". Essencial quando o usuário sabe qual site, mas não qual página exata. |
|
|
356
|
-
| `firecrawl-search` | Busca na web com extração completa do conteúdo da página. Use esta skill sempre que o usuário pedir para buscar na web, encontrar artigos, pesquisar um tópico, procurar por algo, descobrir notícias recentes, encontrar fontes, ou disser "buscar por", "encontre para mim", "procurar", "o que as pessoas estão dizendo sobre", ou "encontre artigos sobre". Retorna resultados de busca reais com markdown opcional da página completa — não apenas trechos. Provê capacidades além do WebSearch integrado do Claude. |
|
|
357
|
-
|
|
358
|
-
</details>
|
|
27
|
+
Após a instalação, você tem:
|
|
359
28
|
|
|
29
|
+
- **<!-- count:skills -->213<!-- /count --> skills** em seis categorias, descobríveis por cada harness como `<name>/SKILL.md`.
|
|
30
|
+
- **<!-- count:agents -->13<!-- /count --> subagentes** (Architect, TechLead, Reviewer, os Godmodes, revisores de segurança e falhas silenciosas) compilados em cada formato nativo de agente do harness.
|
|
31
|
+
- **<!-- count:mcps -->21<!-- /count --> servidores MCP** para software criativo, controle de SO, memória e delegação entre harnesses.
|
|
32
|
+
- **Três pipelines** — `/startcycle`, `/startcycle-graph`, `/startcycle-graph-user` — e um **portão GO** que bloqueia mecanicamente `git push`, `npm publish`, `npm version` e `rm` recursivo.
|
|
33
|
+
- **Ferramentas:** Plan Canvas, agenttrail, archify, AOS Store, dashboard Launchpad e `aos doctor`.
|
|
360
34
|
|
|
361
35
|
---
|
|
362
36
|
|
|
363
|
-
##
|
|
364
|
-
|
|
365
|
-
A v4.0.0 substitui a antiga prosa linear da "pipeline de 5 agentes" por uma máquina de estados real e executável. O contrato vive em [`.agents/graph.md`](.agents/graph.md), a lista de nós em [`.agents/nodes.json`](.agents/nodes.json), e o dispatcher executável em [`.claude/workflows/startcycle-dispatch.mjs`](.claude/workflows/startcycle-dispatch.mjs).
|
|
37
|
+
## O Grafo do Dispatcher
|
|
366
38
|
|
|
367
|
-
|
|
39
|
+
O grafo é agnóstico quanto ao harness e roda no Dynamic Workflows do Claude Code, na execução paralela do Antigravity e em qualquer harness de agente compatível.
|
|
368
40
|
|
|
369
41
|
```mermaid
|
|
370
42
|
flowchart LR
|
|
371
|
-
U(["👤
|
|
372
|
-
A["<b>Architect</b><br/><span>
|
|
373
|
-
T["<b>TechLead</b><br/><span>
|
|
374
|
-
UX["<b>
|
|
375
|
-
EN["<b>
|
|
376
|
-
ME["<b>
|
|
377
|
-
R["<b>Reviewer</b><br/><span>QA
|
|
378
|
-
S["<b>Shipping</b><br/><span>
|
|
43
|
+
U(["👤 User"])
|
|
44
|
+
A["<b>Architect</b><br/><span>System Plan</span>"]
|
|
45
|
+
T["<b>TechLead</b><br/><span>Capability Map</span>"]
|
|
46
|
+
UX["<b>UI_UX</b><br/><span>Frontend</span>"]
|
|
47
|
+
EN["<b>Engineering</b><br/><span>Backend</span>"]
|
|
48
|
+
ME["<b>Media_EventTech</b><br/><span>Creative</span>"]
|
|
49
|
+
R["<b>Reviewer</b><br/><span>QA</span>"]
|
|
50
|
+
S["<b>Shipping</b><br/><span>Gate</span>"]
|
|
379
51
|
|
|
380
52
|
U --> A --> T
|
|
381
53
|
T --> UX & EN & ME
|
|
382
54
|
UX & EN & ME --> R
|
|
383
55
|
R --> S
|
|
384
56
|
|
|
385
|
-
T -.->|
|
|
386
|
-
R -.->|
|
|
387
|
-
S -.->|
|
|
388
|
-
R -.->|
|
|
389
|
-
|
|
390
|
-
classDef box fill:#161b26,stroke:#3a4560,stroke-width:1.5px,color:#e8edf7
|
|
391
|
-
classDef user fill:#1a2436,stroke:#4a6fa5,stroke-width:1.5px,color:#dbeafe
|
|
392
|
-
class A,T,UX,EN,ME,R,S box
|
|
393
|
-
class U user
|
|
394
|
-
linkStyle 8,9,10,11 stroke:#7d8799,stroke-width:1px,color:#9aa4b8
|
|
57
|
+
T -.->|reject| A
|
|
58
|
+
R -.->|findings| UX
|
|
59
|
+
S -.->|gate fail| EN
|
|
60
|
+
R -.->|escalate| U
|
|
395
61
|
```
|
|
396
62
|
|
|
397
|
-
|
|
63
|
+
---
|
|
398
64
|
|
|
399
|
-
|
|
400
|
-
|---|---|
|
|
401
|
-
| **Isolamento do Reviewer** | O Reviewer lê os artefatos de build e o contrato do plano — nunca o `goal` original, nunca o raciocínio de um nó de build ou sua afirmação de que o trabalho está concluído. Repassar a afirmação do implementador enviesa o revisor para a concordância; retê-la é o que torna a revisão adversária em vez de um mero carimbo. |
|
|
402
|
-
| **Guarda anti-inércia** | Se um ciclo de reparo retornar relatando o *mesmo* ID de descoberta bloqueante que o anterior, nada está realmente sendo consertado. A execução escala para um humano em vez de queimar iterações executando um loop idêntico. |
|
|
403
|
-
| **Fragmentos de estado por nó** | Os nós de build rodam em paralelo e cada um escreve seu próprio fragmento `state.d/<nó>.json`, mesclados depois — eles nunca escrevem em `state.json` diretamente. Gravadores paralelos em um arquivo JSON geram condição de corrida por atualização perdida; os fragmentos removem a corrida por construção. |
|
|
404
|
-
| **Teto de iteração** | `max_iterations` (padrão 3) para o loop incondicionalmente, deliberadamente configurado abaixo da própria sobreposição de parada de 8 hooks do Claude Code, para que a própria mensagem de escalonamento da execução chegue a você primeiro. |
|
|
405
|
-
| **Transição humana no loop** | Qualquer nó pode definir `needs_human: true` e parar a execução. Autonomia total soa bem até que um nó atinja algo que apenas um humano pode decidir — isso é uma aresta explícita no grafo, não uma interrupção dele. |
|
|
406
|
-
| **Lançamento com Portão-GO** | Alcançar `ready_to_ship` não é lançar. `git push`, `npm publish`, `npm version` e `rm` recursivo são bloqueados por um hook `PreToolUse` ([`.claude/hooks/go-gate.mjs`](.claude/hooks/go-gate.mjs)) a menos que sua mensagem imediatamente anterior seja a palavra literal **GO**. É um hook, não uma regra que um agente lê e tenta seguir — ele é acionado antes de qualquer verificação de modo de permissão e não pode ser contornado. |
|
|
65
|
+
## Instalar
|
|
407
66
|
|
|
408
|
-
|
|
67
|
+
Requisitos: Node.js >= 20. macOS, Linux e Windows (PowerShell).
|
|
409
68
|
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
| **`/startcycle-graph`** | O grafo completo acima: `state.json` durável, loop de reparo do Reviewer, portão de qualidade, escalonamento automático. | Trabalho de feature real onde a exatidão importa mais que a velocidade, e você quer uma trilha de auditoria do que aconteceu. |
|
|
414
|
-
| **`/startcycle-graph-user`** | Delegação descartável de 2 a 4 nós. Nada persistente — sem inicialização `.agents/`, sem `state.json`. Modelos classificados por função (Opus planeja, Sonnet revisa, Haiku ou uma CLI externa faz o trabalho mecânico). | Um único "gerar alguns trabalhadores para esta tarefa" em *qualquer* projeto, incluindo aqueles que nunca ouviram falar deste repositório. |
|
|
69
|
+
```bash
|
|
70
|
+
npx -y @hybridlabor-api/aos@latest
|
|
71
|
+
```
|
|
415
72
|
|
|
416
|
-
|
|
73
|
+
**Primeira execução.** O instalador detecta quais harnesses estão presentes, pergunta quais são os alvos e qual camada (Pro MEDIA ou Basic), copia as skills em cada diretório de skills do harness, compila os subagentes, conecta os hooks, mescla a configuração MCP em cada arquivo de configuração próprio do harness (entradas existentes são mantidas) e oferece os módulos opcionais listados abaixo.
|
|
417
74
|
|
|
418
|
-
|
|
75
|
+
**Toda execução posterior** abre um menu:
|
|
419
76
|
|
|
420
|
-
|
|
77
|
+
| Item do menu | O que faz |
|
|
78
|
+
|---|---|
|
|
79
|
+
| Quick Update | Atualiza skills, templates, hooks e módulos instalados para a versão que você acabou de executar |
|
|
80
|
+
| Run System Checkup / Doctor | Executa `aos doctor`: dependências, posicionamento de arquivos, daemons, hooks |
|
|
81
|
+
| Drop Local Project Harness | Copia o contrato do dispatcher para o diretório atual (veja abaixo) |
|
|
82
|
+
| Reconfigure System | Muda alvos, camada ou opções |
|
|
83
|
+
| Uninstall AOS | Remove o que o instalador colocou; seus dados permanecem |
|
|
421
84
|
|
|
422
|
-
|
|
85
|
+
### Não-interativo
|
|
423
86
|
|
|
424
|
-
|
|
87
|
+
```bash
|
|
88
|
+
npx -y @hybridlabor-api/aos@latest -y --platforms=2 # Claude only, all defaults
|
|
89
|
+
npx -y @hybridlabor-api/aos@latest -y --platforms=1,5 --mcps=none
|
|
90
|
+
npx -y @hybridlabor-api/aos@latest --dry-run # print what would change
|
|
91
|
+
```
|
|
425
92
|
|
|
426
|
-
|
|
93
|
+
`--platforms=` valores: `0` universal (todos detectados), `1` Antigravity, `2` Claude Desktop / Claude Code, `3` Cursor, `5` Codex CLI, `6` Windsurf, `7` Roo Code / Cline, `8` Aider, `10` AOS CLI. `4` (caminhos personalizados) precisa do menu interativo. `--mcps=<name,name>|all|none` escolhe o subconjunto de MCP. `--verbose` e `--no-intro` fazem o que dizem.
|
|
427
94
|
|
|
428
|
-
|
|
95
|
+
### Harness local do projeto
|
|
429
96
|
|
|
430
|
-
|
|
97
|
+
Em vez de instalar em `$HOME`, solte apenas o contrato do dispatcher (`.agents/`, os hooks do portão, as definições de agentes, o workflow `/startcycle-graph`, o plugin OpenCode) em um repositório:
|
|
431
98
|
|
|
432
|
-
|
|
99
|
+
```bash
|
|
100
|
+
cd your-project && npx -y @hybridlabor-api/aos@latest --project-harness -y
|
|
101
|
+
```
|
|
433
102
|
|
|
434
|
-
|
|
435
|
-
<summary><strong>🎨 Adobe Creative Cloud (Illustrator, Photoshop, After Effects, Premiere Pro)</strong></summary>
|
|
103
|
+
---
|
|
436
104
|
|
|
437
|
-
|
|
438
|
-
- **Direct OS-Native Bridge (`bdb_adobe_mcp`)**: Executa scripts sem necessidade de instalação.
|
|
439
|
-
- **macOS:** Direciona IDs de pacotes de aplicações diretamente via streams de comando AppleScript `do javascript` / `DoScript`.
|
|
440
|
-
- **Windows:** Consulta e instancia automaticamente objetos COM locais via scripts wrapper em PowerShell e executa código ExtendScript `.jsx` temporário.
|
|
441
|
-
- **Cross-Platform UXP WebSocket Bridge (`bdb_adobe_uxp_mcp`)**: Um proxy WebSocket de três camadas (servidor Node.js na porta 8080 + plugins nativos de desenvolvedor UXP) para manipulação profunda de DOM e sessões WebSocket persistentes no Photoshop e Premiere Pro, funcionando identicamente no Windows e macOS.
|
|
442
|
-
</details>
|
|
105
|
+
## Harnesses suportados
|
|
443
106
|
|
|
444
|
-
|
|
445
|
-
<summary><strong>🎬 DaVinci Resolve (Cobertura Tripla)</strong></summary>
|
|
107
|
+
O que o instalador escreve para cada alvo. Os caminhos são os padrões; o instalador apenas escreve em harnesses que realmente detecta.
|
|
446
108
|
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
109
|
+
| Harness | Skills | Subagentes | Hooks | Plugin / regras |
|
|
110
|
+
|---|---|---|---|---|
|
|
111
|
+
| Claude Code / Claude Desktop | `~/.claude/skills` | `~/.claude/agents` | `~/.claude/hooks` + `settings.json` (portão GO, portão de grafo, proteção de arquivo de env, Conventional Commits, injeção memB, retransmissão de trail) | manifesto `.claude-plugin/` enviado no repo (veja Contributing) |
|
|
112
|
+
| Google Antigravity | `~/.gemini/config/skills` | `~/.gemini/config/agents` | `~/.gemini/config/hooks.json` e `~/.gemini/antigravity-cli/hooks.json` | — |
|
|
113
|
+
| Codex CLI | `~/.codex/skills` | `~/.codex/agents` | `~/.codex/hooks` + `config.toml` | `.codex-plugin/` |
|
|
114
|
+
| OpenCode | `~/.config/opencode/skills` | `~/.opencode/agents` | via plugin | plugin `bdb-aos.js` + comando `/startcycle-graph`, registrado em `opencode.jsonc`; mantém uma execução `/startcycle-graph` em movimento em `session.idle` |
|
|
115
|
+
| Cursor | `~/.cursor/skills` | — | — | `.cursor/rules` (projeto) |
|
|
116
|
+
| Windsurf | `~/.windsurf/bdb-skills` | — | — | `mcp.json` |
|
|
117
|
+
| Roo Code / Cline | `~/.roo/skills` | — | — | `.roomodes` (projeto) |
|
|
118
|
+
| Aider | `~/.aider/bdb-skills` | — | — | — |
|
|
119
|
+
| AOS CLI (`pi`) | lê `~/.agents/skills` | `~/.agents/AGENTS.md` como prompt do sistema | — | sem MCP; instalação separada, Node >= 22.19 — veja [packages/aos-cli](packages/aos-cli/README.md) |
|
|
451
120
|
|
|
452
|
-
|
|
453
|
-
<summary><strong>📐 Rhino 3D & Grasshopper (Twin-Engine)</strong></summary>
|
|
121
|
+
Toda instalação também escreve a cópia universal em `~/.agents/skills`, que é o que a CLI AOS e a CLI `skills` leem.
|
|
454
122
|
|
|
455
|
-
|
|
456
|
-
- **Fallback: `bdb_rhino_mcp_fallback`**: O servidor 3D GOLEM com 105 ferramentas para manipular dinamicamente ativos do Rhino 8, executar scripts e resolver definições do Grasshopper.
|
|
457
|
-
</details>
|
|
123
|
+
---
|
|
458
124
|
|
|
459
|
-
|
|
460
|
-
<summary><strong>🏗️ Integrações Especializadas Adicionais (Unreal, TouchDesigner, Vectorworks, etc.)</strong></summary>
|
|
125
|
+
## Os pipelines
|
|
461
126
|
|
|
462
|
-
|
|
463
|
-
- **Principal: `bdb_vectorworks_mcp`**: Índice de busca semântico baseado em RAG sobre documentação do VectorScript e API do Vectorworks (porta 8765) para desenho CAD automatizado.
|
|
127
|
+
O contrato vive em [`.agents/graph.md`](.agents/graph.md), o roster de nós em [`.agents/nodes.json`](.agents/nodes.json), o dispatcher executável em [`.claude/workflows/startcycle-dispatch.mjs`](.claude/workflows/startcycle-dispatch.mjs).
|
|
464
128
|
|
|
465
|
-
|
|
466
|
-
- **Principal: `bdb_unreal_mcp`**: Conecta-se via Unreal Engine 5 Web Remote Control API (porta 30010) e o conjunto de ferramentas `gimmeDG`. Permite ao agente consultar, criar atores, editar materiais, escrever Blueprints e automatizar a manipulação de níveis/sequenciadores.
|
|
129
|
+
**Uma regra: os nós nunca se invocam.** Um dispatcher lê `production_artifacts/state.json` após cada nó retornar e decide o que executa a seguir. Não há cadeia de repasse e nenhum agente dizendo a outro agente para prosseguir. Este design garante fidelidade de contexto, auditabilidade em um único local da lógica de roteamento e portabilidade entre harnesses.
|
|
467
130
|
|
|
468
|
-
|
|
469
|
-
- **Principal: `bdb_blender_mcp`**: Integração de soquete BlenderMCP para layout de cena, geração de malha e controles de viewport.
|
|
470
|
-
- **Fallback: `bdb_blender_mcp_fallback`**: Servidor python do djeada para gerenciar conexões TCP do Blender e scripting python bruto.
|
|
131
|
+
Cada nó lê o plano e seu estado anterior, executa seu trabalho, escreve seu artefato e fragmentos de estado, e retorna. O dispatcher mescla fragmentos de estado por nó (`state.d/<node>.json`), avalia predicados de borda e roteia para o próximo nó — ou escala para o usuário se uma guarda de falta de progresso dispara (mesmo achado bloqueador no segundo ciclo de reparo) ou o teto de iteração é atingido.
|
|
471
132
|
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
133
|
+
```mermaid
|
|
134
|
+
flowchart LR
|
|
135
|
+
U(["User"]) --> A["Architect"] --> T["TechLead"]
|
|
136
|
+
T --> UX["Godmode_UI_UX"] & EN["Godmode_Engineering"] & ME["Godmode_Media"]
|
|
137
|
+
UX & EN & ME --> R["Reviewer"] --> S["Shipping"]
|
|
138
|
+
T -.->|reject| A
|
|
139
|
+
R -.->|findings| UX
|
|
140
|
+
R -.->|needs_human| U
|
|
141
|
+
```
|
|
475
142
|
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
143
|
+
| Comando | Mecanismo | Use quando |
|
|
144
|
+
|---|---|---|
|
|
145
|
+
| `/startcycle` | Cadeia linear, repasses de arquivo em `production_artifacts/`. Nenhuma máquina de estado, nenhum loop de reparo. `/startcycle --skill=<name> <goal>` força uma skill em cada nó. | Uma compilação direta com o roster de agentes mas sem a cerimônia. |
|
|
146
|
+
| `/startcycle-graph` | O grafo completo: `state.json` durável, loop de reparo do Reviewer, portão de qualidade automatizado, escalonamento para humanos. | Trabalho de feature onde a correção importa mais que velocidade e você quer um rastro de auditoria. |
|
|
147
|
+
| `/startcycle-graph-user` | Fan-out de 2–4 nós descartáveis. Nada persistente. Modelo em camadas por função; usa Antigravity, OpenCode ou Codex se instalado, subagentes Claude Code caso contrário. | Um "spawn de alguns workers" único em qualquer projeto. |
|
|
479
148
|
|
|
480
|
-
|
|
481
|
-
- **macOS/Linux: `zavora_computer_use`**: Empacotado com objetos binários nativos pré-compilados do Rust NAPI (macOS arm64/x64, Linux) para controlar mouse, teclado, janelas e aplicativos sem erros de compilação em tempo de execução.
|
|
482
|
-
- **Windows: `bdb_windows_computer_use`**: Controlador nativo Win32 / COM / UIAutomation baseado em python com suporte local a OCR (Tesseract) para automação avançada de GUI do Windows.
|
|
149
|
+
O que mantém o grafo completo honesto:
|
|
483
150
|
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
151
|
+
| Mecanismo | O que previne |
|
|
152
|
+
|---|---|
|
|
153
|
+
| Isolamento do Reviewer | O Reviewer lê artefatos e o contrato do plano, nunca o raciocínio do nó de compilação ou sua alegação de que está pronto. |
|
|
154
|
+
| Guarda de falta de progresso | Um ciclo de reparo que relata o mesmo ID de achado bloqueador da anterior escala para um humano em vez de queimar iterações. |
|
|
155
|
+
| Fragmentos de estado por nó | Nós de compilação paralelos escrevem `state.d/<node>.json`; o dispatcher mescla. Sem corrida de atualização perdida em um arquivo. |
|
|
156
|
+
| Teto de iteração | `max_iterations` (padrão 3) para o loop incondicionalmente. |
|
|
157
|
+
| Borda humana no-loop | Qualquer nó pode definir `needs_human: true` e parar a execução. |
|
|
487
158
|
|
|
488
|
-
|
|
159
|
+
## O portão GO
|
|
489
160
|
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
Este repositório também contém 14 configurações profundas de sistema e diretrizes de documentação mapeadas automaticamente. Se um agente de IA importar este pacote, ele lerá imediatamente esses arquivos markdown para aprender assinaturas de ferramentas, argumentos esperados, ganchos ExtendScript e etapas comuns de solução de problemas para cada aplicação.
|
|
493
|
-
|
|
494
|
-
<details>
|
|
495
|
-
<summary><strong>Ver Lista de Skills do Sistema</strong></summary>
|
|
496
|
-
|
|
497
|
-
- [`bdb-unreal-mcp`](skills/global_config/bdb-unreal-mcp/SKILL.md)
|
|
498
|
-
- [`bdb-rhino-mcp`](skills/global_config/bdb-rhino-mcp/SKILL.md)
|
|
499
|
-
- [`bdb-davinci-mcp`](skills/global_config/bdb-davinci-mcp/SKILL.md)
|
|
500
|
-
- [`bdb-blender-mcp`](skills/global_config/bdb-blender-mcp/SKILL.md)
|
|
501
|
-
- [`bdb-after-effects-mcp`](skills/global_config/bdb-after-effects-mcp/SKILL.md)
|
|
502
|
-
- [`bdb-vectorworks-mcp`](skills/global_config/bdb-vectorworks-mcp/SKILL.md)
|
|
503
|
-
- [`bdb-touchdesigner-mcp`](skills/global_config/bdb-touchdesigner-mcp/SKILL.md)
|
|
504
|
-
- [`bdb-computer-use-mcp`](skills/global_config/bdb-computer-use-mcp/SKILL.md)
|
|
505
|
-
- [`bdb-grandma3-mcp`](skills/global_config/bdb-grandma3-mcp/SKILL.md)
|
|
506
|
-
- [`bdb-resolume-mcp`](skills/global_config/bdb-resolume-mcp/SKILL.md)
|
|
507
|
-
- [`bdb-adobe-suite-mcp`](skills/global_config/bdb-adobe-suite-mcp/SKILL.md)
|
|
508
|
-
- [`bdb-memb-mcp`](skills/global_config/bdb-memb-mcp/SKILL.md)
|
|
509
|
-
- [`openwiki-skill`](skills/global_config/openwiki-skill/SKILL.md): Direct Gemini-native integration of OpenWiki for autonomous, high-agency documentation management and release notes maintenance.
|
|
510
|
-
- [`memb-skill`](skills/global_config/memb-skill/SKILL.md): BDB local-first long-term memory engine (memB). Query, remember, and adapt preferences, code architectures, and developer patterns across tasks.
|
|
511
|
-
</details>
|
|
161
|
+
Alcançar `ready_to_ship` não é enviar. [`.claude/hooks/go-gate.mjs`](.claude/hooks/go-gate.mjs) é um hook `PreToolUse` que bloqueia `git push`, `npm publish`, `npm version` e `rm` recursivo a menos que sua mensagem imediatamente anterior seja a palavra literal **GO**. É um hook, não uma regra que um agente é convidado a respeitar: dispara antes de qualquer verificação de modo de permissão e não pode ser contornado. O instalador conecta o mesmo portão em Antigravity, Codex e OpenCode; em harnesses sem suporte a hook, a regra em [AGENTS.md](AGENTS.md) se aplica e o agente é a execução. Um subagente nunca herda o GO de seu orquestrador, e um comando de lançamento que falha precisa de um novo GO.
|
|
512
162
|
|
|
513
163
|
---
|
|
514
164
|
|
|
515
|
-
##
|
|
165
|
+
## Ferramentas
|
|
516
166
|
|
|
517
|
-
|
|
167
|
+
|
|
518
168
|
|
|
519
|
-
|
|
520
|
-
- **Entrypoint & Setup:** [.openwiki/quickstart.md](.openwiki/quickstart.md)
|
|
521
|
-
- **Architecture & Ecosystem:** [.openwiki/architecture.md](.openwiki/architecture.md)
|
|
522
|
-
- **Design Decisions (ADRs):** [.openwiki/decisions.md](.openwiki/decisions.md)
|
|
523
|
-
- **Changelog & History:** [.openwiki/release_notes.md](.openwiki/release_notes.md)
|
|
524
|
-
- **Code Health Report:** [.openwiki/code_health.md](.openwiki/code_health.md)
|
|
525
|
-
- **Interactive Live Dashboard:** [.openwiki/code_health_dashboard.html](.openwiki/code_health_dashboard.html)
|
|
169
|
+
*Visão conceitual da v3.4.0. Os componentes cresceram desde então; as seções abaixo estão atualizadas.*
|
|
526
170
|
|
|
527
|
-
|
|
528
|
-
|
|
171
|
+
| Ferramenta | Comando | O que faz |
|
|
172
|
+
|---|---|---|
|
|
173
|
+
| Plan Canvas | `aos-plan-canvas open <file>` (skill `plan-canvas`) | Abre um plano ou artefato HTML em um canvas de navegador local onde você anota elementos, conversa e aprova ou solicita mudanças. Planos dos pipelines abrem aqui por padrão. |
|
|
174
|
+
| agenttrail | `aos-trail` (skill `agenttrail`, porta 5330) | Quadro ao vivo de uma compilação multi-agente: qual componente, qual agente ou harness, o que está pronto, o que está preso. Alimentado pelos hooks trail-relay e por `mcsc`. |
|
|
175
|
+
| archify | `aos-archify` (skill `archify`) | Arquitetura validada, sequência, fluxo de dados e diagramas de estado como HTML autossuficiente com exportação SVG; aceita Mermaid. |
|
|
176
|
+
| AOS Store | `aos store list \| search <q> \| install <name> [--project]`, `aos store ui` (também `aos-store`, comando slash `/aos-store`) | Procure e instale skills e agentes AOS Core e ECC. A interface web em `http://127.0.0.1:4322` mostra o que está instalado, visualiza o exato caminho de alvo e instala apenas após você confirmar. Skills multi-arquivo são instaladas completamente. `list` e `search` leem um índice fixo offline. |
|
|
177
|
+
| Launchpad | `aos-dashboard [--port 7900] [--no-open]` | Uma página com todos os serviços BDB locais (memB, Synapse, OpenWiki, AO, Remote, AOS Store): status, iniciar/parar, logs. Registrado como entrada de inicialização automática. |
|
|
178
|
+
| Doctor | `aos doctor [--json] [--net]` (também `aos-doctor`) | Verifica dependências, posicionamento de skills por harness, daemons, hooks e módulos; sai com 1 quando algo precisa de atenção. A primeira coisa a executar quando algo se comporta mal. |
|
|
179
|
+
| Config | `aos-config show \| propose \| set <key> <value>` | Nível de máquina `~/.agents/aos-config.json`: raiz do workspace, domínios, id do usuário. |
|
|
180
|
+
| mcsc | Ferramentas MCP `delegate_agy`, `delegate_opencode`, `delegate_codex`, `delegate_smart` (skill `mcsc`) | Delega uma tarefa a outro harness CLI instalado e transmite suas chamadas de ferramenta para agenttrail. Preferido sobre shell out para a CLI. |
|
|
529
181
|
|
|
530
|
-
|
|
531
|
-
- **Google GenAI:** `gemma-4-26b-a4b-it` (padrão via SDK `google-genai`, com fallback de descoberta automática de modelos)
|
|
532
|
-
- **Groq:** `llama-3.3-70b-versatile` (latência ultra-baixa)
|
|
533
|
-
- **Grok / xAI:** `grok-2-latest`
|
|
534
|
-
- **Nvidia NIM:** `meta/llama-3.3-70b-instruct`
|
|
535
|
-
- **OpenRouter:** `anthropic/claude-3.5-sonnet` (mais de 200 modelos)
|
|
536
|
-
- **OpenAI:** `gpt-4o-mini` / `gpt-4o`
|
|
537
|
-
- **Offline / Local:** Ollama (`llama3`), LM Studio ou qualquer endpoint compatível com OpenAI.
|
|
538
|
-
2. **Análise Git Zero-Token RepoGraph:** Analisa velocidade de hotspot de 90 dias, risco de fator-ônibus de autor único e índice de manutenibilidade puramente através de análise Git local determinística — custando **0 tokens LLM**.
|
|
539
|
-
3. **Dashboard HTML Ao Vivo de Nível Repowise:** `.openwiki/code_health_dashboard.html` fornece 6 painéis visuais SVG (Mapa de Aglomerado de Galáxias, Gráfico de Risco em Rosca, Matriz de Fator Ônibus, Churn de Velocidade de Commit, Leaderboard de Hotspot, Radar de Saúde da Arquitetura) com **atualização automática ao vivo a cada 60 segundos** e telemetria integrada de ADR do memB.
|
|
540
|
-
</details>
|
|
182
|
+
---
|
|
541
183
|
|
|
542
|
-
|
|
543
|
-
<summary><strong>⚙️ Configurando o Daemon em Segundo Plano</strong></summary>
|
|
184
|
+
## AOS CLI
|
|
544
185
|
|
|
545
|
-
|
|
186
|
+
Um harness CLI leve construído em [pi](https://github.com/earendil-works/pi), um agente de codificação que roda no terminal. AOS CLI lê `~/.agents/skills` (escrito pelo instalador) e `~/.agents/AGENTS.md` (o grafo do dispatcher como instruções do sistema), não roda servidores MCP próprios e precisa de **Node >= 22.19** (piso do pi, mais alto do que o instalador AOS principal).
|
|
546
187
|
|
|
547
|
-
#### On macOS (LaunchAgent)
|
|
548
188
|
```bash
|
|
549
|
-
|
|
189
|
+
aos-cli "what is the fastest way to fix this bug"
|
|
190
|
+
aos-cli --continue # resume the previous session
|
|
550
191
|
```
|
|
551
192
|
|
|
552
|
-
|
|
553
|
-
```powershell
|
|
554
|
-
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.gemini\config\skills\openwiki-skill\scripts\install_daemon.ps1"
|
|
555
|
-
```
|
|
193
|
+
O launcher da CLI (`packages/aos-cli/bin/aos-cli.mjs`) vem com um tema escuro AOS (`aos.json`), as dez skills principais de `core-skills.json` (ask-tim, aos-setup, systematic-debugging, archify, etc.) e dois comandos apenas leitura em sessão (`/aos` mostra o menu de instalação; `/aos-status` roda a verificação de saúde).
|
|
556
194
|
|
|
557
|
-
|
|
558
|
-
**Registrar Projetos:** Adicione caminhos de workspace ao seu arquivo de configuração em `~/.openwiki/projects.json`:
|
|
559
|
-
```json
|
|
560
|
-
{
|
|
561
|
-
"projects": [
|
|
562
|
-
"~/dev/bdb-dev/aos",
|
|
563
|
-
"~/Projects/your-active-project"
|
|
564
|
-
],
|
|
565
|
-
"interval_seconds": 3600
|
|
566
|
-
}
|
|
567
|
-
```
|
|
195
|
+
Instale através do instalador AOS com o alvo AOS CLI: `npx -y @hybridlabor-api/aos@latest -y --platforms=10`. O pacote é privado e não é publicado no npm, então `npm i -g @hybridlabor-api/aos-cli` não funciona.
|
|
568
196
|
|
|
569
|
-
**Monitorar Execução:** Acompanhe os logs ativos para inspecionar o status de reconstrução da documentação em segundo plano:
|
|
570
|
-
```bash
|
|
571
|
-
tail -f ~/.openwiki/daemon.log
|
|
572
|
-
```
|
|
573
|
-
</details>
|
|
574
197
|
|
|
575
|
-
|
|
576
|
-
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## Plugins e Marketplace
|
|
577
201
|
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
- **Repositório Direto:** Acesse o gateway em [github.com/hybridlabor-api/bdb-os-remote](https://github.com/hybridlabor-api/bdb-os-remote) ou instale via NPX:
|
|
202
|
+
**Manifesto do plugin:** `.claude-plugin/plugin.json` + `marketplace.json` (gerado por `npm run plugin:build`). O caminho de instalação do marketplace Claude está sendo finalizado; por enquanto, o instalador npm acima é a rota de instalação suportada.
|
|
203
|
+
|
|
204
|
+
**Descoberta de skills:** Todo harness encontra skills em seu diretório nativo (`~/.claude/skills`, `~/.agents/skills`, `~/.codex/skills`, `~/.roo/skills`, etc.). Para procurar e instalar skills adicionais após a instalação:
|
|
582
205
|
|
|
583
206
|
```bash
|
|
584
|
-
npx
|
|
207
|
+
npx skills add hybridlabor-api/aos
|
|
585
208
|
```
|
|
586
|
-
|
|
209
|
+
|
|
210
|
+
Isto descobre todas as <!-- count:skills -->213<!-- /count --> skills curadas e as instala no diretório universal `~/.agents/skills` (usado por todos os harnesses e o AOS CLI).
|
|
587
211
|
|
|
588
212
|
---
|
|
589
213
|
|
|
590
|
-
##
|
|
214
|
+
## Memória e conhecimento
|
|
591
215
|
|
|
592
|
-
|
|
593
|
-
[](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
|
|
594
|
-
[](https://github.com/hybridlabor-api/bdb-agent-orchestrator)
|
|
595
|
-
[](LICENSE)
|
|
216
|
+
Instalado como módulos opcionais pelo instalador; `aos doctor` os verifica e o Launchpad os mostra.
|
|
596
217
|
|
|
597
|
-
|
|
218
|
+
- **memB** (`@hybridlabor-api/memb`) — memória vetorial local, offline com servidor MCP (`add_memory`, `search_memory`, `list_memories`, `delete_memory`), WebUI na porta 8088 e hook ambiente que injeta memórias relevantes em sessões Claude Code. Skills: `memb-skill`, `memb-ingest`, `bdb-memb-mcp`.
|
|
219
|
+
- **deja** (`@vshulcz/deja-vu`, instalado com memB) — indexa seus transcritos de agentes localmente com segredos redatados; `deja fix` em um erro, `deja wip` ao retomar, `deja search` para sessões passadas. Skill: `deja-memory`.
|
|
220
|
+
- **OpenWiki** (CLI `openwiki`) — gera e atualiza uma wiki fundamentada de uma base de código, com um visualizador na porta 4321 e um daemon de fundo. Skill: `openwiki-skill`; a própria wiki deste repo está sob [`.openwiki/`](.openwiki/quickstart.md).
|
|
221
|
+
- **Synapse** (`@hybridlabor-api/bdb-synapse`) — renderiza um repositório como uma cidade de código 3D e repassa sessões de agentes através dela. Skill: `synapse-integration-skill`.
|
|
598
222
|
|
|
599
|
-
|
|
600
|
-
> O AO substitui o antigo **BDB OS Agent Workspace** (`bdb-os-agent-workspace`). Esse repositório está arquivado e seu último release é anterior ao arquivamento — ele contém um defeito conhecido em seu loop de feedback de CI/CD. O instalador do AOS só oferece o AO; não clone o repositório antigo.
|
|
223
|
+
`aos-setup` leva uma máquina a um estado verificado para os quatro; `aos-project-init` vincula um projeto a eles (slug, wiki, memória, `AGENTS.md`).
|
|
601
224
|
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
B --> C[Agent Session 1: Feature Build]
|
|
606
|
-
B --> D[Agent Session 2: Refactoring]
|
|
607
|
-
B --> E[Agent Session N: Test & Verification]
|
|
608
|
-
C --> F[Live Terminal Control & Process Monitor]
|
|
609
|
-
D --> F
|
|
610
|
-
E --> F
|
|
611
|
-
F --> G[Automatic CI/CD Feedback Loops]
|
|
612
|
-
G --> H[PR Review & Merge Routing]
|
|
613
|
-
H --> I[Central Git Repository]
|
|
614
|
-
```
|
|
225
|
+
---
|
|
226
|
+
|
|
227
|
+
## O que está incluído
|
|
615
228
|
|
|
616
|
-
|
|
617
|
-
<summary><strong>⚙️ Arquitetura & Orquestração de Worktrees</strong></summary>
|
|
229
|
+
### Os <!-- count:agents -->13<!-- /count --> Subagentes
|
|
618
230
|
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
231
|
+
O grafo do dispatcher compila estes agentes, disponíveis como subagentes Claude Code e carregáveis em Antigravity, Cursor, Codex, OpenCode e outros:
|
|
232
|
+
|
|
233
|
+
| Agente | Propósito |
|
|
234
|
+
|---|---|
|
|
235
|
+
| **Architect** | Transforma o objetivo do usuário em um plano de sistema. Lê a arquitetura existente antes de propor mudanças. |
|
|
236
|
+
| **TechLead** | Revisa o plano para um mapa de capacidade (limites de módulo, direção de dependência, ordem de compilação) antes de qualquer nó de compilação iniciar. Aprova ou rejeita de volta para Architect. |
|
|
237
|
+
| **UI_UX** | Designer de Frontend Líder. Impõe princípios Anti-Slop, tokens DTCG, gosto frontend de alta agência e dinâmica de movimento fluido. |
|
|
238
|
+
| **Engineering** | Engenheiro Senior Fullstack & Backend. Impõe Domain-Driven Design, Clean Architecture, ciclos TDD e melhores práticas de banco de dados. |
|
|
239
|
+
| **Media_EventTech** | Especialista em Creative-Tech & Show-Control. Governa modelagem 3D, redes TouchDesigner, DaVinci Resolve, iluminação e Resolume. |
|
|
240
|
+
| **Reviewer** | Revisão adversária da saída do nó de compilação contra o contrato do plano. Modelado na disciplina doubt-driven-development. |
|
|
241
|
+
| **Shipping** | Gatekeeper de Liberação & Auditor de QA. Roda o portão de qualidade automatizado (lint, typecheck, testes, a11y, seo) e impõe o portão GO. |
|
|
242
|
+
| **Database Reviewer** | Especialista PostgreSQL para otimização de consulta, design de schema, segurança e performance. |
|
|
243
|
+
| **Security Reviewer** | Detecção e remediação de vulnerabilidades de segurança. Marca segredos, SSRF, injeção, criptografia insegura e OWASP Top 10. |
|
|
244
|
+
| **Silent-Failure Hunter** | Revisa código para falhas silenciosas, erros engolidos, fallbacks ruins e propagação de erro ausente. |
|
|
245
|
+
| **Go-Build Resolver** | Resolve erro de build de Go, vet e compilação com mudanças mínimas. |
|
|
246
|
+
| **Opensource Forker** | Faz fork de um projeto para open-sourcing — remove segredos, substitui referências internas, gera `.env.example`. |
|
|
247
|
+
| **Opensource Sanitizer** | Verifica se um fork de open-source está totalmente sanitizado. Escaneia segredos vazados, PII, referências internas. |
|
|
248
|
+
|
|
249
|
+
### Skills por Categoria
|
|
250
|
+
|
|
251
|
+
<!-- count:skills -->213<!-- /count --> skills curadas, descobríveis por todo harness:
|
|
252
|
+
|
|
253
|
+
- **bdb-core** (30 skills): Infraestrutura AOS principal, pipelines, ferramentas e utilidades — `startcycle`, `startcycle-graph`, `startcycle-graph-user`, `agent-orchestrator`, `agenttrail`, `plan-canvas`, `aos-doctor`, `aos-store`, `bdb-dev-os-skill` e mais.
|
|
254
|
+
- **design-ui-ux** (19 skills): Frontend, design UI, acessibilidade, tokens, movimento, anti-slop — `senior-frontend`, `ui-component`, `ui-review`, `tailwind-patterns`, `shadcn`, `wcag-audit-patterns` e mais.
|
|
255
|
+
- **engineering-method** (46 skills): Arquitetura, testes, debugging, CI/CD, qualidade de código — `software-architecture`, `test-driven-development`, `systematic-debugging`, `ci-pipeline`, `github-actions-generator`, `dockerfile-validator` e mais.
|
|
256
|
+
- **library** (98 skills): Especificidades de linguagem/framework — TypeScript, Node.js, Python, React, Postgres, Prisma, Next.js, Drizzle ORM, Go e mais.
|
|
257
|
+
- **media-eventtech** (19 skills): 3D, vídeo, controle de shows, design espacial — `godmode-eventtech`, `synapse-integration-skill`, `threejs-skills`, `blender-expert` e mais.
|
|
258
|
+
- **engineering-hardware** (1 skill): Design de PCB e elétrico — `godmode-hardware-pcb`.
|
|
259
|
+
|
|
260
|
+
O catálogo completo com descrições detalhadas: [docs/skills_table.md](docs/skills_table.md) — nota: este arquivo está desatualizado e lista 164 de 213 skills.
|
|
261
|
+
|
|
262
|
+
---
|
|
623
263
|
|
|
624
|
-
|
|
625
|
-
<summary><strong>🔬 Especificações Técnicas & Roteamento Automatizado</strong></summary>
|
|
264
|
+
## Skills
|
|
626
265
|
|
|
627
|
-
|
|
628
|
-
- **Loops Automáticos de Feedback CI/CD:** Monitora saídas de testes e tarefas de build, roteando traces de erro diretamente de volta ao contexto do subagente em execução para reparo instantâneo.
|
|
629
|
-
- **Roteamento de Revisão de PR:** Empacota features concluídas, executa verificações automatizadas de segurança e saúde do código, e roteia Pull Requests gerados para revisão humana ou merge automatizado.
|
|
630
|
-
</details>
|
|
266
|
+
<!-- count:skills -->213<!-- /count --> skills, curadas de coleções de código aberto e proprietárias, cobrindo o pipeline completo de desenvolvimento de software e criativo. Cada skill é um diretório com um `SKILL.md` frontmatter declarando `name`, `description` e uma `category`: `bdb-core`, `design-ui-ux`, `engineering-method`, `engineering-hardware`, `media-eventtech`, `library`.
|
|
631
267
|
|
|
632
|
-
|
|
633
|
-
<summary><strong>🔌 Suporte de Plataforma, Harnesses Suportados & Link Direto do Repositório</strong></summary>
|
|
268
|
+
**Camada de Persona:** As skills **Godmode** são personas especializadas que mapeiam diretamente para os nós de compilação e envio do grafo do dispatcher:
|
|
634
269
|
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
-
|
|
270
|
+
| Godmode | Possui | Mapeia para |
|
|
271
|
+
|---|---|---|
|
|
272
|
+
| `godmode-engineering` | Domain-Driven Design, Clean Architecture, TypeScript/Python rigoroso, debugging sistemático, melhores práticas de banco de dados. | Nó **Engineering** |
|
|
273
|
+
| `godmode-ui-ux` | Princípios frontend anti-slop, tokens DTCG, dinâmica de movimento, acessibilidade (WCAG), gosto de alta agência. | Nó **UI_UX** |
|
|
274
|
+
| `godmode-shipping` | Verificações pré-lançamento, portões de qualidade automatizados, procedimentos de rollback seguro, execução do portão Go. | Nó **Shipping** |
|
|
275
|
+
| `godmode-eventtech` | Controle de shows, fluxo de sinal, iluminação DMX, redes TouchDesigner, servidores de mídia Resolume, hardware de evento ao vivo. | Nó **Media_EventTech** |
|
|
276
|
+
| `godmode-3d-creation` | Geração 3D first-MCP, reconstrução de malha, CAD paramétrico, modelagem espacial. | Especialista opcional |
|
|
277
|
+
| `godmode-media-creation` | Produção de vídeo, montagem de timeline, pipelines de design de movimento, OpenMontage, Remotion. | Especialista opcional |
|
|
278
|
+
| `godmode-hardware-pcb` | Esquemáticos elétricos, layout e roteamento de PCB, portão KiCad ERC/DRC/DFM, co-design de invólucro, OpenSCAD. | Especialista opcional |
|
|
279
|
+
|
|
280
|
+
**Pontos de Entrada & Navegação:**
|
|
281
|
+
- **`ask-tim`** — Recomendação de skill por descrição
|
|
282
|
+
- **`bdbrainstorm`** e **`bdbmediastorm`** — Sessões de ideação multi-agente terminando em um plano executável
|
|
283
|
+
- **`teamwork-preview`** — Elaboração de prompt, delegação de função, setup de colaboração
|
|
284
|
+
- **Família Grilling** — `grill-me` (auditoria geral), `grill-with-docs` (fundamentada em documentação), `triage` (priorização)
|
|
285
|
+
- **CI/CD & Geradores** — `ci-pipeline`, `github-actions-generator`, `dockerfile-generator`, `makefile-generator`
|
|
286
|
+
- **Qualidade de Código** — `bdb-security-audit`, `systematic-debugging`, `silent-failure-hunter`, `bdbresilience`
|
|
287
|
+
- **Especialistas de Framework** — Cobertura completa de TypeScript, React, Next.js, Drizzle ORM, Prisma, Python, Go e mais
|
|
288
|
+
|
|
289
|
+
O catálogo completo com descrições e detalhes: [docs/skills_table.md](docs/skills_table.md) (nota: atualmente lista 164 de 213).
|
|
290
|
+
|
|
291
|
+
A biblioteca também é legível pela CLI `skills`:
|
|
644
292
|
|
|
645
293
|
```bash
|
|
646
|
-
|
|
294
|
+
npx skills add hybridlabor-api/aos
|
|
647
295
|
```
|
|
648
|
-
</details>
|
|
649
296
|
|
|
650
297
|
---
|
|
651
298
|
|
|
652
|
-
##
|
|
653
|
-
|
|
654
|
-
[](https://github.com/hybridlabor-api/bdb-synapse)
|
|
655
|
-
[](https://github.com/hybridlabor-api/bdb-synapse)
|
|
656
|
-
[](https://github.com/hybridlabor-api/bdb-synapse)
|
|
657
|
-
[](https://github.com/hybridlabor-api/bdb-synapse/blob/main/LICENSE)
|
|
299
|
+
## Servidores MCP
|
|
658
300
|
|
|
659
|
-
|
|
301
|
+
[`mcp_config.json`](mcp_config.json) define <!-- count:mcps -->21<!-- /count --> servidores, construídos ou aquecidos pelo instalador de `mcps/` e mesclados em cada configuração MCP do harness. Cada servidor expõe ferramentas para um domínio específico; todo harness vê o mesmo conjunto, evitando incompatibilidades por ferramenta.
|
|
660
302
|
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
F --> G[React + Three.js WebGL Frontend]
|
|
670
|
-
G --> H[Interactive 3D Code City]
|
|
671
|
-
```
|
|
303
|
+
**Integrações de software criativo** (pares primário e fallback para redundância):
|
|
304
|
+
- **Unreal Engine** — `bdb_unreal_mcp` (Web Remote Control API na porta 30010), skill: `bdb-unreal-mcp`
|
|
305
|
+
- **Rhino 3D & Grasshopper** — `bdb_rhino_mcp` (roteador Yak de McNeel) + `bdb_rhino_mcp_fallback` (GOLEM 3D, 105 ferramentas), skill: `bdb-rhino-mcp`
|
|
306
|
+
- **DaVinci Resolve** — `bdb_davinci_mcp` (scripts de workspace, 162 ferramentas) + `bdb_davinci_mcp_studio` (Node.js para Studio) + `bdb_davinci_mcp_fallback`, skill: `bdb-davinci-mcp`
|
|
307
|
+
- **Blender** — `bdb_blender_mcp` (integração de socket) + `bdb_blender_mcp_fallback`, skill: `bdb-blender-mcp`
|
|
308
|
+
- **After Effects** — `bdb_after_effects_mcp` + `bdb_after_effects_mcp_fallback`, skill: `bdb-after-effects-mcp`
|
|
309
|
+
- **TouchDesigner** — `bdb_touchdesigner_mcp` (ponte MindDesigner na porta 9980) + `bdb_touchdesigner_mcp_fallback`, skill: `bdb-touchdesigner-mcp`
|
|
310
|
+
- **Adicional:** grandMA3 (OSC/UDP na porta 8000), Resolume (REST API na porta 8080), Vectorworks (RAG semântico na porta 8765), ponte Adobe UXP, Open Design
|
|
672
311
|
|
|
673
|
-
|
|
312
|
+
**Controle de SO & automação de sistema:**
|
|
313
|
+
- **macOS/Linux** — `zavora_computer_use` (binário NAPI Rust nativo, sem compilação em tempo de execução), skill: `bdb-computer-use-mcp`
|
|
314
|
+
- **Windows** — `bdb_windows_computer_use` (Win32 / COM / UIAutomation, OCR local com Tesseract)
|
|
674
315
|
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
316
|
+
**Memória, delegação & infraestrutura:**
|
|
317
|
+
- **memB** — `memb_mcp` (memória vetorial offline local, SQLite + modelo ONNX)
|
|
318
|
+
- **deja** — indexação local de transcrito (segredos redatados)
|
|
319
|
+
- **mcsc** — delegação de tarefa multi-harness
|
|
320
|
+
- **GitHub** — ferramentas MCP nativas para issues, PRs, workflows
|
|
321
|
+
- **Chrome DevTools** — automação de navegador & debugging
|
|
322
|
+
- **RemoteOS** — gateway de execução multi-nuvem com mecanismo de aprovação 4-olhos
|
|
681
323
|
|
|
682
|
-
|
|
683
|
-
- **Visualizações de Árvore & Terreno:** Repositório como uma árvore radial ou treemap — o brilho é proporcional a quão profundamente um arquivo foi tocado.
|
|
684
|
-
- **Estados de Toque:** Visto (verde musgo), Lido (azul luar), Editado (âmbar quente), Não visitado (escuro).
|
|
685
|
-
- **Deck de Reprodução:** Avance ou reproduza a sessão sobre um histograma agrupado. Observação permanece fria, mutação brilha quente.
|
|
686
|
-
- **Lentes de Agente:** Quando uma sessão iniciou subagentes, escolha uma lente para reproduzir o trace de qualquer subagente no mesmo mapa.
|
|
687
|
-
- **Avaliação de Sessão:** Peça a um CLI de agente local para julgar a trajetória da sessão contra critérios elaborados a partir do seu próprio pedido.
|
|
324
|
+
---
|
|
688
325
|
|
|
689
|
-
|
|
690
|
-
synapse # escaneia todos os diretórios de agentes, abre o navegador
|
|
691
|
-
synapse open <session.jsonl> # reproduz uma sessão específica
|
|
692
|
-
synapse map <repo> # renderiza um mapa do repositório, sem necessidade de sessão
|
|
693
|
-
```
|
|
326
|
+
## Módulos opcionais
|
|
694
327
|
|
|
695
|
-
|
|
328
|
+
O instalador oferece esses módulos na seleção, e o Quick Update os mantém atualizados. Todos são opcionais; AOS funciona autossuficiente sem nenhum deles.
|
|
696
329
|
|
|
697
|
-
|
|
330
|
+
### memB — Memória Vetorial Local
|
|
698
331
|
|
|
699
|
-
|
|
332
|
+
`@hybridlabor-api/memb`: memória vetorial offline, local com servidor MCP, WebUI na porta 8088 e hook ambiente que injeta memórias relevantes em sessões Claude Code. Skill: `memb-skill`, `memb-ingest`, `bdb-memb-mcp`.
|
|
700
333
|
|
|
701
|
-
|
|
702
|
-
<summary><strong>⚙️ Como Funciona o Ecossistema (Skills, Vaults & Obsidian)</strong></summary>
|
|
334
|
+
### deja — Indexação de Transcrito
|
|
703
335
|
|
|
704
|
-
|
|
705
|
-
O ecossistema inclui uma skill profundamente integrada (`/memb-ingest`). Quando um agente executa isso, o script `memb_ingest.py` rastreia recursivamente seu projeto (lendo `.openwiki`, `AGENTS.md`, transcrições e arquivos de arquitetura).
|
|
706
|
-
* **Embeddings Vetoriais Offline:** Ele empacota um modelo ONNX `all-MiniLM-L6-v2` pré-quantizado de 30MB para fragmentar e armazenar esses aprendizados nativamente em um banco de dados vetorial SQLite rápido (`~/.MemBDB/memb.db`), tudo sem acessar APIs externas.
|
|
336
|
+
`@vshulcz/deja-vu`: indexa seus transcritos de agentes localmente (segredos redatados), com `deja fix` em um erro, `deja wip` para retomar, `deja search` para sessões passadas. Instalado com memB. Skill: `deja-memory`.
|
|
707
337
|
|
|
708
|
-
###
|
|
709
|
-
Assim que a ingestão é concluída, o memB gera nativamente um **Vault de Markdown físico** (`~/.MemBDB/memB_Vault`) estruturado em torno de uma topologia radial rigorosa de "God Mode":
|
|
710
|
-
* **Contexto Zero-Compute:** Um `AGENTS.md` universal e um `God_Mode.md` mestre são escritos na raiz. Modelos locais pequenos de inferência de 30MB podem se orientar macroscopicamente instantaneamente lendo esses arquivos físicos sem gastar tokens de contexto em chamadas de banco de dados complexas.
|
|
711
|
-
* **RAG Micro-Direcionado:** Para execução precisa, os pequenos LLMs consultam o banco de dados vetorial para recuperar apenas os 3-5 sub-arquivos exatos necessários.
|
|
338
|
+
### OpenWiki — Documentação Viva
|
|
712
339
|
|
|
713
|
-
|
|
714
|
-
O memB inclui um **Plugin Obsidian** nativo (`obsidian-memb-plugin`) que atua como uma interface visual sobre seu vault físico.
|
|
715
|
-
* **Árvore Radial Top-Down:** Ele lê o `memB_Vault` gerado e o mapeia visualmente usando a visualização de grafo do Obsidian.
|
|
716
|
-
* Usando estritamente links direcionais de pai para filho (ex: God Mode -> Projetos -> Categoria -> Neurônio), o grafo do Obsidian se expande para fora como uma flor, evitando completamente o agrupamento de contexto em "buraco negro" visto em bancos de dados de grafos não estruturados.
|
|
340
|
+
CLI `openwiki`: gera e atualiza uma wiki fundamentada de uma base de código, com um visualizador na porta 4321 e um daemon de fundo. Skill: `openwiki-skill`. Wiki deste repo: [.openwiki/](.openwiki/quickstart.md).
|
|
717
341
|
|
|
718
|
-
###
|
|
719
|
-
* **Zero Telemetria:** Soberania absoluta de dados sem rastreamento remoto.
|
|
720
|
-
* **Filtragem de Segredos:** Bloqueia senhas, chaves de API brutas e strings de conexão antes da injeção.
|
|
721
|
-
</details>
|
|
342
|
+
### Synapse — Cidade de Código 3D
|
|
722
343
|
|
|
723
|
-
|
|
344
|
+
`@hybridlabor-api/bdb-synapse`: renderiza um repositório como uma cidade de código 3D e repassa sessões de agentes como rastros de luz. Skill: `synapse-integration-skill`.
|
|
724
345
|
|
|
725
|
-
|
|
346
|
+
```mermaid
|
|
347
|
+
flowchart LR
|
|
348
|
+
A[Agent Session Logs] -->|JSONL Parsing| B[Go Trace Adapters]
|
|
349
|
+
B --> C[Normalized Event Stream]
|
|
350
|
+
D[Repository Tree] -->|Deterministic Layout| E[3D Citymap Generator]
|
|
351
|
+
C & E --> F[Local Go Server]
|
|
352
|
+
F --> G[React + Three.js WebGL Frontend]
|
|
353
|
+
G --> H[Interactive 3D Code City]
|
|
354
|
+
```
|
|
726
355
|
|
|
727
|
-
|
|
356
|
+
### AO — Orquestrador de Agente
|
|
728
357
|
|
|
729
|
-
|
|
358
|
+
`@hybridlabor-api/bdb-agent-orchestrator`: agentes paralelos em Git worktrees com controle de terminal ao vivo e loops de feedback CI/CD automatizados. Skill: `agent-orchestrator`.
|
|
730
359
|
|
|
731
|
-
|
|
732
|
-
|
|
360
|
+
```mermaid
|
|
361
|
+
flowchart TD
|
|
362
|
+
A[Desktop IDE Meta-Harness] --> B[Git Worktree Orchestrator]
|
|
363
|
+
B --> C[Agent Session 1: Feature Build]
|
|
364
|
+
B --> D[Agent Session 2: Refactoring]
|
|
365
|
+
B --> E[Agent Session N: Test & Verification]
|
|
366
|
+
C --> F[Live Terminal Control & Process Monitor]
|
|
367
|
+
D --> F
|
|
368
|
+
E --> F
|
|
369
|
+
F --> G[Automatic CI/CD Feedback Loops]
|
|
370
|
+
G --> H[PR Review & Merge Routing]
|
|
371
|
+
H --> I[Central Git Repository]
|
|
372
|
+
```
|
|
733
373
|
|
|
734
|
-
|
|
735
|
-
- **Garantia de Perda Zero de Informação:** Preserva todas as mensagens de erro, asserções falhas, stack traces, códigos de saída e contexto de depuração acionável, enquanto remove espaços em branco redundantes, spinners de progresso e logs repetitivos.
|
|
736
|
-
- **Ocultação Automática de Segredos:** Detecta e oculta automaticamente senhas, tokens, chaves de API e variáveis de ambiente sensíveis antes de inserir a saída de comandos nas janelas de contexto do agente.
|
|
737
|
-
</details>
|
|
374
|
+
### Creator Extension — Mídia & 3D
|
|
738
375
|
|
|
739
|
-
|
|
740
|
-
<summary><strong>🔬 Especificações Técnicas & Processadores</strong></summary>
|
|
376
|
+
`@hybridlabor-api/bdb-dev-creator-extension`: capacidades ComfyUI MCP (FLUX, SDXL), image-to-3D (TripoSR, TRELLIS) e produção de vídeo automatizada (OpenMontage, Remotion). Skill: `bdb-dev-creator-extension`.
|
|
741
377
|
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
378
|
+
```mermaid
|
|
379
|
+
flowchart LR
|
|
380
|
+
A[Core Skills Agent] -->|MCP Request| B[BDB Creator Extension Router]
|
|
381
|
+
B --> C[3D Generation Suite]
|
|
382
|
+
B --> D[Cinema Video Suite]
|
|
383
|
+
B --> E[Local ComfyUI MCP Engine]
|
|
384
|
+
C --> C1[TRELLIS: High-Fidelity 3D]
|
|
385
|
+
C --> C2[TripoSR: Fast Mesh]
|
|
386
|
+
C --> C3[CadQuery: Text-to-CAD]
|
|
387
|
+
D --> D1[OpenMontage AI Director]
|
|
388
|
+
D --> D2[Remotion Video-Shotcraft]
|
|
389
|
+
E --> E1[FLUX.1 Image Gen]
|
|
390
|
+
E --> E2[SDXL Pipeline]
|
|
391
|
+
C1 & C2 & C3 & D1 & D2 & E1 & E2 --> F[Rendered Media & Spatial Assets]
|
|
392
|
+
```
|
|
749
393
|
|
|
750
|
-
|
|
751
|
-
<summary><strong>🔌 Integração de Agentes & Hooks</strong></summary>
|
|
394
|
+
### Hardware & PCB — Design Elétrico
|
|
752
395
|
|
|
753
|
-
-
|
|
754
|
-
- **Supported Harnesses:**
|
|
755
|
-
- **Claude Code:** Integrated via `PreToolUse` hook.
|
|
756
|
-
- **Google Antigravity CLI:** Integrated via `AfterTool` hook.
|
|
396
|
+
`@hybridlabor-api/bdb-hardware-pcb`: módulo de design KiCad e OpenSCAD, orientado por skill `godmode-hardware-pcb`. Expõe portão ERC/DRC, assinatura de gerber e design paramétrico de invólucro. Skills: `godmode-hardware-pcb`, `bdb-hardware-pcb`.
|
|
757
397
|
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
398
|
+
```mermaid
|
|
399
|
+
flowchart LR
|
|
400
|
+
A[Agent] -->|MCP| B[kicad-mcp-server]
|
|
401
|
+
A -->|MCP| C[openscad-mcp-server]
|
|
402
|
+
B --> D[Schematic Capture & ERC]
|
|
403
|
+
B --> E[PCB Layout & Routing]
|
|
404
|
+
B --> F[DRC / DFM / Gerber Sign-Off]
|
|
405
|
+
C --> G[Parametric Enclosure]
|
|
406
|
+
D & E & F & G --> H[Fabrication-Ready Output]
|
|
407
|
+
```
|
|
764
408
|
|
|
765
|
-
|
|
409
|
+
### Heimdall Token Saver — Compressão de Saída CLI
|
|
766
410
|
|
|
767
|
-
|
|
411
|
+
`@hybridlabor-api/heimdall-token-saver`: comprime saída CLI repetida via hooks ambiente em todo harness. Reduz sobrecarga de token em projetos grandes. Skill: `token-saver-config`.
|
|
768
412
|
|
|
769
|
-
|
|
413
|
+
|
|
770
414
|
|
|
771
|
-
|
|
772
|
-
- **`@next`** — um canal de staging ad-hoc usado ocasionalmente para grandes mudanças (como a renomeação v4.0.0 AOS) antes da promoção para `@latest` (que o CI publica automaticamente a cada release do release-please). Não é um canal paralelo permanente.
|
|
773
|
-
- **`bdb-antigravity-skills@legacy`** — o pacote original, pré-dispatcher, apenas para Antigravity, mantido para qualquer um que ainda dependa dele.
|
|
415
|
+
*Esboço ilustrativo da v3.x. Os percentuais são estimativas do próprio projeto, não medições feitas para este README.*
|
|
774
416
|
|
|
775
|
-
|
|
417
|
+
---
|
|
776
418
|
|
|
777
|
-
|
|
778
|
-
Diga ao seu assistente: *"Execute `npx -y @hybridlabor-api/aos@latest` para instalar o pacote de skills e configurar os servidores MCP locais."*
|
|
419
|
+
## Atualizando
|
|
779
420
|
|
|
780
|
-
|
|
421
|
+
Execute o mesmo comando novamente. O instalador vê a versão instalada, oferece **Quick Update** e atualiza skills, hooks, templates e módulos:
|
|
781
422
|
|
|
782
423
|
```bash
|
|
783
|
-
# Estável
|
|
784
424
|
npx -y @hybridlabor-api/aos@latest
|
|
785
|
-
|
|
786
|
-
# Canal de staging para migração (v4.0.0 AOS)
|
|
787
|
-
# Nota: @next é usado apenas ocasionalmente para migrações ativas, não é um canal permanente.
|
|
788
|
-
npx -y @hybridlabor-api/aos@next
|
|
789
425
|
```
|
|
790
|
-
*(Funciona em terminais Mac/Linux, bem como no Windows PowerShell.)*
|
|
791
426
|
|
|
792
|
-
|
|
427
|
+
Não há um subcomando `aos update`. Se você já executou `npm i -g @hybridlabor-api/aos` alguma vez, um simples `aos` no seu PATH executa essa cópia congelada e sua versão, não a mais recente; ou atualize (`npm i -g @hybridlabor-api/aos@latest`) ou remova e fique com `npx`. O instalador imprime o comando de atualização em si sempre que uma versão mais recente existe; a skill `bdb-updater` envolve a mesma verificação para uso dentro de uma sessão.
|
|
793
428
|
|
|
794
|
-
|
|
429
|
+
## Desinstalar
|
|
795
430
|
|
|
796
431
|
```bash
|
|
797
|
-
|
|
432
|
+
aos-uninstall # removes what AOS installed; memory, wikis and credentials stay
|
|
433
|
+
aos-uninstall --purge # also removes ~/.MemBDB, ~/.openwiki, ~/.synapse, ~/.memb
|
|
434
|
+
aos-uninstall --dry-run # list everything, delete nothing
|
|
798
435
|
```
|
|
799
436
|
|
|
800
|
-
|
|
437
|
+
O desinstalador funciona a partir do manifesto de instalação: um arquivo que ainda corresponde ao hash que AOS escreveu é removido, um arquivo que você editou é salvo como backup, um arquivo que AOS nunca escreveu não é tocado. A mesma ação está no menu do instalador.
|
|
801
438
|
|
|
802
|
-
|
|
439
|
+
---
|
|
803
440
|
|
|
804
|
-
|
|
805
|
-
npx -y @hybridlabor-api/aos --project-harness
|
|
806
|
-
```
|
|
441
|
+
## Contribuindo
|
|
807
442
|
|
|
808
|
-
|
|
443
|
+
- [AGENTS.md](AGENTS.md) é a única fonte de regras para cada harness: o contrato de skill, roteamento de categoria, o portão de lançamento, Conventional Commits.
|
|
444
|
+
- Uma skill é um diretório com `SKILL.md`; o frontmatter precisa de `name` (igual ao diretório), `description` e uma `category`: `bdb-core`, `design-ui-ux`, `engineering-method`, `engineering-hardware`, `media-eventtech`, `library`. `npm run validate` executa o contrato, assim como CI em cada push.
|
|
445
|
+
- `npm test` executa o self-test do validador, verificação do manifesto plugin e testes do instalador, store, doctor e hooks entre harnesses.
|
|
446
|
+
- `.claude-plugin/plugin.json` e `marketplace.json` são gerados por `npm run plugin:build` e verificados por `npm run plugin:check`. Existem hoje; o caminho de instalação do marketplace Claude Code ainda está sendo finalizado, então o instalador acima permanece a rota suportada.
|
|
447
|
+
- Releases são cortadas pelo release-please de Conventional Commits; não bump `package.json` manualmente. `feat:` significa um bump menor.
|
|
448
|
+
- Skills derivadas de outros projetos registram `source:` no frontmatter e uma entrada em [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
|
|
809
449
|
|
|
810
|
-
|
|
811
|
-
git clone https://github.com/hybridlabor-api/aos.git
|
|
812
|
-
cd aos
|
|
813
|
-
npm install
|
|
814
|
-
node installer.js
|
|
815
|
-
```
|
|
450
|
+
## Links
|
|
816
451
|
|
|
817
|
-
|
|
818
|
-
|
|
452
|
+
- Pacote: [npmjs.com/package/@hybridlabor-api/aos](https://www.npmjs.com/package/@hybridlabor-api/aos)
|
|
453
|
+
- Fonte e issues: [github.com/hybridlabor-api/aos](https://github.com/hybridlabor-api/aos) · [issues](https://github.com/hybridlabor-api/aos/issues)
|
|
454
|
+
- [CHANGELOG.md](CHANGELOG.md) · [docs/skills_table.md](docs/skills_table.md)
|
|
455
|
+
- Repos irmãos: [bdb-agent-orchestrator](https://github.com/hybridlabor-api/bdb-agent-orchestrator) · [bdb-synapse](https://github.com/hybridlabor-api/bdb-synapse) · [bdb-dev-creator-extension](https://github.com/hybridlabor-api/bdb-dev-creator-extension) · [bdb-hardware-pcb](https://github.com/hybridlabor-api/bdb-hardware-pcb) · [bdb-os-remote](https://github.com/hybridlabor-api/bdb-os-remote)
|
|
456
|
+
|
|
457
|
+
Licença: [Apache-2.0](LICENSE).
|