👑 Gama AIOS Kit

Sistema de customizações do Claude Code + AIOS framework para a agência Gama

Repositório centralizado com todas as configurações, agentes, workflows e squads do AIOS. Novo time member? Clone, rode install.sh, começa a trabalhar em 10 minutos.

🚀 Quick Start

Primeira vez (novo usuário)

# 1. Clone o repositório
git clone https://github.com/gama/gama-aios-kit.git
cd gama-aios-kit

# 2. Copiar variáveis de ambiente (preenchidas localmente)
cp env/.env.example .env
# Editar .env com suas API keys (EXA, SUPABASE, TELEGRAM, etc)

# 3. Instalar
bash install.sh

# 4. Reiniciar Claude Code
# (ou feche e abra de novo)

# 5. Testar
# Digite no Claude Code:
# /AIOS:agents:aios-master
# Deve mostrar: 👑 Orion (Orchestrator) pronto. Vamos orquestrar!

Atualizar (semanal/conforme necessário)

cd gama-aios-kit
git pull origin main
bash install.sh

# (Reiniciar Claude Code)

📦 O que é instalado?

Configs Globais (~/.claude/)

• CLAUDE.md — Sistema de prompts global do Claude (AIOS master, brief elicitation, auto-healing)
• rules/ — 11 arquivos de regras (agent authority, dispatcher, workflow execution, IDS principles, etc)
• commands/ — Slash commands para AIOS agents
  • AIOS/ — 12 agents (aios-master, dev, qa, pm, architect, data-engineer, etc)
  • DeepResearch/ — Deep research squad (11 agents + workflows)
  • SquadCreator/ — Squad management (templates, checklists, validators)
  • squads/ — Shortcuts para squad chiefs
• skills/ — Invocable skills (mesa-conselheira, guided-brief, etc)
• hooks/ — Automation hooks (ralph-loop, synapse-engine)
• workflows/ — Workflow templates (GLOBAIS, MESA_CONSELHEIRA)

Configs de Projeto (O_GRANDE_PROJETO/.claude/)

• CLAUDE.md — System prompt específico do projeto
• rules/ — Regras adicionais (Gama-específicas)

Squads & MCP Servers

• GAMA_AIOS/squads/ — 9 squads AIOX (apex-lead, curator, dispatch, education, kaizen, seo, sop, squad-chief, dr-orchestrator)
• mcp-servers/ — Servidores MCP locais (telegram-bot, whatsapp)

🔑 Configuração de API Keys

Cada novo usuário precisa preencher .env com suas API keys:

# EXA (web search)
EXA_API_KEY=seu_token_aqui

# SUPABASE (database)
SUPABASE_URL=...
SUPABASE_SERVICE_ROLE_KEY=...

# TELEGRAM (opcional)
TELEGRAM_BOT_TOKEN=...
TELEGRAM_CHAT_ID=...

# Outros (opcional)
GOOGLE_WORKSPACE_*
N8N_*
MAGIC_API_KEY

Ver env/.env.example para todas as opções.

📚 Como usar

Agentes AIOS

# Ativar agente master
/AIOS:agents:aios-master

# Ativar agente específico
@dev        # Development expert
@qa         # QA/testing expert
@architect  # Architecture expert
@pm         # Product manager
@analyst    # Research/analysis expert

# Ou via slash command
/AIOS:agents:aios-master
/AIOS:agents:dev
/AIOS:agents:qa

Workflows

# Mesa Conselheira (briefing colaborativo)
/mesa-conselheira "Novo projeto de SaaS para [descrição]"

# Ou ativar manualmente
@aios-master *mesa-conselheira

Comands de Agentes

# Ver todos os comandos
@aios-master *help

# Criar novo agente
@aios-master *create agent {nome}

# Criar novo task
@aios-master *create task {nome}

# Criar novo workflow
@aios-master *create workflow {nome}

# Ver knowledge base
@aios-master *kb

📖 Fluxo Recomendado (Story Development Cycle)

1. Brief — Use /mesa-conselheira com produto manager
2. Planejamento — @pm cria epic, @sm cria stories
3. Desenvolvimento — @dev implementa, @qa testa
4. QA Gate — @qa valida com checklist
5. Deploy — @devops faz push/release

Cada fase tem seus agentes especializados e workflows automáticos.

🏗️ Estrutura do Repositório

gama-aios-kit/
├── README.md                  ← Você está aqui
├── CHANGELOG.md               ← Histórico de updates
├── install.sh                 ← Script de instalação (Linux/Mac/WSL)
├── install.ps1                ← Script de instalação (Windows)
│
├── global/                    ← Vai para ~/.claude/
│   ├── CLAUDE.md
│   ├── settings.template.json
│   ├── rules/                 ← 11 arquivos de regras
│   ├── commands/              ← AIOS, DeepResearch, SquadCreator, squads
│   ├── skills/                ← mesa-conselheira, guided-brief, etc
│   ├── hooks/                 ← ralph-loop, synapse-engine, etc
│   └── workflows/             ← GLOBAIS, MESA_CONSELHEIRA
│
├── project/                   ← Vai para O_GRANDE_PROJETO/.claude/
│   ├── CLAUDE.md
│   └── rules/
│
├── squads/                    ← Vai para O_GRANDE_PROJETO/GAMA_AIOS/squads/
│   ├── apex-lead/
│   ├── curator-chief/
│   ├── dispatch-chief/
│   ├── education-chief/
│   ├── kaizen-chief/
│   ├── seo-chief/
│   ├── sop-chief/
│   ├── squad-chief/
│   └── dr-orchestrator/
│
├── mcp-servers/               ← Vai para O_GRANDE_PROJETO/mcp-servers/
│   ├── telegram-bot/
│   └── whatsapp/
│
├── mcp/
│   └── mcp.template.json      ← Definição de MCP servers
│
└── env/
    └── .env.example           ← Variáveis de ambiente

🔄 Como o Dono Atualiza

Todo seu time usa automaticamente:

# Dono faz mudanças
# (edita rules/, commands/, skills/, etc)

# Commita
git add .
git commit -m "feat: novo comando xyz"
git push origin main

# Time puxa e instala
git pull origin main
bash install.sh
# (Pronto! Têm a atualização)

🐛 Troubleshooting

Comandos slash não aparecem

# Reiniciar Claude Code completamente
# (fechar e abrir de novo)

# Verificar se ~/.claude/commands/ foi populado
ls ~/.claude/commands/
# Deve ter: AIOS/, DeepResearch/, SquadCreator/, squads/

Agentes não ativam

# Testar com @aios-master
@aios-master *help

# Se falhar, verificar CLAUDE.md
cat ~/.claude/CLAUDE.md | head -20

MCP servers não carregam

# Verificar ~/.mcp.json
cat ~/.mcp.json

# Verificar API keys em .env
cat .env | grep -E "API_KEY|TOKEN"

# Testar com @devops
@devops *list-mcps

Install.sh falhou

# Verificar permissões
chmod +x install.sh

# Rodar com output detalhado
bash -x install.sh

# Ou fazer manual:
cp global/CLAUDE.md ~/.claude/
cp global/rules/* ~/.claude/rules/
# (etc...)

📝 Contribuindo

Você quer adicionar um novo comando/skill/rule?

1. Criar localmente em gama-aios-kit/global/ (ou project/, ou squads/)
2. Testar no seu Claude Code
3. Commit para main
4. Push — seu time recebe na próxima git pull

Mantenha a estrutura:

• Commands em global/commands/{AIOS|DeepResearch|SquadCreator}/
• Rules em global/rules/
• Skills em global/skills/
• Workflows em global/workflows/

📞 Suporte

• Dúvidas sobre AIOS? Ver *kb no @aios-master
• Dúvidas sobre story cycle? @sm *draft ou @po *validate-story-draft
• Dúvidas sobre agentes? Ativar agente e usar *guide
• Erro em MCP server? Contactar dono (Matheus) ou @devops

📊 Versão

• Versão atual: 1.0.0 (2026-03-27)
• AIOS version: 2.0
• Claude Code required: Latest (haiku model)
• Python: 3.9+ (para scripts auxiliares)

💰 Configuração de Modelo (Importante!)

SEMPRE usar Haiku (modelo mais barato):

• Tudo está otimizado pra rodar com Haiku
• Economiza ~70% em tokens comparado a Opus/Sonnet
• Performance mantida porque system prompts são estruturados
• Se precisar de mais velocidade, use /fast (ainda Haiku, output mais rápido)

settings.json padrão:

"model": "haiku"

Não mude para Opus/Sonnet a menos que teste e confirme necessidade.

🔐 Segurança

⚠️ IMPORTANTE:

• .env e settings.local.json são git-ignored (não commite credentials)
• API keys devem ser configuradas localmente por cada usuário
• Se uma API key vazar, regenerar imediatamente em seu painel
• Repo é PRIVADO — só time Gama tem acesso

📜 Licença

Propriedade de Gama Studio. Uso interno. Não distribuir.

Feito com ❤️ pelo Matheus (Founder)