Imported from fralmeagUTP/visualstruct_web (openspec/AGENTS.md). Install upstream with npx skills add fralmeagUTP/visualstruct_web --skill openspec. Copyright stays with the author.

OpenSpec — Instrucciones para agentes

Este proyecto usa OpenSpec para Spec-Driven Development (SDD).

Estructura

openspec/
  project.md        # Contexto y convenciones del proyecto
  AGENTS.md         # Este archivo
  specs/            # VERDAD ACTUAL: capacidades ya implementadas
    <capability>/
      spec.md
  changes/          # PROPUESTAS: cambios aún no implementados
    <change-id>/
      proposal.md
      tasks.md
      design.md     # opcional
      specs/<capability>/spec.md   # deltas
    archive/        # cambios ya desplegados

Reglas fundamentales

1. specs/ describe lo que el sistema hace hoy. Solo se edita cuando un cambio archivado modifica el comportamiento real.
2. changes/ describe lo que se propone hacer. Nunca mezclar propuestas con el estado actual.
3. Toda capacidad nueva o modificada pasa primero por una propuesta en changes/, se implementa, se verifica, y luego se archiva actualizando specs/.

Formato de requisitos

Cada requisito usa lenguaje normativo (DEBE, SHALL) y al menos un escenario:

### Requirement: <Nombre>
El sistema DEBE <comportamiento>.

#### Scenario: <nombre del escenario>
- **GIVEN** <contexto>
- **WHEN** <acción>
- **THEN** <resultado esperado>

Formato de deltas (en changes/)

Los archivos de spec dentro de changes/<id>/specs/<capability>/spec.md usan encabezados de operación:

• ## ADDED Requirements — requisitos nuevos.
• ## MODIFIED Requirements — requisito existente reescrito completo (incluye sus escenarios).
• ## REMOVED Requirements — requisitos eliminados (nombre + razón).
• ## RENAMED Requirements — FROM: nombre viejo / TO: nombre nuevo.

Validación de una propuesta

Antes de considerar completa una propuesta de cambio:

• proposal.md explica el por qué y el qué (no el cómo detallado).
• tasks.md tiene checklist de tareas implementables y verificables.
• Cada requisito en deltas tiene al menos un escenario #### Scenario:.
• Los nombres de requisitos en MODIFIED/REMOVED existen en specs/ actuales.
• Tras implementar: suite pytest -q pasa y cobertura no baja.

Capacidades especificadas (estado actual)