egutierrez
2f83d0b746
Mueve templates a las carpetas de skills que los usan: - templates/issue.md → skills/create-issue/issue.md - templates/skill.md → skills/create-skill/skill.md Actualiza install.sh: solo enlaza skills y agents. Estructura final de .claude/: - CLAUDE.md - settings.local.json - agents/ - skills/
129 lines
2.7 KiB
Markdown
129 lines
2.7 KiB
Markdown
# 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]
|