¿Qué hace socratic?
Zētein — buscar. No es una revisión de código: es una indagación realizada después de que el trabajo se ha enviado. Responde tanto como constructor como escéptico; una respuesta que halaga no tiene valor.
Método
- Nombra el objetivo. El argumento lo nombra — una característica ("emotes"), un conjunto de cambios ("PR #754", una rama, un rango de commits), o todo el repositorio. Sin argumento — toma el PR fusionado más reciente. Si el objetivo no se puede resolver (sin coincidencia, sin PRs fusionados), detente y pregunta. Indícalo en una línea antes que cualquier otra cosa.
- Envía los buscadores. Lanza subagentes Explore en paralelo — siempre en plural, uno por territorio — y no respondas nada hasta que todos regresen. Característica o conjunto de cambios: implementación, pruebas, docs/flujos — anclados en el diff (
gh pr diff <n>para PRs,git diff <rango>para rangos). Repositorio: arquitectura, uniones entre módulos, desviación entre código y documentación. Cada buscador regresa con hallazgos que incluyen citas de archivo:línea; las respuestas se basan únicamente en lo que los buscadores devuelven más la sesión misma. - Haz las siete, en orden. Una a la vez, bajo las reglas siguientes. Sin evasivas; "depende" está prohibido a menos que vaya seguido de "de qué".
- Cierra con seguimientos. Como máximo tres seguimientos concretos que las respuestas exijan (listos para issue, una línea cada uno), luego una frase que nombre la respuesta que más dolió.
Las siete preguntas
- Quis — ¿quién? ¿Para quién es realmente esto — y quién fue olvidado? Nombra al usuario que lo usa primero y al que nunca apareció en el diseño.
- Quid — ¿qué? ¿De qué estás menos seguro ahora mismo? La certeza más débil en lo que se envió, no el código más feo.
- Quando — ¿cuándo? Si esto falla en tres meses, ¿cuál es la razón más probable? El tiempo es la única prueba que siempre se ejecuta.
- Ubi — ¿dónde? ¿Cuál es la cosa más grande que aún no se ha comprendido sobre la situación — dónde vive el punto ciego?
- Cur — ¿por qué? ¿Qué suposiciones se hicieron y nunca se declararon? Saca a la superficie el razonamiento no dicho detrás de cada elección mientras aún sea barato admitirlo.
- Quomodo — ¿de qué manera? ¿Qué podría haber hecho el solicitante de manera diferente para que esto funcionara más fluidamente? Responde con honestidad; la cortesía que oculta una respuesta real no ayuda a nadie.
- Quibus auxiliis — ¿con qué medios? Libre de la solicitud por completo — una adición no solicitada y líder en la industria. ¿Qué haría que esto sea la razón por la que la gente mencione el producto?
Reglas
- Evidencia primero — cada respuesta cita un archivo, una línea, un commit o un momento de la sesión; sin uno es especulación y debe marcarse como tal.
- Las preguntas se ejecutan en orden; nunca leas por adelantado — la característica soñada en la pregunta siete, leída temprano, filtra optimismo en la honestidad que la pregunta dos exige.
- Ninguna respuesta es una respuesta válida. No tener nada no es un fracaso; nunca inventes una porque la pregunta parezca exigirla.
- Nada se arregla durante la indagación — observaciones aquí, prescripciones solo en los seguimientos.
- Los buscadores exploran; tú juzgas. Nunca delegues la respuesta de una pregunta a un subagente.