Añadidos arhcivos basicos de repos

2026-03-18 21:27:21 +01:00
commit 4bc7a7d291
31 changed files with 6506 additions and 0 deletions
@@ -0,0 +1,144 @@
+---
+version: 1.0.0
+updated: {{FECHA}}
+tags: [{{TAGS}}]
+---
+
+# Command: {{NOMBRE}}
+
+{{DESCRIPCION_BREVE}}
+
+## Para el usuario
+
+### Cuándo usar este comando
+
+{{CUANDO_USAR}}
+
+### Sintaxis
+
+```bash
+/{{NOMBRE}} {{ARGUMENTOS}}
+```
+
+### Ejemplos
+
+**Ejemplo 1:**
+```bash
+/{{NOMBRE}} {{EJEMPLO_1}}
+```
+
+{{DESCRIPCION_EJEMPLO_1}}
+
+**Ejemplo 2:**
+```bash
+/{{NOMBRE}} {{EJEMPLO_2}}
+```
+
+{{DESCRIPCION_EJEMPLO_2}}
+
+## Para Claude
+
+### Precondiciones
+
+Verificar antes de ejecutar:
+
+- [ ] {{PRECONDICION_1}}
+- [ ] {{PRECONDICION_2}}
+- [ ] {{PRECONDICION_3}}
+
+### Inputs
+
+Se necesitan los siguientes datos. Si no se proporcionan, preguntar al usuario:
+
+- `{{INPUT_1}}`: {{DESCRIPCION_INPUT_1}}
+- `{{INPUT_2}}` (opcional): {{DESCRIPCION_INPUT_2}}
+
+### Flujo obligatorio
+
+#### 1. {{PASO_1}}
+
+{{DESCRIPCION_PASO_1}}
+
+```bash
+{{COMANDOS_PASO_1}}
+```
+
+{{NOTAS_PASO_1}}
+
+#### 2. {{PASO_2}}
+
+{{DESCRIPCION_PASO_2}}
+
+```bash
+{{COMANDOS_PASO_2}}
+```
+
+{{NOTAS_PASO_2}}
+
+#### 3. {{PASO_3}}
+
+{{include: ask-user-confirm}}
+
+{{MENSAJE_CONFIRMACION}}
+
+#### 4. {{PASO_4}}
+
+{{DESCRIPCION_PASO_4}}
+
+```bash
+{{COMANDOS_PASO_4}}
+```
+
+### Verificación final
+
+```bash
+{{COMANDOS_VERIFICACION}}
+```
+
+Informar al usuario:
+
+```
+✓ {{MENSAJE_EXITO}}
+
+{{DETALLES_FINALES}}
+```
+
+## Convenciones
+
+- **{{CONVENCION_1}}**: {{DESCRIPCION_CONVENCION_1}}
+- **{{CONVENCION_2}}**: {{DESCRIPCION_CONVENCION_2}}
+
+## Troubleshooting
+
+### Error: "{{ERROR_1}}"
+
+**Causa:** {{CAUSA_ERROR_1}}
+
+**Solución:**
+```bash
+{{SOLUCION_ERROR_1}}
+```
+
+### Error: "{{ERROR_2}}"
+
+**Causa:** {{CAUSA_ERROR_2}}
+
+**Solución:**
+```bash
+{{SOLUCION_ERROR_2}}
+```
+
+### Error: "{{ERROR_3}}"
+
+**Causa:** {{CAUSA_ERROR_3}}
+
+**Solución:**
+1. {{PASO_SOLUCION_3_1}}
+2. {{PASO_SOLUCION_3_2}}
+3. {{PASO_SOLUCION_3_3}}
+
+## Reglas críticas
+
+- {{REGLA_CRITICA_1}}
+- {{REGLA_CRITICA_2}}
+- {{REGLA_CRITICA_3}}
@@ -0,0 +1,128 @@
+# NNNN — [Título de la Issue]
+
+## Metadata
+
+| Campo | Valor |
+|-------|-------|
+| **ID** | NNNN |
+| **Estado** | 🟡 pendiente / 🔵 en progreso / ✅ completado / 🔴 bloqueado |
+| **Prioridad** | alta / media / baja |
+| **Tipo** | feature / bugfix / refactor / docs / infrastructure |
+
+## Dependencias
+
+<!-- Issues que DEBEN estar completadas antes de empezar esta -->
+
+| ID | Título | Estado | Requerido |
+|----|--------|--------|-----------|
+| 0001 | Actualizar nombre del módulo | ✅ | Sí |
+| 0002 | Implementar core/ | ✅ | Sí |
+
+**Bloqueada por:** `#0001, #0002`
+
+**Desbloquea:** `#0006, #0007`
+
+> **⚠️ VALIDACIÓN AUTOMÁTICA**: Esta issue no puede iniciarse hasta que todas las dependencias estén en estado `✅ completado`.
+
+---
+
+## Objetivo
+
+[Descripción concisa de qué se quiere lograr en 1-3 oraciones]
+
+## Contexto
+
+- [Punto de contexto 1]
+- [Punto de contexto 2]
+- [Referencias a otras issues o decisiones previas]
+
+## Arquitectura
+
+```
+[Estructura de archivos afectados]
+dir/
+├── file1.go    — Descripción
+├── file2.go    — NEW: Nuevo archivo
+└── file3.go    — MODIFY: Modificación
+```
+
+### Patrón pure core / impure shell
+
+- `core/` — [Qué funciones puras se agregan]
+- `shell/` — [Qué operaciones I/O se implementan]
+- `app/` — [Cómo se orquesta]
+
+## Tareas
+
+### Fase 1: [Nombre de fase]
+
+- [ ] **1.1** [Descripción detallada de tarea]
+- [ ] **1.2** [Otra tarea]
+
+### Fase 2: [Otra fase]
+
+- [ ] **2.1** [Tarea]
+- [ ] **2.2** [Tarea]
+
+### Fase N: Cleanup y docs
+
+- [ ] Actualizar `README.md` con cambios relevantes
+- [ ] Actualizar `CLAUDE.md` si hay cambios arquitectónicos
+- [ ] Ejecutar `go mod tidy`
+- [ ] Ejecutar `go test ./...`
+- [ ] Actualizar issue en `dev/issues/README.md`
+
+---
+
+## Ejemplo de uso
+
+```bash
+# Comandos de ejemplo
+comando ejemplo arg1 arg2
+
+# Output esperado:
+# ✓ Success message
+```
+
+```go
+// Código de ejemplo si aplica
+package example
+
+func Example() {}
+```
+
+## Decisiones de diseño
+
+- **Decisión 1**: Razón y trade-offs
+- **Decisión 2**: Alternativas consideradas y por qué se eligió esta
+
+## Prerequisitos
+
+- Issue #NNNN completado
+- Herramienta X instalada
+- Configuración Y realizada
+
+## Riesgos
+
+- **Riesgo 1**: Descripción del riesgo. **Mitigación**: Cómo se mitigará
+- **Riesgo 2**: Otro riesgo. **Mitigación**: Plan de mitigación
+
+## Criterios de aceptación
+
+- [ ] Todos los tests pasan
+- [ ] Feature flag agregado en `feature_flags.json`
+- [ ] Documentación actualizada
+- [ ] Code review aprobado
+- [ ] Deployable a main
+
+---
+
+## Notas de implementación
+
+[Notas que surjan durante la implementación, decisiones tomadas, problemas encontrados]
+
+## Referencias
+
+- [Link a documentación relevante]
+- [Link a PRs relacionados]
+- [Link a discusiones]