jhanva/core

Guia un proceso de diseno riguroso ANTES de escribir codigo. Dialogo socratico, multiples enfoques con tradeoffs, spec escrita. Usar cuando: el usuario quiere construir algo nuevo, agregar una feature no trivial, redisenar un modulo, o dice "brainstorm" o "disenar".

Construye y consulta un grafo persistente de codigo, SQL, docs y configuracion. Usar para mapear arquitectura, dependencias, flujos o proyectos que ya tienen codegraph-out.

Debugging sistematico en 4 fases con investigacion de causa raiz obligatoria. Prohibido adivinar soluciones o aplicar fixes sin entender el problema. Usar cuando: hay un bug, error, test fallando, comportamiento inesperado, o el usuario dice "no funciona", "falla", "error", "bug", "rompio".

Ejecuta un plan aprobado por tareas, con verificacion de cumplimiento y calidad. Usar cuando existe un plan y el usuario pide implementarlo.

Diagnostica y corrige patrones de texto artificial en espanol o ingles. Usar para humanizar, revisar o reescribir contenido que suena generado por IA.

Audita un flujo de trabajo para reducir contexto, latencia, costo y delegacion innecesaria. Usar cuando el usuario pide optimizar el trabajo del agente o diagnosticar consumo excesivo.

Coordina un manager y workers especializados con routing por riesgo, contratos de tarea, resultados estructurados y escalamiento. Usar al delegar trabajo complejo o costoso.

Despacha multiples subagentes simultaneos para resolver problemas independientes. Solo cuando los problemas no se afectan entre si. Usar cuando: hay 3+ tests fallando con causas diferentes, subsistemas rotos de forma independiente, o investigaciones que no se solapan.

Convierte una spec aprobada en un plan de implementacion con tareas de 2-5 minutos. Codigo exacto, rutas reales, cero placeholders. Usar cuando existe una spec o alcance aprobado y el usuario pide planificar la implementacion.

Revisa cambios con severidades, evidencia y evaluacion tecnica del feedback. Usar al terminar una feature, antes de merge o al recibir comentarios de revision.

Audita seguridad en proyectos locales: codigo, secretos, dependencias e infraestructura. Usar ante solicitudes de vulnerabilidades o antes de un deploy; admite modos quick y full.

Aplica RED-GREEN-REFACTOR a cambios de comportamiento comprobables. Usar al implementar features o bugs con una suite viable; no para docs, exploracion o cambios puramente mecanicos.

Exige evidencia fresca y proporcional antes de afirmar exito. Usar al cerrar tareas, reportar tests, confirmar fixes, preparar commits o responder solicitudes de verificacion.