ES

---
name: docs-analysis
version: 1.0.0
type: skill
author: Lukas Geiger
created: 2026-03-15
updated: 2026-03-15
description: "Análisis de requisitos de documentos: Analiza los documentos de concepto y requisitos en la carpeta docs/, verifica los requisitos con el código actual y crea un informe de diferencias consolidado."

standalone: true
anthropic_compatible: true
bach_compatible: false
bach_origin: true
category: dev
tags: [docs-analysis, requirements, code-review, diff-report, quality-assurance]
language: es
status: active
dependencies: {'tools': [], 'services': [], 'protocols': [], 'python': []}
provenance: {'origin': 'bach', 'origin_path': 'system/skills/workflows/docs-analyse.md', 'origin_version': '1.2.0', 'origin_repo': 'github.com/ellmos-ai/bach', 'last_sync_from_origin': '2026-03-15', 'last_sync_to_origin': None, 'local_changes_since_sync': True}
---

<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*