Una implementación real, revisada el 15-10-2026
Este repositorio construye el sitio real. Demuestra prácticas elegidas de SHAPE; una aplicación funcional no valida todas las variantes. El inventario seleccionado se comprobó en el árbol de trabajo. Se omiten deliberadamente otros archivos anidados, dependencias generadas y salidas de compilación; no es un volcado completo. No incluye credenciales ni archivos privados.
shape/
├── AGENTS.md
├── agent_instructions/
│ ├── SHAPE.md
│ ├── STACK.md
│ ├── ARCHITECTURE.md
│ ├── DESIGN.md
│ └── OBJECTIVES.md
├── specifications/
│ ├── requests/
│ ├── archive/
│ └── current/
├── app/
│ ├── (english)/
│ ├── (german)/de/
│ └── (spanish)/es/
├── application/
├── domain/
├── infrastructure/
├── components/
├── styles/
├── i18n/
├── scripts/
├── tests/
│ ├── unit/
│ └── e2e/
├── public/
├── resources/
├── diagrams/
├── docs/
├── server.js
├── next.config.mjs
├── package.json
└── pnpm-lock.yaml
Ciclo de especificaciones: specifications/requests/ contiene solicitudes humanas pendientes; specifications/archive/ conserva solicitudes humanas implementadas como registros históricos; specifications/current/ contiene descripciones mantenidas por el agente del comportamiento actualmente requerido. Archivar las solicitudes implementadas sin reescribir su contenido histórico y actualizar las especificaciones vigentes. Los mensajes y conversaciones pueden autorizar desarrollo sin archivo formal; mantener el registro vigente con independencia del formato de solicitud.
Instrucciones reales, no el mínimo conceptual
El AGENTS.md raíz real contiene reglas detalladas además del descubrimiento; es mayor que el modelo mínimo. No se reescribió para encajar en el ejemplo. Véase el recorrido raíz.
En agent_instructions/ existen SHAPE.md (principios de agentes), STACK.md (tecnología aprobada), ARCHITECTURE.md (internacionalización y límites de capas), DESIGN.md (orientación visual) y OBJECTIVES.md (contexto empresarial explícitamente no normativo). El ejemplo central y el recorrido de archivos reproducen fuentes en su orden. Son nombres de este proyecto, no una lista universal; aquí no existe LIBRARIES.md.
Primeras líneas reales (fuente literal en inglés):
| Archivo | Primera línea | Recorrido |
|---|---|---|
ARCHITECTURE.md | ## Internationalization (i18n) Architecture | Leer fuente y explicación |
DESIGN.md | # DESIGN.md | Leer fuente y explicación |
OBJECTIVES.md | # OBJECTIVES.md — SHAPE Framework Website | Leer fuente y explicación |
SHAPE.md | # SHAPE — Core Agent Principles | Leer fuente y explicación |
STACK.md | # STACK.md | Leer fuente y explicación |
Responsabilidades por directorio
| Ruta | Contenido y exclusiones | Responsabilidad y acciones | Motivo / alcance |
|---|---|---|---|
AGENTS.md | Descubrimiento y reglas detalladas reales; no intención funcional | Edición solo por instrucción explícita del usuario; agentes leen | Entrada ampliada del proyecto |
agent_instructions/ | Tecnología, arquitectura, diseño y contexto permanentes; no especificaciones de funcionalidades | Responsables gobiernan estándares; agentes leen y cambian con autoridad | Convención extensible, archivos elegidos |
specifications/requests/ | Peticiones humanas; no contenido ejecutable | Personas redactan; agentes leen, no modifican sin instrucción | Registro histórico del proyecto |
specifications/archive/ | Peticiones humanas anteriores; no código generado | Personas conservan historial; agentes leen sin cambios no autorizados | Procedencia archivada, no carpeta obligatoria SHAPE |
specifications/current/ | Requisitos por área; no archivo maestro único | Agentes mantienen; personas deciden intención | Práctica actual del proyecto |
app/ | Adaptadores EN/DE/ES y metadatos; no UI duplicada por idioma | Agentes siguen arquitectura; cambios arquitectónicos con responsable | Rutas de Next.js |
domain/ | Contratos, rutas canónicas y relaciones; no UI ni sistema de archivos | Agentes mantienen contratos e inventario | Separación de estructura |
application/ | Ensamblado de navegación, metadatos y rutas; no presentación | Agentes conectan dominio y cargadores | Capa de aplicación |
infrastructure/ | Carga YAML/archivos de servidor y recuperación HTTP; no acceso desde cliente | Agentes usan capacidades aprobadas | Límite de infraestructura |
components/ | UI canónica compartida e interacciones pequeñas; no componentes por idioma | Reutilización; cambios compartidos de diseño requieren autoridad | Presentación React |
styles/ | Tokens centrales y estilos globales; no valores arbitrarios | Responsable de diseño gobierna estándares; agentes usan tokens | Tema intercambiable |
i18n/ | Ayudantes de idioma y YAML EN/DE/ES; no prosa ejecutable/JSX | Agentes mantienen paridad y metadatos | Arquitectura de contenido local |
scripts/ | Generación de diagramas/recuperación, validación y paquetes; no política de producto | Ejecución solo autorizada, incluidas reglas de pruebas | Operaciones, no herramientas obligatorias SHAPE |
tests/unit/, tests/e2e/ | Pruebas Vitest/Playwright y datos; no aceptación humana | Comprobaciones autorizadas; derivación independiente exige otro contexto | Herramientas elegidas por proyecto |
public/ | Recursos servidos y recuperación; no secretos | Publicación segura aprobada; imágenes protegidas en esta actualización | Archivos para navegador |
resources/ | Ilustraciones originales locales; no lógica empresarial | Recursos aprobados conservados; sin edición de imágenes | Material fuente local |
diagrams/ | Mermaid editable/configuración; no política de permisos | El build puede derivar SVG; aquí no se regeneran | Canal de ilustraciones del sitio |
docs/ | Despliegue y verificación; no nuevo comportamiento | Agentes mantienen hechos/resultados; sin aceptación inventada | Evidencia operativa |
server.js, next.config.mjs | Inicio/configuración cPanel; no dominio | Rige arquitectura existente; confirmar responsable | Alojamiento elegido |
package.json, pnpm-lock.yaml | Scripts y dependencias exactas; no credenciales | Dependencias nuevas requieren aprobación humana; agentes reutilizan | Herramientas reproducibles |
¿Convención del marco o elección del proyecto?
| Elemento | Qué hace este sitio | ¿Requisito general de SHAPE? | ¿Quién puede cambiarlo? | Importancia |
|---|---|---|---|---|
| Descubrimiento raíz | AGENTS.md detallado dirige a todo Markdown | Entrada mínima como convención; contenido completo local | Instrucción explícita del usuario aquí | Encontrar reglas sin registro manual |
| Directorio de instrucciones | Cinco documentos reales | Extensible, sin inventario prescrito | Responsables autorizados; confirmar con responsable del repositorio | Separar asuntos duraderos |
| Archivos nombrados | SHAPE.md, STACK.md, ARCHITECTURE.md, DESIGN.md, OBJECTIVES.md | Sin nombres universales; identidad canónica pendiente | Confirmar con responsable del repositorio | No convertir ejemplos en mandatos |
| Organización de especificaciones | Peticiones y áreas de estado actual | Elección local; ciclo de tres directorios; archivo maestro opcional | Responsables humanos de intención; agentes mantienen contexto | Preservar procedencia y continuidad |
| Fuente/estructura | Capas Next.js/React y YAML | Específico del sitio | Confirmar con responsable del repositorio | SHAPE no prescribe arquitectura |
| Herramientas de pruebas | Vitest y Playwright | Locales; verificación independiente sigue como principio | Personas autorizan ejecución según normas locales | Pruebas no equivalen a aceptación |
| Acceso técnico | Entorno/repositorio deben aplicar límites | Principio general; controles según empresa | Administradores autorizados; confirmar responsable | El texto no crea permisos |
Un cambio pequeño verificable y sus límites
La petición conservada specifications/archive/SHAPE_Framework_Website_QA_Round_3_Correction_Spec.md solicitó consolidar criterios duplicados. El cambio afectó solo esos textos de i18n/en/guides/discovery.yaml y i18n/en/guides/feature-specification.yaml y sus equivalentes alemanes/españoles. specifications/current/content.md y las pruebas tests/unit/round3-content.test.tsx y tests/e2e/qa-content.spec.ts registran intención y comprobaciones.
docs/QA-ROUND-3.md registra 62 pruebas unitarias y 57 de navegador superadas, una omisión intencional y sumas de imágenes intactas. Son resultados locales, no prueba de autoría independiente, ejecución en producción ni aceptación humana. No había registro de aceptación ni revisión del cambio confirmada en Git; no se inventan publicación ni aceptación. Es un ejemplo verificable del árbol de trabajo con esos límites.