> 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/es/proyectos/solana-claude.md). # Solana AI Kit **GitHub**: [solanabr/solana-ai-kit](https://github.com/solanabr/solana-ai-kit) **Estado**: En desarrollo activo, lanzamiento publico **Mantenido por**: @kauenet ## Por Que Existe Los asistentes de codigo con IA tienen un problema con Solana. Sus datos de entrenamiento estan meses o anos detras de un ecosistema que avanza rapidamente, lo que significa que producen codigo que parece correcto pero no lo es: aritmetica sin verificar que desborda silenciosamente, validacion de owner de cuentas faltante, patrones obsoletos de web3.js 1.x cuando el proyecto usa @solana/kit, firmas de API alucinadas para versiones de Anchor que ya no existen. La IA escribe lo incorrecto con confianza, y el desarrollador necesita saber lo suficiente para detectarlo. El segundo problema es el desperdicio de contexto. Un asistente de proposito general carga todo y no filtra nada. Preguntar sobre un patron de CPI en Pinocchio trae conocimiento irrelevante de React. Preguntar sobre metadatos de tokens carga reglas de desarrollo de juegos. Cada token gastado en contexto que no aplica a la tarea actual es un token que no puede dedicarse a resolver el problema real. Solana AI Kit (anteriormente solana-claude-config) resuelve ambos problemas. Es una configuracion de programacion con IA — compatible con Claude Code y Codex — que codifica conocimiento profundo del dominio de Solana (APIs actuales, patrones de seguridad correctos, reglas especificas por lenguaje) y entrega ese conocimiento de forma eficiente a traves de una arquitectura consciente del uso de tokens. El contexto correcto se carga para la tarea correcta, y nada mas. ## Filosofia de Diseno La configuracion esta construida alrededor de un unico principio: cargar solo lo que el trabajo actual requiere. **CLAUDE.md corto** (\~110 lineas) como contexto de mensaje de usuario. Solo las reglas esenciales, principios de seguridad e instrucciones de flujo de trabajo viven aqui. El archivo funciona como un presupuesto de tokens, no como un manual de referencia. **Carga progresiva de skills** via `.claude/skills/`. Conocimiento especializado — patrones de protocolos DeFi, convenciones de desarrollo de juegos, checklists de auditoria de seguridad — se carga bajo demanda a traves de slash commands o invocaciones de agentes, no en cada prompt. **Carga lazy de reglas** via `.claude/rules/`. Estandares especificos por lenguaje se cargan solo cuando se trabaja en ese lenguaje. Las reglas de Rust son invisibles durante un refactor de TypeScript. Las reglas de C# son invisibles durante una auditoria de un programa Anchor. **Contexto acotado por agente.** Cada uno de los 15 agentes carga solo las herramientas y conocimiento relevantes para su rol. El unity-engineer tiene reglas de C#/.NET y patrones de Solana.Unity-SDK. El pinocchio-engineer tiene patrones zero-copy y validacion manual. Ninguno carga el contexto del otro. **CLAUDE.local.md** para notas temporales. Privado, en gitignore, escrito por Claude durante las sesiones. Observaciones del proyecto y resumenes de sesion que no deben compartirse con el equipo. **Soporte para monorepos.** Archivos CLAUDE.md en subdirectorios para decisiones de arquitectura acotadas. Claude Code los carga automaticamente al trabajar en ese directorio. ## Que Incluye ### 15 Agentes Especializados | Agente | Proposito | | ------------------------ | ----------------------------------------------------------------------------------------- | | solana-architect | Diseno de sistemas, estructuras de cuentas, esquemas de PDA, composabilidad cross-program | | anchor-engineer | Desarrollo de programas Anchor con generacion de IDL y patrones estandarizados | | pinocchio-engineer | Optimizacion de CU con framework zero-copy (80-95% de reduccion de CU vs Anchor) | | defi-engineer | Integracion de protocolos DeFi — Jupiter, Drift, Kamino, Raydium, Orca, Meteora | | solana-frontend-engineer | Frontends de dApps con React/Next.js e integracion de wallet adapter | | game-architect | Diseno de juegos on-chain, arquitectura Unity, ecosistema PlaySolana | | unity-engineer | Unity/C# con Solana.Unity-SDK, integracion de wallets, visualizacion de NFTs | | mobile-engineer | React Native y Expo para dApps mobile en Solana | | rust-backend-engineer | Servicios async en Rust con Axum/Tokio para backends de Solana | | devops-engineer | CI/CD, Docker, monitoreo, gestion de RPC, Cloudflare Workers | | token-engineer | Extensiones Token-2022, economia de tokens, transfer hooks, compliance | | solana-researcher | Investigacion profunda sobre protocolos, SDKs y herramientas del ecosistema | | solana-qa-engineer | Testing (Mollusk, LiteSVM, Surfpool, Trident), profiling de CU, fuzzing | | tech-docs-writer | READMEs, docs de API, guias de integracion, documentacion de arquitectura | | solana-guide | Educacion para desarrolladores, tutoriales, rutas de aprendizaje | ### 30 Workflow Commands **Building** * `/build-program` — Build y verificacion de programas Solana * `/scaffold` — Scaffolding de proyectos desde templates * `/build-app` — Setup de aplicacion full-stack * `/build-unity` — Scaffolding de proyectos de juegos Unity **Testing y Calidad** * `/test-rust` — Ejecutor de tests en Rust con cobertura * `/test-ts` — Ejecutor de tests en TypeScript * `/test-dotnet` — Ejecutor de tests .NET/Unity * `/test-and-fix` — Ejecutar tests y corregir fallos automaticamente * `/audit-solana` — Auditoria de seguridad para codigo on-chain * `/profile-cu` — Profiling y optimizacion de compute units * `/benchmark` — Benchmarking de rendimiento * `/diff-review` — Code review y deteccion de AI slop * `/audit-infra` — Auditoria de seguridad centrada en infraestructura: secretos, supply chain, CI/CD, seguridad de LLM/skills, OWASP, STRIDE * `/product-review` — Revision de calidad de producto con un scorecard de 8 dimensiones * `/debug-user-tx` — Reproduce la transaccion fallida de un usuario contra el estado de un cluster forkeado y mapea el error al codigo fuente **Deployment** * `/deploy` — Deploy en devnet y mainnet con gates de confirmacion * `/setup-ci-cd` — Configuracion de pipelines CI/CD * `/setup-mcp` — Configuracion de servidores MCP y gestion de keys **Workflow** * `/quick-commit` — Creacion de ramas y automatizacion de commits * `/explain-code` — Explicar patrones desconocidos de Solana * `/write-docs` — Generar documentacion desde el codigo fuente * `/plan-feature` — Planificacion de arquitectura antes de implementar * `/generate-idl-client` — Generacion de cliente TypeScript desde IDL * `/migrate-web3` — Migrar codigo de web3.js 1.x a @solana/kit * `/update` — Actualizar configuracion y skills a la ultima version * `/resync` — Resincronizar definiciones de agentes y reglas * `/cleanup` — Eliminar contexto obsoleto y archivos temporales * `/commit-claude-config` — Versionar la configuracion del kit en git * `/doctor` — Chequeo de salud de solo lectura para el entorno de desarrollo y la configuracion, con un comando de correccion por cada fallo * `/dream` — Consolidacion de memoria: deduplicar, podar y re-rankear los aprendizajes de sesion ### 18 Submodulos Externos de Skills Cada submodulo es un git submodule obtenido de un proveedor autorizado, manteniendo el conocimiento del dominio actualizado sin integrarlo directamente en la configuracion. | Submodulo | Fuente | Proposito | | ------------------- | ----------------- | --------------------------------------------------------------------------------------------- | | solana-dev | Solana Foundation | Patrones oficiales de desarrollo en Solana — programas, frontend, testing, seguridad | | sendai | SendAI | Integraciones de protocolos DeFi — Jupiter, Raydium, Kamino, perps, cross-chain, oraculos | | solana-game | Superteam Brazil | Desarrollo de juegos Unity para Solana — PlaySolana, PSG1 | | cloudflare | Cloudflare | Infraestructura edge — Workers, Agents SDK, servidores MCP | | trailofbits | Trail of Bits | Auditoria de seguridad y escaneo de vulnerabilidades | | qedgen | QEDGen | Verificacion formal con demostracion de teoremas en Lean 4 | | solana-mobile | Solana Mobile | Mobile Wallet Adapter, Genesis Token, resolucion de direcciones SKR | | colosseum | Colosseum | Investigacion de startups, validacion de ideas, proyectos de hackathon | | safe-solana-builder | Comunidad | Generacion de codigo con enfoque de seguridad primero y 70+ reglas derivadas de auditorias | | vercel | Vercel | Deploy en Vercel, Next.js, AI SDK, v0, edge functions | | solana-new | SendAI | Skills del recorrido de idea a lanzamiento, mas datasets de ideas y base de conocimiento | | ghostsecurity | Ghost Security | Skills de AppSec — criterios SAST, SCA, secretos, validacion | | defending-code | Anthropic | Harness de referencia para descubrimiento de vulnerabilidades y skills de seguridad defensiva | | jupiter | Jupiter | Skills oficiales de Jupiter — Ultra swap, Lend, migracion de swap | | metaplex | Metaplex | Skills oficiales de Metaplex — Core, Token Metadata, Bubblegum, Candy Machine | | helius | Helius | Skill oficial de infraestructura de Helius, mas internals de SVM | | quicknode-anchor | QuickNode | Archivos de referencia de Anchor y matematica financiera (en cuarentena — solo referencias) | | eth-to-sol | Solana Foundation | Porteo de EVM/Solidity a Anchor en dos pasadas | ### 7 Integraciones de Servidores MCP | Servidor | Por Que Importa | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | Helius | 60+ herramientas para RPC, DAS API, webhooks, priority fees y metadatos de tokens — datos on-chain en tiempo real sin salir del editor | | solana-dev | MCP oficial de la Solana Foundation con docs actuales, guias y referencias de API — la IA nunca alucina APIs obsoletas | | Context7 | Obtiene documentacion actualizada de cualquier dependencia, no snapshots de datos de entrenamiento | | Playwright | Automatizacion de navegador para testing de dApps — abre tu frontend, conecta wallets y verifica flujos en un navegador real | | context-mode | Comprime respuestas RPC grandes y logs de build — ahorra ventana de contexto para el trabajo real | | memsearch | Memoria persistente con busqueda semantica — recuerda el contexto del proyecto entre sesiones | | Surfpool | Validador local controlado por agentes y control de fork de mainnet — levanta estado de cluster forkeado para testing de integracion sin salir del editor | ### Reglas Especificas por Lenguaje Estandares de codigo forzados que se cargan solo cuando son relevantes para la tarea actual: * **Rust** — Aritmetica checked, propagacion correcta de errores, sin `unwrap()` en codigo de produccion * **Anchor** — Constraints de validacion de cuentas, almacenamiento de PDA bumps, validacion de target de CPI, recarga de cuentas despues de CPI * **Pinocchio** — Patrones de acceso zero-copy, validacion manual con `TryFrom`, discriminators de un solo byte * **TypeScript** — Seguridad de tipos (`no any`), patrones async/await, integracion de wallet adapter, BigInt para u64 * **C#/.NET** — Convenciones de Unity MonoBehaviour, estandares .NET 9, patrones de integracion de Solana.Unity-SDK ### Patrones de Equipos de Agentes Flujos de trabajo multi-agente que coordinan agentes especializados a traves de un ciclo completo de desarrollo. Crea un equipo con lenguaje natural: `"Create an agent team: solana-architect for design, anchor-engineer for implementation, solana-qa-engineer for testing"`. | Patron | Flujo | Caso de Uso | | ------------------ | ------------------------------------ | ----------------------------------------------------- | | program-ship | architect → engineer → QA → deploy | Entregar un programa Solana completo | | full-stack | architect → engineer → frontend → QA | Desarrollo de dApp de extremo a extremo | | audit-and-fix | QA → engineer → QA | Auditoria de seguridad con correcciones automatizadas | | game-ship | game-architect → unity-engineer → QA | Juego Unity con estado on-chain | | research-and-build | researcher → architect → engineer | Implementacion basada en investigacion | | defi-compose | researcher → defi-engineer → QA | Integracion DeFi multi-protocolo | | token-launch | token-engineer → QA → deploy | Creacion de tokens con extensiones | ## Instalacion **Fork del template** — el enfoque recomendado para proyectos nuevos. Haz fork de [solanabr/solana-ai-kit](https://github.com/solanabr/solana-ai-kit) en GitHub, personaliza el `CLAUDE.md` para tu proyecto e inicializa los submodulos de skills. **Instalacion en una linea** — para agregar la configuracion a un proyecto existente: ```bash curl -fsSL https://aikit.superteam.codes | bash ``` Si el dominio `aikit.superteam.codes` no esta disponible, el fallback documentado es: ```bash curl -fsSL https://raw.githubusercontent.com/solanabr/solana-ai-kit/main/install.sh | bash ``` **Plugin de Claude Code** — instala el kit central (agentes, comandos, servidores MCP) a traves del plugin marketplace: ``` /plugin marketplace add solanabr/solana-ai-kit /plugin install solana-ai-kit@stbr ``` El plugin incluye solo el kit central; la ruta completa via `install.sh` tambien trae las reglas de lenguaje de carga lazy, la allowlist curada de permisos y la politica de sandbox, y los 18 submodulos de skills en `ext/`. **Setup manual** — clona el repositorio y copia el directorio `.claude/` y el `CLAUDE.md` a la raiz de tu proyecto. **Exportacion de agentes** — el flag `--agents` exporta definiciones de agentes para usar con herramientas no-Claude que soporten el formato de especificacion de agentes. ## Stack Moderno (2026) | Capa | 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 | ## Creditos Este proyecto no seria posible sin las organizaciones que publican y mantienen los submodulos de skills de los que depende. Gracias a la **Solana Foundation** por los patrones oficiales de desarrollo y el servidor MCP solana-dev, **SendAI** por el framework de agentes de IA, **Trail of Bits** por la investigacion de seguridad de la que se nutre este proyecto, **Cloudflare** por los patrones de deploy en edge, **Colosseum** por las herramientas para hackathons, **QEDGen** por el trabajo de verificacion formal, **Solana Mobile** por los patrones del SDK mobile, la **comunidad safe-solana-builder** por las convenciones de codigo seguro, **Vercel** por los patrones de deployment, **Jupiter**, **Metaplex** y **Helius** por sus skills oficiales del ecosistema, **Ghost Security** por las skills de AppSec, **Anthropic** por el harness de referencia defending-code, **QuickNode** por el material de referencia de Anchor, y **Superteam Brazil** por la integracion de desarrollo de juegos que inicio este proyecto. --- # 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/es/proyectos/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.