Cardano Dev Skills conecta agentes de IA à documentação atual

Cardano Dev Skills fornece a agentes de programação por IA instruções e referências técnicas para construir transações, escrever contratos inteligentes e compreender os padrões de Cardano. O pacote aborda um problema recorrente de desenvolvimento: agentes podem produzir código convincente que depende de bibliotecas ou regras de rede desatualizadas.

Giovanni Gargiulo, Arquiteto de Blockchain Sênior na Cardano Foundation, demonstrou a ferramenta durante o Developers Office Hours em 18 de setembro, levando um agente de uma explicação do CIP-68 a um exemplo de implementação em Java.

Erros de Aiken e Conway no código de Cardano

Gargiulo iniciou o projeto após constatar que corrigir código gerado por IA às vezes levava mais tempo do que implementar a solução ele mesmo. O que começou como um experimento pessoal depois passou para a organização da Cardano Foundation no GitHub e foi aberto a contribuições da comunidade.

Um problema recorrente envolvia Aiken, uma linguagem para desenvolver contratos inteligentes em Cardano. O agente continuava usando padrões da versão 2.4 da biblioteca padrão mesmo quando Gargiulo solicitava a documentação da versão 3. O código resultante não compilava.

Mudanças da era Conway criaram um ponto de falha diferente. Ao trabalhar com registro de endereço de stake e certificados, o agente combinou requisitos mais novos com uma abordagem mais antiga de construção de transações. O código da aplicação podia compilar com sucesso enquanto a transação falhava ao ser enviada para a rede.

Kits de desenvolvimento de software, ou SDKs, apresentaram problemas semelhantes. Essas bibliotecas permitem que aplicações construam transações e interajam com Cardano, mas campos renomeados ou assinaturas de função alteradas podem tornar exemplos antigos inutilizáveis.

Inicialmente, Gargiulo baixava a documentação atual manualmente e direcionava o agente a ela repetidas vezes. Reinícios de sessão ou compressão do contexto da conversa significavam que essas instruções precisavam ser fornecidas novamente. Seus experimentos com recuperação de documentação também exigiam manutenção contínua das fontes, levando a um pacote que combinou referências com fluxos de trabalho de desenvolvimento reutilizáveis.

Fontes mantidas e a demonstração do CIP-68

A versão apresentada durante a sessão continha 15 habilidades de desenvolvimento e 55 fontes de documentação. Em 2 de outubro, o site oficial do projeto listava 18 habilidades e 73 fontes, cobrindo SDKs, linguagens de programação, infraestrutura, CIPs e especificações do ledger.

Uma habilidade fornece instruções para uma tarefa específica, como construir uma transação de transferência de ADA, escrever um validador ou otimizar um contrato. As Cardano Improvement Proposals, conhecidas como CIPs, fornecem padrões técnicos que os agentes podem explicar e aplicar por meio das fontes que as acompanham.

O pacote separa seu registro de fontes, instruções de tarefa e referências baixadas. Mantenedores podem atualizar a documentação de forma independente dos fluxos de trabalho que dizem a um agente como usá-la.

Descrições de tarefas também ajudam o agente a associar solicitações comuns ao fluxo de trabalho apropriado. Um desenvolvedor pode pedir uma transação de token ou revisão de contrato em linguagem natural, permitindo que o agente selecione a habilidade relevante sem um comando explícito.

Um processo automatizado semanal recupera alterações upstream e abre um pull request no GitHub para revisão humana antes que entrem na branch principal. Os usuários então obtêm o pacote atualizado. Usuários do Claude Code devem ativar as atualizações automáticas em seu marketplace ou atualizá-lo manualmente.

A habilidade cardano-context adiciona uma instrução persistente de projeto dizendo ao Claude Code ou ao Codex para tratar o conhecimento existente sobre Cardano como potencialmente desatualizado e consultar primeiro as referências incluídas. Ambos os agentes usam as mesmas habilidades de desenvolvimento e fontes por meio de suas respectivas rotas de instalação.

Na demonstração, Gargiulo solicitou uma explicação do CIP-68, o padrão de metadados para ativos nativos de Cardano. Ele distingue um NFT de referência, cuja saída da transação contém os metadados, de um token de usuário que representa o ativo na carteira do titular. A lógica do contrato do emissor determina se os metadados podem ser atualizados.

Em seguida, o agente respondeu a um pedido por uma transação correspondente selecionando instruções de desenvolvimento e apresentando bibliotecas disponíveis. Gargiulo escolheu cardano-client-lib, uma biblioteca Java, e recebeu configuração de projeto, dependências e código de implementação. O exemplo gerado especificou Java 17.

Gargiulo não executou o exemplo durante a sessão. Assim, a demonstração cobriu a preparação da implementação, com o teste da transação de ponta a ponta ainda pendente.

Feedback e outras aplicações em Cardano

Cardano Dev Skills inclui um mecanismo de feedback para relatar documentação incorreta, instruções ausentes ou falhas em selecionar uma habilidade apropriada. Bora, um colaborador do projeto, descreveu um caso em que um agente propôs um relatório ao final de uma sessão e pediu ao usuário que o revisasse antes de aprovar o envio como uma issue no GitHub.

Os mantenedores usam esses relatórios para avaliar se uma fonte ou fluxo de trabalho precisa de correção. Gargiulo também distinguiu problemas de documentação de solicitações que são por si só pouco claras ou tecnicamente falhas, já que cada uma requer uma resposta diferente.

Contribuições de especialistas ajudam a expandir a cobertura. Gargiulo citou a adição de material de Go por um colaborador familiarizado com a linguagem e suas ferramentas para Cardano. As regras de escopo do projeto admitem integrações de desenvolvimento, especificações, SDKs e documentação de infraestrutura, excluindo material de marketing e manuais de usuário de produtos finais.

O texto do pacote pode ser inspecionado diretamente, enquanto seus hooks auxiliares exigem revisão porque executam código. Gargiulo delineou novas sessões sobre prompt injection, limites de confiança e situações em que agentes ignoram a documentação. Ele também descreveu planos para trabalho adicional sobre modularidade e compatibilidade com outros agentes na segunda metade de outubro.

Extensões potenciais discutidas durante a sessão incluíram avaliar propostas de governança em relação à Cardano Constitution e um experimento em testnet no qual usuários pagariam a um agente em USDCx por uma revisão de contrato inteligente, possivelmente por meio de Masumi. Essas foram apresentadas como trabalho em andamento e um experimento proposto, respectivamente.

A integração de hackathon forneceu uma aplicação concreta para o pacote existente. Para um evento de 36 horas planejado em Cingapura, um participante descreveu entregar aos desenvolvedores o Cardano Dev Skills e alguns prompts iniciais em vez de montar uma lista extensa de recursos para cada equipe.

Nesse fluxo de trabalho, uma equipe pode começar com uma transação, um validador ou um padrão de token dentro de seu agente de programação. As instruções de tarefa relevantes e as referências técnicas estão disponíveis no mesmo ambiente, enquanto problemas descobertos durante a implementação podem ser relatados por meio do processo de feedback do pacote.