convez.ai
AgenteDesenvolvimento WebAvançado
Vin1-SF19

BibbleSquad

Vin1-SF19/BibbleSquad

21 agentes orquestrados para desenvolvimento de software do planejamento ao deploy

Ver no GitHub
InicialPluginScore · de 0 a 100

Squad 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/BibbleSquad

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 SquadCom 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

AgenteSkillFunção
Bibble/bibbleArquiteto-chefe. Único ponto de contato. Orquestra toda a squad

🔭 Reconhecimento — Obrigatório antes de qualquer implementação

AgenteSkillFunção
Scout/scoutLê o código, mapeia integration points, entrega blueprint escrito

✨ Frontend, Design & Performance

AgenteSkillFunção
Nova/novaReact/Next.js, TypeScript, Server/Client components, hooks
Iris/irisUI/UX designer — cria 3 opções visuais, specs de interface "viva"
Atlas/atlasAnalista visual — extrai design tokens de sites existentes
Flux/fluxPerformance — Core Web Vitals, bundle analysis, SSR/ISR, SEO

📡 Backend & Dados

AgenteSkillFunção
Echo/echoAPI routes, Server Actions, Prisma, autenticação
DataEngineer/data-engineerSchema design, migrations seguras, queries otimizadas, índices
Vault/vault🔒 Guardião do banco — bloqueia migrations destrutivas sem backup

⚡ Qualidade — Pipeline de Gates

AgenteSkillFunção
Forge/forgeRoda tsc --noEmit, lint, build REAIS — nunca "verificação estática"
Probe/probeVerifica integration points — a feature aparece onde deve aparecer?
Anubis/anubisSegurança — OWASP Top 10, IDOR, prompt injection, AI security
Lens/lensCode review 🔴🟡🟢 — SEMPRE após Forge aprovar
Sage/sageQA/testes, edge cases, regressões, veredicto PASS/CONCERNS/FAIL

💾 Memória & Documentação

AgenteSkillFunção
Scribe/scribeMantém mapa do codebase e integration points atualizados
Kowalski/kowalski🐧 Cronista — arquiva sessões em journal.md, mantém known-errors

📊 Produto & Análise

AgenteSkillFunção
PM/pmPRDs, epics, stories, roadmap, priorização RICE, análise de impacto
Analyst/analystPesquisa, análise competitiva, ROI, brainstorming, viabilidade técnica

🚀 DevOps & Infraestrutura

AgenteSkillFunção
DevOps/devopsEXCLUSIVO para git push, PRs, releases, CI/CD, branch protection

🤖 AI Engine — Para projetos com assistente IA

AgenteSkillFunção
Muse/bibble-museDefine identidade, voz e personalidade do assistente IA
Cortex/bibble-cortexClaude 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:

  1. Scout mapeia o código e entrega blueprint
  2. Nova/Echo implementam seguindo o blueprint
  3. DataEngineer/Vault se houver mudança no banco
  4. Forge verifica tsc + lint + build
  5. Probe verifica que aparece no menu e funciona
  6. Anubis audita se houver auth/API
  7. Lens revisa o código
  8. Sage testa edge cases
  9. Scribe atualiza a memória
  10. 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

WorkflowQuando UsarAtivar com
feature-workflowFeature nova médio/grande porte/bibble → "execute feature-workflow"
qa-loopQA reprovou, iterar correções/bibble → "execute qa-loop"
design-to-codeFeature com design visual complexo/bibble → "execute design-to-code"
new-project-setupPrimeira vez no projeto/bibble → "execute new-project-setup"
security-hardeningAuditoria 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

#RegraConsequência de Violar
1Nenhuma implementação começa sem ScoutTrabalho que será refeito
2Lens só revisa após Forge aprovarReview de código com erros de tipo
3Vault aprova antes de migration destrutivaPerda de dados
4DevOps é o único que faz git pushPushes não verificados
5Kowalski arquiva toda sessão significativaContexto perdido

Constitution — Princípios Inegociáveis

O Bibble Squad opera sob uma Constituição formal. Gates automáticos bloqueiam violações.

ArtigoPrincípioSeveridade
IScout Primeiro — nenhuma implementação sem blueprintNON-NEGOTIABLE
IIAutoridade dos Agentes — cada agente tem domínio exclusivoNON-NEGOTIABLE
IIIQualidade Obrigatória — Forge executa comandos reaisMUST
IVSem Invenção — consultar memória antes de qualquer açãoMUST
VSegurança Por Padrão — auth + ownership em todo endpoint/toolMUST
VIMemória é Sagrada — Scribe e Kowalski são obrigatóriosMUST
VIIImports Absolutos — sempre @/caminho, nunca ../../SHOULD
VIIIProbe Verifica Integração — feature visível ao usuárioMUST

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:

ArquivoO que guardaQuem atualiza
architecture.mdStack, banco, endpoints, env varsEcho, Scribe
decisions.mdDecisões técnicas e por quêBibble, PM, todos
patterns.mdPadrões de UX descobertosAtlas, Iris
design-tokens.mdCores, tipografia, espaçamentosAtlas
components.mdCatálogo de componentes existentesNova, Scribe
codebase-map.mdMapa estrutural do projetoScout, Scribe
integration-points.mdOnde cada módulo se integraScout, Scribe
journal.mdHistórico cronológico de sessõesKowalski
known-errors.mdErros resolvidos com seus fixesKowalski, Forge
bibble-persona.mdPersonalidade do assistente IAMuse
bibble-flows.mdTools e fluxos do assistenteCortex

Stack Suportada

O Bibble Squad funciona em qualquer projeto web moderno:

ÁreaCompatível com
FrameworkNext.js 13+, React, Remix, Nuxt
AuthNext-Auth v5, Clerk, Lucia, Better-Auth, custom JWT
BancoPostgreSQL, MySQL, SQLite, Turso, Supabase, PlanetScale, Neon
ORMPrisma, Drizzle, TypeORM, Kysely
EstilizaçãoTailwind CSS v4/v3, CSS Modules, Styled Components
UIshadcn/ui, Radix UI, MUI, Ant Design, Headless UI
EstadoZustand, Jotai, Redux Toolkit, React Query, SWR
AIClaude/Anthropic, OpenAI, Gemini, Ollama, local LLMs
DeployVercel, 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

  1. Fork o repositório
  2. Crie uma branch: feature/novo-agente ou fix/nome-do-fix
  3. Siga o formato dos SKILL.md existentes
  4. 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

Ver o original no GitHub

Bom para

Relacionados