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:
_XXdonde 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