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,212 @@
+---
+version: 1.0.0
+updated: 2026-03-15
+tags: [issues, quick, automation, tui]
+---
+
+# Command: quick-issue
+
+Crea un issue nuevo automáticamente desde la TUI con detección automática de workspace y número de issue.
+
+## Para el usuario
+
+### Cuándo usar este comando
+
+Este comando es invocado automáticamente por la TUI cuando el usuario presiona la opción "Create Issue". **No se debe invocar manualmente** desde la línea de comandos.
+
+### Sintaxis
+
+```bash
+/issues:quick-issue --text "descripción del issue"
+```
+
+El comando auto-detecta el próximo número de issue disponible y crea el archivo automáticamente.
+
+## Para Claude
+
+### Precondiciones
+
+Verificar antes de ejecutar:
+
+- [ ] Directorio `dev/issues/` existe
+- [ ] Parámetro `--text` fue proporcionado
+- [ ] Working tree limpio
+
+### Inputs
+
+**Obligatorios:**
+- `--text`: Texto descriptivo del issue (se usará como título y descripción)
+
+**Auto-detectados:**
+- Número de issue: Siguiente disponible en `dev/issues/`
+- Workspace: Proyecto padre (Dataforge)
+
+### Flujo obligatorio
+
+#### 1. Determinar número del issue
+
+```bash
+# Listar issues existentes
+ls -1 dev/issues/*.md | grep -E '^dev/issues/[0-9]{4}[a-z]?-' | sort -V
+
+# Extraer último número
+# Si el último es 0023-foo.md, siguiente es 0024
+# Si el último es 0023c-bar.md, siguiente es 0024
+```
+
+Regla: **SIEMPRE incrementar el número base**, ignorar letras.
+
+#### 2. Generar título y slug
+
+- **Título**: Usar `--text` directamente
+- **Slug**: Convertir título a kebab-case
+
+Ejemplo:
+```
+--text "Agregar soporte para temas oscuros"
+→ Título: "Agregar soporte para temas oscuros"
+→ Slug: "agregar-soporte-para-temas-oscuros"
+```
+
+#### 3. Crear archivo de issue
+
+Usar template `.claude/templates/issue.md` y completar:
+
+```markdown
+# NNNN — [Título]
+
+## Metadata
+
+| Campo | Valor |
+|-------|-------|
+| **ID** | NNNN |
+| **Estado** | 🟡 pendiente |
+| **Prioridad** | media |
+| **Tipo** | feature |
+
+## Dependencias
+
+| ID | Título | Estado | Requerido |
+|----|--------|--------|-----------|
+| - | - | - | - |
+
+**Bloqueada por:** Ninguna
+
+**Desbloquea:** (a determinar)
+
+---
+
+## Objetivo
+
+[Texto del parámetro --text]
+
+## Contexto
+
+(A completar durante implementación)
+
+## Tareas
+
+- [ ] (A detallar durante implementación con /issues:fix-issue)
+
+---
+
+## Criterios de aceptación
+
+- [ ] Tests pasando
+- [ ] Documentación actualizada
+- [ ] Issue movida a completed/
+
+---
+
+## Notas de implementación
+
+[Notas que surjan durante la implementación]
+```
+
+#### 4. Actualizar índice
+
+Agregar línea en `dev/issues/README.md`:
+
+```markdown
+- [ ] [NNNN](NNNN-slug.md) — [Título] (pendiente)
+```
+
+#### 5. Crear commits y mergear
+
+**Sin pedir confirmación**, ejecutar:
+
+```bash
+# Crear rama
+git checkout -b quick/issues:quick-issue-NNNN
+
+# Commitear
+git add dev/issues/NNNN-slug.md dev/issues/README.md
+git commit -m "docs: crear issue NNNN-slug" -m "Issue NNNN: [Título]
+
+Creado desde TUI con quick-issue.
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+# Mergear
+git checkout master
+git pull --rebase
+git merge --no-ff quick/issues:quick-issue-NNNN -m "merge: quick/issues:quick-issue-NNNN — [título]"
+
+# Push
+git push
+
+# Limpiar
+git branch -d quick/issues:quick-issue-NNNN
+```
+
+#### 6. Reportar resultado
+
+Informar al usuario con formato claro:
+
+```
+✓ Issue NNNN-slug creado e integrado
+
+Título: [Título]
+Archivo: dev/issues/NNNN-slug.md
+
+Para implementar:
+  /issues:fix-issue NNNN
+```
+
+## Convenciones
+
+- **Auto-detección**: workspace y número de issue
+- **Sin confirmación**: flujo completamente automático
+- **Trunk-based**: rama quick/ y merge inmediato
+- **Template simple**: detalles se completan durante /fix-issue
+- **Commits atómicos**: issue + índice en un solo commit
+
+## Troubleshooting
+
+### Error: "Missing --text parameter"
+
+**Causa:** El comando fue invocado sin el parámetro `--text`.
+
+**Solución:** Este comando debe ser invocado automáticamente por la TUI. No invocar manualmente.
+
+### Error: "Working tree not clean"
+
+**Causa:** Hay cambios pendientes.
+
+**Solución:**
+```bash
+git status
+git stash
+# Reintentar desde TUI
+git stash pop
+```
+
+## Reglas críticas
+
+- **SIEMPRE auto-detectar número de issue** - no pedirlo
+- **USAR --text como título completo** - no truncar
+- **NO pedir confirmación** - flujo automático
+- **Template minimalista** - los detalles se agregan en /fix-issue
+- **REPORTAR resultado claramente** - mostrar número y path del issue