🚀 AG-Kit (Antigravity Kit)

Sistema modular de sincronização de contextos para agentes de IA

AG-Kit é uma ferramenta poderosa para gerenciar e sincronizar configurações de agentes, skills, regras e workflows entre diferentes plataformas de desenvolvimento assistido por IA (OpenCode, Antigravity, Claude, etc).

📋 Índice

• Características
• Instalação
• Uso Rápido
• Estrutura do Projeto
• Configuração
• Stacks Disponíveis
• Providers
• Análise de Código
• Exemplos de Uso
• Contribuindo

✨ Características

• 🎯 Sincronização multi-plataforma: Suporta OpenCode, Antigravity, Claude e outros providers
• 🔧 Modular e extensível: Fácil adição de novos providers
• 📦 Sistema de Stacks: Escolha contextos específicos para diferentes tipos de projeto (frontend, backend, fullstack, mobile, etc)
• 🤖 Agentes especializados: Diversos agentes para diferentes necessidades de desenvolvimento
• 🎨 Skills organizadas: Biblioteca de habilidades reutilizáveis para agentes
• 🔍 Análise automática de projeto: Identifica linguagens, frameworks e gera documentação
• 💬 Interface interativa: Menu intuitivo para seleção de providers e stacks
• ⚡ CLI completo: Suporte a flags e argumentos para automação

📦 Instalação

Pré-requisitos

• Node.js 14+ (recomendado v16 ou superior)
• npm ou yarn

Uso com npx (recomendado - sem instalação)

Execute diretamente sem precisar instalar:

# Executar diretamente
npx @edalicio/ag-kit

# Com argumentos
npx @edalicio/ag-kit --stack frontend
npx @edalicio/ag-kit --providers opencode,antigravity

Instalação local (desenvolvimento)

# Clone o repositório
git clone <repo-url> ag-kit
cd ag-kit

# Instale as dependências
npm install

# Execute a sincronização
npm run sync

Instalação global

# Do npm (após publicação)
npm install -g @edalicio/ag-kit

# Do repositório local
npm install -g .

# Usar o comando
ag-kit

🚀 Uso Rápido

Modo interativo (recomendado)

Execute sem argumentos para escolher stacks e providers interativamente:

npm run sync

Modo automático

# Sincronizar todos os providers com stack fullstack
npm run sync -- --stack fullstack

# Sincronizar apenas OpenCode
npm run sync -- --only opencode

# Sincronizar múltiplos providers
npm run sync -- --providers opencode,antigravity

# Pular um provider específico
npm run sync -- --skip claude

📂 Estrutura do Projeto

ag-kit/
├── src/
│   ├── contexts/           # Fonte dos contextos
│   │   ├── agents/        # Definições de agentes
│   │   ├── skills/        # Skills reutilizáveis
│   │   ├── rules/         # Regras de desenvolvimento
│   │   └── workflows/     # Workflows automatizados
│   ├── providers/         # Implementações de providers
│   │   ├── opencode.js
│   │   ├── antigravity.js
│   │   ├── claude.js
│   │   └── contexts.js
│   ├── analysis/          # Sistema de análise de código
│   ├── core.js           # Lógica central
│   └── main.js           # Ponto de entrada
├── config.json           # Configuração de providers
├── stacks.json           # Definição de stacks
└── package.json

⚙️ Configuração

config.json

Define os providers ativos e suas configurações:

{
  "active_bridges": ["opencode", "antigravity", "claude"],
  "source_dir": "./src/contexts",
  "analysis": {
    "enabled": true,
    "output_dir": "./.contexts/analysis",
    "auto_run": true,
    "depth": "comprehensive"
  },
  "providers": {
    "opencode": {
      "dest": "./.opencode",
      "enabled": true
    },
    "antigravity": {
      "dest": "./.agent",
      "enabled": true
    },
    "claude": {
      "dest": "./.claude",
      "enabled": true
    },
    "contexts": {
      "dest": "./.contexts",
      "enabled": true
    }
  }
}

🎨 Stacks Disponíveis

O AG-Kit oferece stacks pré-configuradas para diferentes tipos de projeto:

| Stack | Descrição | Agentes Principais | Use Quando... | |-------|-----------|-------------------|---------------| | frontend 🎨 | React/Next.js + TypeScript + Tailwind | frontend-specialist, ux-ui-designer, performance-optimizer | Desenvolver interfaces web modernas | | backend ⚡ | Node.js/Python/PHP + APIs + Database | backend-specialist, database-architect, security-auditor | Criar APIs e serviços backend | | mobile 📱 | React Native/Flutter + Cross-platform | mobile-developer, ux-ui-designer | Desenvolver apps mobile | | fullstack 🌐 | Stack completa web | orchestrator, frontend + backend specialists | Projetos web completos | | gamedev 🎮 | Unity/Phaser/Three.js + Performance | game-developer, performance-optimizer | Desenvolver jogos | | devops 🛡️ | Docker/K8s + CI/CD + Cloud | devops-engineer, security-auditor | Infraestrutura e deploy | | security 🔍 | Pentest + Audit + Compliance | security-auditor, penetration-tester | Segurança e auditoria | | qa 🧪 | Testing + E2E + Performance | test-engineer, qa-automation-engineer | Testes e qualidade | | advanced 🧠 | Advanced Agent & Tool Building | orchestrator, software-architect | Desenvolvimento avançado | | all 🌟 | Todos os agentes e skills | Todos | Acesso total (padrão) |

Exemplo de uso com stacks

# Desenvolvimento frontend
npm run sync -- --stack frontend

# Múltiplas stacks
npm run sync -- --stack frontend,backend

# Seleção interativa de stacks
npm run sync -- --select-stack

🔌 Providers

OpenCode

Sincroniza para o formato OpenCode com suporte a:

• Agentes com frontmatter YAML
• Skills com parâmetros de modelo
• Configuração de ferramentas

Antigravity (.agent)

Sincroniza para a estrutura Antigravity:

• /agents - Agentes especializados
• /skills - Habilidades reutilizáveis
• /rules - Regras de desenvolvimento
• /workflows - Automações

Claude (.claude)

Sincroniza para o formato Claude Desktop/MCP

Contexts (.contexts)

Cópia espelho dos contextos para uso geral

🔍 Análise de Código

O AG-Kit inclui um sistema de análise que:

• ✅ Identifica linguagens e frameworks usados no projeto
• ✅ Detecta configurações e dependências
• ✅ Gera documentação automática do projeto
• ✅ Cria resumo em .contexts/analysis/summary.md
• ✅ Atualiza automaticamente o README dos agentes

Desabilitar análise

{
  "analysis": {
    "enabled": false
  }
}

💡 Exemplos de Uso

Cenário 1: Novo projeto React

# Sincronizar apenas para frontend
npm run sync -- --stack frontend --providers opencode,antigravity

Cenário 2: API Backend Node.js

# Usar stack backend
npm run sync -- --stack backend

Cenário 3: Projeto fullstack em equipe

# Menu interativo para escolher contextos
npm run sync -- --select-stack

Cenário 4: Desenvolvimento local sem Claude

# Sincronizar tudo exceto Claude
npm run sync -- --skip claude

Cenário 5: Automação CI/CD

# Sincronização silenciosa e completa
npm run sync -- --stack all --providers opencode

🛠️ Adicionando Novos Providers

1. Crie src/providers/meu-provider.js:

export async function sync(contexts, config) {
  console.log(`🔄 Sincronizando para ${config.dest}...`);
  
  // Sua lógica de sincronização aqui
  // contexts contém: agents, skills, rules, workflows
  
  console.log(`✅ ${config.dest} sincronizado!`);
}

2. Adicione ao config.json:

{
  "active_bridges": ["opencode", "antigravity", "meu-provider"],
  "providers": {
    "meu-provider": {
      "dest": "./.meu-provider",
      "enabled": true
    }
  }
}

🤝 Contribuindo

Contribuições são bem-vindas! Para adicionar:

Novos Agentes

Crie em src/contexts/agents/nome-agente.md

Novas Skills

Crie em src/contexts/skills/nome-skill/SKILL.md

Novas Stacks

Edite stacks.json e adicione sua stack customizada

Novos Providers

Crie em src/providers/nome-provider.js

📝 Licença

ISC

🙏 Agradecimentos

Desenvolvido para facilitar o trabalho com agentes de IA em diferentes plataformas, permitindo uma experiência consistente e modular.

📧 Suporte

Para dúvidas ou problemas:

• Abra uma issue no repositório
• Consulte a documentação em src/contexts/

Feito com ❤️ para desenvolvedores que usam IA como copiloto de desenvolvimento