repo_Claude/.claude/skills/create-issue/issue.md

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

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

# Comandos de ejemplo
comando ejemplo arg1 arg2

# Output esperado:
# ✓ Success message

// 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]