🔁 Refinamiento continuo (Idea y Especificaciones)

---

🌍 Par de idioma / Language pair

• Español: 11-refinamiento-continuo.md
• English: ../en/11-continuous-refinement.md

🗣️ Prompt amigable (copiar y pegar)

Usa esto cuando no eres técnico y quieres que la IA haga la integración + guía completa:

Usando https://github.com/juanklagos/spec-driven-development-template, crea todo lo necesario para llevar a cabo mi proyecto de principio a fin.
Mi proyecto es: [explica tu proyecto en lenguaje simple].

Si mi proyecto es nuevo, inicialízalo con este template y GitHub Spec Kit.
Si mi proyecto ya existe, adáptalo a idea/specs/bitacora sin romper el comportamiento actual.
Guíame paso a paso según mi nivel (principiante/intermedio/avanzado), con lenguaje claro.
No omitas especificación, plan, tareas, traza de refinamiento, bitácora y validación.

[!TIP] Para inicio rápido y prompts, usa:

• AI_START_HERE.md
• Matriz de prompts
• Banco de prompts validados

Esta guía define cómo mejorar el proyecto cuando cambian ideas, prioridades o requisitos.

🎯 Objetivo

Mantener consistencia entre:

• idea/IDEA_GENERAL.md
• specs/ (todas las especificaciones)
• bitacora/ (registro real de lo que pasó)

📌 Regla principal

Cada cambio importante debe dejar rastro en 3 lugares:

1. Idea o especificación afectada.
2. Historial de la especificación.
3. Bitácora de sesión.

🧭 Tipos de cambio y acción obligatoria

Tipo de cambio	Qué hacer	Dónde registrar
Cambio de visión del producto	Actualizar idea general	idea/IDEA_GENERAL.md + bitacora/global/PROJECT_LOG.md
Nuevo requisito	Crear o actualizar especificación	specs/NNN-.../spec.md + specs/NNN-.../history.md
Cambio técnico de implementación	Actualizar plan y tareas	plan.md, tasks.md, history.md
Ajuste por hallazgos	Actualizar investigación	research.md, history.md, bitácora diaria
Cambio de alcance	Marcar impacto y priorización	specs/INDEX.md + history.md

📈 Flujo visual de refinamiento

flowchart LR
  A["Cambio detectado"] --> B["Clasificar tipo de cambio"]
  B --> C["Actualizar Idea o Spec"]
  C --> D["Registrar en history.md"]
  D --> E["Actualizar bitacora"]
  E --> F["Revalidar plan y tareas"]

✅ Checklist rápido de refinamiento

• ¿El cambio afecta idea general?
• ¿Se actualizó la spec activa?
• ¿Se registró entrada en history.md?
• ¿Se actualizó bitácora global o diaria?
• ¿Se revisaron tareas para evitar contradicciones?

📝 Formato recomendado para history.md

Fecha	Tipo de cambio	Resumen	Archivos impactados	Responsable
2026-03-12	Cambio de alcance	Se dividió spec en dos fases	spec.md, tasks.md	IA

🤖 Regla para herramientas de Inteligencia Artificial

Si detectas contradicción entre idea y spec:

1. No implementar de inmediato.
2. Proponer refinamiento.
3. Actualizar documentación.
4. Recién después continuar implementación.

💡 Tips rápidos

• Empieza con una descripción corta del proyecto en lenguaje simple.
• Pide a la IA confirmar la spec activa antes de programar.
• Cierra cada sesión con validación y próximo paso claro.

📊 Flujo visual

flowchart LR
  A["Idea del proyecto"] --> B["Spec aprobada"]
  B --> C["Plan alineado"]
  C --> D["Tareas priorizadas"]
  D --> E["Implementación"]
  E --> F["Validación + Bitácora"]