simonpokorny/knowledgebase

Escreva uma pequena entrada, limpa e com esquema, dentro do diretório .knowledgebase/ do repositório. Se o repositório não tiver um diretório .knowledgebase/, pare e diga ao usuário para executar a skill /setup-knowledgebase primeiro.

1. Escolha o tipo:

   É	Tipo	Caminho
   uma afirmação sobre o sistema, verdadeira e que vale a pena não redescobrir	finding	.knowledgebase/entries/finding-<topico-kebab>.md
   uma regra de comportamento, geralmente nascida de um erro	learning	.knowledgebase/entries/learning-<topico-kebab>.md
   uma escolha entre alternativas, com uma compensação	decision	.knowledgebase/entries/decision-NNNN-<topico-kebab>.md

2. Escreva a entrada. Os campos de frontmatter, status, limites e convenções do corpo estão em ENTRY-FORMAT.md; leia-o antes de escrever. Exemplos prontos acompanham este plugin no diretório templates/.

3. Verifique se o status é honesto. Para findings e learnings: verified somente quando você mesmo comprovou a afirmação nesta sessão; nesse caso, defina verified-by: agent e coloque a evidência no corpo (um link da Fonte ou a verificação que você executou). Qualquer coisa que você não pôde comprovar permanece unverified; essas são as entradas que o humano deve verificar na revisão. Novas decisões recebem status: decided e vêm em dois tipos:

   • Decisões de implementação: escolhas fundamentais que você mesmo fez durante a construção. Registre-as com o porquê e a compensação, como decided-by: agent.
   • Decisões de planejamento: tomadas junto com o usuário, não inferíveis a partir do código. Registre-as também como decided-by: agent, depois entregue ao usuário a linha de adoção do relatório de final de sessão para que a entrada se torne decided-by: human. Nunca defina decided-by: human você mesmo; apenas um humano o faz. Qualquer um dos tipos pode posteriormente ser superseded por uma decisão mais recente.

4. Se a entrada for um learning que proíbe um comando, adicione uma regex guard: para que a regra se auto-aplique. As regras para escrever guards estão em ENTRY-FORMAT.md; teste a regex com grep -E antes de commitar.

5. Commite a entrada no mesmo branch da mudança que a produziu, para que ela acompanhe o mesmo commit. Não acumule entradas para depois.