| name | gurusup-workflow |
| description | Workflow completo de desarrollo Design-First: exploración → clarificación → planificación → implementación autónoma (Ralph Loop). Incluye creación de issues GitHub de alta calidad estilo PRD. |
| version | 1.0.0 |
| author | VisiClaw (basado en GuruSup workflow) |
| commands | ["/explore-plan","/implement","/create-issue","/product-clarify"] |
GuruSup Workflow - Design-First Development
Sistema completo de desarrollo que integra exploración, planificación detallada, e implementación autónoma con feedback loops.
Comandos Disponibles
/explore-plan <descripción>
Explora el codebase y crea un plan detallado de implementación.
/implement <issue_number>
Inicia el Ralph Loop para ejecutar el plan de forma autónoma hasta completar todas las validaciones.
/create-issue <plan_path>
Crea una issue de GitHub de alta calidad estilo PRD.
/product-clarify <issue_number>
Clarifica requisitos de producto para una issue existente.
Filosofía
Design-First: Antes de escribir código, entender completamente el problema y planificar la solución.
Ralph Loop: Implementación autónoma iterativa. Cada iteración valida, corrige y avanza hasta completar.
Self-documenting: Todo el proceso queda documentado en archivos de sesión y logs de progreso.
Flujo de Trabajo Completo
┌─────────────────────────────────────────────────────────────────┐
│ 1. EXPLORE & PLAN │
│ /explore-plan "nueva funcionalidad X" │
│ → Crea context_session_{feature}.md │
│ → Explora código existente │
│ → Hace preguntas de clarificación │
│ → Genera plan detallado con fases │
└─────────────────────┬───────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. CREATE GITHUB ISSUE │
│ /create-issue context_session_{feature}.md │
│ → Genera issue estilo PRD │
│ → Incluye criterios de aceptación │
│ → Añade diagramas UML │
│ → Documenta edge cases │
└─────────────────────┬───────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. IMPLEMENT (Ralph Loop) │
│ /implement <issue_number> │
│ → Crea worktree feature-issue-{N} │
│ → Loop autónomo: implement → validate → fix → repeat │
│ → Genera reporte de implementación │
│ → Crea PR a develop │
└─────────────────────────────────────────────────────────────────┘
Estructura de Archivos
.claude/
├── sessions/
│ └── context_session_{feature}.md # Plan de sesión activa
├── ralph.state.md # Estado del Ralph Loop
├── ralph-archives/ # Historial de loops completados
│ └── YYYY-MM-DD-{feature}/
│ ├── state.md
│ ├── plan.md
│ └── learnings.md
└── reports/
└── {feature}-report.md # Reporte de implementación
Referencias
Ver carpeta references/ para:
explore-plan.md - Comando de exploración y planificaciónimplement-ralph.md - Comando de implementación autónomacreate-issue.md - Creación de issues GitHub estilo PRDproduct-clarify.md - Clarificación de requisitosralph-loop-guide.md - Guía detallada del Ralph Loop
Uso Recomendado
Para una nueva feature:
1. /explore-plan "Implementar sistema de notificaciones push"
2. [Responder preguntas de clarificación]
3. [Revisar plan generado]
4. /create-issue .claude/sessions/context_session_notificaciones.md
5. /implement 42
Para un bug:
1. /explore-plan "Fix: usuarios ven documentos de otros educandos"
2. [Analizar código relevante]
3. /create-issue .claude/sessions/context_session_fix_docs.md
4. /implement 43
Integración con Setup-Software-IA
Esta skill complementa el sistema Design-First existente:
| Fase Design-First | Comando GuruSup |
|---|
| Entrevista | /explore-plan (clarificación) |
| Diseño | /explore-plan (planificación) |
| Implementación | /implement (Ralph Loop) |
| Documentación | /create-issue (PRD automático) |
