simonpokorny/knowledgebase

Escribe una entrada pequeña y limpia (conforme al esquema) en el directorio .knowledgebase/ del repositorio. Si el repositorio no tiene .knowledgebase/, detente e indica al usuario que ejecute primero el skill /setup-knowledgebase.

1. Elige el tipo:

   Es	Tipo	Ruta
   una afirmación sobre el sistema, verdadera y que vale la pena no redescubrir	hallazgo	.knowledgebase/entries/hallazgo-<tema-kebab>.md
   una regla de comportamiento, normalmente nacida de un error	aprendizaje	.knowledgebase/entries/aprendizaje-<tema-kebab>.md
   una elección entre alternativas, con una compensación	decisión	.knowledgebase/entries/decision-NNNN-<tema-kebab>.md

2. Escribe la entrada. Los campos del frontmatter, estados, límites y convenciones del cuerpo están en ENTRY-FORMAT.md; léelo antes de escribir. En el directorio templates/ de este plugin se incluyen ejemplos funcionales.

3. Comprueba que el estado es honesto. Para hallazgos y aprendizajes: verified solo si has demostrado tú mismo la afirmación en esta sesión; en ese caso, establece verified-by: agent e incluye la evidencia en el cuerpo (un enlace a la fuente o la comprobación que realizaste). Todo lo que no puedas probar permanece como unverified; esas son las entradas que se pide al humano que verifique en la revisión. Las nuevas decisiones reciben el estado status: decided y existen de dos tipos:

   • Decisiones de implementación: elecciones fundamentales que tomaste tú mismo mientras construías. Registrarlas con el porqué y la compensación, como decided-by: agent.
   • Decisiones de planificación: tomadas junto con el usuario, no inferibles del código. Regístralas también como decided-by: agent, y luego entrega al usuario la línea de adopción del informe final de la sesión para que la entrada pase a ser decided-by: human. Nunca establezcas decided-by: human tú mismo; solo un humano lo hace. Cualquiera de los dos tipos puede posteriormente ser superseded por una decisión más reciente.

4. Si la entrada es un aprendizaje que prohíbe un comando, añade una expresión regular guard: para que la regla se aplique a sí misma. Las reglas para escribir guardias están en ENTRY-FORMAT.md; prueba la expresión regular con grep -E antes de confirmarla.

5. Confirma la entrada en la misma rama que el cambio que la produjo, para que viaje en el mismo commit. No acumules entradas para confirmarlas después.