> For the complete documentation index, see [llms.txt](https://wiki.superteam.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.superteam.com.br/projetos/solana-claude.md). # Solana AI Kit **GitHub**: [solanabr/solana-ai-kit](https://github.com/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 | Agente | Propósito | | ------------------------ | ---------------------------------------------------------------------------------------- | | 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. | Submódulo | Fonte | Propósito | | ------------------- | ----------------- | ---------------------------------------------------------------------------------------------- | | 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 | Servidor | Por Que Importa | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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ção * **Anchor** -- 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 único * **TypeScript** -- Segurança de tipos (`no any`), padrões async/await, integração de wallet adapter, BigInt para u64 * **C#/.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"`. | Padrão | Fluxo | Caso de Uso | | ------------------ | ------------------------------------ | -------------------------------------------------- | | 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](https://github.com/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: ```bash curl -fsSL https://aikit.superteam.codes | bash ``` Se o domínio `aikit.superteam.codes` não estiver acessível, o fallback documentado é: ```bash curl -fsSL https://raw.githubusercontent.com/solanabr/solana-ai-kit/main/install.sh | bash ``` **Plugin do Claude Code** -- instala o núcleo do kit (agentes, comandos, servidores MCP) pelo marketplace de plugins: ``` /plugin marketplace add solanabr/solana-ai-kit /plugin install solana-ai-kit@stbr ``` 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) | Camada | Tecnologia | | -------- | -------------------------------------------------- | | 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://wiki.superteam.com.br/projetos/solana-claude.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.