Inteligencia del repositorio
Entiende Repository Learnings, Codebase Index y Deep Code Scan sin confundir sus funciones.
Kensa mantiene separadas tres clases de conocimiento del repositorio: las reglas que tu equipo quiere que las revisiones respeten, un mapa descriptivo del código y una forma opcional de proponer nuevas reglas. Mantenerlas separadas aclara qué puede afectar una revisión y qué sólo aporta contexto.
Identifica qué herramienta responde a cada pregunta
| Término | Qué es | Qué cambia |
|---|---|---|
| Repository Learning | Una regla o decisión específica del repositorio que Kensa debe recordar para futuras revisiones. | Los aprendizajes activos y relevantes orientan el juicio de revisión. |
| Learning Signal | Evidencia que podría convertirse en un aprendizaje: una instrucción, resultado de revisión o comentario. | Nada hasta convertirla en un aprendizaje. |
| Codebase Index | Un mapa generado por IA de módulos, tecnologías, convenciones y rutas. | Contexto de fondo para los agentes de revisión. |
| Deep Code Scan | Un análisis opcional de reglas escritas y código representativo. | Propone nuevos aprendizajes para que las personas los revisen. |
Un Repository Learning cambia qué busca Kensa; no es una preferencia de tono de redacción ni un reemplazo de una skill. Los aprendizajes sugeridos no influyen en las revisiones hasta que los apruebes. Un Stale Learning queda en cuarentena cuando su evidencia de respaldo cambió o desapareció, así que deja de afectar las revisiones hasta que alguien lo confirme, edite o archive. La Supersession conserva el aprendizaje anterior como historial mientras su reemplazo se vuelve la regla que se debe usar.
Usa el Codebase Index para orientarte
Genera o actualiza el Codebase Index cuando Kensa necesite un mapa arquitectónico de un clon local. Describe la estructura y las convenciones del repositorio para que los agentes interpreten un diff con contexto. Un Codebase Index describe el repositorio; no es una fuente de Repository Learnings. Se mantiene separado de la vista Learnings y puede actualizarse cuando cambie el contexto del repositorio.
Usa Deep Code Scan para proponer reglas
Ejecuta Deep Code Scan cuando quieras extraer conocimiento duradero para revisiones desde la documentación, configuración y archivos de código representativos del propio repositorio. No forma parte de una revisión normal. Deep Code Scan es opcional y muestra una estimación de costo antes de ejecutarse. Su resultado se propone como Suggested Learnings para que inspecciones la evidencia y decidas qué reglas se activan.
Secuencia práctica
- Agrega un Repository Learning claro cuando ya conozcas una regla que los revisores deben respetar.
- Mantén actualizado el Codebase Index cuando la estructura del proyecto cambie de forma material.
- Ejecuta Deep Code Scan sólo cuando quieras candidatos para revisar; después apruébalos o archívalos.