Agentes y Habilidades (Skills)

En pocas palabras: En ospec-workflow, un Agente es el rol profesional que asume la IA (como un arquitecto de software o un auditor de seguridad), y una Skill es el manual de instrucciones exacto que le enseña paso a paso cómo realizar su trabajo con excelencia.

IDD por defecto, SDD como paquete opcional

En el flujo por defecto (IDD) no hay agentes de fase: la skill idd guía al asistente con el CLI ospec, y solo intervienen los revisores de solo lectura review-* cuando una obligación pide una revisión de confianza. El orquestador y los agentes sdd-* de esta página forman el paquete SDD, que se instala con --with-sdd.

Estructura de Roles Especializados (modo SDD)

En lugar de tener una sola IA que intente hacerlo todo, el sistema divide el trabajo entre agentes con responsabilidades muy claras:

flowchart TD
    Orch["sdd-orchestrator
(Coordinador del flujo)"] --> P["sdd-propose (Propuestas)"]
    Orch --> S["sdd-spec (Especificaciones)"]
    Orch --> D["sdd-design (Arquitectura)"]
    Orch --> T["sdd-tasks (Plan de tareas)"]
    Orch --> A["sdd-apply (Programador TDD)"]
    Orch --> V["sdd-verify (Verificador de tests)"]
    Orch --> Arc["sdd-archive (Historiador)"]
    
    V --> R1["review-trust (Trust)"]
    V --> R2["review-runtime (Runtime)"]
    V --> R3["review-evolution (Evolution)"]
    V --> R4["review-efficiency (Efficiency)"]

Live routes use the quality v2 roster above. The 4R lenses (review-risk, review-readability, review-reliability, review-resilience) were retired in v2.91.0: schema_version: 1 lineages stay readable for one minor version and migrate to v2 when they still need lenses.

Catálogo de Agentes Principales

Agente	Rol y Responsabilidad
`sdd-orchestrator`	El director de orquesta. Evalúa la solicitud, elige la ruta y delega en el especialista correspondiente.
`sdd-propose`	Redacta la propuesta inicial con el objetivo, alcance y análisis de riesgos.
`sdd-spec`	Define los requerimientos y escenarios de prueba utilizando el estándar OpenSpec.
`sdd-design`	Diseña la arquitectura técnica, estructuras de datos y estrategia de archivos.
`sdd-tasks`	Desglosa la solución en tareas concretas y estima el impacto en líneas de código.
`sdd-apply`	Implementa el código siguiendo estrictamente TDD (primero el test que falla, luego el código).
`sdd-verify`	Ejecuta las pruebas en consola real y audita que la evidencia sea sólida y sin trampas.
`sdd-archive`	Registra el cambio terminado en el historial de archivo inmutable de la empresa.

Las Habilidades (Skills): Procedimientos Paso a Paso

Cada agente cuenta con un documento SKILL.md que define su procedimiento operativo estándar. Existen 4 tipos de habilidades en el repositorio:

Habilidades de Fase SDD (skills/sdd-*): El procedimiento formal para cada una de las etapas de desarrollo.
Protocolo Compartido (skills/_shared/): Reglas universales para todos los agentes (formato de respuesta, memoria operativa y estilo de comunicación).
Habilidades de Stack Tecnológico (skills/stack-*): Buenas prácticas específicas para React, Go, Python, Spring Boot, Astro Starlight, Angular, etc.
Habilidades de Utilidad (skills/chained-pr, skills/branch-pr, etc.): Herramientas para dividir Pull Requests grandes, crear ramas o generar notas de versión.

Registro Ultrarrápido en Caché

Para que los asistentes no pierdan tiempo buscando archivos en el disco, el sistema compila todo el catálogo de habilidades en un archivo JSON indexado (.ospec/cache/skill-registry.cache.json). Al iniciar la sesión, los agentes acceden a sus instrucciones en milisegundos.