diagnosticar-repo
Se invoca SOLO de forma explicita (/diagnosticar-repo); NO se carga por contexto y nada del ciclo de desarrollo la dispara. Corre el Doctor del proyecto (doctor/bin/doctor.sh o .ps1) y explica como le
SKILL.mdback/.claude/skills/diagnosticar-repo/SKILL.md
GitHubDiagnosticar repo — la puerta del Doctor
Esta skill no implementa el diagnostico: lo corre. El motor vive en doctor/ y es un
programa de verdad, con su README propio.
Por que la skill no lista los comandos de cada sonda. La version anterior si lo hacia: era una skill con ocho bloques de comandos para que el agente los corriera a mano. Al pasar el Doctor a codigo, esa lista quedo como una segunda fuente de verdad que se desincronizo sola — la skill decia una cosa y el programa hacia otra. Ahora hay un solo lugar donde estan las sondas:
doctor/doctor.py.
Gate de ejecucion (dos turnos, obligatorio)
Turno 1 — avisar y esperar. No se corre de una. Primero se dice:
- Que hace: recorre los archivos del proyecto y produce un informe HTML.
- Que NO hace: no modifica nada, no escribe en el Cerebro, no toca el tablero.
- Que cuesta: recorre los archivos del proyecto y corre varios comandos de git. Es rapido en segundos, pero leer el informe y actuar sobre el no lo es — por eso conviene correrlo a conciencia y no por costumbre.
- Cuanto tarda en leerse: el informe trae todas las sondas del Doctor (las del proyecto y las del
codigo; el numero lo imprime el informe). Si solo interesan dos, conviene
--solo. - Que se enciende y que no: las sondas de codigo solo corren si hay un repositorio
clonado en
back/ofront/. Sin codigo, se saltean y una sola sonda explica por que.
Y se termina el turno. Sin un "si" explicito, no se corre.
Turno 2 — correr y reportar. Con el si, se ejecuta y se resume el resultado en criollo: cuantas sondas dieron OK, cuales tienen hallazgo, y donde quedo el informe.
Como se corre
bash doctor/bin/doctor.sh
.\doctor\bin\doctor.ps1
| Variante | Para que |
|---|---|
--repo back · --repo front |
Acota a una carpeta — acepta cualquiera, no una lista fija. Tres sondas quedan afuera: asimetria y gemelas porque comparan back contra front, y conteos porque mide documentos de la raiz |
--comparar |
Ademas del informe, el reporte de arreglos: que mejoro, que empeoro y que quedo igual desde la corrida anterior. Es con lo que cierra atender-hallazgos |
--solo espejos,gemelas |
Corre solo esas sondas |
--json |
Resumen por consola, sin escribir archivo. Es el modo para pasarle el estado a otro agente como contexto |
El informe queda en doctor/salida/informe.html (o informe-back.html / informe-front.html),
mas una copia fechada en doctor/salida/historico/.
Como se lee el resultado
Tres estados por sonda, y ninguno es un puntaje:
| Estado | Que quiere decir |
|---|---|
| OK | Se midio y no hay nada que corregir |
| HALLAZGO | Se midio y hay algo que arreglar o decidir |
| SIN DATOS | No se pudo medir. No es aprobado |
No hay puntaje unico, y es una decision tomada. Nada de "82/100": un numero resume de mas, da falsa objetividad y esconde justo lo que hay que arreglar. El encabezado dice "N de M sondas con datos" y listo.
Un repositorio vacio no es un repositorio sano. Por eso
back/yfront/, que hoy solo tienen su README, salen grises con la etiqueta "prometido: todavia sin codigo" en vez de verdes. Decir "cero problemas" sobre cero lineas de codigo es mentir con verde.
Cada sonda con hallazgo trae, en su panel del informe: que significa, por que importa, los pasos para arreglarlo, y un texto listo para copiar y pegarle a un asistente, que ya viene con los datos del hallazgo adentro.
Alcance y barreras
- SOLO LECTURA. No modifica un solo archivo.
- No toca el Cerebro Digital ni lo funcional. Los lee —las skills viven ahi, y varias sondas los recorren— pero jamas propone cambios sobre su contenido de negocio. Lo que mide son propiedades mecanicas: que un enlace resuelva, que un conteo coincida, que dos copias de una skill no hayan divergido.
- El informe no va al Cerebro. Es un artefacto derivado: se regenera corriendo el
comando, y por eso
doctor/salida/esta en el.gitignore. El Cerebro guarda conocimiento validado por una persona; un informe automatico no es eso. Lo que si es conocimiento son las decisiones que salen de leerlo, y esas se escriben a mano donde corresponda. - No se dispara sola. Ningun paso del ciclo de desarrollo la invoca. Se corre a mano, por hito o antes de un cambio grande — no en cada commit: para eso esta el hook, que es instantaneo y bloquea.
Que NO mide
El cambio por subir (auditar-codigo, /code-review), el ciclo de TDD (verificar-tdd), la tarjeta
(auditar-tarea, auditar-historia): quien contesta cada pregunta esta en una sola tabla, «Quien contesta que», en
cerebro-digital/configuracion-ia/orquestador-desarrollo.md del nucleo. Tampoco mira estilo (formateador y linter)
ni politicas de seguridad (la puerta SAST del pipeline: el Doctor verifica que este puesta y que frene la entrega).
El Doctor mira el proyecto en reposo. Ninguna de las otras lo hace, y el no hace ninguna de las de ellas.
Detalle completo
doctor/README.md — que hace cada sonda, los dos numeros de tokens y por que son dos, el
autocontrol y que promete, el historico, y lo que todavia le falta.