Fornecer funcionalidade de "memória" aos Agentes de Codificação de IA pode reduzir significativamente os erros, diminuir os custos de chamadas de API, promover o "aprendizado" do Agente e simplificar a Engenharia de Interação. @PawelHuryn enfatiza que essa abordagem vai além do gerenciamento manual das Habilidades Claude, automatizando, em vez disso, o acúmulo de conhecimento por meio de arquivos Markdown editáveis. Principais recomendações: Etapas operacionais específicas • Documentar a solução existente: Solicitar ao agente que registre sua lógica de código em um arquivo .md, que servirá como base para sua base de conhecimento. • Verificação comparativa: Antes de uma nova tarefa, permita que o Agente examine as diferenças entre a implementação atual e a documentação (como mostrado na captura de tela da postagem: o Agente examina o arquivo "fuckups.md", descobre que funções de borda podem revelar detalhes de erros técnicos e os corrige automaticamente, exibindo avisos amigáveis ao usuário). • Referência da tarefa: Ao iniciar uma nova tarefa, instrua explicitamente o Agente a consultar o arquivo .md relevante para evitar a repetição de erros. • Transformação do PRD: Utilize um agente para decompor o PRD em uma lista de tarefas .md para facilitar a iteração. Exemplo de projeto: O autor do sistema de documentação da accredia.io publicou 12 modelos de arquivos .md (que podem ser copiados e ajustados diretamente) no diretório /documentation/ de sua plataforma de certificados online https://t.co/PlWNCyRza7. Esses arquivos são criados, atualizados e gerenciados inteiramente pelo Agente de IA. Eles abrangem todo o ciclo de vida do projeto, formando um ciclo de conhecimento autoconsistente. • analytics.md: Um sistema de análise que rastreia certificados e interações do usuário, e oferece suporte a registros de eventos de privacidade e painéis de controle em tempo real. • architecture.md: Guia de arquitetura com foco no backend, utilizando autenticação Clerk, funções de borda Supabase e licenciamento JWT. • cron.md: Automatiza tarefas de sincronização, gerenciamento de organização, perfis de usuário e conciliação de e-mails. • database.md: Referência do esquema da tabela do banco de dados, incluindo entidades principais como organizações, cursos e certificados. • design.md: Especificações do sistema de design que definem tipografia, cores, componentes e padrões de acessibilidade. • emails.md: Notificações de e-mail em fila, usando o Postmark para gerenciar o envio de certificados, novas tentativas e modelos. • fuckups.md: Uma biblioteca de lições aprendidas com erros, registro de erros de autenticação, problemas de UX e melhores práticas (como a forma como o agente na captura de tela corrigiu os erros com base nisso). • permissions.md: Matriz de permissões baseada em funções (administrador, membro, aluno, anônimo), define as regras de acesso aos endpoints. • security.md: Medidas de segurança, incluindo proteção contra XSS, validação de entrada e mecanismos anti-fraude. • socialsharing.md: Uma arquitetura de pré-visualização social que suporta geração e armazenamento em cache de imagens. • todo.md: Lista de tarefas para melhoria. • variables.md: Guia de variáveis de ambiente, abrangendo o gerenciamento de segredos no front-end e no back-end.
