smart-plan

Quality review y refactoring con 3 reviewers paralelos (simplicity, bugs, conventions) y confidence >= 80%. Acepta directorio como alcance opcional.

Este agente debe usarse cuando se necesita disenar la arquitectura de un feature analizando patrones existentes del codebase. Produce blueprints de implementacion con archivos especificos a crear/modificar, plan de dependencias externas, mapa de ownership de archivos, grupos de paralelizacion, y recomendacion de modelo por tarea.

Este agente debe usarse cuando se necesita explorar un codebase para entender su arquitectura, patrones, features similares, entry points y flujo de ejecucion. Combina busqueda textual con analisis semantico via LSP Chain para archivos .ts/.js/.tsx/.jsx/.go. Produce un mapa completo de archivos esenciales, dependencias y convenciones del proyecto.

Este agente debe usarse cuando se necesita implementar una tarea especifica del plan de arquitectura. Recibe una asignacion concreta de archivos a crear/modificar y la ejecuta siguiendo el plan estrictamente. Usa LSP para verificar tipos y encontrar referencias antes de escribir codigo. No compila ni ejecuta tests.

Este agente debe usarse cuando se necesita construir un mapa semantico del codebase usando LSP exclusivamente. Analiza dependencias de tipos, interfaces, call hierarchy y relaciones entre simbolos para archivos .ts/.js/.tsx/.jsx/.go. Complementa al code-explorer con informacion semantica profunda que la busqueda textual no puede proporcionar.

Este agente debe usarse despues del code review para aplicar correcciones automaticas a hallazgos con confianza >= 80%. Lee cada archivo afectado, aplica fixes uno por uno, verifica tipos con LSP despues de cada correccion, y al finalizar ejecuta build, tests y linters para validar que nada se rompio.

Este agente debe usarse cuando se necesita revisar codigo implementado para detectar bugs, errores logicos, vulnerabilidades de seguridad, problemas de calidad, y adherencia a convenciones del proyecto. Usa un sistema de scoring de confianza y solo reporta hallazgos con confianza >= 80%. Produce sugerencias de fix concretas y accionables.

Esta skill debe usarse cuando el usuario pide "planear una feature", "plan a feature", "crear un plan de acción", "disenar una implementacion", "design an implementation", "crear un plan de desarrollo", "create a development plan", "quiero planear", "quiero hacer un plan", "quiero disenar", o cuando solicite un feature cuya complejidad lo requiera. Ejecuta workflow de 5 fases: discovery, exploracion del codebase, clarificacion, arquitectura, y escritura del plan. Al aprobar el plan, invoca smart-delegation automaticamente para ejecutar la implementacion.

Esta skill debe usarse cuando el usuario pide "haz review de los cambios", "review the changes", "aplica el post-implementacion", "apply post-implementation", "run post-implementation", o cuando el plan aprobado instruye "invoke /smart-plan:post-implementation". Ejecuta workflow post-implementacion despues de que el codigo este completo con quality review (3 reviewers paralelos), auto-fix de issues (confianza >= 80%), documentacion del feature, y commit opcional. Puede usarse despues de cualquier implementacion, no solo smart-plan.

Esta skill debe usarse cuando Claude detecta que una implementacion es lo suficientemente grande como para dividirla en sub-agentes (5+ archivos, dependencias entre cambios, nuevas abstracciones que otros archivos consumen), cuando el usuario pide "delega la implementacion", "orquesta los implementadores", "usa sub-agentes", "delegate to sub-agents", "orchestrate implementers", o cuando plan-feature invoca la delegacion tras aprobar un plan.

Esta skill debe usarse cuando el usuario pregunta "¿Preguntas?", "¿Tienes dudas?", "¿Tienes preguntas?", "¿Quieres aclarar algo?", "¿Necesitas aclarar algo?", "aclara lo que necesites", o cuando quiere aterrizar requerimientos antes de planear. Tambien la invoca plan-feature en Phase 3. Ejecuta entrevista estructurada para obtener requerimientos cuantificables, reglas de negocio traducibles a codigo, y flujos del sistema; luego anota los resultados en el plan.