Files

T

egutierrez 9deffc12c9 refactor: migrar policies/ a rules/ y añadir create_issue

Se renombra .claude/policies/ a .claude/rules/ para usar terminología
más clara y consistente. Se añade la nueva regla create_issue.md con
guía completa para crear issues en dev/issues/, incluyendo el template
en .claude/templates/issue.md. El índice (index.md) se actualiza con
la nueva regla.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-07 17:41:08 +00:00

2.3 KiB

Raw Blame History

Regla: Crear un nuevo issue

Guia para crear issues de features, mejoras o bugs en dev/issues/.

Inputs — preguntar al usuario si no los da

Input	Requerido	Ejemplo
Titulo	si	"Hot reload de configuracion"
Descripcion/objetivo	si	"Recargar config sin reiniciar el agente"
Dependencias	no	"Requiere issue 010"

Pasos

1. Determinar el numero del issue

Buscar el numero mas alto en dev/issues/ y usar el siguiente. Formato: 3 digitos con ceros a la izquierda (019, 020, etc.).

2. Crear el archivo desde el template

Copiar .claude/templates/issue.md a dev/issues/<NNN>-<slug>.md.

El slug debe ser:

Lowercase
Palabras separadas por guiones
Conciso (2-4 palabras)
Ejemplo: 019-hot-reload.md

3. Rellenar el template

Completar todas las secciones del template:

Objetivo: 1-3 frases claras de que se quiere lograr
Contexto: que existe, que falta, dependencias
Arquitectura: archivos afectados, marcar NEW los nuevos. Incluir como se respeta pure core / impure shell
Tareas: desglosar en fases con tareas numeradas (1.1, 1.2, etc.). Cada tarea debe ser concreta y verificable. Incluir siempre una fase de tests y una de cleanup/docs
Ejemplo de uso: flujo concreto mostrando la feature funcionando
Decisiones de diseno: justificar las decisiones clave
Prerequisitos: que debe estar implementado antes
Riesgos: problemas potenciales y mitigacion

4. Actualizar el indice

Agregar una fila al final de la tabla en dev/issues/README.md:

| <N> | <Titulo> | [<NNN>-<slug>.md](<NNN>-<slug>.md) | pendiente |

Reglas

Patron pure core / impure shell: toda feature debe explicar que va en pkg/ (puro) vs shell/ (impuro).
Tareas atomicas: cada tarea debe ser implementable de forma independiente.
Numeracion continua: nunca reusar numeros de issues eliminados.
Estado: los issues nuevos siempre empiezan como pendiente.
Completados: cuando se termine un issue, moverlo a dev/issues/completed/ y actualizar el README.

Verificacion

Archivo creado en dev/issues/<NNN>-<slug>.md
Todas las secciones del template rellenadas
Fila agregada en dev/issues/README.md
Numero de issue es consecutivo (no hay saltos ni duplicados)

2.3 KiB Raw Blame History