🚀 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

$3

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

$3

Execute diretamente sem precisar instalar:

``bash

Executar diretamente

npx @edalicio/ag-kit

Com argumentos

npx @edalicio/ag-kit --stack frontend
npx @edalicio/ag-kit --providers opencode,antigravity
`

$3

`bash

Clone o repositório

git clone ag-kit
cd ag-kit

Instale as dependências

npm install

Execute a sincronização

npm run sync
`

$3

`bash

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

$3

Execute sem argumentos para escolher stacks e providers interativamente:

`bash
npm run sync
`

$3

`bash

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

$3

Define os providers ativos e suas configurações:

`json
{
"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) |

$3

`bash

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

$3

Sincroniza para o formato OpenCode com suporte a:
- Agentes com frontmatter YAML
- Skills com parâmetros de modelo
- Configuração de ferramentas

$3

Sincroniza para a estrutura Antigravity:
- /agents - Agentes especializados
- /skills - Habilidades reutilizáveis
- /rules - Regras de desenvolvimento
- /workflows - Automações

$3

Sincroniza para o formato Claude Desktop/MCP

$3

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

$3

`json
{
"analysis": {
"enabled": false
}
}
`

---

💡 Exemplos de Uso

$3

`bash

Sincronizar apenas para frontend

npm run sync -- --stack frontend --providers opencode,antigravity
`

$3

`bash

Usar stack backend

npm run sync -- --stack backend
`

$3

`bash

Menu interativo para escolher contextos

npm run sync -- --select-stack
`

$3

`bash

Sincronizar tudo exceto Claude

npm run sync -- --skip claude
`

$3

`bash

Sincronização silenciosa e completa

npm run sync -- --stack all --providers opencode
`

---

🛠️ Adicionando Novos Providers

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

`javascript
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:

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

---

🤝 Contribuindo

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

$3

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

$3

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

$3

Edite stacks.json e adicione sua stack customizada

$3

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