Pular para o conteúdo principal

Project Knowledge Skills

Project Knowledge Skills são mecanismos para criar, atualizar e manter conhecimento estruturado junto ao código.

A ideia central é simples: conhecimento de projeto não deve ficar perdido em conversas, sessões temporárias ou apenas na cabeça de uma pessoa.

Problema​

Agentes melhoram quando recebem contexto denso, específico e confiável. O mesmo vale para pessoas entrando em um projeto. Sem uma camada de memória técnica, o trabalho tende a repetir descobertas, decisões e erros.

O que uma skill pode registrar​

  • Resumo da arquitetura do projeto.
  • Mapa de componentes.
  • Convenções técnicas.
  • Decisões arquiteturais.
  • Fluxos de desenvolvimento.
  • Regras de teste.
  • Estratégia de deploy.
  • Dependências externas.
  • Glossário do domínio.
  • Histórico de decisões.
  • Instruções para agentes de IA.

Objetivo técnico​

O objetivo é criar uma camada de conhecimento que cresça junto com o código e ajude humanos e agentes a entenderem rapidamente:

  • Onde está o contexto importante.
  • Como executar o projeto com segurança.
  • Quais decisões já foram tomadas.
  • Quais validações provam que uma mudança funciona.
  • Quais limites e riscos já foram descobertos.

Boas propriedades​

Uma Project Knowledge Skill deve ser:

  • Fácil de encontrar.
  • Pequena o suficiente para ser carregada por agentes.
  • Atualizada quando o comportamento real do projeto muda.
  • Baseada em evidência, não em intenção.
  • Ligada a comandos, arquivos, decisões e validações concretas.

Próximos registros​

Este projeto deve evoluir com exemplos de skills reais, estratégias de manutenção, formatos de memória e critérios para decidir o que deve ou não ser persistido.