Cardano Dev Skills conecta a agentes de IA con la documentación actual

Cardano Dev Skills brinda a los agentes de programación con IA instrucciones y referencias técnicas para construir transacciones, escribir contratos inteligentes y comprender los estándares de Cardano. El paquete aborda un problema de desarrollo recurrente: los agentes pueden producir código convincente que depende de bibliotecas o reglas de red desactualizadas.

Giovanni Gargiulo, Senior Blockchain Architect en la Cardano Foundation, demostró la herramienta durante Developers Office Hours el 18 de septiembre, llevando a un agente desde una explicación de CIP-68 hasta un ejemplo de implementación en Java.

Errores de Aiken y Conway en código de Cardano

Gargiulo inició el proyecto tras descubrir que corregir código generado por IA a veces llevaba más tiempo que implementar él mismo la solución. Lo que comenzó como un experimento personal pasó después a la organización de GitHub de la Cardano Foundation y se abrió a contribuciones de la comunidad.

Un problema recurrente involucraba Aiken, un lenguaje para desarrollar contratos inteligentes en Cardano. El agente seguía usando patrones de la versión 2.4 de la biblioteca estándar incluso cuando Gargiulo solicitaba documentación para la versión 3. El código resultante no compilaba.

Los cambios de la era Conway crearon un punto de falla diferente. Al trabajar con el registro de direcciones de participación y certificados, el agente combinó requisitos más recientes con un enfoque más antiguo de construcción de transacciones. El código de la aplicación podía compilarse correctamente mientras que la transacción fallaba al enviarse a la red.

Los kits de desarrollo de software, o SDK, presentaron problemas similares. Estas bibliotecas permiten que las aplicaciones construyan transacciones e interactúen con Cardano, pero los campos renombrados o los cambios en las firmas de funciones pueden volver inutilizables ejemplos antiguos.

Inicialmente, Gargiulo descargaba la documentación vigente de forma manual y dirigía repetidamente al agente hacia ella. Que las sesiones se reiniciaran o que se comprimiera el contexto de la conversación implicaba que esas instrucciones debían proporcionarse otra vez. Sus experimentos con la recuperación de documentación también requerían mantenimiento continuo de las fuentes, lo que condujo a un paquete que combinaba referencias con flujos de trabajo de desarrollo reutilizables.

Fuentes mantenidas y la demostración de CIP-68

La versión presentada durante la sesión contenía 15 habilidades de desarrollo y 55 fuentes de documentación. El 2 de octubre, el sitio web oficial del proyecto enumeraba 18 habilidades y 73 fuentes, que abarcan SDK, lenguajes de programación, infraestructura, CIPs y especificaciones del libro mayor.

Una habilidad proporciona instrucciones para una tarea específica, como construir una transacción de transferencia de ADA, escribir un validador u optimizar un contrato. Las Cardano Improvement Proposals, conocidas como CIPs, aportan estándares técnicos que los agentes pueden explicar y aplicar mediante las fuentes que las acompañan.

El paquete separa su registro de fuentes, las instrucciones de tareas y las referencias descargadas. Los encargados del mantenimiento pueden actualizar la documentación de manera independiente de los flujos de trabajo que indican a un agente cómo utilizarla.

Las descripciones de tareas también ayudan al agente a vincular solicitudes normales con el flujo de trabajo adecuado. Un desarrollador puede pedir una transacción de token o la revisión de un contrato en lenguaje natural, lo que permite al agente seleccionar la habilidad pertinente sin un comando explícito.

Un proceso automatizado semanal recupera cambios ascendentes y abre una pull request en GitHub para revisión humana antes de que ingresen a la rama principal. Los usuarios obtienen entonces el paquete actualizado. Los usuarios de Claude Code deben habilitar las actualizaciones automáticas en su marketplace o actualizarlo manualmente.

La habilidad cardano-context agrega una instrucción de proyecto persistente que indica a Claude Code o Codex que traten el conocimiento existente sobre Cardano como potencialmente desactualizado y consulten primero las referencias incluidas. Ambos agentes usan las mismas habilidades de desarrollo y fuentes mediante sus respectivas rutas de instalación.

En la demostración, Gargiulo solicitó una explicación de CIP-68, el estándar de metadatos para los activos nativos de Cardano. Distingue un NFT de referencia, cuya salida de la transacción contiene los metadatos, de un token de usuario que representa el activo en la billetera del titular. La lógica del contrato del emisor determina si los metadatos pueden actualizarse.

Luego, el agente respondió a una solicitud de transacción correspondiente seleccionando instrucciones de desarrollo y presentando las bibliotecas disponibles. Gargiulo eligió cardano-client-lib, una biblioteca de Java, y recibió la configuración del proyecto, las dependencias y el código de implementación. El ejemplo generado especificó Java 17.

Gargiulo no ejecutó el ejemplo durante la sesión. Por lo tanto, la demostración cubrió la preparación de la implementación, quedando pendiente la prueba de la transacción de extremo a extremo.

Retroalimentación y más aplicaciones en Cardano

Cardano Dev Skills incluye un mecanismo de retroalimentación para reportar documentación incorrecta, instrucciones faltantes o fallas al seleccionar una habilidad adecuada. Bora, colaborador del proyecto, describió un caso en el que un agente propuso un informe al final de una sesión y pidió al usuario que lo revisara antes de aprobar su envío como issue de GitHub.

Los encargados del mantenimiento usan esos informes para evaluar si una fuente o un flujo de trabajo necesita corrección. Gargiulo también distinguió los problemas de documentación de las solicitudes que en sí mismas son poco claras o técnicamente defectuosas, ya que cada una requiere una respuesta diferente.

Las contribuciones de especialistas ayudan a ampliar la cobertura. Gargiulo citó la incorporación de material sobre Go por parte de un colaborador familiarizado con el lenguaje y sus herramientas en Cardano. Las reglas de alcance del proyecto admiten integraciones de desarrollo, especificaciones, SDK y documentación de infraestructura, mientras excluyen material de marketing y manuales de usuario de productos finales.

El texto del paquete puede inspeccionarse directamente, mientras que sus hooks auxiliares requieren revisión porque ejecutan código. Gargiulo esbozó más sesiones sobre inyección de prompts, límites de confianza y situaciones en las que los agentes ignoran la documentación. También describió planes para trabajo adicional sobre modularidad y compatibilidad con otros agentes en la segunda mitad de octubre.

Las posibles extensiones discutidas durante la sesión incluyeron evaluar propuestas de gobernanza frente a la Cardano Constitution y un experimento en testnet en el que los usuarios pagarían a un agente en USDCx por una revisión de contrato inteligente, potencialmente a través de Masumi. Estas se presentaron como trabajo en curso y como un experimento propuesto, respectivamente.

La incorporación en hackatones aportó una aplicación concreta para el paquete existente. Para un evento planificado de 36 horas en Singapur, un participante describió entregar a los desarrolladores Cardano Dev Skills y unos pocos prompts iniciales en lugar de armar una lista extensa de recursos para cada equipo.

En ese flujo de trabajo, un equipo puede comenzar con una transacción, un validador o un estándar de token dentro de su agente de programación. Las instrucciones de la tarea pertinente y las referencias técnicas están disponibles en el mismo entorno, mientras que los problemas descubiertos durante la implementación pueden reportarse mediante el proceso de retroalimentación del paquete.