methodology
Cómo documentar un proyecto para que Jakite pueda evaluarlo
27 de octubre de 2026
Jakite solo puntúa la documentación si el proyecto tiene un fichero de entrada de la herramienta y Markdown en rutas que reconozca.
Jakite mide si el proyecto tiene documentación que la herramienta puede tomar como guía. Si no llega a ese mínimo, la evaluación diaria no inventa una nota: deja el score vacío y explica qué falta.
Hace falta un fichero de entrada en la raíz del repositorio:
- Cursor: AGENTS.md. Si no existe, reglas en .cursor/rules/*.mdc. Si tampoco hay esa carpeta, .cursorrules. Con AGENTS.md presente, las reglas .mdc no cuentan como entrada.
- Claude Code: CLAUDE.md.
- Codex: AGENTS.md. Si no existe, CODEX.md.
El nombre lleva la extensión en minúsculas (.md). Un fichero vacío cuenta como entrada y bloquea el fallback, pero no documenta el proyecto.
Además hace falta algún Markdown cuya ruta contenga una de estas palabras: arquitectura, api, datos o reglas. Jakite mira la ruta, no el título ni el cuerpo. doc/diseno.md no entra, aunque el texto describa el producto. arquitectura/vision.md sí entra. Esas cuatro palabras son las secciones del esquema con el que se compara la cobertura.
Con eso Jakite puede puntuar la documentación del período y decirte, en la justificación, cómo está de estructura, cobertura, frescura y formato. Sin eso, cada sesión vuelve a reconstruir el contexto a mano.
La noticia no cambia la nota de un período ya cerrado. El siguiente sync, con el mínimo en el proyecto, es el que puede traer un score.