project-context, a skill em que o agente registra o contexto do projeto com base em arquivos

Ao criar e operar projetos com agentes,
você acaba querendo manter continuamente o contexto em nível de projeto.
Assim, mesmo na próxima sessão, fica mais fácil ler o estado atual com poucos tokens
e continuar o trabalho.

Ao passar por vários projetos, continuei testando qual seria a melhor forma de preservar esse contexto
e, no fim, organizei tudo na direção de deixar o estado do trabalho e o contexto de referência dentro da pasta docs,
em um formato que pessoas e agentes possam consultar juntos.
O agente registra por conta própria os pontos importantes durante o trabalho,
e o que for necessário de forma recorrente pode ser mantido como documentação de referência para reutilização.

Esta não é uma abordagem para documentar completamente o projeto
ou criar uma enorme base de conhecimento.
O objetivo é manter, o máximo possível de forma automática,
uma linha de base do contexto do projeto.

No começo, também considerei estruturas mais complexas e houve bastante tentativa e erro,
mas no fim o agente funcionou bem o suficiente apenas com busca em arquivos,
o que permitiu organizar tudo em uma estrutura leve baseada em arquivos.

Depois da instalação, basta escrever em AGENTS.md para usar esta skill,
e também incluí junto uma skill de migração
capaz de mover o contexto que você já organizou para a estrutura do project-context.

Se puderem testar e me enviar feedback, agradeço.

Instalação: npx skills add perhapsspy/project-context

Esta skill é uma continuação da $structure-first, que publiquei antes.
Ela funciona ainda melhor em conjunto, e ambas foram feitas com a proposta de elevar a linha de base dos entregáveis ao usar agentes.