BibbleSquad
Vin1-SF19/BibbleSquad
21 agentes orquestrados para desenvolvimento de software do planejamento ao deploy
Ver no GitHubSquad de 21 agentes de IA especializados que operam como uma equipe de desenvolvimento real dentro do Claude Code. Cobre todo o ciclo de software: planejamento, implementação, qualidade, segurança e deploy, com cada agente dominando uma especialidade exclusiva.
Instalação
npx convez-ai Vin1-SF19/BibbleSquad1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Orquestração completa do ciclo de desenvolvimento (planejamento até produção)
- Implementação de features com validação automática de qualidade e segurança
- Code review especializado com múltiplas lentes (performance, segurança, edge cases)
- Automação de pipelines de qualidade (tsc, lint, build, testes reais)
Veredito

Solução empresarial robusta para equipes que querem elevar a qualidade do desenvolvimento. Excelente para projetos com requisitos rigorosos de segurança e performance, mas requer compreensão técnica profunda para orquestração eficaz.
README
A tradução para o português deste README ainda está na fila.
🐟 Bibble Squad
A squad de IA para desenvolvimento de software moderno
21 agentes especializados · 11 tasks executáveis · 5 workflows completos · 5 checklists de qualidade · 5 templates — tudo integrado ao Claude Code.
O que é o Bibble Squad?
O Bibble Squad é uma coleção de agentes de IA especializados que operam como uma equipe de desenvolvimento real dentro do Claude Code.
Cada agente tem uma especialidade exclusiva, e juntos cobrem todo o ciclo de desenvolvimento: do planejamento de produto à entrega em produção, com qualidade e segurança em cada etapa.
Você pede uma feature → Bibble orquestra a squad → Feature entregue com qualidade
Por que usar uma squad ao invés de um assistente genérico?
Um assistente genérico faz tudo medianamente. A squad faz cada coisa com excelência:
| Sem Squad | Com Squad |
|---|---|
| "Crie uma rota" | Scout mapeia → Echo cria com padrões → Forge valida → Anubis audita |
| "Revise meu código" | Forge roda os checks reais → Lens classifica 🔴🟡🟢 → Sage testa edge cases |
| "Estou com um bug" | Kowalski consulta known-errors → Forge localiza → Lens verifica o fix |
| "Nova feature" | PM cria PRD → Scout mapeia → Nova/Echo implementa → pipeline completo |
Agentes (21 no total)
🧠 Orquestrador
| Agente | Skill | Função |
|---|---|---|
| Bibble | /bibble | Arquiteto-chefe. Único ponto de contato. Orquestra toda a squad |
🔭 Reconhecimento — Obrigatório antes de qualquer implementação
| Agente | Skill | Função |
|---|---|---|
| Scout | /scout | Lê o código, mapeia integration points, entrega blueprint escrito |
✨ Frontend, Design & Performance
| Agente | Skill | Função |
|---|---|---|
| Nova | /nova | React/Next.js, TypeScript, Server/Client components, hooks |
| Iris | /iris | UI/UX designer — cria 3 opções visuais, specs de interface "viva" |
| Atlas | /atlas | Analista visual — extrai design tokens de sites existentes |
| Flux | /flux | Performance — Core Web Vitals, bundle analysis, SSR/ISR, SEO |
📡 Backend & Dados
| Agente | Skill | Função |
|---|---|---|
| Echo | /echo | API routes, Server Actions, Prisma, autenticação |
| DataEngineer | /data-engineer | Schema design, migrations seguras, queries otimizadas, índices |
| Vault | /vault | 🔒 Guardião do banco — bloqueia migrations destrutivas sem backup |
⚡ Qualidade — Pipeline de Gates
| Agente | Skill | Função |
|---|---|---|
| Forge | /forge | Roda tsc --noEmit, lint, build REAIS — nunca "verificação estática" |
| Probe | /probe | Verifica integration points — a feature aparece onde deve aparecer? |
| Anubis | /anubis | Segurança — OWASP Top 10, IDOR, prompt injection, AI security |
| Lens | /lens | Code review 🔴🟡🟢 — SEMPRE após Forge aprovar |
| Sage | /sage | QA/testes, edge cases, regressões, veredicto PASS/CONCERNS/FAIL |
💾 Memória & Documentação
| Agente | Skill | Função |
|---|---|---|
| Scribe | /scribe | Mantém mapa do codebase e integration points atualizados |
| Kowalski | /kowalski | 🐧 Cronista — arquiva sessões em journal.md, mantém known-errors |
📊 Produto & Análise
| Agente | Skill | Função |
|---|---|---|
| PM | /pm | PRDs, epics, stories, roadmap, priorização RICE, análise de impacto |
| Analyst | /analyst | Pesquisa, análise competitiva, ROI, brainstorming, viabilidade técnica |
🚀 DevOps & Infraestrutura
| Agente | Skill | Função |
|---|---|---|
| DevOps | /devops | EXCLUSIVO para git push, PRs, releases, CI/CD, branch protection |
🤖 AI Engine — Para projetos com assistente IA
| Agente | Skill | Função |
|---|---|---|
| Muse | /bibble-muse | Define identidade, voz e personalidade do assistente IA |
| Cortex | /bibble-cortex | Claude API, streaming SSE, prompt caching, tool use, agent loop |
Instalação
Pré-requisitos
- Claude Code instalado
- Node.js 18+
- Projeto web (Next.js, React, ou similar)
Passo 1 — Clonar o repositório
# Em alguma pasta acessível (não precisa ser no projeto)
git clone https://github.com/seu-usuario/bibble-squad.git
Passo 2 — Instalar no seu projeto
# Navegar para o seu projeto
cd /caminho/para/seu/projeto
# Rodar o installer
node /caminho/para/bibble-squad/install.js
Saída esperada:
┌────────────────────────────────────────────────┐
│ 🐟 Bibble Squad — Installer v2.0 │
└────────────────────────────────────────────────┘
[1/6] Instalando skills em .claude/skills/bibble-squad/ ...
✅ 21 agentes instalados
[2/6] Criando estrutura .bibble/ (memória e regras) ...
✅ Estrutura .bibble/ criada
[3/6] Instalando tasks em .bibble/tasks/ ...
✅ 11 tasks instaladas
[4/6] Instalando workflows em .bibble/workflows/ ...
✅ 5 workflows instalados
[5/6] Instalando checklists e templates ...
✅ 5 checklists + 5 templates instalados
[6/6] Instalando constitution e core-config ...
✅ constitution.md instalado
✅ core-config.yaml instalado
✅ Instalação concluída!
Passo 3 — Recarregar o Claude Code
Ctrl+Shift+P → Developer: Reload Window
Passo 4 — Ativar e configurar
/bibble
"Bibble, execute o workflow new-project-setup para configurar a memória do projeto"
O Bibble vai guiar você pelo setup inicial: mapeamento do codebase, identificação da stack, documentação dos integration points.
Como Usar
Uso Básico — Fale com Bibble
Bibble é o único ponto de contato. Você fala com Bibble, Bibble orquestra a squad:
/bibble → "quero criar um módulo de relatórios financeiros"
Bibble vai executar automaticamente o pipeline:
- Scout mapeia o código e entrega blueprint
- Nova/Echo implementam seguindo o blueprint
- DataEngineer/Vault se houver mudança no banco
- Forge verifica tsc + lint + build
- Probe verifica que aparece no menu e funciona
- Anubis audita se houver auth/API
- Lens revisa o código
- Sage testa edge cases
- Scribe atualiza a memória
- Kowalski arquiva a sessão
Usar Agentes Diretamente
Você também pode ir direto para o especialista:
/scout # "mapeie o que precisa mudar para adicionar a rota /dashboard/analytics"
/forge # "verifique se o build está passando"
/anubis # "audite a segurança das novas routes de pagamento"
/lens # "revise o componente ClienteCard.tsx"
/pm # "crie um PRD para o módulo de faturamento"
/analyst # "compare react-query vs swr para o nosso projeto"
/devops # "faça push e crie um PR para main"
/data-engineer # "projete o schema para a entidade Fatura"
Workflows Disponíveis
| Workflow | Quando Usar | Ativar com |
|---|---|---|
feature-workflow | Feature nova médio/grande porte | /bibble → "execute feature-workflow" |
qa-loop | QA reprovou, iterar correções | /bibble → "execute qa-loop" |
design-to-code | Feature com design visual complexo | /bibble → "execute design-to-code" |
new-project-setup | Primeira vez no projeto | /bibble → "execute new-project-setup" |
security-hardening | Auditoria de segurança | /bibble → "execute security-hardening" |
Fluxo de Execução Padrão
SCOUT (blueprint obrigatório)
↓
┌───────────────────────────────┐
│ Nova Echo Iris DataEng │ (implementação)
└───────────────────────────────┘
↓
VAULT (se banco foi alterado)
↓
FORGE (tsc + lint + build)
↓
PROBE (integration points)
↓
ANUBIS (se auth / API / AI / upload)
↓
LENS (code review 🔴🟡🟢)
↓
SAGE (QA: PASS/CONCERNS/FAIL)
↓
SCRIBE (atualiza memória)
↓
KOWALSKI (arquiva sessão)
↓
DEVOPS (git push → PR)
Regras de Ouro
| # | Regra | Consequência de Violar |
|---|---|---|
| 1 | Nenhuma implementação começa sem Scout | Trabalho que será refeito |
| 2 | Lens só revisa após Forge aprovar | Review de código com erros de tipo |
| 3 | Vault aprova antes de migration destrutiva | Perda de dados |
| 4 | DevOps é o único que faz git push | Pushes não verificados |
| 5 | Kowalski arquiva toda sessão significativa | Contexto perdido |
Constitution — Princípios Inegociáveis
O Bibble Squad opera sob uma Constituição formal. Gates automáticos bloqueiam violações.
| Artigo | Princípio | Severidade |
|---|---|---|
| I | Scout Primeiro — nenhuma implementação sem blueprint | NON-NEGOTIABLE |
| II | Autoridade dos Agentes — cada agente tem domínio exclusivo | NON-NEGOTIABLE |
| III | Qualidade Obrigatória — Forge executa comandos reais | MUST |
| IV | Sem Invenção — consultar memória antes de qualquer ação | MUST |
| V | Segurança Por Padrão — auth + ownership em todo endpoint/tool | MUST |
| VI | Memória é Sagrada — Scribe e Kowalski são obrigatórios | MUST |
| VII | Imports Absolutos — sempre @/caminho, nunca ../../ | SHOULD |
| VIII | Probe Verifica Integração — feature visível ao usuário | MUST |
Constituição completa em .bibble/constitution.md.
Memória do Projeto
O squad aprende sobre seu projeto ao longo do tempo. Quanto mais sessões, mais contexto:
| Arquivo | O que guarda | Quem atualiza |
|---|---|---|
architecture.md | Stack, banco, endpoints, env vars | Echo, Scribe |
decisions.md | Decisões técnicas e por quê | Bibble, PM, todos |
patterns.md | Padrões de UX descobertos | Atlas, Iris |
design-tokens.md | Cores, tipografia, espaçamentos | Atlas |
components.md | Catálogo de componentes existentes | Nova, Scribe |
codebase-map.md | Mapa estrutural do projeto | Scout, Scribe |
integration-points.md | Onde cada módulo se integra | Scout, Scribe |
journal.md | Histórico cronológico de sessões | Kowalski |
known-errors.md | Erros resolvidos com seus fixes | Kowalski, Forge |
bibble-persona.md | Personalidade do assistente IA | Muse |
bibble-flows.md | Tools e fluxos do assistente | Cortex |
Stack Suportada
O Bibble Squad funciona em qualquer projeto web moderno:
| Área | Compatível com |
|---|---|
| Framework | Next.js 13+, React, Remix, Nuxt |
| Auth | Next-Auth v5, Clerk, Lucia, Better-Auth, custom JWT |
| Banco | PostgreSQL, MySQL, SQLite, Turso, Supabase, PlanetScale, Neon |
| ORM | Prisma, Drizzle, TypeORM, Kysely |
| Estilização | Tailwind CSS v4/v3, CSS Modules, Styled Components |
| UI | shadcn/ui, Radix UI, MUI, Ant Design, Headless UI |
| Estado | Zustand, Jotai, Redux Toolkit, React Query, SWR |
| AI | Claude/Anthropic, OpenAI, Gemini, Ollama, local LLMs |
| Deploy | Vercel, Railway, Fly.io, Render, AWS, GCP, VPS |
Módulo de AI — Para Projetos com Assistente
Se seu projeto tem ou vai ter um chat assistido por IA:
# 1. Definir a personalidade
/bibble-muse → "crie a persona do nosso assistente"
# 2. Implementar a infraestrutura de AI
/bibble-cortex → "implemente o endpoint de chat com Claude API"
Stack de AI configurada automaticamente:
// Modelo: claude-sonnet-4-6 (custo/qualidade ideal)
// Streaming: SSE — latência mínima no chat
// Cache: Prompt caching no system prompt (~90% redução de custo)
// Segurança: userId em todas as tools (anti-IDOR)
// Rate limit: por usuário (evita abuso)
Estrutura do Repositório
bibble-squad/
├── skills/ # 21 agentes (copiados para .claude/skills/)
│ ├── bibble/SKILL.md
│ ├── scout/SKILL.md
│ ├── forge/SKILL.md
│ ├── vault/SKILL.md
│ ├── probe/SKILL.md
│ ├── anubis/SKILL.md
│ ├── lens/SKILL.md
│ ├── sage/SKILL.md
│ ├── nova/SKILL.md
│ ├── echo/SKILL.md
│ ├── iris/SKILL.md
│ ├── atlas/SKILL.md
│ ├── flux/SKILL.md
│ ├── scribe/SKILL.md
│ ├── kowalski/SKILL.md
│ ├── pm/SKILL.md
│ ├── analyst/SKILL.md
│ ├── data-engineer/SKILL.md
│ ├── devops/SKILL.md
│ ├── bibble-muse/SKILL.md
│ └── bibble-cortex/SKILL.md
│
├── tasks/ # Tasks executáveis
│ ├── scout-blueprint.md # Mapear código e integration points
│ ├── build-check.md # tsc + lint + build
│ ├── dev-develop.md # Implementar seguindo blueprint
│ ├── qa-gate.md # QA completo com veredicto
│ ├── security-audit.md # Auditoria OWASP completa
│ ├── code-review.md # Review 🔴🟡🟢
│ ├── db-backup.md # Backup antes de migrations
│ ├── session-archive.md # Arquivar sessão no journal
│ ├── new-module-setup.md # Criar módulo com integration points
│ ├── performance-check.md # Core Web Vitals + bundle
│ └── atlas-extract-tokens.md # Extrair design tokens
│
├── workflows/ # Workflows completos
│ ├── feature-workflow.md # Feature do zero ao push
│ ├── qa-loop.md # Loop iterativo QA ↔ Dev
│ ├── design-to-code.md # Iris spec → Nova implementa
│ ├── new-project-setup.md # Onboarding de novo projeto
│ └── security-hardening.md # Auditoria completa de segurança
│
├── checklists/ # Checklists de qualidade
│ ├── feature-dod.md # Definition of Done
│ ├── security-checklist.md # 40 pontos de segurança
│ ├── api-checklist.md # Route handler / Server Action
│ ├── component-checklist.md # React component
│ └── new-module-integration.md # Integration points checklist
│
├── templates/ # Templates de documentação
│ ├── story-tmpl.md # Template de story
│ ├── prd-tmpl.md # Template de PRD
│ ├── api-spec-tmpl.md # Especificação de API
│ └── session-report-tmpl.md # Relatório de sessão
│
├── .bibble/ # Templates copiados para o projeto
│ ├── memory/ # 11 templates de memória (vazios)
│ └── rules/ # 4 arquivos de regras técnicas
│
├── constitution.md # 8 princípios inegociáveis
├── core-config.yaml # Configuração central do squad
├── install.js # Installer (Node.js)
├── package.json
└── README.md
Atualizar o Squad
# Atualizar o repositório
cd bibble-squad
git pull origin main
# Re-instalar (memória do projeto é preservada)
cd /seu-projeto
node bibble-squad/install.js
O que é preservado na atualização:
- ✅
.bibble/memory/— toda sua memória de projeto - ✅
.bibble/constitution.md— se customizada - ✅
.bibble/core-config.yaml— se customizado
O que é atualizado:
- 🔄
.claude/skills/bibble-squad/— agentes (sempre a versão mais recente) - 🔄
.bibble/tasks/— tasks do framework - 🔄
.bibble/workflows/— workflows do framework - 🔄
.bibble/checklists/— checklists do framework
Dicas Avançadas
Personalizar as Rules
Edite os arquivos em .bibble/rules/ para adaptar ao seu stack:
# Não usa Tailwind? Edite
.bibble/rules/styling-rules.md
# Usa Drizzle ao invés de Prisma? Edite
.bibble/rules/api-rules.md
# Usa Clerk ao invés de Next-Auth? Edite
.bibble/rules/nextjs-rules.md
Ensinar ao Squad
Quando aprender algo sobre seu projeto, diga ao Bibble:
/bibble → "Bibble, registra essa decisão: estamos usando Drizzle ORM, não Prisma"
/bibble → "Bibble, registra esse erro no known-errors: [erro] → [fix]"
Integration Points do Seu Projeto
Depois do setup inicial, verifique .bibble/memory/integration-points.md.
Esse arquivo é crítico — sem ele, Scout não sabe onde adicionar novos módulos.
Perguntas Frequentes
Q: Precisa de internet para usar o squad?
A: O squad é local. Você precisa de internet para a API do Claude (Anthropic).
Q: Funciona em projetos existentes?
A: Sim. Execute new-project-setup para a squad aprender seu projeto.
Q: Minha memória é apagada ao atualizar o squad?
A: Não. A pasta .bibble/memory/ é preservada em qualquer reinstalação.
Q: Posso usar apenas alguns agentes?
A: Sim. Todos são independentes. Use /nova e /forge sozinhos se quiser.
Q: O DevOps realmente precisa ser o único a fazer push?
A: É uma convenção de qualidade, não limitação técnica. Em uso solo você pode escolher não seguir.
Q: Funciona com TypeScript e JavaScript?
A: Sim. As rules são para TypeScript mas os princípios se aplicam a JS também.
Q: Posso adicionar novos agentes?
A: Sim. Crie skills/nome/SKILL.md seguindo o formato existente. O installer detecta automaticamente.
Contribuindo
- Fork o repositório
- Crie uma branch:
feature/novo-agenteoufix/nome-do-fix - Siga o formato dos SKILL.md existentes
- Abra um PR com descrição clara
Para adicionar um novo agente:
# Estrutura mínima do SKILL.md
---
name: nome-agente
description: "Descrição clara do que o agente faz e quando usar"
user-invocable: true
activation_type: pipeline
---
ACTIVATION-NOTICE: [instrução de ativação]
# NOME — TÍTULO
[persona e expertise]
## PRIMEIRA AÇÃO OBRIGATÓRIA
[o que ler antes de agir]
## [SEÇÃO PRINCIPAL]
[conhecimento especializado]
## COMANDOS
- `*comando` — descrição
## REGRAS ABSOLUTAS
- [regras inegociáveis]
Licença
MIT — Use, modifique e distribua livremente.
🐟 Bibble Squad
A squad de IA que transforma Claude Code em uma equipe de desenvolvimento completa