Solana AI Kit
GitHub: solanabr/solana-ai-kit Status: Em desenvolvimento ativo, lançamento público Mantido por: @kauenet
Por Que Existe
Assistentes de código com IA têm um problema com Solana. Seus dados de treinamento estão meses ou anos atrasados em relação a um ecossistema que evolui rapidamente, o que significa que produzem código que parece correto mas não é: aritmética sem verificação que transborda silenciosamente, validação de owner de contas ausente, padrões obsoletos de web3.js 1.x quando o projeto usa @solana/kit, assinaturas de API alucinadas para versões do Anchor que não existem mais. A IA escreve a coisa errada com confiança, e o desenvolvedor precisa saber o suficiente para perceber.
O segundo problema é o desperdício de contexto. Um assistente de propósito geral carrega tudo e não filtra nada. Perguntar sobre um padrão de CPI em Pinocchio traz conhecimento irrelevante de React. Perguntar sobre metadados de tokens carrega regras de desenvolvimento de jogos. Cada token gasto em contexto que não se aplica à tarefa atual é um token que não pode ser usado para resolver o problema real.
O Solana AI Kit (antes solana-claude-config) resolve ambos os problemas. É uma configuração de AI coding -- compatível com Claude Code e Codex -- que codifica conhecimento profundo do domínio Solana (APIs atuais, padrões de segurança corretos, regras específicas por linguagem) e entrega esse conhecimento de forma eficiente por meio de uma arquitetura consciente do uso de tokens. O contexto certo carrega para a tarefa certa, e nada mais.
Filosofia de Design
A configuração é construída em torno de um único princípio: carregar apenas o que o trabalho atual exige.
CLAUDE.md curto (~110 linhas) como contexto de mensagem do usuário. Apenas regras essenciais, princípios de segurança e instruções de workflow ficam aqui. O arquivo funciona como um orçamento de tokens, não como um manual de referência.
Carregamento progressivo de skills via .claude/skills/. Conhecimento especializado -- padrões de protocolos DeFi, convenções de desenvolvimento de jogos, checklists de auditoria de segurança -- carrega sob demanda por meio de slash commands ou invocações de agentes, não em cada prompt.
Carregamento lazy de regras via .claude/rules/. Padrões específicos por linguagem carregam apenas quando você está trabalhando naquela linguagem. As regras de Rust são invisíveis durante um refactor de TypeScript. As regras de C# são invisíveis durante uma auditoria de um programa Anchor.
Contexto delimitado por agente. Cada um dos 15 agentes carrega apenas as ferramentas e o conhecimento relevantes para seu papel. O unity-engineer tem regras de C#/.NET e padrões do Solana.Unity-SDK. O pinocchio-engineer tem padrões zero-copy e validação manual. Nenhum carrega o contexto do outro.
CLAUDE.local.md para notas temporárias. Privado, no gitignore, escrito pelo Claude durante as sessões. Observações do projeto e resumos de sessão que não devem ser compartilhados com a equipe.
Suporte a monorepos. Arquivos CLAUDE.md em subdiretórios para decisões de arquitetura delimitadas. O Claude Code os carrega automaticamente ao trabalhar naquele diretório.
O Que Você Recebe
15 Agentes Especializados
solana-architect
Design de sistemas, estruturas de contas, esquemas de PDA, composabilidade cross-program
anchor-engineer
Desenvolvimento de programas Anchor com geração de IDL e padrões padronizados
pinocchio-engineer
Otimização de CU com framework zero-copy (80-95% de redução de CU vs Anchor)
defi-engineer
Integração de protocolos DeFi -- Jupiter, Drift, Kamino, Raydium, Orca, Meteora
solana-frontend-engineer
Frontends de dApps com React/Next.js e integração de wallet adapter
game-architect
Design de jogos on-chain, arquitetura Unity, ecossistema PlaySolana
unity-engineer
Unity/C# com Solana.Unity-SDK, integração de wallets, exibição de NFTs
mobile-engineer
React Native e Expo para dApps mobile em Solana
rust-backend-engineer
Serviços async em Rust com Axum/Tokio para backends Solana
devops-engineer
CI/CD, Docker, monitoramento, gerenciamento de RPC, Cloudflare Workers
token-engineer
Extensões Token-2022, economia de tokens, transfer hooks, compliance
solana-researcher
Pesquisa aprofundada sobre protocolos, SDKs e ferramentas do ecossistema
solana-qa-engineer
Testing (Mollusk, LiteSVM, Surfpool, Trident), profiling de CU, fuzzing
tech-docs-writer
READMEs, docs de API, guias de integração, documentação de arquitetura
solana-guide
Educação para desenvolvedores, tutoriais, trilhas de aprendizado
30 Comandos de Workflow
Building
/build-program-- Build e verificação de programas Solana/scaffold-- Scaffolding de projetos a partir de templates/build-app-- Setup de aplicação full-stack/build-unity-- Scaffolding de projetos de jogos Unity
Testing e Qualidade
/test-rust-- Executor de testes Rust com cobertura/test-ts-- Executor de testes TypeScript/test-dotnet-- Executor de testes .NET/Unity/test-and-fix-- Executar testes e corrigir falhas automaticamente/audit-solana-- Auditoria de segurança para código on-chain/profile-cu-- Profiling e otimização de compute units/benchmark-- Benchmarking de performance/diff-review-- Code review e detecção de AI slop/audit-infra-- Auditoria de segurança com foco em infraestrutura: secrets, supply chain, CI/CD, segurança de LLM/skills, OWASP, STRIDE/product-review-- Revisão de qualidade de produto com um scorecard de 8 dimensões/debug-user-tx-- Reproduzir a transação com falha de um usuário contra o estado de um cluster forkado e mapear o erro até o código fonte
Deployment
/deploy-- Deploy em devnet e mainnet com gates de confirmação/setup-ci-cd-- Configuração de pipelines CI/CD/setup-mcp-- Configuração de servidores MCP e gerenciamento de keys
Workflow
/quick-commit-- Criação de branches e automação de commits/explain-code-- Explicar padrões desconhecidos de Solana/write-docs-- Gerar documentação a partir do código fonte/plan-feature-- Planejamento de arquitetura antes da implementação/generate-idl-client-- Geração de cliente TypeScript a partir de IDL/migrate-web3-- Migrar código de web3.js 1.x para @solana/kit/update-- Atualizar configuração e skills para a versão mais recente/resync-- Ressincronizar definições de agentes e regras/cleanup-- Remover contexto obsoleto e arquivos temporários/commit-claude-config-- Versionar a configuração do kit no git/doctor-- Checagem de saúde somente leitura do ambiente de desenvolvimento e da configuração, com um comando de correção por falha/dream-- Consolidação de memória: deduplicar, podar e reordenar aprendizados de sessão
18 Submódulos Externos de Skills
Cada submódulo é um git submodule obtido de um provedor autorizado, mantendo o conhecimento do domínio atualizado sem incorporá-lo diretamente na configuração.
solana-dev
Solana Foundation
Padrões oficiais de desenvolvimento Solana -- programas, frontend, testing, segurança
sendai
SendAI
Integrações de protocolos DeFi -- Jupiter, Raydium, Kamino, perps, cross-chain, oráculos
solana-game
Superteam Brazil
Desenvolvimento de jogos Unity para Solana -- PlaySolana, PSG1
cloudflare
Cloudflare
Infraestrutura de edge -- Workers, Agents SDK, servidores MCP
trailofbits
Trail of Bits
Auditoria de segurança e varredura de vulnerabilidades
qedgen
QEDGen
Verificação formal com provas de teoremas em Lean 4
solana-mobile
Solana Mobile
Mobile Wallet Adapter, Genesis Token, resolução de endereços SKR
colosseum
Colosseum
Pesquisa de startups, validação de ideias, projetos de hackathon
safe-solana-builder
Comunidade
Geração de código com segurança em primeiro lugar, com 70+ regras derivadas de auditorias
vercel
Vercel
Deploy na Vercel, Next.js, AI SDK, v0, edge functions
solana-new
SendAI
Skills da jornada da ideia ao lançamento, além de datasets de ideias e base de conhecimento
ghostsecurity
Ghost Security
Skills de AppSec -- critérios de SAST, SCA, secrets, validação
defending-code
Anthropic
Harness de referência para descoberta de vulnerabilidades e skills de segurança defensiva
jupiter
Jupiter
Skills oficiais da Jupiter -- Ultra swap, Lend, migração de swap
metaplex
Metaplex
Skills oficiais da Metaplex -- Core, Token Metadata, Bubblegum, Candy Machine
helius
Helius
Skill oficial de infraestrutura da Helius, além de internals da SVM
quicknode-anchor
QuickNode
Arquivos de referência de Anchor e matemática financeira (em quarentena -- apenas referências)
eth-to-sol
Solana Foundation
Porte em duas passadas de EVM/Solidity para Anchor
7 Integrações com Servidores MCP
Helius
60+ ferramentas para RPC, DAS API, webhooks, priority fees e metadados de tokens -- dados on-chain em tempo real sem sair do editor
solana-dev
MCP oficial da Solana Foundation com docs atuais, guias e referências de API -- a IA nunca alucina APIs obsoletas
Context7
Busca documentação atualizada de qualquer dependência, não snapshots de dados de treinamento
Playwright
Automação de navegador para testing de dApps -- abre seu frontend, conecta wallets e verifica fluxos em um navegador real
context-mode
Comprime respostas RPC grandes e logs de build -- economiza janela de contexto para o trabalho real
memsearch
Memória persistente com busca semântica -- lembra o contexto do projeto entre sessões
Surfpool
Validator local controlado por agentes e controle de fork da mainnet -- suba o estado de um cluster forkado para testes de integração sem sair do editor
Regras Específicas por Linguagem
Padrões de código aplicados que carregam apenas quando relevantes para a tarefa atual:
Rust -- Aritmética checked, propagação correta de erros, sem
unwrap()em código de produçãoAnchor -- Constraints de validação de contas, armazenamento de PDA bumps, validação de target de CPI, recarga de contas após CPI
Pinocchio -- Padrões de acesso zero-copy, validação manual com
TryFrom, discriminators de byte únicoTypeScript -- Segurança de tipos (
no any), padrões async/await, integração de wallet adapter, BigInt para u64C#/.NET -- Convenções de Unity MonoBehaviour, padrões .NET 9, padrões de integração do Solana.Unity-SDK
Padrões de Equipes de Agentes
Workflows multi-agente que coordenam agentes especializados ao longo de um ciclo completo de desenvolvimento. Crie uma equipe com linguagem natural: "Create an agent team: solana-architect for design, anchor-engineer for implementation, solana-qa-engineer for testing".
program-ship
architect → engineer → QA → deploy
Entregar um programa Solana completo
full-stack
architect → engineer → frontend → QA
Desenvolvimento de dApp ponta a ponta
audit-and-fix
QA → engineer → QA
Auditoria de segurança com correções automatizadas
game-ship
game-architect → unity-engineer → QA
Jogo Unity com estado on-chain
research-and-build
researcher → architect → engineer
Implementação orientada por pesquisa
defi-compose
researcher → defi-engineer → QA
Integração DeFi multi-protocolo
token-launch
token-engineer → QA → deploy
Criação de tokens com extensões
Instalação
Fork do template -- a abordagem recomendada para projetos novos. Faça fork de solanabr/solana-ai-kit no GitHub, personalize o CLAUDE.md para seu projeto e inicialize os submódulos de skills.
Instalação em uma linha -- para adicionar a configuração a um projeto existente:
Se o domínio aikit.superteam.codes não estiver acessível, o fallback documentado é:
Plugin do Claude Code -- instala o núcleo do kit (agentes, comandos, servidores MCP) pelo marketplace de plugins:
O plugin traz apenas o núcleo do kit; a rota completa via install.sh também inclui as regras de linguagem com carregamento lazy, a allowlist curada de permissões com a política de sandbox e os 18 submódulos de skills em ext/.
Setup manual -- clone o repositório e copie o diretório .claude/ e o CLAUDE.md para a raiz do seu projeto.
Exportação de agentes -- o flag --agents exporta definições de agentes para uso com ferramentas não-Claude que suportem o formato de especificação de agentes.
Stack Moderna (2026)
Programs
Anchor 1.0+ / Pinocchio / Rust 1.82+
Frontend
Next.js 15 / React 19 / @solana/kit
Testing
Mollusk / LiteSVM / Surfpool / Trident
Mobile
React Native / Expo / Solana Mobile SDK
Games
Unity 6+ / Solana.Unity-SDK / PlaySolana
Backend
Rust (Axum 0.8+ / Tokio 1.40+ / sqlx) / Helius API
Edge
Cloudflare Workers
Créditos
Este projeto não seria possível sem as organizações que publicam e mantêm os submódulos de skills dos quais ele depende. Agradecimentos à Solana Foundation pelos padrões oficiais de desenvolvimento e o servidor MCP solana-dev, SendAI pelo framework de agentes de IA, Trail of Bits pela pesquisa de segurança da qual este projeto se baseia, Cloudflare pelos padrões de deploy em edge, Colosseum pelas ferramentas de hackathon, QEDGen pelo trabalho de verificação formal, Solana Mobile pelos padrões do SDK mobile, a comunidade safe-solana-builder pelas convenções de código seguro, Vercel pelos padrões de deploy, Jupiter, Metaplex e Helius pelas suas skills oficiais de ecossistema, Ghost Security pelas skills de AppSec, Anthropic pelo harness de referência defending-code, QuickNode pelo material de referência de Anchor, e Superteam Brazil pela integração de desenvolvimento de jogos que deu início a este projeto.
Atualizado
Isto foi útil?