<img src="../banner.png" width="100%" alt="docs-analysis banner">

Español — Versión oficial en español de docs-analysis.

Análisis de Requisitos de Documentos (Español)

Analiza todos los documentos de concepto y requisitos, verifica sus requisitos con el código actual y crea un informe de diferencias consolidado.

---

Descripción general y propósito

Analiza todos los documentos de concepto y requisitos en la carpeta ../docs/, verifica sus requisitos con el código actual y crea un informe de diferencias consolidado.

---

Convención de nomenclatura

Prefijo y sufijo

Todos los documentos analizados reciben:

• Prefijo: conN_ donde N = versión de análisis (1, 2, 3, ...)
• Sufijo: _XX donde XX = porcentaje de cumplimiento (redondeado al 10 más cercano)

Umbral de archivado

• >= 75% cumplido: El documento se mueve a ../docs/_archive/
• < 75% cumplido: El documento permanece en ../docs/ con prefijo/sufijo
• Umbral configurable (predeterminado: 75)

---

Proceso

Fase 1: Recopilar documentos

• Listar todos los archivos *.md y *.txt en ../docs/ (raíz)
• Filtrar README.txt

Fase 2: Extraer requisitos

Para cada documento:

• Leer contenido
• Identificar requisitos (listas de verificación, tablas, marcadores MISSING/TODO)
• Categorizar: Structure, Code, API, DB Schema, CLI, Feature

Fase 3: Verificación de código

Para cada requisito:

• Determinar el método de verificación (Glob, Grep, Read)
• Ejecutar la verificación
• Marcar como: FULFILLED, PARTIAL, MISSING

Fase 4: Evaluación

• Contar requisitos cumplidos vs. pendientes
• Calcular porcentaje de cumplimiento (%)
• Decidir: archivar (>= 75%) o mantener (< 75%)

Fase 5: Generar salida

• Crear REQUIREMENTS_ANALYSIS.md (resumen)
• Crear consense_diff.md (solo requisitos pendientes, por prioridad)

Fase 6: Control de versiones

• Escanear en busca del prefijo conN_ más alto
• Nueva versión = más alta + 1

Fase 7: Renombrar y mover

• Aplicar nuevo prefijo/sufijo a los documentos
• Archivar o mantener

---

Salida

Archivo	Descripción
conN_REQUIREMENTS_ANALYSIS.md	Análisis completo (versión N)
consense_diff_N.md	Requisitos pendientes consolidados
_archive/conN_*_XX.*	Documentos archivados (>=75%)

---

Clasificación de prioridad

Prioridad	Criterios
P1	Funcionalidad principal ausente, sistema no utilizable
P2	Función importante ausente, alternativa posible
P3	Deseable, mejora la UX
P4	Cosmético, documentación, calidad de código

---

Registro de cambios

1.0.0 (2026-03-15)

• Adaptado de BACH v3.8.0

---

Adaptado de BACH v3.8.0 | Versión independiente