SPEC-011 — Spec Auditor

Project ID: 011-spec-auditor
Carpeta de implementacion: projects/011-spec-auditor/

Overview

Spec Auditor nace para reducir errores de calidad en specs y episodios: valida frontmatter, consistencia de campos clave y cumplimiento SEO antes del deploy.

Problema

En trabajo paralelo con multiples sesiones, es facil que entren documentos con estructura incompleta, metadatos inconsistentes o descripciones SEO debiles.

Objetivo funcional

Entregar un flujo de auditoria que detecte desalineaciones y produzca un reporte accionable, priorizando seguridad editorial, cambios pequenos y validaciones repetibles.

Alcance inicial (MVP)

• Leer documentos objetivo en src/content/docs/projects/*/spec.md.
• Verificar presencia de title, description, status.
• Verificar campos SEO: seoTitle, metaDescription (<=160), keywords.
• Reportar fallos con nivel de severidad y recomendacion breve.

Fuera de alcance (fase actual)

• Correcciones automaticas en masa.
• Integracion con servicios externos.
• Edicion de contenido narrativo fuera de specs.

Criterios de aceptacion

• El auditor identifica faltantes de frontmatter en archivos objetivo.
• El auditor marca metaDescription que excede 160 caracteres.
• El reporte diferencia errores bloqueantes y advertencias.
• El resultado es entendible para ejecutar correcciones pequenas por iteracion.

Riesgos

• Reglas demasiado estrictas pueden frenar iteracion temprana.
• Sin criterios de severidad claros, el reporte puede perder utilidad operativa.

Notas

• Este documento inicializa el proyecto 011 en modo SDD.
• El contenido se puede extender cuando Caprini aporte criterios adicionales de auditoria.