{
  "version": "1.0.0",
  "actualizado": "2026-11-17T00:00:00.000Z",
  "formato": "TPP 1.0",
  "plantillas": [
    {
      "id": "game-2d-platformer",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Plataformas 2D pixel-art",
      "name_en": "2D platformer pixel-art",
      "summary_es": "Juego de plataformas con bucle estable, colisiones justas y guardado atómico.",
      "summary_en": "Platformer with a stable loop, fair collisions and atomic saves.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-physics-collision",
        "game-save-systems"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art limpio con UI de alto contraste",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Plataformas 2D pixel-art",
        "schema_version": 1,
        "identity": {
          "name": "Plataformas 2D pixel-art",
          "description": "Los juegos 2D pequeños mueren por bucles inestables, colisiones injustas y saves corruptos.",
          "problem": "Los juegos 2D pequeños mueren por bucles inestables, colisiones injustas y saves corruptos.",
          "vision": "Un juego 2D compacto, justo y terminable, con progreso que nunca se pierde.",
          "goals": [
            "Bucle y física",
            "Control y colisiones"
          ],
          "specific_goals": [
            "60 fps estables en gama media",
            "Cero saves corruptos en prueba de corte",
            "Partida completa en menos de 2 h"
          ],
          "users": [
            "Jugador casual de escritorio o móvil",
            "Desarrollador solitario que mantiene el juego"
          ],
          "use_cases": [
            "Bucle de juego estable",
            "Control del jugador",
            "Colisiones y daño"
          ],
          "scope": [
            "Bucle y física",
            "Control y colisiones",
            "Progreso y guardado",
            "HUD y pausa"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "60 fps estables en gama media",
            "Cero saves corruptos en prueba de corte",
            "Partida completa en menos de 2 h"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego estable",
            "statement": "El juego mantiene un bucle de actualización y dibujo a paso fijo con interpolación.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El paso de física es independiente del framerate",
              "Pausar congela simulación y audio"
            ],
            "links": [
              "process:p-01"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Control del jugador",
            "statement": "El jugador se mueve, salta o esquiva con respuesta inmediata y coyote time.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Input buffering de 100 ms",
              "Coyote time de 80 ms en plataformas"
            ],
            "links": [
              "process:p-02",
              "entity:partida"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Colisiones y daño",
            "statement": "Las colisiones usan capas y máscaras; el daño respeta invulnerabilidad temporal.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ningún golpe atraviesa paredes",
              "Invulnerabilidad de 600 ms tras daño"
            ],
            "links": [
              "process:p-02",
              "entity:partida"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Progreso y guardado",
            "statement": "La partida guarda progreso y ajustes en un archivo local versionado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Guardar no corrompe partidas ante cierre abrupto",
              "Migración de saves entre versiones"
            ],
            "links": [
              "process:p-03",
              "entity:partida"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "HUD y pausa",
            "statement": "El HUD muestra vida, puntuación y objetivo; el menú de pausa permite salir sin perder progreso.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "HUD legible a 720p y 1080p",
              "Pausa accesible con un botón"
            ],
            "links": [
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Dificultad acotada",
            "statement": "La dificultad nunca supera el máximo configurado por nivel u oleada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Curva de dificultad monotónica por tramo"
            ],
            "links": [
              "entity:nivel"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Sin assets sin licencia",
            "statement": "Todo asset gráfico o de audio incluye fuente y licencia en la trazabilidad.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ningún asset sin entrada de licencia"
            ],
            "links": [
              "entity:asset"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Niveles con meta",
            "statement": "Cada nivel define meta de avance y condición de victoria.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "La victoria otorga progreso guardado"
            ],
            "links": [
              "entity:nivel"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "permission",
            "title": "Perfil local sin cuenta",
            "statement": "El juego opera con un perfil local: sin roles ni permisos remotos, el progreso y los ajustes pertenecen al perfil del equipo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Jugar no requiere cuenta ni red"
            ],
            "links": [
              "entity:partida"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Juego compacto terminable",
            "summary": "El valor está en una experiencia corta y pulida, no en contenido infinito.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Motor y pipeline de assets",
            "summary": "El motor elegido define el pipeline de importación y el empaquetado.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Motor",
            "choice": "Godot 4",
            "rationale": "Pipeline 2D maduro y empaquetado sencillo para el equipo.",
            "alternatives": [
              "Unity",
              "Defold"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Persistencia",
            "choice": "SQLite local",
            "rationale": "Saves consultables y migrables sin servidor.",
            "alternatives": [
              "JSON plano",
              "Binario propietario"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Estado de una sesión de juego.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "vida",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "0..3"
                  ]
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "actualizado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "nivel_actual"
              ],
              "rules": []
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Definición de nivel u oleada.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "orden",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "1..10"
                  ]
                },
                {
                  "name": "escena",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "asset",
              "name": "asset",
              "description": "Recurso gráfico o de audio con licencia.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fuente",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "licencia",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "partida",
              "to": "nivel",
              "label": "progresa por"
            }
          ],
          "seed_data": [
            "Niveles u oleadas 1..5 con dificultad creciente"
          ],
          "migrations": [
            "v1: esquema inicial de save"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Bucle principal",
            "summary": "Actualiza simulación a paso fijo y dibuja interpolado.",
            "trigger": "Arranque de la escena de juego",
            "inputs": [
              "delta"
            ],
            "outputs": [
              "estado simulado"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "proceso",
                  "name": "Bucle principal",
                  "params": [
                    "delta"
                  ],
                  "body": [
                    {
                      "op": "definir",
                      "variable": "acumulador",
                      "data_type": "float",
                      "value": "0"
                    },
                    {
                      "op": "mientras",
                      "condition": "acumulador >= paso_fijo",
                      "body": [
                        {
                          "op": "llamar",
                          "process": "Paso de simulación",
                          "args": [
                            "paso_fijo"
                          ]
                        },
                        {
                          "op": "asignar",
                          "variable": "acumulador",
                          "expression": "acumulador - paso_fijo"
                        }
                      ]
                    },
                    {
                      "op": "asignar",
                      "variable": "estado_dibujo",
                      "expression": "interpolar(acumulador / paso_fijo)"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Delta mayor que 250 ms se recorta para evitar espirales"
            ],
            "rules": [],
            "links": [
              "requirement:FR-001"
            ]
          },
          {
            "id": "p-02",
            "name": "Paso de simulación",
            "summary": "Mueve entidades, resuelve colisiones y aplica daño.",
            "trigger": "Cada paso fijo",
            "inputs": [
              "paso"
            ],
            "outputs": [
              "posiciones",
              "vida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "para_cada",
                  "variable": "entidad",
                  "collection": "entidades_activas",
                  "body": [
                    {
                      "op": "llamar",
                      "process": "Mover y colisionar",
                      "args": [
                        "entidad",
                        "paso"
                      ]
                    },
                    {
                      "op": "si",
                      "condition": "entidad.colisiona_con_danio",
                      "then_body": [
                        {
                          "op": "si",
                          "condition": "entidad.invulnerable",
                          "then_body": [],
                          "else_body": [
                            {
                              "op": "asignar",
                              "variable": "entidad.vida",
                              "expression": "entidad.vida - 1"
                            },
                            {
                              "op": "asignar",
                              "variable": "entidad.invulnerable",
                              "expression": "true"
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "op": "si",
                  "condition": "jugador.vida <= 0",
                  "then_body": [
                    {
                      "op": "llamar",
                      "process": "Fin de partida",
                      "args": [
                        "derrota"
                      ]
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Colisión sin capa definida se registra y se ignora"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002",
              "requirement:FR-003"
            ]
          },
          {
            "id": "p-03",
            "name": "Guardar partida",
            "summary": "Serializa progreso y ajustes de forma atómica.",
            "trigger": "Menú de pausa o hito de progreso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "archivo de save"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "progreso y ajustes",
                  "into": "datos"
                },
                {
                  "op": "guardar",
                  "target": "archivo",
                  "value": "serializar(datos) en save.tmp"
                },
                {
                  "op": "si",
                  "condition": "escritura_ok",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "archivo",
                      "value": "renombrar(save.tmp, save.dat)"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se pudo guardar la partida",
                      "code": "SAVE_IO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "SAVE_IO: disco lleno o sin permisos"
            ],
            "rules": [],
            "links": [
              "requirement:FR-004",
              "entity:partida"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Capas del juego",
            "description": "Capas del juego",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "Escena y HUD",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Simulación",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "Save SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "input",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "progreso",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art limpio con UI de alto contraste",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD de juego 2D",
            "screen": "HUD y pausa",
            "notes": "Base del HUD y del menú de pausa"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes de audio y video",
            "notes": "Volumen, pantalla completa y mando"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Comportamientos componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Capas, máscaras y respuesta justa al contacto.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de simulación deterministas con seeds fijas más prueba de corte de guardado.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Simulación y colisiones",
              "tools": [
                "Framework de test del motor"
              ],
              "notes": "Seeds fijas"
            },
            {
              "kind": "functional",
              "scope": "Guardado y pausa",
              "tools": [
                "Prueba de corte de proceso"
              ],
              "notes": "Save atómico"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Paso fijo estable",
              "given": "Juego corriendo a 30 fps",
              "when": "Pasan 10 s",
              "then": "La simulación avanza el mismo tiempo que a 60 fps",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-003",
              "title": "Daño con invulnerabilidad",
              "given": "Jugador con 3 de vida",
              "when": "Recibe dos golpes en 200 ms",
              "then": "Vida queda en 2",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-004",
              "title": "Guardado atómico",
              "given": "Partida en curso",
              "when": "Se corta el proceso durante el guardado",
              "then": "El save anterior sigue intacto",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-005",
              "title": "Pausa sin pérdida",
              "given": "Partida en curso",
              "when": "Se pausa y se reanuda",
              "then": "Estado idéntico al pausar",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Meta de nivel",
              "given": "Nivel cargado",
              "when": "Se cumple la meta",
              "then": "Se otorga progreso y se guarda",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-002",
              "title": "Coyote time y buffer",
              "given": "Jugador al borde de una plataforma",
              "when": "Salta 60 ms después de caer",
              "then": "El salto se registra",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "RN-001",
              "title": "Dificultad acotada",
              "given": "Nivel u oleada final",
              "when": "Se consulta la curva",
              "then": "Dificultad nunca supera el máximo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Assets con licencia",
              "given": "Build empaquetado",
              "when": "Se revisa la trazabilidad",
              "then": "Todo asset tiene fuente y licencia",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-007",
              "title": "Juego sin cuenta",
              "given": "Equipo sin red",
              "when": "Se inicia partida",
              "then": "Perfil local opera completo",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios de aceptación en verde",
            "Sin assets sin licencia",
            "Empaquetado probado en plataforma destino"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Ejecutable del juego",
            "kind": "instalacion",
            "format": "zip por plataforma",
            "audience": "Jugador",
            "contents": [
              "Binario",
              "Assets con licencia",
              "LEEME"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño",
            "kind": "arquitectura",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "GDD",
              "Curva de dificultad"
            ]
          },
          {
            "id": "dl-03",
            "title": "Informe de pruebas",
            "kind": "tecnico",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "Casos",
              "Resultados por seed"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "El guardado es atómico con archivo temporal y renombrado.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "El pipeline de assets puede inflar el binario.",
            "status": "resolved",
            "resolution": "Mitigado: atlas y compresión por plataforma",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y física",
                    "Control y colisiones",
                    "Progreso y guardado"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-arcade",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Arcade 2D por oleadas",
      "name_en": "2D wave arcade",
      "summary_es": "Arcade de oleadas con dificultad acotada y progreso guardado.",
      "summary_en": "Wave arcade with bounded difficulty and saved progress.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-physics-collision",
        "game-save-systems"
      ],
      "pieces": [
        "sqlite-schema-migrations"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "mobile"
        ],
        "languages": [
          "C#"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art limpio con UI de alto contraste",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Arcade 2D por oleadas",
        "schema_version": 1,
        "identity": {
          "name": "Arcade 2D por oleadas",
          "description": "Los juegos 2D pequeños mueren por bucles inestables, colisiones injustas y saves corruptos.",
          "problem": "Los juegos 2D pequeños mueren por bucles inestables, colisiones injustas y saves corruptos.",
          "vision": "Un juego 2D compacto, justo y terminable, con progreso que nunca se pierde.",
          "goals": [
            "Bucle y física",
            "Control y colisiones"
          ],
          "specific_goals": [
            "60 fps estables en gama media",
            "Cero saves corruptos en prueba de corte",
            "Partida completa en menos de 2 h"
          ],
          "users": [
            "Jugador casual de escritorio o móvil",
            "Desarrollador solitario que mantiene el juego"
          ],
          "use_cases": [
            "Bucle de juego estable",
            "Control del jugador",
            "Colisiones y daño"
          ],
          "scope": [
            "Bucle y física",
            "Control y colisiones",
            "Progreso y guardado",
            "HUD y pausa"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "60 fps estables en gama media",
            "Cero saves corruptos en prueba de corte",
            "Partida completa en menos de 2 h"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego estable",
            "statement": "El juego mantiene un bucle de actualización y dibujo a paso fijo con interpolación.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El paso de física es independiente del framerate",
              "Pausar congela simulación y audio"
            ],
            "links": [
              "process:p-01"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Control del jugador",
            "statement": "El jugador se mueve, salta o esquiva con respuesta inmediata y coyote time.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Input buffering de 100 ms",
              "Coyote time de 80 ms en plataformas"
            ],
            "links": [
              "process:p-02",
              "entity:partida"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Colisiones y daño",
            "statement": "Las colisiones usan capas y máscaras; el daño respeta invulnerabilidad temporal.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ningún golpe atraviesa paredes",
              "Invulnerabilidad de 600 ms tras daño"
            ],
            "links": [
              "process:p-02",
              "entity:partida"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Progreso y guardado",
            "statement": "La partida guarda progreso y ajustes en un archivo local versionado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Guardar no corrompe partidas ante cierre abrupto",
              "Migración de saves entre versiones"
            ],
            "links": [
              "process:p-03",
              "entity:partida"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "HUD y pausa",
            "statement": "El HUD muestra vida, puntuación y objetivo; el menú de pausa permite salir sin perder progreso.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "HUD legible a 720p y 1080p",
              "Pausa accesible con un botón"
            ],
            "links": [
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Dificultad acotada",
            "statement": "La dificultad nunca supera el máximo configurado por nivel u oleada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Curva de dificultad monotónica por tramo"
            ],
            "links": [
              "entity:nivel"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Sin assets sin licencia",
            "statement": "Todo asset gráfico o de audio incluye fuente y licencia en la trazabilidad.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ningún asset sin entrada de licencia"
            ],
            "links": [
              "entity:asset"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Niveles con meta",
            "statement": "Cada oleada define enemigos y condición de superación.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "La victoria otorga progreso guardado"
            ],
            "links": [
              "entity:nivel"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "permission",
            "title": "Perfil local sin cuenta",
            "statement": "El juego opera con un perfil local: sin roles ni permisos remotos, el progreso y los ajustes pertenecen al perfil del equipo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Jugar no requiere cuenta ni red"
            ],
            "links": [
              "entity:partida"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Juego compacto terminable",
            "summary": "El valor está en una experiencia corta y pulida, no en contenido infinito.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Motor y pipeline de assets",
            "summary": "El motor elegido define el pipeline de importación y el empaquetado.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "mobile",
          "language": "C#",
          "framework": "Unity 2022 LTS",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Unity 2022 LTS"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Motor",
            "choice": "Unity 2022 LTS",
            "rationale": "Pipeline 2D maduro y empaquetado sencillo para el equipo.",
            "alternatives": [
              "Godot 4",
              "Defold"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Persistencia",
            "choice": "SQLite local",
            "rationale": "Saves consultables y migrables sin servidor.",
            "alternatives": [
              "JSON plano",
              "Binario propietario"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Estado de una sesión de juego.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "vida",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "0..3"
                  ]
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "actualizado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "nivel_actual"
              ],
              "rules": []
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Definición de nivel u oleada.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "orden",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "1..10"
                  ]
                },
                {
                  "name": "escena",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "asset",
              "name": "asset",
              "description": "Recurso gráfico o de audio con licencia.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fuente",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "licencia",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "partida",
              "to": "nivel",
              "label": "progresa por"
            }
          ],
          "seed_data": [
            "Niveles u oleadas 1..5 con dificultad creciente"
          ],
          "migrations": [
            "v1: esquema inicial de save"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Bucle principal",
            "summary": "Actualiza simulación a paso fijo y dibuja interpolado.",
            "trigger": "Arranque de la escena de juego",
            "inputs": [
              "delta"
            ],
            "outputs": [
              "estado simulado"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "proceso",
                  "name": "Bucle principal",
                  "params": [
                    "delta"
                  ],
                  "body": [
                    {
                      "op": "definir",
                      "variable": "acumulador",
                      "data_type": "float",
                      "value": "0"
                    },
                    {
                      "op": "mientras",
                      "condition": "acumulador >= paso_fijo",
                      "body": [
                        {
                          "op": "llamar",
                          "process": "Paso de simulación",
                          "args": [
                            "paso_fijo"
                          ]
                        },
                        {
                          "op": "asignar",
                          "variable": "acumulador",
                          "expression": "acumulador - paso_fijo"
                        }
                      ]
                    },
                    {
                      "op": "asignar",
                      "variable": "estado_dibujo",
                      "expression": "interpolar(acumulador / paso_fijo)"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Delta mayor que 250 ms se recorta para evitar espirales"
            ],
            "rules": [],
            "links": [
              "requirement:FR-001"
            ]
          },
          {
            "id": "p-02",
            "name": "Paso de simulación",
            "summary": "Mueve entidades, resuelve colisiones y aplica daño.",
            "trigger": "Cada paso fijo",
            "inputs": [
              "paso"
            ],
            "outputs": [
              "posiciones",
              "vida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "para_cada",
                  "variable": "entidad",
                  "collection": "entidades_activas",
                  "body": [
                    {
                      "op": "llamar",
                      "process": "Mover y colisionar",
                      "args": [
                        "entidad",
                        "paso"
                      ]
                    },
                    {
                      "op": "si",
                      "condition": "entidad.colisiona_con_danio",
                      "then_body": [
                        {
                          "op": "si",
                          "condition": "entidad.invulnerable",
                          "then_body": [],
                          "else_body": [
                            {
                              "op": "asignar",
                              "variable": "entidad.vida",
                              "expression": "entidad.vida - 1"
                            },
                            {
                              "op": "asignar",
                              "variable": "entidad.invulnerable",
                              "expression": "true"
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "op": "si",
                  "condition": "jugador.vida <= 0",
                  "then_body": [
                    {
                      "op": "llamar",
                      "process": "Fin de partida",
                      "args": [
                        "derrota"
                      ]
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Colisión sin capa definida se registra y se ignora"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002",
              "requirement:FR-003"
            ]
          },
          {
            "id": "p-03",
            "name": "Guardar partida",
            "summary": "Serializa progreso y ajustes de forma atómica.",
            "trigger": "Menú de pausa o hito de progreso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "archivo de save"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "progreso y ajustes",
                  "into": "datos"
                },
                {
                  "op": "guardar",
                  "target": "archivo",
                  "value": "serializar(datos) en save.tmp"
                },
                {
                  "op": "si",
                  "condition": "escritura_ok",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "archivo",
                      "value": "renombrar(save.tmp, save.dat)"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se pudo guardar la partida",
                      "code": "SAVE_IO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "SAVE_IO: disco lleno o sin permisos"
            ],
            "rules": [],
            "links": [
              "requirement:FR-004",
              "entity:partida"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Capas del juego",
            "description": "Capas del juego",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "Escena y HUD",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Simulación",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "Save SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "input",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "progreso",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art limpio con UI de alto contraste",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD de juego 2D",
            "screen": "HUD y pausa",
            "notes": "Base del HUD y del menú de pausa"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes de audio y video",
            "notes": "Volumen, pantalla completa y mando"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Comportamientos componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Capas, máscaras y respuesta justa al contacto.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de simulación deterministas con seeds fijas más prueba de corte de guardado.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Simulación y colisiones",
              "tools": [
                "Framework de test del motor"
              ],
              "notes": "Seeds fijas"
            },
            {
              "kind": "functional",
              "scope": "Guardado y pausa",
              "tools": [
                "Prueba de corte de proceso"
              ],
              "notes": "Save atómico"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Paso fijo estable",
              "given": "Juego corriendo a 30 fps",
              "when": "Pasan 10 s",
              "then": "La simulación avanza el mismo tiempo que a 60 fps",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-003",
              "title": "Daño con invulnerabilidad",
              "given": "Jugador con 3 de vida",
              "when": "Recibe dos golpes en 200 ms",
              "then": "Vida queda en 2",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-004",
              "title": "Guardado atómico",
              "given": "Partida en curso",
              "when": "Se corta el proceso durante el guardado",
              "then": "El save anterior sigue intacto",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-005",
              "title": "Pausa sin pérdida",
              "given": "Partida en curso",
              "when": "Se pausa y se reanuda",
              "then": "Estado idéntico al pausar",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Meta de nivel",
              "given": "Nivel cargado",
              "when": "Se cumple la meta",
              "then": "Se otorga progreso y se guarda",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-002",
              "title": "Coyote time y buffer",
              "given": "Jugador al borde de una plataforma",
              "when": "Salta 60 ms después de caer",
              "then": "El salto se registra",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "RN-001",
              "title": "Dificultad acotada",
              "given": "Nivel u oleada final",
              "when": "Se consulta la curva",
              "then": "Dificultad nunca supera el máximo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Assets con licencia",
              "given": "Build empaquetado",
              "when": "Se revisa la trazabilidad",
              "then": "Todo asset tiene fuente y licencia",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-007",
              "title": "Juego sin cuenta",
              "given": "Equipo sin red",
              "when": "Se inicia partida",
              "then": "Perfil local opera completo",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios de aceptación en verde",
            "Sin assets sin licencia",
            "Empaquetado probado en plataforma destino"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Ejecutable del juego",
            "kind": "instalacion",
            "format": "zip por plataforma",
            "audience": "Jugador",
            "contents": [
              "Binario",
              "Assets con licencia",
              "LEEME"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño",
            "kind": "arquitectura",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "GDD",
              "Curva de dificultad"
            ]
          },
          {
            "id": "dl-03",
            "title": "Informe de pruebas",
            "kind": "tecnico",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "Casos",
              "Resultados por seed"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "El guardado es atómico con archivo temporal y renombrado.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "El pipeline de assets puede inflar el binario.",
            "status": "resolved",
            "resolution": "Mitigado: atlas y compresión por plataforma",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y física",
                    "Control y colisiones",
                    "Progreso y guardado"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "web-pwa-flutter",
      "types": [
        "web",
        "pwa"
      ],
      "name_es": "PWA Flutter de reservas",
      "name_en": "Flutter booking PWA",
      "summary_es": "Web instalable de reservas con cupos sin sobreventa y recordatorios.",
      "summary_en": "Installable booking web with oversell-free slots and reminders.",
      "expert_id": "dart-falcon",
      "skills": [
        "flutter-architecture",
        "state-management",
        "responsive-design",
        "accessibility-wcag"
      ],
      "pieces": [
        "flutter-feature-first",
        "flutter-repository-pattern",
        "flutter-http-client",
        "i18n-arb-flutter"
      ],
      "mockups": [
        "m-booking-reminder",
        "m-admin-crud",
        "m-settings-center"
      ],
      "resources": [
        "lucide",
        "undraw",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "Dart"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "web",
          "pwa"
        ],
        "non_goals": [
          "Pasarela de pagos",
          "App nativa en tiendas",
          "Multi-idioma más de dos idiomas"
        ],
        "visual_style": "Limpio y denso en datos, con acentos turquesa",
        "asset_sources": [
          "unDraw",
          "Google Fonts"
        ],
        "mockup": "m-booking-reminder"
      },
      "document": {
        "name": "PWA Flutter de reservas",
        "schema_version": 1,
        "identity": {
          "name": "PWA Flutter de reservas",
          "description": "Los negocios pequeños pierden citas y pedidos por agendas manuales y sobreventa.",
          "problem": "Los negocios pequeños pierden citas y pedidos por agendas manuales y sobreventa.",
          "vision": "Una web instalable donde el cliente reserva solo y el operador controla cupos sin sobresaltos.",
          "goals": [
            "Catálogo",
            "Reservas o pedidos"
          ],
          "specific_goals": [
            "Cero sobreventas en prueba de concurrencia",
            "Confirmación en menos de 2 s",
            "Recordatorios entregados al 95%"
          ],
          "users": [
            "Cliente final desde móvil",
            "Operador del negocio",
            "Administrador de precios y cupos"
          ],
          "use_cases": [
            "Catálogo consultable",
            "Reserva o pedido",
            "Recordatorios"
          ],
          "scope": [
            "Catálogo",
            "Reservas o pedidos",
            "Recordatorios",
            "Panel de operación"
          ],
          "out_of_scope": [
            "Pasarela de pagos",
            "App nativa en tiendas",
            "Multi-idioma más de dos idiomas"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero sobreventas en prueba de concurrencia",
            "Confirmación en menos de 2 s",
            "Recordatorios entregados al 95%"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Catálogo consultable",
            "statement": "El catálogo lista servicios o productos con búsqueda y filtros.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Búsqueda responde en menos de 300 ms con 1000 registros"
            ],
            "links": [
              "process:p-01",
              "entity:catalogo"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Reserva o pedido",
            "statement": "El cliente crea una reserva o pedido con confirmación visible.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se confirman dos reservas del mismo cupo",
              "Confirmación muestra resumen y código"
            ],
            "links": [
              "process:p-02",
              "entity:reserva"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Recordatorios",
            "statement": "El sistema envía recordatorio antes de la cita o entrega.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Recordatorio 24 h antes",
              "Reintento único si falla el envío"
            ],
            "links": [
              "process:p-03"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "permission",
            "title": "Roles y acceso",
            "statement": "Cliente, operador y administrador ven solo lo que les corresponde.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cliente no ve datos de otros clientes",
              "Operador no cambia precios"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Panel de operación",
            "statement": "El operador gestiona cupos, estados y cancelaciones desde un panel.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cambio de estado queda auditado"
            ],
            "links": [
              "mockup:m-admin-crud",
              "entity:reserva"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Cupos sin sobreventa",
            "statement": "Un cupo nunca se confirma por encima de su capacidad.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Prueba de concurrencia con 20 solicitudes simultáneas"
            ],
            "links": [
              "entity:reserva"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Precios con histórico",
            "statement": "Todo cambio de precio conserva el valor anterior y su fecha.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Histórico consultable por registro"
            ],
            "links": [
              "entity:catalogo"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "non_functional",
            "title": "Instalable y offline parcial",
            "statement": "La app se instala como PWA y muestra el catálogo cacheado sin conexión.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Catálogo visible sin conexión"
            ],
            "links": [
              "entity:catalogo"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Negocio de citas o pedidos",
            "summary": "El cupo es el recurso escaso; todo gira alrededor de él.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Web instalable",
            "summary": "La PWA o web cacheable reduce fricción de instalación y datos móviles.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "Dart",
          "framework": "Flutter web",
          "style": "Feature-first con repositorios",
          "database": "PostgreSQL",
          "data_access": "Repositorio tipado",
          "api_style": "REST JSON",
          "auth": "Sesión con token y roles",
          "infrastructure": "Estáticos + API",
          "hosting": "VPS con HTTPS",
          "external_services": [],
          "dependencies": [
            "Flutter web",
            "PostgreSQL"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "despliegue por contenedor"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Frontend",
            "choice": "Flutter web",
            "rationale": "Un solo código para web instalable y mantenimiento simple.",
            "alternatives": [
              "React",
              "Vue"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Concurrencia de cupos",
            "choice": "Transacción con bloqueo de fila",
            "rationale": "Evita sobreventa sin servicios externos.",
            "alternatives": [
              "Cola externa",
              "Optimista con reintento"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "catalogo",
              "name": "catalogo",
              "description": "Servicio o producto publicable.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "publicado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "actualizado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "publicado"
              ],
              "rules": []
            },
            {
              "id": "reserva",
              "name": "reserva",
              "description": "Reserva o pedido de un cliente.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "catalogo_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "catalogo.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "pendiente",
                    "confirmada",
                    "cancelada"
                  ]
                },
                {
                  "name": "inicia_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "inicia_en",
                "estado"
              ],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Persona con rol en el sistema.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "cliente",
                    "operador",
                    "admin"
                  ]
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "catalogo",
              "to": "reserva",
              "label": "recibe"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "reserva",
              "label": "crea"
            }
          ],
          "seed_data": [
            "Catálogo de ejemplo con 12 registros",
            "Usuario administrador inicial"
          ],
          "migrations": [
            "v1: catálogo, reservas y usuarios"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Consultar catálogo",
            "summary": "Busca y filtra el catálogo publicado.",
            "trigger": "Búsqueda o filtro del cliente",
            "inputs": [
              "consulta"
            ],
            "outputs": [
              "lista de registros"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "consulta",
                  "source": "cliente"
                },
                {
                  "op": "consultar",
                  "target": "catalogo",
                  "query": "publicado y coincide(consulta)",
                  "into": "resultados"
                },
                {
                  "op": "devolver",
                  "value": "resultados"
                }
              ]
            },
            "errors": [],
            "rules": [],
            "links": [
              "requirement:FR-001",
              "entity:catalogo"
            ]
          },
          {
            "id": "p-02",
            "name": "Crear reserva",
            "summary": "Valida cupo y confirma la reserva de forma transaccional.",
            "trigger": "Confirmación del cliente",
            "inputs": [
              "cupo",
              "cliente"
            ],
            "outputs": [
              "reserva confirmada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "reserva",
                  "query": "capacidad del cupo - confirmadas",
                  "into": "disponible"
                },
                {
                  "op": "si",
                  "condition": "disponible > 0",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "reserva",
                      "value": "estado=confirmada"
                    },
                    {
                      "op": "llamar",
                      "process": "Notificar confirmación",
                      "args": [
                        "reserva"
                      ]
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Cupo agotado",
                      "code": "CUPO_LLENO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "CUPO_LLENO: sin capacidad"
            ],
            "rules": [
              "Transacción única para validar y confirmar"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:RN-001",
              "entity:reserva"
            ]
          },
          {
            "id": "p-03",
            "name": "Enviar recordatorio",
            "summary": "Envía el recordatorio programado con reintento único.",
            "trigger": "Programador 24 h antes",
            "inputs": [
              "reserva"
            ],
            "outputs": [
              "notificación"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "reserva",
                  "query": "confirmada y inicia_en_24h",
                  "into": "pendientes"
                },
                {
                  "op": "para_cada",
                  "variable": "r",
                  "collection": "pendientes",
                  "body": [
                    {
                      "op": "si",
                      "condition": "envio_ok(r)",
                      "then_body": [
                        {
                          "op": "guardar",
                          "target": "reserva",
                          "value": "recordatorio=enviado"
                        }
                      ],
                      "else_body": [
                        {
                          "op": "guardar",
                          "target": "reserva",
                          "value": "recordatorio=reintento"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Envío fallido se reintenta una vez"
            ],
            "rules": [],
            "links": [
              "requirement:FR-003"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "architecture",
            "title": "Capas de la web",
            "description": "Capas de la web",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "UI web",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "API y dominio",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "REST",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "consultas",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Limpio y denso en datos, con acentos turquesa",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Inter o Roboto para UI",
            "Monospace para códigos"
          ],
          "components": [
            "Tarjetas de catálogo",
            "Tabla de operación con filtros"
          ],
          "navigation": "Navegación superior con tres áreas: catálogo, mis reservas, panel",
          "responsive_notes": "Tablas con scroll horizontal en móvil; tarjetas apiladas",
          "asset_sources": [
            "unDraw",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-booking-reminder",
            "name": "Reservas y recordatorios",
            "screen": "Reserva del cliente",
            "notes": "Flujo de reserva y recordatorio"
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Administración general",
            "screen": "Panel de operación",
            "notes": "Cupos, estados y cancelaciones"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes del negocio",
            "notes": "Horarios y políticas"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "flutter-architecture",
            "name": "Arquitectura Flutter",
            "purpose": "Features aisladas, testeables y sin fugas de UI.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "state-management",
            "name": "Gestión de estado",
            "purpose": "Estado predecible y reconstruible tras rotación o muerte.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "responsive-design",
            "name": "Diseño responsivo",
            "purpose": "Una base de código legible en móvil, tableta y escritorio.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "accessibility-wcag",
            "name": "Accesibilidad WCAG",
            "purpose": "Contraste, foco y lectores de pantalla desde el inicio.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de concurrencia sobre cupos más funcionales de reserva y roles.",
          "levels": [
            {
              "kind": "integration",
              "scope": "API y base de datos",
              "tools": [
                "Suite del framework"
              ],
              "notes": "Transacciones reales"
            },
            {
              "kind": "functional",
              "scope": "Reserva y recordatorios",
              "tools": [
                "Navegador automatizado"
              ],
              "notes": "Flujo completo"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Búsqueda rápida",
              "given": "Catálogo con 1000 registros",
              "when": "Se busca un término",
              "then": "Resultados en menos de 300 ms",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "RN-001",
              "title": "Sin sobreventa",
              "given": "Cupo con 1 lugar",
              "when": "20 solicitudes simultáneas",
              "then": "Exactamente 1 confirmada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-002",
              "title": "Confirmación con resumen",
              "given": "Cupo disponible",
              "when": "Se confirma",
              "then": "Resumen y código visibles",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Aislamiento por rol",
              "given": "Sesión de cliente",
              "when": "Intenta ver otra reserva",
              "then": "Acceso denegado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Catálogo sin conexión",
              "given": "PWA instalada",
              "when": "Se corta la red",
              "then": "Catálogo cacheado visible",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-003",
              "title": "Recordatorio puntual",
              "given": "Reserva confirmada para mañana",
              "when": "Llega la hora del recordatorio",
              "then": "Notificación enviada con reintento único",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Cambio auditado",
              "given": "Sesión de operador",
              "when": "Cambia estado de una reserva",
              "then": "Auditoría con usuario y fecha",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Histórico de precios",
              "given": "Precio editado",
              "when": "Se consulta el histórico",
              "then": "Valor anterior y fecha visibles",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Prueba de concurrencia documentada",
            "Lighthouse accesibilidad mayor a 90"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Web desplegable",
            "kind": "despliegue",
            "format": "contenedor o estáticos",
            "audience": "Operador",
            "contents": [
              "Build",
              "Migraciones",
              "Guía de despliegue"
            ]
          },
          {
            "id": "dl-02",
            "title": "Contrato de API",
            "kind": "api",
            "format": "openapi",
            "audience": "Desarrollador",
            "contents": [
              "Esquemas",
              "Ejemplos"
            ]
          },
          {
            "id": "dl-03",
            "title": "Manual del operador",
            "kind": "usuario",
            "format": "markdown",
            "audience": "Operador",
            "contents": [
              "Cupos",
              "Estados",
              "Cancelaciones"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "La sobreventa se evita con transacción y bloqueo de fila.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "Los recordatorios dependen del proveedor de envío.",
            "status": "resolved",
            "resolution": "Mitigado: reintento único y estado visible",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Catálogo",
                    "Reservas o pedidos",
                    "Recordatorios"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-db",
          "question_es": "¿Base de datos del servicio?",
          "question_en": "Service database?",
          "options": [
            {
              "id": "pg",
              "label_es": "PostgreSQL",
              "label_en": "PostgreSQL",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "PostgreSQL"
                }
              ]
            },
            {
              "id": "sqlite",
              "label_es": "SQLite (un solo equipo)",
              "label_en": "SQLite (single machine)",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "SQLite"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "web-php-catalogo",
      "types": [
        "web"
      ],
      "name_es": "Web PHP de catálogo y pedidos",
      "name_en": "PHP catalog & orders web",
      "summary_es": "Web clásica de catálogo y pedidos con panel de operación y roles.",
      "summary_en": "Classic catalog and orders web with an operations panel and roles.",
      "expert_id": "pedro-laravel",
      "skills": [
        "rest-api-design",
        "owasp-top-10",
        "authentication-authorization",
        "caching-strategies"
      ],
      "pieces": [
        "docker-compose-postgres-redis",
        "github-actions-ci-node",
        "openapi-contract-base"
      ],
      "mockups": [
        "m-booking-reminder",
        "m-admin-crud",
        "m-settings-center"
      ],
      "resources": [
        "heroicons",
        "undraw",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "PHP"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "web"
        ],
        "non_goals": [
          "Pasarela de pagos",
          "App nativa en tiendas",
          "Multi-idioma más de dos idiomas"
        ],
        "visual_style": "Limpio y denso en datos, con acentos turquesa",
        "asset_sources": [
          "unDraw",
          "Google Fonts"
        ],
        "mockup": "m-booking-reminder"
      },
      "document": {
        "name": "Web PHP de catálogo y pedidos",
        "schema_version": 1,
        "identity": {
          "name": "Web PHP de catálogo y pedidos",
          "description": "Los negocios pequeños pierden citas y pedidos por agendas manuales y sobreventa.",
          "problem": "Los negocios pequeños pierden citas y pedidos por agendas manuales y sobreventa.",
          "vision": "Una web instalable donde el cliente reserva solo y el operador controla cupos sin sobresaltos.",
          "goals": [
            "Catálogo",
            "Reservas o pedidos"
          ],
          "specific_goals": [
            "Cero sobreventas en prueba de concurrencia",
            "Confirmación en menos de 2 s",
            "Recordatorios entregados al 95%"
          ],
          "users": [
            "Cliente final desde móvil",
            "Operador del negocio",
            "Administrador de precios y cupos"
          ],
          "use_cases": [
            "Catálogo consultable",
            "Reserva o pedido",
            "Recordatorios"
          ],
          "scope": [
            "Catálogo",
            "Reservas o pedidos",
            "Recordatorios",
            "Panel de operación"
          ],
          "out_of_scope": [
            "Pasarela de pagos",
            "App nativa en tiendas",
            "Multi-idioma más de dos idiomas"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero sobreventas en prueba de concurrencia",
            "Confirmación en menos de 2 s",
            "Recordatorios entregados al 95%"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Catálogo consultable",
            "statement": "El catálogo lista servicios o productos con búsqueda y filtros.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Búsqueda responde en menos de 300 ms con 1000 registros"
            ],
            "links": [
              "process:p-01",
              "entity:catalogo"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Reserva o pedido",
            "statement": "El cliente crea una reserva o pedido con confirmación visible.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se confirman dos reservas del mismo cupo",
              "Confirmación muestra resumen y código"
            ],
            "links": [
              "process:p-02",
              "entity:reserva"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Recordatorios",
            "statement": "El sistema envía recordatorio antes de la cita o entrega.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Recordatorio 24 h antes",
              "Reintento único si falla el envío"
            ],
            "links": [
              "process:p-03"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "permission",
            "title": "Roles y acceso",
            "statement": "Cliente, operador y administrador ven solo lo que les corresponde.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cliente no ve datos de otros clientes",
              "Operador no cambia precios"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Panel de operación",
            "statement": "El operador gestiona cupos, estados y cancelaciones desde un panel.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cambio de estado queda auditado"
            ],
            "links": [
              "mockup:m-admin-crud",
              "entity:reserva"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Cupos sin sobreventa",
            "statement": "Un cupo nunca se confirma por encima de su capacidad.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Prueba de concurrencia con 20 solicitudes simultáneas"
            ],
            "links": [
              "entity:reserva"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Precios con histórico",
            "statement": "Todo cambio de precio conserva el valor anterior y su fecha.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Histórico consultable por registro"
            ],
            "links": [
              "entity:catalogo"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "non_functional",
            "title": "Instalable y offline parcial",
            "statement": "La web sirve HTML cacheable y funciona sin JavaScript para el catálogo.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Catálogo legible sin JavaScript"
            ],
            "links": [
              "entity:catalogo"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Negocio de citas o pedidos",
            "summary": "El cupo es el recurso escaso; todo gira alrededor de él.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Web instalable",
            "summary": "La PWA o web cacheable reduce fricción de instalación y datos móviles.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "PHP",
          "framework": "Laravel 11",
          "style": "MVC con servicios de dominio",
          "database": "PostgreSQL",
          "data_access": "Eloquent con consultas explícitas",
          "api_style": "REST JSON",
          "auth": "Sesión con token y roles",
          "infrastructure": "Contenedor único",
          "hosting": "VPS con HTTPS",
          "external_services": [],
          "dependencies": [
            "Laravel 11",
            "PostgreSQL"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "despliegue por contenedor"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Frontend",
            "choice": "Laravel 11",
            "rationale": "PHP maduro con hosting barato y ecosistema de paquetes.",
            "alternatives": [
              "Symfony",
              "Vue"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Concurrencia de cupos",
            "choice": "Transacción con bloqueo de fila",
            "rationale": "Evita sobreventa sin servicios externos.",
            "alternatives": [
              "Cola externa",
              "Optimista con reintento"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "catalogo",
              "name": "catalogo",
              "description": "Servicio o producto publicable.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "publicado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "actualizado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "publicado"
              ],
              "rules": []
            },
            {
              "id": "reserva",
              "name": "reserva",
              "description": "Reserva o pedido de un cliente.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "catalogo_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "catalogo.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "pendiente",
                    "confirmada",
                    "cancelada"
                  ]
                },
                {
                  "name": "inicia_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "inicia_en",
                "estado"
              ],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Persona con rol en el sistema.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "cliente",
                    "operador",
                    "admin"
                  ]
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "catalogo",
              "to": "reserva",
              "label": "recibe"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "reserva",
              "label": "crea"
            }
          ],
          "seed_data": [
            "Catálogo de ejemplo con 12 registros",
            "Usuario administrador inicial"
          ],
          "migrations": [
            "v1: catálogo, reservas y usuarios"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Consultar catálogo",
            "summary": "Busca y filtra el catálogo publicado.",
            "trigger": "Búsqueda o filtro del cliente",
            "inputs": [
              "consulta"
            ],
            "outputs": [
              "lista de registros"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "consulta",
                  "source": "cliente"
                },
                {
                  "op": "consultar",
                  "target": "catalogo",
                  "query": "publicado y coincide(consulta)",
                  "into": "resultados"
                },
                {
                  "op": "devolver",
                  "value": "resultados"
                }
              ]
            },
            "errors": [],
            "rules": [],
            "links": [
              "requirement:FR-001",
              "entity:catalogo"
            ]
          },
          {
            "id": "p-02",
            "name": "Crear reserva",
            "summary": "Valida cupo y confirma la reserva de forma transaccional.",
            "trigger": "Confirmación del cliente",
            "inputs": [
              "cupo",
              "cliente"
            ],
            "outputs": [
              "reserva confirmada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "reserva",
                  "query": "capacidad del cupo - confirmadas",
                  "into": "disponible"
                },
                {
                  "op": "si",
                  "condition": "disponible > 0",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "reserva",
                      "value": "estado=confirmada"
                    },
                    {
                      "op": "llamar",
                      "process": "Notificar confirmación",
                      "args": [
                        "reserva"
                      ]
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Cupo agotado",
                      "code": "CUPO_LLENO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "CUPO_LLENO: sin capacidad"
            ],
            "rules": [
              "Transacción única para validar y confirmar"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:RN-001",
              "entity:reserva"
            ]
          },
          {
            "id": "p-03",
            "name": "Enviar recordatorio",
            "summary": "Envía el recordatorio programado con reintento único.",
            "trigger": "Programador 24 h antes",
            "inputs": [
              "reserva"
            ],
            "outputs": [
              "notificación"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "reserva",
                  "query": "confirmada y inicia_en_24h",
                  "into": "pendientes"
                },
                {
                  "op": "para_cada",
                  "variable": "r",
                  "collection": "pendientes",
                  "body": [
                    {
                      "op": "si",
                      "condition": "envio_ok(r)",
                      "then_body": [
                        {
                          "op": "guardar",
                          "target": "reserva",
                          "value": "recordatorio=enviado"
                        }
                      ],
                      "else_body": [
                        {
                          "op": "guardar",
                          "target": "reserva",
                          "value": "recordatorio=reintento"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Envío fallido se reintenta una vez"
            ],
            "rules": [],
            "links": [
              "requirement:FR-003"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "architecture",
            "title": "Capas de la web",
            "description": "Capas de la web",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "UI web",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "API y dominio",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "REST",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "consultas",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Limpio y denso en datos, con acentos turquesa",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Inter o Roboto para UI",
            "Monospace para códigos"
          ],
          "components": [
            "Tarjetas de catálogo",
            "Tabla de operación con filtros"
          ],
          "navigation": "Navegación superior con tres áreas: catálogo, mis reservas, panel",
          "responsive_notes": "Tablas con scroll horizontal en móvil; tarjetas apiladas",
          "asset_sources": [
            "unDraw",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-booking-reminder",
            "name": "Reservas y recordatorios",
            "screen": "Reserva del cliente",
            "notes": "Flujo de reserva y recordatorio"
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Administración general",
            "screen": "Panel de operación",
            "notes": "Cupos, estados y cancelaciones"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes del negocio",
            "notes": "Horarios y políticas"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "rest-api-design",
            "name": "Diseño de API REST",
            "purpose": "Recursos, códigos y paginación estables para consumidores.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "owasp-top-10",
            "name": "OWASP Top 10",
            "purpose": "Superficie de ataque revisada antes de publicar.",
            "when": "seguridad"
          },
          {
            "id": "sk-03",
            "skill_id": "authentication-authorization",
            "name": "Autenticación y autorización",
            "purpose": "Sesiones y roles verificables en cada entrada.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "caching-strategies",
            "name": "Estrategias de caché",
            "purpose": "Invalidación explícita para no servir datos viejos.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de concurrencia sobre cupos más funcionales de reserva y roles.",
          "levels": [
            {
              "kind": "integration",
              "scope": "API y base de datos",
              "tools": [
                "Suite del framework"
              ],
              "notes": "Transacciones reales"
            },
            {
              "kind": "functional",
              "scope": "Reserva y recordatorios",
              "tools": [
                "Navegador automatizado"
              ],
              "notes": "Flujo completo"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Búsqueda rápida",
              "given": "Catálogo con 1000 registros",
              "when": "Se busca un término",
              "then": "Resultados en menos de 300 ms",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "RN-001",
              "title": "Sin sobreventa",
              "given": "Cupo con 1 lugar",
              "when": "20 solicitudes simultáneas",
              "then": "Exactamente 1 confirmada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-002",
              "title": "Confirmación con resumen",
              "given": "Cupo disponible",
              "when": "Se confirma",
              "then": "Resumen y código visibles",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Aislamiento por rol",
              "given": "Sesión de cliente",
              "when": "Intenta ver otra reserva",
              "then": "Acceso denegado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Catálogo sin conexión",
              "given": "Navegador sin JavaScript",
              "when": "Se corta la red",
              "then": "Catálogo cacheado visible",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-003",
              "title": "Recordatorio puntual",
              "given": "Reserva confirmada para mañana",
              "when": "Llega la hora del recordatorio",
              "then": "Notificación enviada con reintento único",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Cambio auditado",
              "given": "Sesión de operador",
              "when": "Cambia estado de una reserva",
              "then": "Auditoría con usuario y fecha",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Histórico de precios",
              "given": "Precio editado",
              "when": "Se consulta el histórico",
              "then": "Valor anterior y fecha visibles",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Prueba de concurrencia documentada",
            "Lighthouse accesibilidad mayor a 90"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Web desplegable",
            "kind": "despliegue",
            "format": "contenedor o estáticos",
            "audience": "Operador",
            "contents": [
              "Build",
              "Migraciones",
              "Guía de despliegue"
            ]
          },
          {
            "id": "dl-02",
            "title": "Contrato de API",
            "kind": "api",
            "format": "openapi",
            "audience": "Desarrollador",
            "contents": [
              "Esquemas",
              "Ejemplos"
            ]
          },
          {
            "id": "dl-03",
            "title": "Manual del operador",
            "kind": "usuario",
            "format": "markdown",
            "audience": "Operador",
            "contents": [
              "Cupos",
              "Estados",
              "Cancelaciones"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "La sobreventa se evita con transacción y bloqueo de fila.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "Los recordatorios dependen del proveedor de envío.",
            "status": "resolved",
            "resolution": "Mitigado: reintento único y estado visible",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Catálogo",
                    "Reservas o pedidos",
                    "Recordatorios"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-db",
          "question_es": "¿Base de datos del servicio?",
          "question_en": "Service database?",
          "options": [
            {
              "id": "pg",
              "label_es": "PostgreSQL",
              "label_en": "PostgreSQL",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "PostgreSQL"
                }
              ]
            },
            {
              "id": "sqlite",
              "label_es": "SQLite (un solo equipo)",
              "label_en": "SQLite (single machine)",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "SQLite"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "mobile-offline",
      "types": [
        "móvil"
      ],
      "name_es": "Móvil offline-first de agenda",
      "name_en": "Offline-first agenda mobile",
      "summary_es": "Agenda móvil que opera sin red con copia durable y recordatorios del sistema.",
      "summary_en": "Mobile agenda that works offline with durable copies and system reminders.",
      "expert_id": "dart-falcon",
      "skills": [
        "flutter-architecture",
        "state-management",
        "responsive-design",
        "accessibility-wcag"
      ],
      "pieces": [
        "flutter-feature-first",
        "flutter-repository-pattern",
        "sqlite-schema-migrations",
        "i18n-arb-flutter"
      ],
      "mockups": [
        "m-booking-reminder",
        "m-chat-support",
        "m-settings-center"
      ],
      "resources": [
        "lucide",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "mobile"
        ],
        "languages": [
          "Dart"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "móvil"
        ],
        "non_goals": [
          "Versión de escritorio",
          "Compartir agenda entre usuarios",
          "Widgets del sistema"
        ],
        "visual_style": "Cálido y legible en exterior",
        "asset_sources": [
          "Lucide Icons",
          "Google Fonts"
        ],
        "mockup": "m-booking-reminder"
      },
      "document": {
        "name": "Móvil offline-first de agenda",
        "schema_version": 1,
        "identity": {
          "name": "Móvil offline-first de agenda",
          "description": "Las agendas móviles pierden datos sin conexión y olvidan recordatorios al cerrar la app.",
          "problem": "Las agendas móviles pierden datos sin conexión y olvidan recordatorios al cerrar la app.",
          "vision": "Una agenda móvil que funciona siempre, con o sin red, y recuerda a tiempo.",
          "goals": [
            "Agenda y recordatorios",
            "Copia o sincronización"
          ],
          "specific_goals": [
            "Cero pérdidas en prueba de avión",
            "Arranque en frío menor a 2 s",
            "Recordatorios puntuales al 99%"
          ],
          "users": [
            "Usuario final en móvil",
            "Soporte del producto"
          ],
          "use_cases": [
            "Agenda personal",
            "Recordatorios locales",
            "Copia local durable"
          ],
          "scope": [
            "Agenda y recordatorios",
            "Copia o sincronización",
            "Soporte en app",
            "Ajustes versionados"
          ],
          "out_of_scope": [
            "Versión de escritorio",
            "Compartir agenda entre usuarios",
            "Widgets del sistema"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero pérdidas en prueba de avión",
            "Arranque en frío menor a 2 s",
            "Recordatorios puntuales al 99%"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Agenda personal",
            "statement": "El usuario crea, edita y completa entradas de agenda con recordatorio.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Edición sin pérdida al cambiar de pantalla"
            ],
            "links": [
              "process:p-01",
              "entity:entrada"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Recordatorios locales",
            "statement": "Los recordatorios se disparan aunque la app esté cerrada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Notificación a la hora exacta ±1 min"
            ],
            "links": [
              "process:p-02"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Copia local durable",
            "statement": "Toda la agenda vive en SQLite local y sobrevive a reinstalaciones con copia.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Sin pérdida de cambios offline"
            ],
            "links": [
              "process:p-03",
              "entity:entrada"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Soporte en la app",
            "statement": "El usuario consulta dudas frecuentes y abre chat de soporte.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Chat disponible sin salir de la app"
            ],
            "links": [
              "mockup:m-chat-support"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "permission",
            "title": "Datos solo del usuario",
            "statement": "Cada usuario accede únicamente a sus entradas y ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Sesión caducada pide reingreso"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Sin borrado silencioso",
            "statement": "Borrar una entrada pide confirmación y ofrece deshacer 10 s.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Deshacer restaura la entrada completa"
            ],
            "links": [
              "entity:entrada"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Ajustes versionados",
            "statement": "Los ajustes guardan esquema versionado para migrar entre versiones.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Migración sin resetear ajustes"
            ],
            "links": [
              "entity:ajuste"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "non_functional",
            "title": "Arranque en frío rápido",
            "statement": "La app abre la agenda en menos de 2 s en gama media.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Medición en dispositivo de gama media"
            ],
            "links": []
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Uso con conectividad irregular",
            "summary": "El modo avión es un estado normal, no un error.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Notificaciones del sistema",
            "summary": "El sistema operativo es el único reloj confiable con app cerrada.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "mobile",
          "language": "Dart",
          "framework": "Flutter",
          "style": "Feature-first con repositorios",
          "database": "SQLite local",
          "data_access": "Repositorio con fuente local y remota",
          "api_style": "ninguna",
          "auth": "Token por dispositivo",
          "infrastructure": "Dispositivo",
          "hosting": "Tiendas móviles",
          "external_services": [],
          "dependencies": [
            "Flutter",
            "SQLite"
          ],
          "environments": [
            "desarrollo",
            "tiendas"
          ],
          "deploy_strategy": "publicación por tienda"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Persistencia",
            "choice": "SQLite local primero",
            "rationale": "La app nunca depende de la red para operar.",
            "alternatives": [
              "Solo remoto",
              "Hive"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Reloj de recordatorios",
            "choice": "Notificaciones del sistema",
            "rationale": "Funcionan con la app cerrada sin servicios propios.",
            "alternatives": [
              "Alarmas propias en background"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "entrada",
              "name": "entrada",
              "description": "Entrada de agenda del usuario.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "titulo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "recordatorio_en",
                  "data_type": "timestamp",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "activa",
                    "completada",
                    "borrada"
                  ]
                },
                {
                  "name": "pendiente_sync",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "recordatorio_en"
              ],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Dueño de la agenda.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "creado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencias versionadas de la app.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "esquema",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "entrada",
              "label": "posee"
            },
            {
              "id": "rel-02",
              "kind": "one_to_one",
              "from": "usuario",
              "to": "ajuste",
              "label": "configura"
            }
          ],
          "seed_data": [
            "Ajustes por defecto esquema 1"
          ],
          "migrations": [
            "v1: entradas, usuarios y ajustes"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Guardar entrada",
            "summary": "Valida y persiste la entrada en local.",
            "trigger": "Confirmación del formulario",
            "inputs": [
              "entrada"
            ],
            "outputs": [
              "entrada guardada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "entrada",
                  "source": "formulario"
                },
                {
                  "op": "si",
                  "condition": "entrada.titulo_vacio",
                  "then_body": [
                    {
                      "op": "generar_error",
                      "message": "Título obligatorio",
                      "code": "TITULO_VACIO"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "entrada",
                      "value": "estado=activa"
                    },
                    {
                      "op": "llamar",
                      "process": "Programar recordatorio",
                      "args": [
                        "entrada"
                      ]
                    }
                  ]
                }
              ]
            },
            "errors": [
              "TITULO_VACIO"
            ],
            "rules": [],
            "links": [
              "requirement:FR-001",
              "entity:entrada"
            ]
          },
          {
            "id": "p-02",
            "name": "Programar recordatorio",
            "summary": "Registra la notificación local en el sistema.",
            "trigger": "Entrada con recordatorio",
            "inputs": [
              "entrada"
            ],
            "outputs": [
              "notificación programada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "entrada",
                  "query": "recordatorio_en",
                  "into": "cuando"
                },
                {
                  "op": "guardar",
                  "target": "almacen",
                  "value": "notificacion_local programada(cuando, entrada.id)"
                }
              ]
            },
            "errors": [
              "Permiso de notificaciones denegado se avisa en UI"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002"
            ]
          },
          {
            "id": "p-03",
            "name": "Respaldar copia local",
            "summary": "Exporta copia durable de la base local.",
            "trigger": "Menú de ajustes",
            "inputs": [
              "cambios"
            ],
            "outputs": [
              "archivo de copia"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "entrada",
                  "query": "todas",
                  "into": "lote"
                },
                {
                  "op": "si",
                  "condition": "lote_vacio",
                  "then_body": [
                    {
                      "op": "finalizar"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "archivo",
                      "value": "lote"
                    },
                    {
                      "op": "guardar",
                      "target": "entrada",
                      "value": "respaldada=true"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Red caída deja el lote pendiente"
            ],
            "rules": [],
            "links": [
              "requirement:FR-003",
              "entity:entrada"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Capas de la móvil",
            "description": "Capas de la móvil",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "UI Flutter",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Repositorios",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "estado",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "lectura y escritura",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Cálido y legible en exterior",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Roboto para UI",
            "Tamaños mínimos de 14 px"
          ],
          "components": [
            "Tarjetas de agenda",
            "Confirmación con deshacer"
          ],
          "navigation": "Barra inferior con agenda, ajustes y soporte",
          "responsive_notes": "Una columna en móvil; objetivos táctiles de 48 px",
          "asset_sources": [
            "Lucide Icons",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-booking-reminder",
            "name": "Reservas y recordatorios",
            "screen": "Agenda y recordatorios",
            "notes": "Base de la lista y el recordatorio"
          },
          {
            "mockup_id": "m-chat-support",
            "name": "Chat de soporte",
            "screen": "Soporte",
            "notes": "Dudas frecuentes y chat"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes",
            "notes": "Notificaciones y copia"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "flutter-architecture",
            "name": "Arquitectura Flutter",
            "purpose": "Features aisladas, testeables y sin fugas de UI.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "state-management",
            "name": "Gestión de estado",
            "purpose": "Estado predecible y reconstruible tras rotación o muerte.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "responsive-design",
            "name": "Diseño responsivo",
            "purpose": "Una base de código legible en móvil, tableta y escritorio.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "accessibility-wcag",
            "name": "Accesibilidad WCAG",
            "purpose": "Contraste, foco y lectores de pantalla desde el inicio.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de modo avión y de reloj con notificaciones del sistema.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Repositorios y sync",
              "tools": [
                "flutter test"
              ],
              "notes": "Reloj inyectable"
            },
            {
              "kind": "ui",
              "scope": "Flujo de agenda",
              "tools": [
                "integration test"
              ],
              "notes": "Gama media"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Edición sin pérdida",
              "given": "Entrada en edición",
              "when": "Se rota la pantalla",
              "then": "Contenido intacto",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Recordatorio con app cerrada",
              "given": "Entrada con recordatorio",
              "when": "Llega la hora con app cerrada",
              "then": "Notificación visible",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Copia durable",
              "given": "Cambios hechos sin red",
              "when": "Se exporta copia",
              "then": "Copia restaurable",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "RN-001",
              "title": "Deshacer borrado",
              "given": "Entrada activa",
              "when": "Se borra y se deshace en 5 s",
              "then": "Entrada restaurada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Arranque rápido",
              "given": "App instalada en gama media",
              "when": "Arranque en frío",
              "then": "Agenda visible en menos de 2 s",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-004",
              "title": "Soporte sin salir",
              "given": "Sesión activa",
              "when": "Abre soporte",
              "then": "Dudas y chat dentro de la app",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Sesión caducada",
              "given": "Token vencido",
              "when": "Abre la agenda",
              "then": "Pide reingreso sin mostrar datos ajenos",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Migración de ajustes",
              "given": "Ajustes de versión anterior",
              "when": "Actualiza la app",
              "then": "Ajustes migrados sin reseteo",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Prueba de avión documentada",
            "Arranque medido en gama media"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Paquetes de tienda",
            "kind": "instalacion",
            "format": "aab/ipa",
            "audience": "Usuario",
            "contents": [
              "Binarios firmados",
              "Fichas de tienda"
            ]
          },
          {
            "id": "dl-02",
            "title": "Guía de copia y restauración",
            "kind": "usuario",
            "format": "markdown",
            "audience": "Usuario",
            "contents": [
              "Estados",
              "Recuperación"
            ]
          },
          {
            "id": "dl-03",
            "title": "Informe de pruebas",
            "kind": "tecnico",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "Casos",
              "Mediciones"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "SQLite local es la fuente de verdad en el dispositivo.",
            "status": "resolved",
            "resolution": "Aceptado en dec-01",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "Las tiendas rechazan permisos de notificación mal explicados.",
            "status": "resolved",
            "resolution": "Mitigado: solicitud en contexto con texto claro",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Agenda y recordatorios",
                    "Copia o sincronización",
                    "Soporte en app"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-sync",
          "question_es": "¿Cómo se conservan los datos?",
          "question_en": "How is data kept?",
          "options": [
            {
              "id": "local",
              "label_es": "Copia local durable",
              "label_en": "Durable local copy",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "SQLite local"
                }
              ]
            },
            {
              "id": "sync",
              "label_es": "Sincronización con servidor",
              "label_en": "Server synchronization",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "SQLite local + PostgreSQL remoto"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "mobile-api",
      "types": [
        "móvil"
      ],
      "name_es": "Móvil conectada a API de agenda",
      "name_en": "API-connected agenda mobile",
      "summary_es": "Agenda móvil con sincronización por marca de tiempo y soporte en app.",
      "summary_en": "Mobile agenda with timestamp sync and in-app support.",
      "expert_id": "dart-falcon",
      "skills": [
        "flutter-architecture",
        "state-management",
        "responsive-design",
        "accessibility-wcag"
      ],
      "pieces": [
        "flutter-feature-first",
        "flutter-http-client",
        "flutter-repository-pattern",
        "i18n-arb-flutter"
      ],
      "mockups": [
        "m-booking-reminder",
        "m-chat-support",
        "m-settings-center"
      ],
      "resources": [
        "lucide",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "mobile"
        ],
        "languages": [
          "Dart"
        ],
        "databases": [
          "SQLite local + PostgreSQL remoto"
        ],
        "project_types": [
          "móvil"
        ],
        "non_goals": [
          "Versión de escritorio",
          "Compartir agenda entre usuarios",
          "Widgets del sistema"
        ],
        "visual_style": "Cálido y legible en exterior",
        "asset_sources": [
          "Lucide Icons",
          "Google Fonts"
        ],
        "mockup": "m-booking-reminder"
      },
      "document": {
        "name": "Móvil conectada a API de agenda",
        "schema_version": 1,
        "identity": {
          "name": "Móvil conectada a API de agenda",
          "description": "Las agendas móviles pierden datos sin conexión y olvidan recordatorios al cerrar la app.",
          "problem": "Las agendas móviles pierden datos sin conexión y olvidan recordatorios al cerrar la app.",
          "vision": "Una agenda móvil que funciona siempre, con o sin red, y recuerda a tiempo.",
          "goals": [
            "Agenda y recordatorios",
            "Copia o sincronización"
          ],
          "specific_goals": [
            "Cero pérdidas en prueba de avión",
            "Arranque en frío menor a 2 s",
            "Recordatorios puntuales al 99%"
          ],
          "users": [
            "Usuario final en móvil",
            "Soporte del producto"
          ],
          "use_cases": [
            "Agenda personal",
            "Recordatorios locales",
            "Sincronización"
          ],
          "scope": [
            "Agenda y recordatorios",
            "Copia o sincronización",
            "Soporte en app",
            "Ajustes versionados"
          ],
          "out_of_scope": [
            "Versión de escritorio",
            "Compartir agenda entre usuarios",
            "Widgets del sistema"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero pérdidas en prueba de avión",
            "Arranque en frío menor a 2 s",
            "Recordatorios puntuales al 99%"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Agenda personal",
            "statement": "El usuario crea, edita y completa entradas de agenda con recordatorio.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Edición sin pérdida al cambiar de pantalla"
            ],
            "links": [
              "process:p-01",
              "entity:entrada"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Recordatorios locales",
            "statement": "Los recordatorios se disparan aunque la app esté cerrada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Notificación a la hora exacta ±1 min"
            ],
            "links": [
              "process:p-02"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Sincronización",
            "statement": "Los cambios se sincronizan con el servidor al recuperar conexión.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Conflictos resueltos por marca de tiempo"
            ],
            "links": [
              "process:p-03",
              "entity:entrada"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Soporte en la app",
            "statement": "El usuario consulta dudas frecuentes y abre chat de soporte.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Chat disponible sin salir de la app"
            ],
            "links": [
              "mockup:m-chat-support"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "permission",
            "title": "Datos solo del usuario",
            "statement": "Cada usuario accede únicamente a sus entradas y ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Sesión caducada pide reingreso"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Sin borrado silencioso",
            "statement": "Borrar una entrada pide confirmación y ofrece deshacer 10 s.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Deshacer restaura la entrada completa"
            ],
            "links": [
              "entity:entrada"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Ajustes versionados",
            "statement": "Los ajustes guardan esquema versionado para migrar entre versiones.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Migración sin resetear ajustes"
            ],
            "links": [
              "entity:ajuste"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "non_functional",
            "title": "Arranque en frío rápido",
            "statement": "La app abre la agenda en menos de 2 s en gama media.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Medición en dispositivo de gama media"
            ],
            "links": []
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Uso con conectividad irregular",
            "summary": "El modo avión es un estado normal, no un error.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Notificaciones del sistema",
            "summary": "El sistema operativo es el único reloj confiable con app cerrada.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "mobile",
          "language": "Dart",
          "framework": "Flutter",
          "style": "Feature-first con repositorios",
          "database": "SQLite local + PostgreSQL remoto",
          "data_access": "Repositorio con fuente local y remota",
          "api_style": "REST JSON",
          "auth": "Token por dispositivo",
          "infrastructure": "Dispositivo + API",
          "hosting": "Tiendas móviles",
          "external_services": [],
          "dependencies": [
            "Flutter",
            "SQLite"
          ],
          "environments": [
            "desarrollo",
            "tiendas"
          ],
          "deploy_strategy": "publicación por tienda"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Persistencia",
            "choice": "SQLite local primero",
            "rationale": "La app nunca depende de la red para operar.",
            "alternatives": [
              "Solo remoto",
              "Hive"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Reloj de recordatorios",
            "choice": "Notificaciones del sistema",
            "rationale": "Funcionan con la app cerrada sin servicios propios.",
            "alternatives": [
              "Alarmas propias en background"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "entrada",
              "name": "entrada",
              "description": "Entrada de agenda del usuario.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "titulo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "recordatorio_en",
                  "data_type": "timestamp",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "activa",
                    "completada",
                    "borrada"
                  ]
                },
                {
                  "name": "pendiente_sync",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "recordatorio_en"
              ],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Dueño de la agenda.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "creado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencias versionadas de la app.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "esquema",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "entrada",
              "label": "posee"
            },
            {
              "id": "rel-02",
              "kind": "one_to_one",
              "from": "usuario",
              "to": "ajuste",
              "label": "configura"
            }
          ],
          "seed_data": [
            "Ajustes por defecto esquema 1"
          ],
          "migrations": [
            "v1: entradas, usuarios y ajustes"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Guardar entrada",
            "summary": "Valida y persiste la entrada en local.",
            "trigger": "Confirmación del formulario",
            "inputs": [
              "entrada"
            ],
            "outputs": [
              "entrada guardada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "entrada",
                  "source": "formulario"
                },
                {
                  "op": "si",
                  "condition": "entrada.titulo_vacio",
                  "then_body": [
                    {
                      "op": "generar_error",
                      "message": "Título obligatorio",
                      "code": "TITULO_VACIO"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "entrada",
                      "value": "estado=activa"
                    },
                    {
                      "op": "llamar",
                      "process": "Programar recordatorio",
                      "args": [
                        "entrada"
                      ]
                    }
                  ]
                }
              ]
            },
            "errors": [
              "TITULO_VACIO"
            ],
            "rules": [],
            "links": [
              "requirement:FR-001",
              "entity:entrada"
            ]
          },
          {
            "id": "p-02",
            "name": "Programar recordatorio",
            "summary": "Registra la notificación local en el sistema.",
            "trigger": "Entrada con recordatorio",
            "inputs": [
              "entrada"
            ],
            "outputs": [
              "notificación programada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "entrada",
                  "query": "recordatorio_en",
                  "into": "cuando"
                },
                {
                  "op": "guardar",
                  "target": "almacen",
                  "value": "notificacion_local programada(cuando, entrada.id)"
                }
              ]
            },
            "errors": [
              "Permiso de notificaciones denegado se avisa en UI"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002"
            ]
          },
          {
            "id": "p-03",
            "name": "Sincronizar cambios",
            "summary": "Sube cambios pendientes y baja novedades.",
            "trigger": "Conexión recuperada",
            "inputs": [
              "cambios"
            ],
            "outputs": [
              "estado sincronizado"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "entrada",
                  "query": "pendiente_de_sync",
                  "into": "lote"
                },
                {
                  "op": "si",
                  "condition": "lote_vacio",
                  "then_body": [
                    {
                      "op": "finalizar"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "api",
                      "value": "lote"
                    },
                    {
                      "op": "guardar",
                      "target": "entrada",
                      "value": "pendiente=false"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Red caída deja el lote pendiente"
            ],
            "rules": [],
            "links": [
              "requirement:FR-003",
              "entity:entrada"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Capas de la móvil",
            "description": "Capas de la móvil",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "UI Flutter",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Repositorios",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "estado",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "lectura y escritura",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Cálido y legible en exterior",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Roboto para UI",
            "Tamaños mínimos de 14 px"
          ],
          "components": [
            "Tarjetas de agenda",
            "Confirmación con deshacer"
          ],
          "navigation": "Barra inferior con agenda, ajustes y soporte",
          "responsive_notes": "Una columna en móvil; objetivos táctiles de 48 px",
          "asset_sources": [
            "Lucide Icons",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-booking-reminder",
            "name": "Reservas y recordatorios",
            "screen": "Agenda y recordatorios",
            "notes": "Base de la lista y el recordatorio"
          },
          {
            "mockup_id": "m-chat-support",
            "name": "Chat de soporte",
            "screen": "Soporte",
            "notes": "Dudas frecuentes y chat"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes",
            "notes": "Notificaciones y copia"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "flutter-architecture",
            "name": "Arquitectura Flutter",
            "purpose": "Features aisladas, testeables y sin fugas de UI.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "state-management",
            "name": "Gestión de estado",
            "purpose": "Estado predecible y reconstruible tras rotación o muerte.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "responsive-design",
            "name": "Diseño responsivo",
            "purpose": "Una base de código legible en móvil, tableta y escritorio.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "accessibility-wcag",
            "name": "Accesibilidad WCAG",
            "purpose": "Contraste, foco y lectores de pantalla desde el inicio.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de modo avión y de reloj con notificaciones del sistema.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Repositorios y sync",
              "tools": [
                "flutter test"
              ],
              "notes": "Reloj inyectable"
            },
            {
              "kind": "ui",
              "scope": "Flujo de agenda",
              "tools": [
                "integration test"
              ],
              "notes": "Gama media"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Edición sin pérdida",
              "given": "Entrada en edición",
              "when": "Se rota la pantalla",
              "then": "Contenido intacto",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Recordatorio con app cerrada",
              "given": "Entrada con recordatorio",
              "when": "Llega la hora con app cerrada",
              "then": "Notificación visible",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Sync tras offline",
              "given": "Cambios offline",
              "when": "Vuelve la conexión",
              "then": "Cambios presentes en servidor",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "RN-001",
              "title": "Deshacer borrado",
              "given": "Entrada activa",
              "when": "Se borra y se deshace en 5 s",
              "then": "Entrada restaurada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Arranque rápido",
              "given": "App instalada en gama media",
              "when": "Arranque en frío",
              "then": "Agenda visible en menos de 2 s",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-004",
              "title": "Soporte sin salir",
              "given": "Sesión activa",
              "when": "Abre soporte",
              "then": "Dudas y chat dentro de la app",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Sesión caducada",
              "given": "Token vencido",
              "when": "Abre la agenda",
              "then": "Pide reingreso sin mostrar datos ajenos",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Migración de ajustes",
              "given": "Ajustes de versión anterior",
              "when": "Actualiza la app",
              "then": "Ajustes migrados sin reseteo",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Prueba de avión documentada",
            "Arranque medido en gama media"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Paquetes de tienda",
            "kind": "instalacion",
            "format": "aab/ipa",
            "audience": "Usuario",
            "contents": [
              "Binarios firmados",
              "Fichas de tienda"
            ]
          },
          {
            "id": "dl-02",
            "title": "Guía de sincronización",
            "kind": "usuario",
            "format": "markdown",
            "audience": "Usuario",
            "contents": [
              "Estados",
              "Recuperación"
            ]
          },
          {
            "id": "dl-03",
            "title": "Informe de pruebas",
            "kind": "tecnico",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "Casos",
              "Mediciones"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "SQLite local es la fuente de verdad en el dispositivo.",
            "status": "resolved",
            "resolution": "Aceptado en dec-01",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "Las tiendas rechazan permisos de notificación mal explicados.",
            "status": "resolved",
            "resolution": "Mitigado: solicitud en contexto con texto claro",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Agenda y recordatorios",
                    "Copia o sincronización",
                    "Soporte en app"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-sync",
          "question_es": "¿Cómo se conservan los datos?",
          "question_en": "How is data kept?",
          "options": [
            {
              "id": "local",
              "label_es": "Copia local durable",
              "label_en": "Durable local copy",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "SQLite local"
                }
              ]
            },
            {
              "id": "sync",
              "label_es": "Sincronización con servidor",
              "label_en": "Server synchronization",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "SQLite local + PostgreSQL remoto"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "api-express",
      "types": [
        "backend",
        "api"
      ],
      "name_es": "API REST Express multitenant",
      "name_en": "Multitenant Express REST API",
      "summary_es": "API REST con contrato publicado, sobre de error uniforme y aislamiento por tenant.",
      "summary_en": "REST API with published contract, uniform error envelope and tenant isolation.",
      "expert_id": "ada-crudwell",
      "skills": [
        "rest-api-design",
        "error-handling-design",
        "data-modeling",
        "authentication-authorization"
      ],
      "pieces": [
        "node-express-rest-base",
        "auth-jwt-express",
        "error-envelope-rest",
        "pagination-cursor-sql"
      ],
      "mockups": [],
      "resources": [
        "lucide"
      ],
      "brief": {
        "platforms": [
          "backend"
        ],
        "languages": [
          "TypeScript"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "backend",
          "api"
        ],
        "non_goals": [
          "GraphQL",
          "Eventos asíncronos",
          "Facturación por uso"
        ],
        "visual_style": "Documentación clara como producto",
        "asset_sources": [
          "Lucide Icons"
        ],
        "mockup": ""
      },
      "document": {
        "name": "API REST Express multitenant",
        "schema_version": 1,
        "identity": {
          "name": "API REST Express multitenant",
          "description": "Las APIs internas crecen sin contrato, sin aislamiento y con errores imposibles de depurar.",
          "problem": "Las APIs internas crecen sin contrato, sin aislamiento y con errores imposibles de depurar.",
          "vision": "Una API REST multitenant con contrato publicado, errores uniformes y aislamiento verificable.",
          "goals": [
            "CRUD por tenant",
            "Auth con scopes"
          ],
          "specific_goals": [
            "Cero fugas entre tenants",
            "p95 menor a 200 ms",
            "100% de errores con request-id"
          ],
          "users": [
            "Equipo consumidor de la API",
            "Operador de plataforma"
          ],
          "use_cases": [
            "CRUD de recursos",
            "Autenticación y scopes",
            "Validación de entrada"
          ],
          "scope": [
            "CRUD por tenant",
            "Auth con scopes",
            "Validación y sobre de error",
            "Observabilidad"
          ],
          "out_of_scope": [
            "GraphQL",
            "Eventos asíncronos",
            "Facturación por uso"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero fugas entre tenants",
            "p95 menor a 200 ms",
            "100% de errores con request-id"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "CRUD de recursos",
            "statement": "La API expone creación, lectura, actualización y borrado lógico de recursos por tenant.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Borrado lógico nunca destruye datos",
              "Paginación por cursor estable"
            ],
            "links": [
              "process:p-01",
              "entity:recurso"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Autenticación y scopes",
            "statement": "Tokens con scopes por tenant y rol; renovación sin relogin.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Token caducado devuelve 401 con código estable"
            ],
            "links": [
              "process:p-02",
              "entity:tenant"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "validation",
            "title": "Validación de entrada",
            "statement": "Toda entrada se valida contra esquema antes de tocar dominio.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Error de validación devuelve 422 con detalles por campo"
            ],
            "links": [
              "process:p-01"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Sobre de error uniforme",
            "statement": "Todos los errores comparten sobre con código, mensaje y request-id.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ningún 500 filtra stack traces"
            ],
            "links": [
              "process:p-03"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "non_functional",
            "title": "Observabilidad mínima",
            "statement": "Logs estructurados con request-id y healthcheck con dependencias.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Healthcheck distingue vivo y listo"
            ],
            "links": []
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Aislamiento por tenant",
            "statement": "Ninguna consulta cruza tenants sin permiso explícito de plataforma.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Prueba de fuga entre tenants en verde"
            ],
            "links": [
              "entity:recurso",
              "entity:tenant"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Migraciones hacia adelante",
            "statement": "Los cambios de esquema son migraciones versionadas y reversibles.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Migración probada en copia de producción"
            ],
            "links": [
              "entity:recurso"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Contrato publicado",
            "statement": "La API publica contrato OpenAPI con ejemplos por endpoint.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Contrato coincide con respuestas reales"
            ],
            "links": []
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Producto multi-organización",
            "summary": "El tenant es la frontera de seguridad y de facturación futura.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Contrato primero",
            "summary": "El contrato OpenAPI es el acuerdo con los consumidores.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "backend",
          "language": "TypeScript",
          "framework": "Express + TypeScript",
          "style": "Capas: rutas, dominio, repositorios",
          "database": "PostgreSQL",
          "data_access": "Repositorio tipado",
          "api_style": "REST JSON versionado",
          "auth": "JWT con scopes",
          "infrastructure": "Contenedor",
          "hosting": "VPS o nube con HTTPS",
          "external_services": [],
          "dependencies": [
            "Express + TypeScript",
            "PostgreSQL"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI con migraciones previas"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Lenguaje y framework",
            "choice": "Express + TypeScript",
            "rationale": "Tipado fuerte y ecosistema de validación maduro.",
            "alternatives": [
              "FastAPI",
              "NestJS"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Aislamiento",
            "choice": "Filtro de tenant en repositorio",
            "rationale": "Una sola puerta de consulta evita fugas por olvido.",
            "alternatives": [
              "Row-Level Security",
              "Esquemas por tenant"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "tenant",
              "name": "tenant",
              "description": "Organización dueña de sus datos.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "plan",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "recurso",
              "name": "recurso",
              "description": "Registro de dominio aislado por tenant.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tenant_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "tenant.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "borrado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "actualizado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "tenant_id",
                "actualizado_en"
              ],
              "rules": [
                "Toda consulta filtra tenant_id"
              ]
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Identidad con rol dentro de un tenant.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tenant_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "tenant.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "tenant",
              "to": "recurso",
              "label": "contiene"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "tenant",
              "to": "usuario",
              "label": "emplea"
            }
          ],
          "seed_data": [
            "Tenant de demostración con recursos de ejemplo"
          ],
          "migrations": [
            "v1: tenants, recursos y usuarios"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Atender petición de recurso",
            "summary": "Valida, autoriza y ejecuta la operación sobre el tenant.",
            "trigger": "Petición HTTP autenticada",
            "inputs": [
              "petición"
            ],
            "outputs": [
              "respuesta"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "peticion",
                  "source": "http"
                },
                {
                  "op": "llamar",
                  "process": "Validar entrada",
                  "args": [
                    "peticion"
                  ]
                },
                {
                  "op": "consultar",
                  "target": "recurso",
                  "query": "tenant = peticion.tenant",
                  "into": "datos"
                },
                {
                  "op": "si",
                  "condition": "datos_existe",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "recurso",
                      "value": "peticion.cambios"
                    },
                    {
                      "op": "devolver",
                      "value": "recurso"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Recurso inexistente",
                      "code": "NO_EXISTE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "NO_EXISTE: 404"
            ],
            "rules": [
              "Filtro de tenant obligatorio en toda consulta"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "requirement:RN-001",
              "entity:recurso"
            ]
          },
          {
            "id": "p-02",
            "name": "Emitir y renovar token",
            "summary": "Emite token con scopes del tenant y rol.",
            "trigger": "Login o renovación",
            "inputs": [
              "credenciales"
            ],
            "outputs": [
              "token"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "usuario",
                  "query": "credenciales_validas",
                  "into": "usuario"
                },
                {
                  "op": "si",
                  "condition": "usuario_existe",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "almacen",
                      "value": "token con scopes(usuario)"
                    },
                    {
                      "op": "devolver",
                      "value": "token"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Credenciales inválidas",
                      "code": "AUTH_FALLIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "AUTH_FALLIDA: 401"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002",
              "entity:tenant"
            ]
          },
          {
            "id": "p-03",
            "name": "Cerrar error con sobre",
            "summary": "Convierte cualquier fallo en sobre uniforme con request-id.",
            "trigger": "Excepción no controlada",
            "inputs": [
              "error"
            ],
            "outputs": [
              "sobre de error"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "definir",
                  "variable": "sobre",
                  "value": "{codigo, mensaje, request_id}"
                },
                {
                  "op": "si",
                  "condition": "error.es_validacion",
                  "then_body": [
                    {
                      "op": "asignar",
                      "variable": "sobre.codigo",
                      "expression": "VALIDACION"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "asignar",
                      "variable": "sobre.codigo",
                      "expression": "INTERNO"
                    }
                  ]
                },
                {
                  "op": "guardar",
                  "target": "archivo",
                  "value": "log estructurado con request_id"
                },
                {
                  "op": "devolver",
                  "value": "sobre"
                }
              ]
            },
            "errors": [
              "Nunca se expone el stack"
            ],
            "rules": [],
            "links": [
              "requirement:FR-004"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "architecture",
            "title": "Capas de la API",
            "description": "Capas de la API",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "Rutas y validación",
                "shape": "box",
                "group": "borde",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Dominio",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "casos de uso",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "repositorios",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Documentación clara como producto",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Monospace para ejemplos",
            "Sans para guía"
          ],
          "components": [
            "Referencia de endpoints",
            "Tabla de códigos de error"
          ],
          "navigation": "Referencia navegable por recurso",
          "responsive_notes": "Documentación legible en móvil",
          "asset_sources": [
            "Lucide Icons"
          ],
          "references": []
        },
        "mockups": [],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "rest-api-design",
            "name": "Diseño de API REST",
            "purpose": "Recursos, códigos y paginación estables para consumidores.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Sobre uniforme, códigos estables y mensajes accionables.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "data-modeling",
            "name": "Modelado de datos",
            "purpose": "Entidades y relaciones que sostienen los procesos.",
            "when": "diseño"
          },
          {
            "id": "sk-04",
            "skill_id": "authentication-authorization",
            "name": "Autenticación y autorización",
            "purpose": "Sesiones y roles verificables en cada entrada.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de contrato contra OpenAPI y prueba de fuga entre tenants.",
          "levels": [
            {
              "kind": "integration",
              "scope": "Endpoints y base",
              "tools": [
                "Suite del framework"
              ],
              "notes": "BD real en contenedor"
            },
            {
              "kind": "security",
              "scope": "Aislamiento y auth",
              "tools": [
                "Pruebas de fuga"
              ],
              "notes": "Dos tenants"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "RN-001",
              "title": "Sin fuga entre tenants",
              "given": "Dos tenants con datos",
              "when": "Consulta del tenant A",
              "then": "Cero registros del tenant B",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-003",
              "title": "Validación con detalle",
              "given": "Cuerpo inválido",
              "when": "POST al recurso",
              "then": "422 con errores por campo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-004",
              "title": "Sobre uniforme",
              "given": "Fallo interno provocado",
              "when": "Petición",
              "then": "Sobre con código y request-id, sin stack",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-002",
              "title": "Renovación de token",
              "given": "Token por caducar",
              "when": "Renovación",
              "then": "Token nuevo sin relogin",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Contrato fiel",
              "given": "Contrato publicado",
              "when": "Se comparan respuestas",
              "then": "Esquemas coinciden",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-001",
              "title": "Borrado lógico y cursor",
              "given": "Recurso existente",
              "when": "Se borra y se pagina",
              "then": "Registro conservado y cursor estable",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Healthcheck con dependencias",
              "given": "Base caída",
              "when": "Se consulta listo",
              "then": "Distingue vivo de listo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Migración reversible",
              "given": "Migración aplicada",
              "when": "Se revierte en copia",
              "then": "Esquema anterior restaurado",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Contrato comparado en CI",
            "Migraciones probadas en copia"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Servicio desplegable",
            "kind": "despliegue",
            "format": "contenedor",
            "audience": "Operador",
            "contents": [
              "Imagen",
              "Migraciones",
              "Variables"
            ]
          },
          {
            "id": "dl-02",
            "title": "Contrato OpenAPI",
            "kind": "api",
            "format": "yaml",
            "audience": "Consumidor",
            "contents": [
              "Esquemas",
              "Ejemplos",
              "Códigos"
            ]
          },
          {
            "id": "dl-03",
            "title": "Guía de operación",
            "kind": "mantenimiento",
            "format": "markdown",
            "audience": "Operador",
            "contents": [
              "Healthcheck",
              "Logs",
              "Incidentes"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "El filtro de tenant vive en el repositorio, no en cada ruta.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "El contrato puede divergir de la implementación.",
            "status": "resolved",
            "resolution": "Mitigado: comparación en CI",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "CRUD por tenant",
                    "Auth con scopes",
                    "Validación y sobre de error"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-api",
          "question_es": "¿Estilo de la API?",
          "question_en": "API style?",
          "options": [
            {
              "id": "rest",
              "label_es": "REST JSON versionado",
              "label_en": "Versioned REST JSON",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "api_style",
                  "value": "REST JSON versionado"
                }
              ]
            },
            {
              "id": "rpc",
              "label_es": "RPC por procedimientos",
              "label_en": "Procedure RPC",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "api_style",
                  "value": "RPC JSON"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "api-fastapi",
      "types": [
        "backend",
        "api"
      ],
      "name_es": "API REST FastAPI con SQL tipado",
      "name_en": "FastAPI REST API with typed SQL",
      "summary_es": "API REST en Python con repositorios tipados, migraciones y contrato publicado.",
      "summary_en": "Python REST API with typed repositories, migrations and published contract.",
      "expert_id": "gru-sql",
      "skills": [
        "sql-modeling",
        "query-optimization",
        "database-migrations",
        "transactions-isolation"
      ],
      "pieces": [
        "fastapi-rest-base",
        "auth-fastapi-oauth2",
        "sqlalchemy-repository",
        "pagination-cursor-sql"
      ],
      "mockups": [],
      "resources": [
        "lucide"
      ],
      "brief": {
        "platforms": [
          "backend"
        ],
        "languages": [
          "Python"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "backend",
          "api"
        ],
        "non_goals": [
          "GraphQL",
          "Eventos asíncronos",
          "Facturación por uso"
        ],
        "visual_style": "Documentación clara como producto",
        "asset_sources": [
          "Lucide Icons"
        ],
        "mockup": ""
      },
      "document": {
        "name": "API REST FastAPI con SQL tipado",
        "schema_version": 1,
        "identity": {
          "name": "API REST FastAPI con SQL tipado",
          "description": "Las APIs internas crecen sin contrato, sin aislamiento y con errores imposibles de depurar.",
          "problem": "Las APIs internas crecen sin contrato, sin aislamiento y con errores imposibles de depurar.",
          "vision": "Una API REST multitenant con contrato publicado, errores uniformes y aislamiento verificable.",
          "goals": [
            "CRUD por tenant",
            "Auth con scopes"
          ],
          "specific_goals": [
            "Cero fugas entre tenants",
            "p95 menor a 200 ms",
            "100% de errores con request-id"
          ],
          "users": [
            "Equipo consumidor de la API",
            "Operador de plataforma"
          ],
          "use_cases": [
            "CRUD de recursos",
            "Autenticación y scopes",
            "Validación de entrada"
          ],
          "scope": [
            "CRUD por tenant",
            "Auth con scopes",
            "Validación y sobre de error",
            "Observabilidad"
          ],
          "out_of_scope": [
            "GraphQL",
            "Eventos asíncronos",
            "Facturación por uso"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero fugas entre tenants",
            "p95 menor a 200 ms",
            "100% de errores con request-id"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "CRUD de recursos",
            "statement": "La API expone creación, lectura, actualización y borrado lógico de recursos por tenant.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Borrado lógico nunca destruye datos",
              "Paginación por cursor estable"
            ],
            "links": [
              "process:p-01",
              "entity:recurso"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Autenticación y scopes",
            "statement": "Tokens con scopes por tenant y rol; renovación sin relogin.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Token caducado devuelve 401 con código estable"
            ],
            "links": [
              "process:p-02",
              "entity:tenant"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "validation",
            "title": "Validación de entrada",
            "statement": "Toda entrada se valida contra esquema antes de tocar dominio.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Error de validación devuelve 422 con detalles por campo"
            ],
            "links": [
              "process:p-01"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Sobre de error uniforme",
            "statement": "Todos los errores comparten sobre con código, mensaje y request-id.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ningún 500 filtra stack traces"
            ],
            "links": [
              "process:p-03"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "non_functional",
            "title": "Observabilidad mínima",
            "statement": "Logs estructurados con request-id y healthcheck con dependencias.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Healthcheck distingue vivo y listo"
            ],
            "links": []
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Aislamiento por tenant",
            "statement": "Ninguna consulta cruza tenants sin permiso explícito de plataforma.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Prueba de fuga entre tenants en verde"
            ],
            "links": [
              "entity:recurso",
              "entity:tenant"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Migraciones hacia adelante",
            "statement": "Los cambios de esquema son migraciones versionadas y reversibles.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Migración probada en copia de producción"
            ],
            "links": [
              "entity:recurso"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Contrato publicado",
            "statement": "La API publica contrato OpenAPI con ejemplos por endpoint.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Contrato coincide con respuestas reales"
            ],
            "links": []
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Producto multi-organización",
            "summary": "El tenant es la frontera de seguridad y de facturación futura.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Contrato primero",
            "summary": "El contrato OpenAPI es el acuerdo con los consumidores.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "backend",
          "language": "Python",
          "framework": "FastAPI + Python",
          "style": "Capas: rutas, dominio, repositorios",
          "database": "PostgreSQL",
          "data_access": "SQLAlchemy 2 tipado",
          "api_style": "REST JSON versionado",
          "auth": "JWT con scopes",
          "infrastructure": "Contenedor",
          "hosting": "VPS o nube con HTTPS",
          "external_services": [],
          "dependencies": [
            "FastAPI + Python",
            "PostgreSQL"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI con migraciones previas"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Lenguaje y framework",
            "choice": "FastAPI + Python",
            "rationale": "Tipado fuerte y ecosistema de validación maduro.",
            "alternatives": [
              "Express",
              "NestJS"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Aislamiento",
            "choice": "Filtro de tenant en repositorio",
            "rationale": "Una sola puerta de consulta evita fugas por olvido.",
            "alternatives": [
              "Row-Level Security",
              "Esquemas por tenant"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "tenant",
              "name": "tenant",
              "description": "Organización dueña de sus datos.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "plan",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "recurso",
              "name": "recurso",
              "description": "Registro de dominio aislado por tenant.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tenant_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "tenant.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "borrado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "actualizado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "tenant_id",
                "actualizado_en"
              ],
              "rules": [
                "Toda consulta filtra tenant_id"
              ]
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Identidad con rol dentro de un tenant.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tenant_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "tenant.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "tenant",
              "to": "recurso",
              "label": "contiene"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "tenant",
              "to": "usuario",
              "label": "emplea"
            }
          ],
          "seed_data": [
            "Tenant de demostración con recursos de ejemplo"
          ],
          "migrations": [
            "v1: tenants, recursos y usuarios"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Atender petición de recurso",
            "summary": "Valida, autoriza y ejecuta la operación sobre el tenant.",
            "trigger": "Petición HTTP autenticada",
            "inputs": [
              "petición"
            ],
            "outputs": [
              "respuesta"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "peticion",
                  "source": "http"
                },
                {
                  "op": "llamar",
                  "process": "Validar entrada",
                  "args": [
                    "peticion"
                  ]
                },
                {
                  "op": "consultar",
                  "target": "recurso",
                  "query": "tenant = peticion.tenant",
                  "into": "datos"
                },
                {
                  "op": "si",
                  "condition": "datos_existe",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "recurso",
                      "value": "peticion.cambios"
                    },
                    {
                      "op": "devolver",
                      "value": "recurso"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Recurso inexistente",
                      "code": "NO_EXISTE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "NO_EXISTE: 404"
            ],
            "rules": [
              "Filtro de tenant obligatorio en toda consulta"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "requirement:RN-001",
              "entity:recurso"
            ]
          },
          {
            "id": "p-02",
            "name": "Emitir y renovar token",
            "summary": "Emite token con scopes del tenant y rol.",
            "trigger": "Login o renovación",
            "inputs": [
              "credenciales"
            ],
            "outputs": [
              "token"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "usuario",
                  "query": "credenciales_validas",
                  "into": "usuario"
                },
                {
                  "op": "si",
                  "condition": "usuario_existe",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "almacen",
                      "value": "token con scopes(usuario)"
                    },
                    {
                      "op": "devolver",
                      "value": "token"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Credenciales inválidas",
                      "code": "AUTH_FALLIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "AUTH_FALLIDA: 401"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002",
              "entity:tenant"
            ]
          },
          {
            "id": "p-03",
            "name": "Cerrar error con sobre",
            "summary": "Convierte cualquier fallo en sobre uniforme con request-id.",
            "trigger": "Excepción no controlada",
            "inputs": [
              "error"
            ],
            "outputs": [
              "sobre de error"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "definir",
                  "variable": "sobre",
                  "value": "{codigo, mensaje, request_id}"
                },
                {
                  "op": "si",
                  "condition": "error.es_validacion",
                  "then_body": [
                    {
                      "op": "asignar",
                      "variable": "sobre.codigo",
                      "expression": "VALIDACION"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "asignar",
                      "variable": "sobre.codigo",
                      "expression": "INTERNO"
                    }
                  ]
                },
                {
                  "op": "guardar",
                  "target": "archivo",
                  "value": "log estructurado con request_id"
                },
                {
                  "op": "devolver",
                  "value": "sobre"
                }
              ]
            },
            "errors": [
              "Nunca se expone el stack"
            ],
            "rules": [],
            "links": [
              "requirement:FR-004"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "architecture",
            "title": "Capas de la API",
            "description": "Capas de la API",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "Rutas y validación",
                "shape": "box",
                "group": "borde",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Dominio",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "casos de uso",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "repositorios",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Documentación clara como producto",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Monospace para ejemplos",
            "Sans para guía"
          ],
          "components": [
            "Referencia de endpoints",
            "Tabla de códigos de error"
          ],
          "navigation": "Referencia navegable por recurso",
          "responsive_notes": "Documentación legible en móvil",
          "asset_sources": [
            "Lucide Icons"
          ],
          "references": []
        },
        "mockups": [],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "sql-modeling",
            "name": "Modelado SQL",
            "purpose": "Esquema normalizado con índices pensados para las consultas.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "query-optimization",
            "name": "Optimización de consultas",
            "purpose": "Agregaciones rápidas con volumen real.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "database-migrations",
            "name": "Migraciones de base de datos",
            "purpose": "Esquema versionado, reversible y probado en copia.",
            "when": "despliegue"
          },
          {
            "id": "sk-04",
            "skill_id": "transactions-isolation",
            "name": "Transacciones y aislamiento",
            "purpose": "Operaciones compuestas atómicas sin estados a medias.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de contrato contra OpenAPI y prueba de fuga entre tenants.",
          "levels": [
            {
              "kind": "integration",
              "scope": "Endpoints y base",
              "tools": [
                "Suite del framework"
              ],
              "notes": "BD real en contenedor"
            },
            {
              "kind": "security",
              "scope": "Aislamiento y auth",
              "tools": [
                "Pruebas de fuga"
              ],
              "notes": "Dos tenants"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "RN-001",
              "title": "Sin fuga entre tenants",
              "given": "Dos tenants con datos",
              "when": "Consulta del tenant A",
              "then": "Cero registros del tenant B",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-003",
              "title": "Validación con detalle",
              "given": "Cuerpo inválido",
              "when": "POST al recurso",
              "then": "422 con errores por campo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-004",
              "title": "Sobre uniforme",
              "given": "Fallo interno provocado",
              "when": "Petición",
              "then": "Sobre con código y request-id, sin stack",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-002",
              "title": "Renovación de token",
              "given": "Token por caducar",
              "when": "Renovación",
              "then": "Token nuevo sin relogin",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Contrato fiel",
              "given": "Contrato publicado",
              "when": "Se comparan respuestas",
              "then": "Esquemas coinciden",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-001",
              "title": "Borrado lógico y cursor",
              "given": "Recurso existente",
              "when": "Se borra y se pagina",
              "then": "Registro conservado y cursor estable",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Healthcheck con dependencias",
              "given": "Base caída",
              "when": "Se consulta listo",
              "then": "Distingue vivo de listo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Migración reversible",
              "given": "Migración aplicada",
              "when": "Se revierte en copia",
              "then": "Esquema anterior restaurado",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Contrato comparado en CI",
            "Migraciones probadas en copia"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Servicio desplegable",
            "kind": "despliegue",
            "format": "contenedor",
            "audience": "Operador",
            "contents": [
              "Imagen",
              "Migraciones",
              "Variables"
            ]
          },
          {
            "id": "dl-02",
            "title": "Contrato OpenAPI",
            "kind": "api",
            "format": "yaml",
            "audience": "Consumidor",
            "contents": [
              "Esquemas",
              "Ejemplos",
              "Códigos"
            ]
          },
          {
            "id": "dl-03",
            "title": "Guía de operación",
            "kind": "mantenimiento",
            "format": "markdown",
            "audience": "Operador",
            "contents": [
              "Healthcheck",
              "Logs",
              "Incidentes"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "El filtro de tenant vive en el repositorio, no en cada ruta.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "El contrato puede divergir de la implementación.",
            "status": "resolved",
            "resolution": "Mitigado: comparación en CI",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "CRUD por tenant",
                    "Auth con scopes",
                    "Validación y sobre de error"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-api",
          "question_es": "¿Estilo de la API?",
          "question_en": "API style?",
          "options": [
            {
              "id": "rest",
              "label_es": "REST JSON versionado",
              "label_en": "Versioned REST JSON",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "api_style",
                  "value": "REST JSON versionado"
                }
              ]
            },
            {
              "id": "rpc",
              "label_es": "RPC por procedimientos",
              "label_en": "Procedure RPC",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "api_style",
                  "value": "RPC JSON"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "desktop-tauri",
      "types": [
        "desktop"
      ],
      "name_es": "Escritorio Tauri de punto de venta",
      "name_en": "Tauri POS desktop",
      "summary_es": "Punto de venta de escritorio en Rust que vende sin red y cuadra caja.",
      "summary_en": "Rust desktop POS that sells offline and reconciles the register.",
      "expert_id": "vox-cli",
      "skills": [
        "rust-idioms",
        "error-handling-design",
        "static-analysis",
        "unit-testing"
      ],
      "pieces": [
        "rust-error-thiserror",
        "structured-logging-rust",
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-pos-checkout",
        "m-settings-center",
        "m-admin-crud"
      ],
      "resources": [
        "tabler",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "Rust"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "desktop"
        ],
        "non_goals": [
          "Facturación fiscal",
          "Tienda en línea",
          "Multi-sucursal"
        ],
        "visual_style": "Denso y legible a distancia de mostrador",
        "asset_sources": [
          "Tabler Icons",
          "Google Fonts"
        ],
        "mockup": "m-pos-checkout"
      },
      "document": {
        "name": "Escritorio Tauri de punto de venta",
        "schema_version": 1,
        "identity": {
          "name": "Escritorio Tauri de punto de venta",
          "description": "Los puntos de venta pequeños dependen de hojas de cálculo y cajas que no cuadran.",
          "problem": "Los puntos de venta pequeños dependen de hojas de cálculo y cajas que no cuadran.",
          "vision": "Un punto de venta de escritorio que vende sin red, cuadra caja y deja rastro de todo.",
          "goals": [
            "Venta y caja",
            "Inventario mínimo"
          ],
          "specific_goals": [
            "Venta en menos de 10 s",
            "Cortes cuadrados o diferencia explicada",
            "Cero ventas perdidas"
          ],
          "users": [
            "Cajero de tienda",
            "Administrador del negocio"
          ],
          "use_cases": [
            "Venta rápida",
            "Caja y corte",
            "Inventario mínimo"
          ],
          "scope": [
            "Venta y caja",
            "Inventario mínimo",
            "Roles y anulaciones",
            "Instalador propio"
          ],
          "out_of_scope": [
            "Facturación fiscal",
            "Tienda en línea",
            "Multi-sucursal"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Venta en menos de 10 s",
            "Cortes cuadrados o diferencia explicada",
            "Cero ventas perdidas"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Venta rápida",
            "statement": "El cajero registra ventas con búsqueda de producto y total inmediato.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Venta completa en menos de 10 s",
              "Total recalcula sin errores de redondeo"
            ],
            "links": [
              "process:p-01",
              "entity:venta"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Caja y corte",
            "statement": "La caja abre y cierra con corte ciego y diferencias reportadas.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Corte muestra esperado contra contado"
            ],
            "links": [
              "process:p-02",
              "entity:caja"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Inventario mínimo",
            "statement": "Existencias bajan con cada venta y avisan bajo mínimo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Alerta de mínimo visible al abrir"
            ],
            "links": [
              "process:p-01",
              "entity:producto"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Trabajo sin red",
            "statement": "Toda la operación funciona offline con base local.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cero dependencia de red para vender"
            ],
            "links": [
              "entity:venta"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "permission",
            "title": "Roles de tienda",
            "statement": "Cajero y administrador tienen permisos distintos y auditados.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cajero no anula ventas sin clave"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Anulación con rastro",
            "statement": "Anular una venta conserva el registro y su motivo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ninguna venta desaparece de la base"
            ],
            "links": [
              "entity:venta"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Dinero en enteros",
            "statement": "Los importes se guardan en centavos enteros, nunca en flotantes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Sin errores de redondeo en totales"
            ],
            "links": [
              "entity:venta"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "non_functional",
            "title": "Instalador con identidad",
            "statement": "La app se instala con nombre, icono y desinstalador propios.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Instalación y desinstalación limpias"
            ],
            "links": []
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Tienda con conectividad irregular",
            "summary": "La red es opcional; la venta nunca se detiene.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Dinero exacto",
            "summary": "Centavos enteros eliminan una clase completa de errores.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "Rust",
          "framework": "Tauri 2 + Rust",
          "style": "Capas UI / dominio / SQLite",
          "database": "SQLite local",
          "data_access": "Repositorio con transacciones",
          "api_style": "ninguna",
          "auth": "Clave local por rol",
          "infrastructure": "Equipo de tienda",
          "hosting": "Instalador por equipo",
          "external_services": [],
          "dependencies": [
            "Tauri 2 + Rust",
            "SQLite"
          ],
          "environments": [
            "desarrollo",
            "tienda"
          ],
          "deploy_strategy": "instalador firmado"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Stack de escritorio",
            "choice": "Tauri 2 + Rust",
            "rationale": "Binario ligero con base local y empaquetado nativo.",
            "alternatives": [
              "Flutter",
              "Electron"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Representación de dinero",
            "choice": "Enteros en centavos",
            "rationale": "Exactitud decimal sin dependencias.",
            "alternatives": [
              "Decimal library",
              "Flotantes con redondeo"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "producto",
              "name": "producto",
              "description": "Artículo vendible con existencia.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio_centavos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "existencia",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "minimo",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "venta",
              "name": "venta",
              "description": "Venta con líneas y estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "caja_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "caja.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "total_centavos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "activa",
                    "anulada"
                  ]
                },
                {
                  "name": "motivo",
                  "data_type": "text",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "caja",
              "name": "caja",
              "description": "Turno de caja con corte.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "abierta_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cerrada_en",
                  "data_type": "timestamp",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Cajero o administrador.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "cajero",
                    "admin"
                  ]
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "caja",
              "to": "venta",
              "label": "agrupa"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "caja",
              "label": "opera"
            }
          ],
          "seed_data": [
            "Productos de demostración con mínimos",
            "Usuario administrador inicial"
          ],
          "migrations": [
            "v1: productos, ventas, cajas y usuarios"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Registrar venta",
            "summary": "Suma líneas, calcula total y descuenta existencias.",
            "trigger": "Confirmación del cajero",
            "inputs": [
              "líneas"
            ],
            "outputs": [
              "venta"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "lineas",
                  "source": "carrito"
                },
                {
                  "op": "consultar",
                  "target": "producto",
                  "query": "existencia >= cantidad",
                  "into": "disponibles"
                },
                {
                  "op": "si",
                  "condition": "todo_disponible",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "venta",
                      "value": "total_en_centavos(lineas)"
                    },
                    {
                      "op": "para_cada",
                      "variable": "l",
                      "collection": "lineas",
                      "body": [
                        {
                          "op": "guardar",
                          "target": "producto",
                          "value": "existencia - l.cantidad"
                        }
                      ]
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Existencia insuficiente",
                      "code": "SIN_EXISTENCIA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "SIN_EXISTENCIA"
            ],
            "rules": [
              "Importes en centavos enteros"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "requirement:RN-002",
              "entity:venta"
            ]
          },
          {
            "id": "p-02",
            "name": "Cerrar caja",
            "summary": "Compara esperado contra contado y guarda el corte.",
            "trigger": "Cierre de turno",
            "inputs": [
              "contado"
            ],
            "outputs": [
              "corte"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "venta",
                  "query": "del_turno",
                  "into": "esperado"
                },
                {
                  "op": "definir",
                  "variable": "diferencia",
                  "value": "contado - esperado"
                },
                {
                  "op": "guardar",
                  "target": "caja",
                  "value": "corte={esperado, contado, diferencia}"
                },
                {
                  "op": "si",
                  "condition": "diferencia != 0",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "caja",
                      "value": "diferencia_reportada"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Diferencia se reporta, no se oculta"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002",
              "entity:caja"
            ]
          },
          {
            "id": "p-03",
            "name": "Anular venta",
            "summary": "Marca la venta como anulada con motivo y usuario.",
            "trigger": "Solicitud con clave de administrador",
            "inputs": [
              "venta",
              "motivo"
            ],
            "outputs": [
              "venta anulada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "venta",
                  "query": "id y estado",
                  "into": "v"
                },
                {
                  "op": "si",
                  "condition": "v.anulable",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "venta",
                      "value": "estado=anulada, motivo"
                    },
                    {
                      "op": "guardar",
                      "target": "producto",
                      "value": "existencia + lineas"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Venta no anulable",
                      "code": "NO_ANULABLE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "NO_ANULABLE"
            ],
            "rules": [],
            "links": [
              "requirement:RN-001",
              "entity:venta"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Capas del escritorio",
            "description": "Capas del escritorio",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "UI de caja",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Dominio de ventas",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "comandos",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "transacciones",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Denso y legible a distancia de mostrador",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Sans de alto contraste",
            "Números tabulares"
          ],
          "components": [
            "Teclado rápido de venta",
            "Tabla de corte"
          ],
          "navigation": "Pantalla única de caja con paneles laterales",
          "responsive_notes": "Objetivos táctiles grandes; atajos de teclado",
          "asset_sources": [
            "Tabler Icons",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-pos-checkout",
            "name": "Punto de venta",
            "screen": "Caja y venta",
            "notes": "Base del flujo de venta"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes de tienda",
            "notes": "Roles y mínimos"
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Administración general",
            "screen": "Productos y reportes",
            "notes": "Altas y cortes"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "rust-idioms",
            "name": "Rust idiomático",
            "purpose": "Dominio seguro y testeable sin UI ni excepciones ocultas.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Sobre uniforme, códigos estables y mensajes accionables.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "static-analysis",
            "name": "Análisis estático",
            "purpose": "Lint y Clippy en verde como parte de la definición de terminado.",
            "when": "pruebas"
          },
          {
            "id": "sk-04",
            "skill_id": "unit-testing",
            "name": "Pruebas unitarias",
            "purpose": "Dominio y cálculos verificados con casos sembrados.",
            "when": "pruebas"
          }
        ],
        "testing": {
          "strategy": "Pruebas de dominio con dinero en enteros y prueba de venta sin red.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Totales, cortes y anulaciones",
              "tools": [
                "Suite del lenguaje"
              ],
              "notes": "Casos de redondeo"
            },
            {
              "kind": "functional",
              "scope": "Flujo de caja",
              "tools": [
                "Prueba manual guiada"
              ],
              "notes": "Sin red"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Venta en 10 s",
              "given": "Caja abierta",
              "when": "Venta de 3 líneas",
              "then": "Confirmada en menos de 10 s",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "RN-002",
              "title": "Totales exactos",
              "given": "Precios con decimales",
              "when": "100 ventas",
              "then": "Cero diferencias de redondeo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-002",
              "title": "Corte con diferencia",
              "given": "Turno con ventas",
              "when": "Cierre con contado menor",
              "then": "Diferencia reportada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "RN-001",
              "title": "Anulación con rastro",
              "given": "Venta activa",
              "when": "Anulación con clave",
              "then": "Registro conservado con motivo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-004",
              "title": "Venta sin red",
              "given": "Equipo sin conexión",
              "when": "Venta completa",
              "then": "Operación normal",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-003",
              "title": "Alerta de mínimo",
              "given": "Producto bajo mínimo",
              "when": "Se abre la app",
              "then": "Alerta visible con existencia",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Cajero sin anulación",
              "given": "Sesión de cajero",
              "when": "Intenta anular sin clave",
              "then": "Operación denegada y auditada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-006",
              "title": "Instalación limpia",
              "given": "Equipo sin la app",
              "when": "Instala y desinstala",
              "then": "Accesos creados y retirados sin restos",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Instalador probado en equipo limpio",
            "Corte de demostración cuadrado"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Instalador de escritorio",
            "kind": "instalacion",
            "format": "exe o msi",
            "audience": "Tienda",
            "contents": [
              "Instalador",
              "Accesos",
              "Desinstalador"
            ]
          },
          {
            "id": "dl-02",
            "title": "Manual de caja",
            "kind": "usuario",
            "format": "markdown",
            "audience": "Cajero",
            "contents": [
              "Venta",
              "Corte",
              "Anulación"
            ]
          },
          {
            "id": "dl-03",
            "title": "Informe de pruebas",
            "kind": "tecnico",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "Casos",
              "Resultados"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "El dinero se guarda en centavos enteros.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "El equipo de tienda puede apagarse sin cerrar caja.",
            "status": "resolved",
            "resolution": "Mitigado: recuperación de turno al abrir",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-08"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Venta y caja",
                    "Inventario mínimo",
                    "Roles y anulaciones"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-pack",
          "question_es": "¿Cómo se distribuye?",
          "question_en": "How is it distributed?",
          "options": [
            {
              "id": "installer",
              "label_es": "Instalador con accesos",
              "label_en": "Installer with shortcuts",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "deploy_strategy",
                  "value": "instalador firmado"
                }
              ]
            },
            {
              "id": "portable",
              "label_es": "Portable sin instalar",
              "label_en": "Portable, no install",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "deploy_strategy",
                  "value": "carpeta portable"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "desktop-flutter",
      "types": [
        "desktop"
      ],
      "name_es": "Escritorio Flutter de punto de venta",
      "name_en": "Flutter POS desktop",
      "summary_es": "Punto de venta de escritorio en Flutter con caja auditada e instalador propio.",
      "summary_en": "Flutter desktop POS with audited register and its own installer.",
      "expert_id": "dart-falcon",
      "skills": [
        "flutter-architecture",
        "state-management",
        "responsive-design",
        "accessibility-wcag"
      ],
      "pieces": [
        "flutter-feature-first",
        "flutter-repository-pattern",
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-pos-checkout",
        "m-settings-center",
        "m-admin-crud"
      ],
      "resources": [
        "tabler",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "Dart"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "desktop"
        ],
        "non_goals": [
          "Facturación fiscal",
          "Tienda en línea",
          "Multi-sucursal"
        ],
        "visual_style": "Denso y legible a distancia de mostrador",
        "asset_sources": [
          "Tabler Icons",
          "Google Fonts"
        ],
        "mockup": "m-pos-checkout"
      },
      "document": {
        "name": "Escritorio Flutter de punto de venta",
        "schema_version": 1,
        "identity": {
          "name": "Escritorio Flutter de punto de venta",
          "description": "Los puntos de venta pequeños dependen de hojas de cálculo y cajas que no cuadran.",
          "problem": "Los puntos de venta pequeños dependen de hojas de cálculo y cajas que no cuadran.",
          "vision": "Un punto de venta de escritorio que vende sin red, cuadra caja y deja rastro de todo.",
          "goals": [
            "Venta y caja",
            "Inventario mínimo"
          ],
          "specific_goals": [
            "Venta en menos de 10 s",
            "Cortes cuadrados o diferencia explicada",
            "Cero ventas perdidas"
          ],
          "users": [
            "Cajero de tienda",
            "Administrador del negocio"
          ],
          "use_cases": [
            "Venta rápida",
            "Caja y corte",
            "Inventario mínimo"
          ],
          "scope": [
            "Venta y caja",
            "Inventario mínimo",
            "Roles y anulaciones",
            "Instalador propio"
          ],
          "out_of_scope": [
            "Facturación fiscal",
            "Tienda en línea",
            "Multi-sucursal"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Venta en menos de 10 s",
            "Cortes cuadrados o diferencia explicada",
            "Cero ventas perdidas"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Venta rápida",
            "statement": "El cajero registra ventas con búsqueda de producto y total inmediato.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Venta completa en menos de 10 s",
              "Total recalcula sin errores de redondeo"
            ],
            "links": [
              "process:p-01",
              "entity:venta"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Caja y corte",
            "statement": "La caja abre y cierra con corte ciego y diferencias reportadas.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Corte muestra esperado contra contado"
            ],
            "links": [
              "process:p-02",
              "entity:caja"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Inventario mínimo",
            "statement": "Existencias bajan con cada venta y avisan bajo mínimo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Alerta de mínimo visible al abrir"
            ],
            "links": [
              "process:p-01",
              "entity:producto"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Trabajo sin red",
            "statement": "Toda la operación funciona offline con base local.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cero dependencia de red para vender"
            ],
            "links": [
              "entity:venta"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "permission",
            "title": "Roles de tienda",
            "statement": "Cajero y administrador tienen permisos distintos y auditados.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cajero no anula ventas sin clave"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Anulación con rastro",
            "statement": "Anular una venta conserva el registro y su motivo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ninguna venta desaparece de la base"
            ],
            "links": [
              "entity:venta"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Dinero en enteros",
            "statement": "Los importes se guardan en centavos enteros, nunca en flotantes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Sin errores de redondeo en totales"
            ],
            "links": [
              "entity:venta"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "non_functional",
            "title": "Instalador con identidad",
            "statement": "La app se empaqueta como instalador de escritorio con accesos.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Instalación y desinstalación limpias"
            ],
            "links": []
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Tienda con conectividad irregular",
            "summary": "La red es opcional; la venta nunca se detiene.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Dinero exacto",
            "summary": "Centavos enteros eliminan una clase completa de errores.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "Dart",
          "framework": "Flutter desktop",
          "style": "Capas UI / dominio / SQLite",
          "database": "SQLite local",
          "data_access": "Repositorio con transacciones",
          "api_style": "ninguna",
          "auth": "Clave local por rol",
          "infrastructure": "Equipo de tienda",
          "hosting": "Instalador por equipo",
          "external_services": [],
          "dependencies": [
            "Flutter desktop",
            "SQLite"
          ],
          "environments": [
            "desarrollo",
            "tienda"
          ],
          "deploy_strategy": "instalador firmado"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Stack de escritorio",
            "choice": "Flutter desktop",
            "rationale": "Un solo código con el resto de productos Flutter.",
            "alternatives": [
              "Tauri",
              "Electron"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Representación de dinero",
            "choice": "Enteros en centavos",
            "rationale": "Exactitud decimal sin dependencias.",
            "alternatives": [
              "Decimal library",
              "Flotantes con redondeo"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "producto",
              "name": "producto",
              "description": "Artículo vendible con existencia.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio_centavos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "existencia",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "minimo",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "venta",
              "name": "venta",
              "description": "Venta con líneas y estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "caja_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "caja.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "total_centavos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "activa",
                    "anulada"
                  ]
                },
                {
                  "name": "motivo",
                  "data_type": "text",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "caja",
              "name": "caja",
              "description": "Turno de caja con corte.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "abierta_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cerrada_en",
                  "data_type": "timestamp",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Cajero o administrador.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": [
                    "cajero",
                    "admin"
                  ]
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "caja",
              "to": "venta",
              "label": "agrupa"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "caja",
              "label": "opera"
            }
          ],
          "seed_data": [
            "Productos de demostración con mínimos",
            "Usuario administrador inicial"
          ],
          "migrations": [
            "v1: productos, ventas, cajas y usuarios"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Registrar venta",
            "summary": "Suma líneas, calcula total y descuenta existencias.",
            "trigger": "Confirmación del cajero",
            "inputs": [
              "líneas"
            ],
            "outputs": [
              "venta"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "recibir",
                  "variable": "lineas",
                  "source": "carrito"
                },
                {
                  "op": "consultar",
                  "target": "producto",
                  "query": "existencia >= cantidad",
                  "into": "disponibles"
                },
                {
                  "op": "si",
                  "condition": "todo_disponible",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "venta",
                      "value": "total_en_centavos(lineas)"
                    },
                    {
                      "op": "para_cada",
                      "variable": "l",
                      "collection": "lineas",
                      "body": [
                        {
                          "op": "guardar",
                          "target": "producto",
                          "value": "existencia - l.cantidad"
                        }
                      ]
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Existencia insuficiente",
                      "code": "SIN_EXISTENCIA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "SIN_EXISTENCIA"
            ],
            "rules": [
              "Importes en centavos enteros"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "requirement:RN-002",
              "entity:venta"
            ]
          },
          {
            "id": "p-02",
            "name": "Cerrar caja",
            "summary": "Compara esperado contra contado y guarda el corte.",
            "trigger": "Cierre de turno",
            "inputs": [
              "contado"
            ],
            "outputs": [
              "corte"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "venta",
                  "query": "del_turno",
                  "into": "esperado"
                },
                {
                  "op": "definir",
                  "variable": "diferencia",
                  "value": "contado - esperado"
                },
                {
                  "op": "guardar",
                  "target": "caja",
                  "value": "corte={esperado, contado, diferencia}"
                },
                {
                  "op": "si",
                  "condition": "diferencia != 0",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "caja",
                      "value": "diferencia_reportada"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "Diferencia se reporta, no se oculta"
            ],
            "rules": [],
            "links": [
              "requirement:FR-002",
              "entity:caja"
            ]
          },
          {
            "id": "p-03",
            "name": "Anular venta",
            "summary": "Marca la venta como anulada con motivo y usuario.",
            "trigger": "Solicitud con clave de administrador",
            "inputs": [
              "venta",
              "motivo"
            ],
            "outputs": [
              "venta anulada"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "venta",
                  "query": "id y estado",
                  "into": "v"
                },
                {
                  "op": "si",
                  "condition": "v.anulable",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "venta",
                      "value": "estado=anulada, motivo"
                    },
                    {
                      "op": "guardar",
                      "target": "producto",
                      "value": "existencia + lineas"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Venta no anulable",
                      "code": "NO_ANULABLE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "NO_ANULABLE"
            ],
            "rules": [],
            "links": [
              "requirement:RN-001",
              "entity:venta"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Capas del escritorio",
            "description": "Capas del escritorio",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "UI de caja",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Dominio de ventas",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "comandos",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "transacciones",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Denso y legible a distancia de mostrador",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Sans de alto contraste",
            "Números tabulares"
          ],
          "components": [
            "Teclado rápido de venta",
            "Tabla de corte"
          ],
          "navigation": "Pantalla única de caja con paneles laterales",
          "responsive_notes": "Objetivos táctiles grandes; atajos de teclado",
          "asset_sources": [
            "Tabler Icons",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-pos-checkout",
            "name": "Punto de venta",
            "screen": "Caja y venta",
            "notes": "Base del flujo de venta"
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Ajustes de tienda",
            "notes": "Roles y mínimos"
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Administración general",
            "screen": "Productos y reportes",
            "notes": "Altas y cortes"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "flutter-architecture",
            "name": "Arquitectura Flutter",
            "purpose": "Features aisladas, testeables y sin fugas de UI.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "state-management",
            "name": "Gestión de estado",
            "purpose": "Estado predecible y reconstruible tras rotación o muerte.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "responsive-design",
            "name": "Diseño responsivo",
            "purpose": "Una base de código legible en móvil, tableta y escritorio.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "accessibility-wcag",
            "name": "Accesibilidad WCAG",
            "purpose": "Contraste, foco y lectores de pantalla desde el inicio.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de dominio con dinero en enteros y prueba de venta sin red.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Totales, cortes y anulaciones",
              "tools": [
                "Suite del lenguaje"
              ],
              "notes": "Casos de redondeo"
            },
            {
              "kind": "functional",
              "scope": "Flujo de caja",
              "tools": [
                "Prueba manual guiada"
              ],
              "notes": "Sin red"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Venta en 10 s",
              "given": "Caja abierta",
              "when": "Venta de 3 líneas",
              "then": "Confirmada en menos de 10 s",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "RN-002",
              "title": "Totales exactos",
              "given": "Precios con decimales",
              "when": "100 ventas",
              "then": "Cero diferencias de redondeo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-002",
              "title": "Corte con diferencia",
              "given": "Turno con ventas",
              "when": "Cierre con contado menor",
              "then": "Diferencia reportada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "RN-001",
              "title": "Anulación con rastro",
              "given": "Venta activa",
              "when": "Anulación con clave",
              "then": "Registro conservado con motivo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-004",
              "title": "Venta sin red",
              "given": "Equipo sin conexión",
              "when": "Venta completa",
              "then": "Operación normal",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-003",
              "title": "Alerta de mínimo",
              "given": "Producto bajo mínimo",
              "when": "Se abre la app",
              "then": "Alerta visible con existencia",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-005",
              "title": "Cajero sin anulación",
              "given": "Sesión de cajero",
              "when": "Intenta anular sin clave",
              "then": "Operación denegada y auditada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-006",
              "title": "Instalación limpia",
              "given": "Equipo sin la app",
              "when": "Instala y desinstala",
              "then": "Accesos creados y retirados sin restos",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Instalador probado en equipo limpio",
            "Corte de demostración cuadrado"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Instalador de escritorio",
            "kind": "instalacion",
            "format": "exe o msi",
            "audience": "Tienda",
            "contents": [
              "Instalador",
              "Accesos",
              "Desinstalador"
            ]
          },
          {
            "id": "dl-02",
            "title": "Manual de caja",
            "kind": "usuario",
            "format": "markdown",
            "audience": "Cajero",
            "contents": [
              "Venta",
              "Corte",
              "Anulación"
            ]
          },
          {
            "id": "dl-03",
            "title": "Informe de pruebas",
            "kind": "tecnico",
            "format": "markdown",
            "audience": "Desarrollador",
            "contents": [
              "Casos",
              "Resultados"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "El dinero se guarda en centavos enteros.",
            "status": "resolved",
            "resolution": "Aceptado en dec-02",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "El equipo de tienda puede apagarse sin cerrar caja.",
            "status": "resolved",
            "resolution": "Mitigado: recuperación de turno al abrir",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-08"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Venta y caja",
                    "Inventario mínimo",
                    "Roles y anulaciones"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-pack",
          "question_es": "¿Cómo se distribuye?",
          "question_en": "How is it distributed?",
          "options": [
            {
              "id": "installer",
              "label_es": "Instalador con accesos",
              "label_en": "Installer with shortcuts",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "deploy_strategy",
                  "value": "instalador firmado"
                }
              ]
            },
            {
              "id": "portable",
              "label_es": "Portable sin instalar",
              "label_en": "Portable, no install",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "deploy_strategy",
                  "value": "carpeta portable"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "dashboard-finanzas",
      "types": [
        "gestión",
        "finanzas"
      ],
      "name_es": "Tablero financiero con auditoría",
      "name_en": "Audited finance dashboard",
      "summary_es": "Tablero de cifras conciliadas con auditoría inmutable y periodos cerrados.",
      "summary_en": "Dashboard of reconciled figures with immutable audit and closed periods.",
      "expert_id": "fint-sterling",
      "skills": [
        "domain-driven-design",
        "transactions-isolation",
        "data-modeling",
        "error-handling-design"
      ],
      "pieces": [
        "postgres-multitenant-schema",
        "auth-jwt-express",
        "pagination-cursor-sql",
        "error-envelope-rest"
      ],
      "mockups": [
        "m-report-dashboard",
        "m-pos-checkout",
        "m-admin-crud"
      ],
      "resources": [
        "tabler",
        "lucide",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "TypeScript"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "gestión",
          "finanzas"
        ],
        "non_goals": [
          "Predicción automática",
          "Integración bancaria o de paquetería",
          "App móvil nativa"
        ],
        "visual_style": "Sobrio y numérico, con semáforos de estado",
        "asset_sources": [
          "Tabler Icons",
          "Google Fonts"
        ],
        "mockup": "m-report-dashboard"
      },
      "document": {
        "name": "Tablero financiero con auditoría",
        "schema_version": 1,
        "identity": {
          "name": "Tablero financiero con auditoría",
          "description": "Los tableros de gestión mienten cuando las cifras no concilian con su detalle.",
          "problem": "Los tableros de gestión mienten cuando las cifras no concilian con su detalle.",
          "vision": "Un tablero donde cada cifra se puede abrir, conciliar y auditar hasta su origen.",
          "goals": [
            "Indicadores conciliados",
            "Auditoría de cambios"
          ],
          "specific_goals": [
            "Cero cifras sin conciliar",
            "Exportación en menos de 5 s",
            "Auditoría completa al 100%"
          ],
          "users": [
            "Dirección del negocio",
            "Responsable de unidad"
          ],
          "use_cases": [
            "Indicadores en vivo",
            "Registro auditado",
            "Exportables presentables"
          ],
          "scope": [
            "Indicadores conciliados",
            "Auditoría de cambios",
            "Exportables",
            "Alertas por umbral"
          ],
          "out_of_scope": [
            "Predicción automática",
            "Integración bancaria o de paquetería",
            "App móvil nativa"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero cifras sin conciliar",
            "Exportación en menos de 5 s",
            "Auditoría completa al 100%"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Indicadores en vivo",
            "statement": "El tablero muestra indicadores calculados con filtro por periodo y unidad.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cifras coinciden con el detalle subyacente"
            ],
            "links": [
              "process:p-01",
              "entity:movimiento"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Registro auditado",
            "statement": "Todo alta o cambio guarda quién, cuándo y valor anterior.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Auditoría consultable por registro"
            ],
            "links": [
              "process:p-02",
              "entity:auditoria"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Exportables presentables",
            "statement": "Los reportes se exportan con formato listo para compartir.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Exportación incluye periodo y filtros"
            ],
            "links": [
              "process:p-03"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "permission",
            "title": "Vistas por rol",
            "statement": "Dirección ve todo; unidad ve solo lo suyo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Unidad no ve cifras de otra unidad"
            ],
            "links": [
              "entity:unidad"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Alertas por umbral",
            "statement": "El sistema alerta cuando un indicador cruza su umbral configurado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Alerta con valor y umbral visibles"
            ],
            "links": [
              "process:p-01"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Cifras conciliadas",
            "statement": "Ningún indicador se publica si su detalle no concilia.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Conciliación bloquea publicación"
            ],
            "links": [
              "entity:movimiento"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Periodos cerrados",
            "statement": "Un periodo cerrado no admite cambios sin reapertura auditada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Reapertura queda en auditoría"
            ],
            "links": [
              "entity:periodo"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Comparativo entre periodos",
            "statement": "El tablero compara periodos con variación absoluta y porcentual.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Variación coincide con cifras publicadas"
            ],
            "links": [
              "mockup:m-report-dashboard"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Gestión por unidades",
            "summary": "Cada unidad responde por sus cifras; dirección consolida.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Periodos cerrados",
            "summary": "Cerrar un periodo congela el pasado y obliga a auditar reaperturas.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "TypeScript",
          "framework": "Express + React",
          "style": "Capas con dominio de conciliación",
          "database": "PostgreSQL",
          "data_access": "Repositorio con agregaciones explícitas",
          "api_style": "REST JSON",
          "auth": "Sesión con roles y unidad",
          "infrastructure": "Contenedor",
          "hosting": "VPS con HTTPS",
          "external_services": [],
          "dependencies": [
            "PostgreSQL",
            "React"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI con migraciones"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Fuente de cifras",
            "choice": "Agregación sobre detalle conciliado",
            "rationale": "La cifra nunca se escribe a mano: se calcula.",
            "alternatives": [
              "Cifras cargadas manualmente",
              "Vistas materializadas sin conciliación"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Auditoría",
            "choice": "Tabla inmutable en la misma transacción",
            "rationale": "El rastro no puede perderse ni editarse.",
            "alternatives": [
              "Log externo",
              "Triggers diferidos"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "movimiento",
              "name": "movimiento",
              "description": "Movimiento financiero",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "unidad_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "unidad.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "periodo_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "periodo.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "importe_centavos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "registrado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "periodo_id",
                "unidad_id"
              ],
              "rules": []
            },
            {
              "id": "unidad",
              "name": "unidad",
              "description": "Unidad de negocio o ruta.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "periodo",
              "name": "periodo",
              "description": "Periodo contable o de operación.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "etiqueta",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cerrado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "auditoria",
              "name": "auditoria",
              "description": "Rastro inmutable de cambios.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "registro_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "antes",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "despues",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "alerta",
              "name": "alerta",
              "description": "Aviso de umbral cruzado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indicador",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "umbral",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Persona con rol y unidad.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "unidad_id",
                  "data_type": "uuid",
                  "nullable": true,
                  "key": "foreign",
                  "references": "unidad.id",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "unidad",
              "to": "movimiento",
              "label": "acumula"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "periodo",
              "to": "movimiento",
              "label": "agrupa"
            }
          ],
          "seed_data": [
            "Unidades y periodos de demostración",
            "Detalle sembrado que concilia"
          ],
          "migrations": [
            "v1: unidades, periodos, detalle y auditoría"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Calcular indicadores",
            "summary": "Agrega el detalle del periodo y evalúa umbrales.",
            "trigger": "Cambio de filtro o nuevo registro",
            "inputs": [
              "periodo",
              "unidad"
            ],
            "outputs": [
              "indicadores",
              "alertas"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "movimiento",
                  "query": "periodo y unidad",
                  "into": "detalle"
                },
                {
                  "op": "si",
                  "condition": "concilia(detalle)",
                  "then_body": [
                    {
                      "op": "definir",
                      "variable": "indicadores",
                      "value": "agregar(detalle)"
                    },
                    {
                      "op": "para_cada",
                      "variable": "i",
                      "collection": "indicadores",
                      "body": [
                        {
                          "op": "si",
                          "condition": "i.cruza_umbral",
                          "then_body": [
                            {
                              "op": "guardar",
                              "target": "alerta",
                              "value": "i.valor y i.umbral"
                            }
                          ]
                        }
                      ]
                    },
                    {
                      "op": "devolver",
                      "value": "indicadores"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Detalle no concilia",
                      "code": "NO_CONCILIA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "NO_CONCILIA bloquea publicación"
            ],
            "rules": [],
            "links": [
              "requirement:FR-001",
              "requirement:FR-005",
              "requirement:RN-001",
              "entity:movimiento"
            ]
          },
          {
            "id": "p-02",
            "name": "Registrar con auditoría",
            "summary": "Guarda el cambio y su rastro de quién y valor anterior.",
            "trigger": "Alta o edición",
            "inputs": [
              "registro",
              "usuario"
            ],
            "outputs": [
              "registro",
              "auditoría"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "movimiento",
                  "query": "valor_anterior",
                  "into": "antes"
                },
                {
                  "op": "guardar",
                  "target": "movimiento",
                  "value": "registro"
                },
                {
                  "op": "guardar",
                  "target": "auditoria",
                  "value": "{usuario, ahora, antes, despues}"
                }
              ]
            },
            "errors": [],
            "rules": [
              "Auditoría en la misma transacción"
            ],
            "links": [
              "requirement:FR-002",
              "entity:auditoria"
            ]
          },
          {
            "id": "p-03",
            "name": "Exportar reporte",
            "summary": "Genera el exportable con periodo, filtros y cifras conciliadas.",
            "trigger": "Solicitud de exportación",
            "inputs": [
              "periodo",
              "filtros"
            ],
            "outputs": [
              "archivo"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "llamar",
                  "process": "Calcular indicadores",
                  "args": [
                    "periodo",
                    "filtros"
                  ],
                  "into": "cifras"
                },
                {
                  "op": "guardar",
                  "target": "archivo",
                  "value": "formatear(cifras, periodo, filtros)"
                },
                {
                  "op": "devolver",
                  "value": "reporte"
                }
              ]
            },
            "errors": [
              "Sin conciliación no hay exportación"
            ],
            "rules": [],
            "links": [
              "requirement:FR-003"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "architecture",
            "title": "Capas del tablero",
            "description": "Capas del tablero",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "Tablero React",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Dominio de conciliación",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "consultas",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "detalle y auditoría",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Sobrio y numérico, con semáforos de estado",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Números tabulares",
            "Sans compacta"
          ],
          "components": [
            "Tarjetas de indicador",
            "Tabla de detalle conciliable"
          ],
          "navigation": "Navegación por indicadores, detalle y auditoría",
          "responsive_notes": "Tablas con columnas fijas y scroll horizontal",
          "asset_sources": [
            "Tabler Icons",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-report-dashboard",
            "name": "Panel de indicadores",
            "screen": "Tablero principal",
            "notes": "Indicadores y comparativos"
          },
          {
            "mockup_id": "m-pos-checkout",
            "name": "Punto de venta",
            "screen": "Registro de movimientos",
            "notes": "Altas con auditoría"
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Administración general",
            "screen": "Unidades y periodos",
            "notes": "Cierre y reapertura"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "domain-driven-design",
            "name": "Diseño guiado por dominio",
            "purpose": "Reglas de negocio explícitas y lenguaje compartido.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "transactions-isolation",
            "name": "Transacciones y aislamiento",
            "purpose": "Operaciones compuestas atómicas sin estados a medias.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "data-modeling",
            "name": "Modelado de datos",
            "purpose": "Entidades y relaciones que sostienen los procesos.",
            "when": "diseño"
          },
          {
            "id": "sk-04",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Sobre uniforme, códigos estables y mensajes accionables.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de conciliación con detalle sembrado y de permisos por unidad.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Conciliación y umbrales",
              "tools": [
                "Suite del lenguaje"
              ],
              "notes": "Detalle sembrado"
            },
            {
              "kind": "integration",
              "scope": "API y auditoría",
              "tools": [
                "Suite de integración"
              ],
              "notes": "Transacciones reales"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "RN-001",
              "title": "Conciliación bloquea",
              "given": "Detalle con diferencia",
              "when": "Se intenta publicar",
              "then": "Publicación bloqueada con motivo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Auditoría completa",
              "given": "Registro editado",
              "when": "Se consulta auditoría",
              "then": "Quién, cuándo y valores visibles",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-004",
              "title": "Vista por unidad",
              "given": "Sesión de unidad",
              "when": "Abre tablero",
              "then": "Solo cifras propias",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-005",
              "title": "Alerta por umbral",
              "given": "Indicador sobre umbral",
              "when": "Recalculo",
              "then": "Alerta con valor y umbral",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Comparativo o mapa",
              "given": "Dos periodos",
              "when": "Se abre la vista",
              "then": "Cifras o posiciones correctas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-001",
              "title": "Cifra abre su detalle",
              "given": "Indicador publicado",
              "when": "Se abre el detalle",
              "then": "Suma del detalle igual a la cifra",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-003",
              "title": "Exportable con filtros",
              "given": "Periodo filtrado",
              "when": "Se exporta",
              "then": "Archivo con periodo y filtros visibles",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Periodo cerrado protegido",
              "given": "Periodo cerrado",
              "when": "Se intenta editar",
              "then": "Cambio rechazado sin reapertura auditada",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Conciliación probada con diferencias",
            "Exportables revisados a ojo"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Tablero desplegable",
            "kind": "despliegue",
            "format": "contenedor",
            "audience": "Operador",
            "contents": [
              "Build",
              "Migraciones",
              "Guía"
            ]
          },
          {
            "id": "dl-02",
            "title": "Reportes de ejemplo",
            "kind": "usuario",
            "format": "xlsx y pdf",
            "audience": "Dirección",
            "contents": [
              "Periodo",
              "Filtros",
              "Cifras"
            ]
          },
          {
            "id": "dl-03",
            "title": "Diccionario de indicadores",
            "kind": "arquitectura",
            "format": "markdown",
            "audience": "Dirección",
            "contents": [
              "Definiciones",
              "Umbrales"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "Las cifras se calculan, nunca se capturan a mano.",
            "status": "resolved",
            "resolution": "Aceptado en dec-01",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "Reaperturas de periodo pueden usarse para maquillar cifras.",
            "status": "resolved",
            "resolution": "Mitigado: reapertura auditada y visible",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Indicadores conciliados",
                    "Auditoría de cambios",
                    "Exportables"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-tenant",
          "question_es": "¿Varias unidades de negocio?",
          "question_en": "Several business units?",
          "options": [
            {
              "id": "multi",
              "label_es": "Varias unidades con vistas propias",
              "label_en": "Several units with own views",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "style",
                  "value": "Capas con dominio de conciliación por unidad"
                }
              ]
            },
            {
              "id": "single",
              "label_es": "Una sola unidad",
              "label_en": "A single unit",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "style",
                  "value": "Capas con dominio de conciliación único"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "dashboard-logistica",
      "types": [
        "gestión",
        "logística"
      ],
      "name_es": "Tablero logístico de envíos",
      "name_en": "Logistics shipping dashboard",
      "summary_es": "Tablero de envíos con seguimiento, costos conciliados y alertas por umbral.",
      "summary_en": "Shipping dashboard with tracking, reconciled costs and threshold alerts.",
      "expert_id": "logis-truck",
      "skills": [
        "data-modeling",
        "query-optimization",
        "transactions-isolation",
        "error-handling-design"
      ],
      "pieces": [
        "postgres-multitenant-schema",
        "pagination-cursor-sql",
        "sqlalchemy-repository",
        "auth-jwt-express"
      ],
      "mockups": [
        "m-logistics-tracking",
        "m-report-dashboard",
        "m-admin-crud"
      ],
      "resources": [
        "tabler",
        "lucide"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "TypeScript"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "gestión",
          "logística"
        ],
        "non_goals": [
          "Predicción automática",
          "Integración bancaria o de paquetería",
          "App móvil nativa"
        ],
        "visual_style": "Sobrio y numérico, con semáforos de estado",
        "asset_sources": [
          "Tabler Icons",
          "Google Fonts"
        ],
        "mockup": "m-logistics-tracking"
      },
      "document": {
        "name": "Tablero logístico de envíos",
        "schema_version": 1,
        "identity": {
          "name": "Tablero logístico de envíos",
          "description": "Los tableros de gestión mienten cuando las cifras no concilian con su detalle.",
          "problem": "Los tableros de gestión mienten cuando las cifras no concilian con su detalle.",
          "vision": "Un tablero donde cada cifra se puede abrir, conciliar y auditar hasta su origen.",
          "goals": [
            "Indicadores conciliados",
            "Auditoría de cambios"
          ],
          "specific_goals": [
            "Cero cifras sin conciliar",
            "Exportación en menos de 5 s",
            "Auditoría completa al 100%"
          ],
          "users": [
            "Dirección del negocio",
            "Responsable de unidad"
          ],
          "use_cases": [
            "Indicadores en vivo",
            "Registro auditado",
            "Exportables presentables"
          ],
          "scope": [
            "Indicadores conciliados",
            "Auditoría de cambios",
            "Exportables",
            "Alertas por umbral"
          ],
          "out_of_scope": [
            "Predicción automática",
            "Integración bancaria o de paquetería",
            "App móvil nativa"
          ],
          "constraints": [
            "Sin datos reales de pacientes o clientes en el repositorio",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero cifras sin conciliar",
            "Exportación en menos de 5 s",
            "Auditoría completa al 100%"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Indicadores en vivo",
            "statement": "El tablero muestra indicadores calculados con filtro por periodo y unidad.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cifras coinciden con el detalle subyacente"
            ],
            "links": [
              "process:p-01",
              "entity:envio"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Registro auditado",
            "statement": "Todo alta o cambio guarda quién, cuándo y valor anterior.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Auditoría consultable por registro"
            ],
            "links": [
              "process:p-02",
              "entity:auditoria"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Exportables presentables",
            "statement": "Los reportes se exportan con formato listo para compartir.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Exportación incluye periodo y filtros"
            ],
            "links": [
              "process:p-03"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "permission",
            "title": "Vistas por rol",
            "statement": "Dirección ve todo; unidad ve solo lo suyo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Unidad no ve cifras de otra unidad"
            ],
            "links": [
              "entity:unidad"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Alertas por umbral",
            "statement": "El sistema alerta cuando un indicador cruza su umbral configurado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Alerta con valor y umbral visibles"
            ],
            "links": [
              "process:p-01"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Cifras conciliadas",
            "statement": "Ningún indicador se publica si su detalle no concilia.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Conciliación bloquea publicación"
            ],
            "links": [
              "entity:envio"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Periodos cerrados",
            "statement": "Un periodo cerrado no admite cambios sin reapertura auditada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Reapertura queda en auditoría"
            ],
            "links": [
              "entity:periodo"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Seguimiento en mapa",
            "statement": "El tablero muestra seguimiento de envíos en mapa.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Variación coincide con cifras publicadas"
            ],
            "links": [
              "mockup:m-logistics-tracking"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Gestión por unidades",
            "summary": "Cada unidad responde por sus cifras; dirección consolida.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Periodos cerrados",
            "summary": "Cerrar un periodo congela el pasado y obliga a auditar reaperturas.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "TypeScript",
          "framework": "FastAPI + React",
          "style": "Capas con dominio de conciliación",
          "database": "PostgreSQL",
          "data_access": "Repositorio con agregaciones explícitas",
          "api_style": "REST JSON",
          "auth": "Sesión con roles y unidad",
          "infrastructure": "Contenedor",
          "hosting": "VPS con HTTPS",
          "external_services": [],
          "dependencies": [
            "PostgreSQL",
            "React"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI con migraciones"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Fuente de cifras",
            "choice": "Agregación sobre detalle conciliado",
            "rationale": "La cifra nunca se escribe a mano: se calcula.",
            "alternatives": [
              "Cifras cargadas manualmente",
              "Vistas materializadas sin conciliación"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Auditoría",
            "choice": "Tabla inmutable en la misma transacción",
            "rationale": "El rastro no puede perderse ni editarse.",
            "alternatives": [
              "Log externo",
              "Triggers diferidos"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "envio",
              "name": "envio",
              "description": "Envío con estados y tiempos.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "unidad_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "unidad.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "periodo_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "periodo.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "costo_centavos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "registrado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "periodo_id",
                "unidad_id"
              ],
              "rules": []
            },
            {
              "id": "unidad",
              "name": "unidad",
              "description": "Unidad de negocio o ruta.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "periodo",
              "name": "periodo",
              "description": "Periodo contable o de operación.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "etiqueta",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cerrado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "auditoria",
              "name": "auditoria",
              "description": "Rastro inmutable de cambios.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "registro_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "antes",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "despues",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "alerta",
              "name": "alerta",
              "description": "Aviso de umbral cruzado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indicador",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "umbral",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Persona con rol y unidad.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "unidad_id",
                  "data_type": "uuid",
                  "nullable": true,
                  "key": "foreign",
                  "references": "unidad.id",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": []
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "unidad",
              "to": "envio",
              "label": "acumula"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "periodo",
              "to": "envio",
              "label": "agrupa"
            }
          ],
          "seed_data": [
            "Unidades y periodos de demostración",
            "Detalle sembrado que concilia"
          ],
          "migrations": [
            "v1: unidades, periodos, detalle y auditoría"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Calcular indicadores",
            "summary": "Agrega el detalle del periodo y evalúa umbrales.",
            "trigger": "Cambio de filtro o nuevo registro",
            "inputs": [
              "periodo",
              "unidad"
            ],
            "outputs": [
              "indicadores",
              "alertas"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "envio",
                  "query": "periodo y unidad",
                  "into": "detalle"
                },
                {
                  "op": "si",
                  "condition": "concilia(detalle)",
                  "then_body": [
                    {
                      "op": "definir",
                      "variable": "indicadores",
                      "value": "agregar(detalle)"
                    },
                    {
                      "op": "para_cada",
                      "variable": "i",
                      "collection": "indicadores",
                      "body": [
                        {
                          "op": "si",
                          "condition": "i.cruza_umbral",
                          "then_body": [
                            {
                              "op": "guardar",
                              "target": "alerta",
                              "value": "i.valor y i.umbral"
                            }
                          ]
                        }
                      ]
                    },
                    {
                      "op": "devolver",
                      "value": "indicadores"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Detalle no concilia",
                      "code": "NO_CONCILIA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "NO_CONCILIA bloquea publicación"
            ],
            "rules": [],
            "links": [
              "requirement:FR-001",
              "requirement:FR-005",
              "requirement:RN-001",
              "entity:envio"
            ]
          },
          {
            "id": "p-02",
            "name": "Registrar con auditoría",
            "summary": "Guarda el cambio y su rastro de quién y valor anterior.",
            "trigger": "Alta o edición",
            "inputs": [
              "registro",
              "usuario"
            ],
            "outputs": [
              "registro",
              "auditoría"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "envio",
                  "query": "valor_anterior",
                  "into": "antes"
                },
                {
                  "op": "guardar",
                  "target": "envio",
                  "value": "registro"
                },
                {
                  "op": "guardar",
                  "target": "auditoria",
                  "value": "{usuario, ahora, antes, despues}"
                }
              ]
            },
            "errors": [],
            "rules": [
              "Auditoría en la misma transacción"
            ],
            "links": [
              "requirement:FR-002",
              "entity:auditoria"
            ]
          },
          {
            "id": "p-03",
            "name": "Exportar reporte",
            "summary": "Genera el exportable con periodo, filtros y cifras conciliadas.",
            "trigger": "Solicitud de exportación",
            "inputs": [
              "periodo",
              "filtros"
            ],
            "outputs": [
              "archivo"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "llamar",
                  "process": "Calcular indicadores",
                  "args": [
                    "periodo",
                    "filtros"
                  ],
                  "into": "cifras"
                },
                {
                  "op": "guardar",
                  "target": "archivo",
                  "value": "formatear(cifras, periodo, filtros)"
                },
                {
                  "op": "devolver",
                  "value": "reporte"
                }
              ]
            },
            "errors": [
              "Sin conciliación no hay exportación"
            ],
            "rules": [],
            "links": [
              "requirement:FR-003"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "architecture",
            "title": "Capas del tablero",
            "description": "Capas del tablero",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "Tablero React",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "Dominio de conciliación",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "consultas",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "detalle y auditoría",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Sobrio y numérico, con semáforos de estado",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y estados pendientes"
            }
          ],
          "typography": [
            "Números tabulares",
            "Sans compacta"
          ],
          "components": [
            "Tarjetas de indicador",
            "Tabla de detalle conciliable"
          ],
          "navigation": "Navegación por indicadores, detalle y auditoría",
          "responsive_notes": "Tablas con columnas fijas y scroll horizontal",
          "asset_sources": [
            "Tabler Icons",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-logistics-tracking",
            "name": "Seguimiento de envíos",
            "screen": "Mapa y estados",
            "notes": "Seguimiento operativo"
          },
          {
            "mockup_id": "m-report-dashboard",
            "name": "Panel de indicadores",
            "screen": "Tablero principal",
            "notes": "Costos y tiempos"
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Administración general",
            "screen": "Unidades y periodos",
            "notes": "Cierre y reapertura"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "data-modeling",
            "name": "Modelado de datos",
            "purpose": "Entidades y relaciones que sostienen los procesos.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "query-optimization",
            "name": "Optimización de consultas",
            "purpose": "Agregaciones rápidas con volumen real.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "transactions-isolation",
            "name": "Transacciones y aislamiento",
            "purpose": "Operaciones compuestas atómicas sin estados a medias.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Sobre uniforme, códigos estables y mensajes accionables.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas de conciliación con detalle sembrado y de permisos por unidad.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Conciliación y umbrales",
              "tools": [
                "Suite del lenguaje"
              ],
              "notes": "Detalle sembrado"
            },
            {
              "kind": "integration",
              "scope": "API y auditoría",
              "tools": [
                "Suite de integración"
              ],
              "notes": "Transacciones reales"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "RN-001",
              "title": "Conciliación bloquea",
              "given": "Detalle con diferencia",
              "when": "Se intenta publicar",
              "then": "Publicación bloqueada con motivo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Auditoría completa",
              "given": "Registro editado",
              "when": "Se consulta auditoría",
              "then": "Quién, cuándo y valores visibles",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-004",
              "title": "Vista por unidad",
              "given": "Sesión de unidad",
              "when": "Abre tablero",
              "then": "Solo cifras propias",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-005",
              "title": "Alerta por umbral",
              "given": "Indicador sobre umbral",
              "when": "Recalculo",
              "then": "Alerta con valor y umbral",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-006",
              "title": "Comparativo o mapa",
              "given": "Envíos activos",
              "when": "Se abre la vista",
              "then": "Cifras o posiciones correctas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-001",
              "title": "Cifra abre su detalle",
              "given": "Indicador publicado",
              "when": "Se abre el detalle",
              "then": "Suma del detalle igual a la cifra",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-003",
              "title": "Exportable con filtros",
              "given": "Periodo filtrado",
              "when": "Se exporta",
              "then": "Archivo con periodo y filtros visibles",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "RN-002",
              "title": "Periodo cerrado protegido",
              "given": "Periodo cerrado",
              "when": "Se intenta editar",
              "then": "Cambio rechazado sin reapertura auditada",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80% en dominio y procesos críticos",
          "definition_of_done": [
            "Criterios en verde",
            "Conciliación probada con diferencias",
            "Exportables revisados a ojo"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Tablero desplegable",
            "kind": "despliegue",
            "format": "contenedor",
            "audience": "Operador",
            "contents": [
              "Build",
              "Migraciones",
              "Guía"
            ]
          },
          {
            "id": "dl-02",
            "title": "Reportes de ejemplo",
            "kind": "usuario",
            "format": "xlsx y pdf",
            "audience": "Dirección",
            "contents": [
              "Periodo",
              "Filtros",
              "Cifras"
            ]
          },
          {
            "id": "dl-03",
            "title": "Diccionario de indicadores",
            "kind": "arquitectura",
            "format": "markdown",
            "audience": "Dirección",
            "contents": [
              "Definiciones",
              "Umbrales"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Saltar criterios de aceptación",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar nombres y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "Las cifras se calculan, nunca se capturan a mano.",
            "status": "resolved",
            "resolution": "Aceptado en dec-01",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "Reaperturas de periodo pueden usarse para maquillar cifras.",
            "status": "resolved",
            "resolution": "Mitigado: reapertura auditada y visible",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-006"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-05"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Indicadores conciliados",
                    "Auditoría de cambios",
                    "Exportables"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-tenant",
          "question_es": "¿Varias unidades de negocio?",
          "question_en": "Several business units?",
          "options": [
            {
              "id": "multi",
              "label_es": "Varias unidades con vistas propias",
              "label_en": "Several units with own views",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "style",
                  "value": "Capas con dominio de conciliación por unidad"
                }
              ]
            },
            {
              "id": "single",
              "label_es": "Una sola unidad",
              "label_en": "A single unit",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "style",
                  "value": "Capas con dominio de conciliación único"
                }
              ]
            }
          ],
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it."
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "crm-pyme",
      "types": [
        "gestión",
        "web"
      ],
      "name_es": "CRM pyme con pipeline de ventas",
      "name_en": "Small-business CRM with sales pipeline",
      "summary_es": "Cartera de clientes y contactos con oportunidades por etapas, actividades y pronóstico ponderado.",
      "summary_en": "Client and contact book with staged opportunities, activities and weighted forecast.",
      "expert_id": "ada-crudwell",
      "skills": [
        "rest-api-design",
        "data-modeling",
        "authentication-authorization",
        "error-handling-design",
        "unit-testing"
      ],
      "pieces": [
        "node-express-rest-base",
        "auth-jwt-express",
        "prisma-data-access",
        "error-envelope-rest",
        "pagination-cursor-sql"
      ],
      "mockups": [
        "m-crm-contacts",
        "m-kanban-board",
        "m-report-dashboard"
      ],
      "resources": [
        "tabler",
        "lucide",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "TypeScript"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "gestión",
          "web"
        ],
        "non_goals": [
          "Facturación y cobros",
          "Campañas de email masivo",
          "App móvil nativa"
        ],
        "visual_style": "Limpio y comercial, con color por etapa y estados siempre visibles",
        "asset_sources": [
          "Tabler Icons",
          "Google Fonts"
        ],
        "mockup": "m-crm-contacts"
      },
      "document": {
        "name": "CRM pyme con pipeline de ventas",
        "schema_version": 1,
        "identity": {
          "name": "CRM pyme con pipeline de ventas",
          "description": "Las pymes pierden ventas porque su cartera vive en hojas de cálculo, correos y cabezas distintas.",
          "problem": "La información comercial está dispersa: nadie sabe qué se prometió a cada cliente ni qué oportunidades siguen vivas.",
          "vision": "Un CRM pequeño donde cada cliente tiene su historia, cada oportunidad su etapa y cada pronóstico su cálculo.",
          "goals": [
            "Cartera única de clientes y contactos",
            "Pipeline de ventas visible",
            "Pronóstico calculado, no estimado a ojo"
          ],
          "specific_goals": [
            "Alta de cliente con contacto en menos de 1 min",
            "Mover una oportunidad de etapa en un solo gesto",
            "Pronóstico del mes visible al abrir el tablero"
          ],
          "users": [
            "Vendedor de una pyme (5-30 empleados)",
            "Gerente que revisa el pipeline y el pronóstico"
          ],
          "use_cases": [
            "Registrar una llamada o visita tras cada contacto",
            "Revisar el pipeline semanal por etapa",
            "Cerrar el mes con pronóstico ponderado"
          ],
          "scope": [
            "Cartera de clientes y contactos",
            "Oportunidades con pipeline por etapas",
            "Actividades e historial",
            "Pronóstico ponderado",
            "Etiquetas y segmentación"
          ],
          "out_of_scope": [
            "Facturación y cobros",
            "Campañas de email masivo",
            "App móvil nativa"
          ],
          "constraints": [
            "Sin datos reales de clientes en el repositorio",
            "Importes siempre en céntimos enteros",
            "Toda entrega se verifica contra los criterios de aceptación"
          ],
          "success_metrics": [
            "Cero oportunidades abiertas sin responsable",
            "Pronóstico cuadra con la suma ponderada del detalle",
            "Historial completo en el 100 % de los cambios de etapa"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Cartera de clientes",
            "statement": "El CRM permite crear, editar y archivar clientes (empresas) con NIF único y propietario asignado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se admiten dos clientes con el mismo NIF",
              "Un cliente archivado sale de las listas activas sin perder su historial"
            ],
            "links": [
              "entity:cliente",
              "mockup:m-crm-contacts"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Contactos por cliente",
            "statement": "Cada cliente admite varios contactos con nombre, correo, teléfono y cargo; uno puede marcarse como principal.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un contacto siempre pertenece a un cliente existente",
              "Solo un contacto principal por cliente"
            ],
            "links": [
              "entity:contacto",
              "entity:cliente"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Oportunidades de venta",
            "statement": "Se crean oportunidades con título, importe en céntimos, cliente, responsable y fecha prevista de cierre.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Toda oportunidad nace en la primera etapa del pipeline",
              "El importe se muestra en euros pero se guarda en céntimos"
            ],
            "links": [
              "entity:oportunidad",
              "requirement:RN-003"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Pipeline por etapas",
            "statement": "Las oportunidades se ven en un tablero por etapas y se mueven de etapa arrastrando; cada movimiento queda en el historial.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El tablero muestra importe y responsable en cada tarjeta",
              "Cada cambio de etapa registra quién, cuándo, etapa origen y destino"
            ],
            "links": [
              "process:p-02",
              "entity:oportunidad",
              "mockup:m-kanban-board"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Registro de actividades",
            "statement": "Sobre un cliente u oportunidad se registran llamadas, visitas y tareas con fecha, autor y resultado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La actividad aparece en la ficha del cliente en orden cronológico",
              "Registrar una actividad actualiza la última interacción del cliente"
            ],
            "links": [
              "process:p-01",
              "entity:actividad"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pronóstico ponderado",
            "statement": "El tablero calcula el pronóstico como suma de importe por probabilidad de etapa de las oportunidades abiertas, con desglose por mes y responsable.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El pronóstico coincide con la suma ponderada del detalle",
              "Las oportunidades cerradas no suman al pronóstico"
            ],
            "links": [
              "process:p-03",
              "mockup:m-report-dashboard",
              "requirement:RN-002"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Búsqueda y filtros",
            "statement": "Clientes, contactos y oportunidades se buscan por nombre, correo o etiqueta con resultados paginados.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La búsqueda responde en menos de 300 ms con 5000 clientes",
              "Los filtros se conservan al volver a la lista"
            ],
            "links": [
              "entity:cliente",
              "entity:contacto",
              "skill:rest-api-design"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "permission",
            "title": "Vistas por rol",
            "statement": "El administrador gestiona usuarios y etapas y ve toda la cartera; cada vendedor solo ve y edita los clientes y oportunidades que tiene asignados.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un vendedor no puede abrir la ficha de un cliente ajeno",
              "Solo el administrador cambia las probabilidades de etapa"
            ],
            "links": [
              "entity:usuario",
              "skill:authentication-authorization"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Etiquetas y segmentación",
            "statement": "Los clientes admiten etiquetas libres para segmentar la cartera y filtrar listas y pronósticos.",
            "priority": "should",
            "status": "approved",
            "acceptance": [
              "Una etiqueta se crea al escribirla y se sugiere al reutilizarla",
              "El filtro por etiqueta afecta a las listas y al pronóstico"
            ],
            "links": [
              "entity:cliente"
            ]
          },
          {
            "id": "rn-001",
            "code": "RN-001",
            "kind": "business_rule",
            "title": "Cierre terminal",
            "statement": "Una oportunidad ganada o perdida queda cerrada: no cambia de etapa ni de importe salvo reapertura por un administrador.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Arrastrar una oportunidad cerrada fuera de su columna se rechaza con motivo",
              "La reapertura queda registrada en el historial"
            ],
            "links": [
              "entity:oportunidad",
              "process:p-02"
            ]
          },
          {
            "id": "rn-002",
            "code": "RN-002",
            "kind": "business_rule",
            "title": "Céntimos y probabilidad acotada",
            "statement": "Los importes se guardan en céntimos enteros y las probabilidades de etapa son enteros de 0 a 100; el pronóstico nunca se edita a mano.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La API rechaza importes con decimales",
              "Una etapa con probabilidad 101 se rechaza al guardar"
            ],
            "links": [
              "entity:oportunidad",
              "entity:etapa",
              "process:p-03"
            ]
          },
          {
            "id": "rn-003",
            "code": "RN-003",
            "kind": "business_rule",
            "title": "Oportunidad con cliente y responsable",
            "statement": "No se guarda una oportunidad sin cliente activo y sin usuario responsable asignado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Crear una oportunidad sin responsable devuelve error de validación",
              "Un cliente archivado no admite oportunidades nuevas"
            ],
            "links": [
              "entity:oportunidad",
              "entity:cliente",
              "entity:usuario"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Cómo vende una pyme",
            "summary": "Ventas consultivas de ciclo corto: la relación con el cliente pesa más que el volumen; el seguimiento telefónico y las visitas son el día a día.",
            "source_note": "Curaduría de la plantilla"
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Etapas con probabilidad propia",
            "summary": "Cada etapa del pipeline lleva su probabilidad histórica de cierre; el pronóstico ponderado sale de ahí, no de estimaciones manuales.",
            "source_note": "Curaduría de la plantilla"
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "TypeScript",
          "framework": "Express + React",
          "style": "Capas con dominio de ventas",
          "database": "PostgreSQL",
          "data_access": "Prisma con repositorios por entidad",
          "api_style": "REST JSON",
          "auth": "JWT con roles administrador y vendedor",
          "infrastructure": "Contenedor",
          "hosting": "VPS con HTTPS",
          "external_services": [],
          "dependencies": [
            "PostgreSQL",
            "React",
            "Prisma"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI con migraciones"
        },
        "decisions": [
          {
            "id": "dec-01",
            "topic": "Fuente del pronóstico",
            "choice": "Cálculo sobre oportunidades abiertas y probabilidad por etapa",
            "rationale": "El pronóstico se calcula desde el detalle: nadie lo escribe a mano ni lo maquilla.",
            "alternatives": [
              "Importe estimado por vendedor",
              "Media histórica sin ponderar"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-02",
            "topic": "Dinero y etapas",
            "choice": "Céntimos enteros y etapas como tabla con probabilidad",
            "rationale": "Evita errores de coma flotante y permite ajustar probabilidades sin desplegar código.",
            "alternatives": [
              "Importes en euros con decimales",
              "Etapas fijadas en el código"
            ],
            "status": "accepted"
          },
          {
            "id": "dec-03",
            "topic": "Historial de cambios",
            "choice": "Actividades de tipo cambio_etapa en la misma transacción",
            "rationale": "El historial usa la misma entidad que las actividades: una sola línea de tiempo por cliente y sin tablas huérfanas.",
            "alternatives": [
              "Tabla de auditoría separada",
              "Log externo"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "cliente",
              "name": "cliente",
              "description": "Empresa de la cartera comercial.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nif",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "etiquetas",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "propietario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "archivado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "ultima_interaccion",
                  "data_type": "timestamp",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "creado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "propietario_id"
              ],
              "rules": [
                "NIF único por cliente"
              ]
            },
            {
              "id": "contacto",
              "name": "contacto",
              "description": "Persona de contacto dentro de un cliente.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cliente_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "cliente.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "telefono",
                  "data_type": "text",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cargo",
                  "data_type": "text",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "principal",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "cliente_id"
              ],
              "rules": [
                "A lo sumo un contacto principal por cliente"
              ]
            },
            {
              "id": "etapa",
              "name": "etapa",
              "description": "Etapa del pipeline con su probabilidad histórica de cierre.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "orden",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "probabilidad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "terminal",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": [
                "probabilidad entre 0 y 100",
                "orden único"
              ]
            },
            {
              "id": "oportunidad",
              "name": "oportunidad",
              "description": "Venta potencial con importe, etapa y responsable.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cliente_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "cliente.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "responsable_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "etapa_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "etapa.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "titulo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "importe_centavos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cierre_previsto",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cerrada",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "resultado",
                  "data_type": "text",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "etapa_id",
                "responsable_id",
                "cierre_previsto"
              ],
              "rules": [
                "resultado solo ganada o perdida cuando cerrada"
              ]
            },
            {
              "id": "actividad",
              "name": "actividad",
              "description": "Interacción o tarea registrada; incluye los cambios de etapa.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cliente_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "cliente.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "oportunidad_id",
                  "data_type": "uuid",
                  "nullable": true,
                  "key": "foreign",
                  "references": "oportunidad.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "resumen",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "cliente_id",
                "oportunidad_id"
              ],
              "rules": [
                "tipo: llamada, visita, tarea o cambio_etapa"
              ]
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Persona del equipo con rol y cartera asignada.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "correo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "activo",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": [
                "rol: administrador o vendedor"
              ]
            }
          ],
          "relations": [
            {
              "id": "rel-01",
              "kind": "one_to_many",
              "from": "cliente",
              "to": "contacto",
              "label": "agrupa"
            },
            {
              "id": "rel-02",
              "kind": "one_to_many",
              "from": "cliente",
              "to": "oportunidad",
              "label": "genera"
            },
            {
              "id": "rel-03",
              "kind": "one_to_many",
              "from": "oportunidad",
              "to": "actividad",
              "label": "documenta"
            },
            {
              "id": "rel-04",
              "kind": "one_to_many",
              "from": "etapa",
              "to": "oportunidad",
              "label": "clasifica"
            },
            {
              "id": "rel-05",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "oportunidad",
              "label": "gestiona"
            }
          ],
          "seed_data": [
            "Etapas sembradas: Lead 10 %, Contacto 25 %, Propuesta 50 %, Negociación 75 %, Ganada 100 % (terminal), Perdida 0 % (terminal)",
            "Un administrador y dos vendedores de demostración",
            "Tres clientes con contactos y cinco oportunidades abiertas con importes y fechas realistas"
          ],
          "migrations": [
            "v1: usuarios, clientes, contactos, etapas, oportunidades y actividades",
            "v2: índices por responsable y cierre previsto para el pronóstico"
          ]
        },
        "processes": [
          {
            "id": "p-01",
            "name": "Registrar actividad",
            "summary": "Guarda la interacción y actualiza la última fecha de contacto del cliente.",
            "trigger": "El vendedor registra una llamada, visita o tarea",
            "inputs": [
              "cliente",
              "usuario",
              "datos de la actividad"
            ],
            "outputs": [
              "actividad"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "cliente",
                  "query": "id, propietario y archivado",
                  "into": "cliente"
                },
                {
                  "op": "si",
                  "condition": "cliente existe y usuario puede_ver(cliente)",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "actividad",
                      "value": "{tipo, resumen, cliente_id, oportunidad_id, usuario_id, fecha}"
                    },
                    {
                      "op": "guardar",
                      "target": "cliente",
                      "value": "{ultima_interaccion: fecha}"
                    },
                    {
                      "op": "devolver",
                      "value": "actividad"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Cliente inexistente o fuera de la cartera del usuario",
                      "code": "CLIENTE_NO_ACCESIBLE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "CLIENTE_NO_ACCESIBLE rechaza el registro sin guardar nada"
            ],
            "rules": [],
            "links": [
              "requirement:FR-005",
              "requirement:FR-008",
              "entity:actividad"
            ]
          },
          {
            "id": "p-02",
            "name": "Mover oportunidad de etapa",
            "summary": "Valida el movimiento, actualiza la etapa y deja el cambio en el historial.",
            "trigger": "Arrastre de tarjeta o cambio de etapa en la ficha",
            "inputs": [
              "oportunidad",
              "etapa destino",
              "usuario"
            ],
            "outputs": [
              "oportunidad",
              "actividad"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "oportunidad",
                  "query": "id, etapa actual, cerrada y responsable",
                  "into": "opp"
                },
                {
                  "op": "consultar",
                  "target": "etapa",
                  "query": "destino por id",
                  "into": "destino"
                },
                {
                  "op": "si",
                  "condition": "opp.cerrada",
                  "then_body": [
                    {
                      "op": "generar_error",
                      "message": "La oportunidad está ganada o perdida; solo un administrador puede reabrirla",
                      "code": "OPORTUNIDAD_CERRADA"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "si",
                      "condition": "destino existe",
                      "then_body": [
                        {
                          "op": "guardar",
                          "target": "oportunidad",
                          "value": "{etapa_id: destino.id, cerrada: destino.terminal, resultado: etiqueta_cierre(destino)}"
                        },
                        {
                          "op": "guardar",
                          "target": "actividad",
                          "value": "{tipo: cambio_etapa, resumen: etapa_anterior → destino.nombre, usuario_id, fecha}"
                        },
                        {
                          "op": "devolver",
                          "value": "oportunidad"
                        }
                      ],
                      "else_body": [
                        {
                          "op": "generar_error",
                          "message": "La etapa destino no existe",
                          "code": "ETAPA_DESCONOCIDA"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            "errors": [
              "OPORTUNIDAD_CERRADA bloquea el movimiento",
              "ETAPA_DESCONOCIDA rechaza destinos inexistentes"
            ],
            "rules": [
              "El movimiento y su historial se guardan en la misma transacción"
            ],
            "links": [
              "requirement:FR-004",
              "requirement:RN-001",
              "entity:oportunidad",
              "entity:etapa"
            ]
          },
          {
            "id": "p-03",
            "name": "Calcular pronóstico ponderado",
            "summary": "Suma importe por probabilidad de etapa de las oportunidades abiertas y la desglosa por mes y responsable.",
            "trigger": "Apertura del tablero o cambio de filtros",
            "inputs": [
              "filtros de responsable, mes y etiqueta"
            ],
            "outputs": [
              "pronóstico"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "oportunidad",
                  "query": "abiertas por responsable, mes de cierre y etiqueta",
                  "into": "abiertas"
                },
                {
                  "op": "consultar",
                  "target": "etapa",
                  "query": "probabilidad por etapa",
                  "into": "etapas"
                },
                {
                  "op": "definir",
                  "variable": "ponderado",
                  "value": "suma(o.importe_centavos * probabilidad(o.etapa_id, etapas) / 100 para o en abiertas)"
                },
                {
                  "op": "para_cada",
                  "variable": "mes",
                  "collection": "agrupar_por_mes(abiertas)",
                  "body": [
                    {
                      "op": "definir",
                      "variable": "subtotal",
                      "value": "suma_ponderada(mes, etapas)"
                    }
                  ]
                },
                {
                  "op": "devolver",
                  "value": "{total_centavos: ponderado, por_mes, por_responsable}"
                }
              ]
            },
            "errors": [
              "Sin oportunidades abiertas el pronóstico es cero: no es un error"
            ],
            "rules": [
              "Las oportunidades cerradas quedan fuera del cálculo"
            ],
            "links": [
              "requirement:FR-006",
              "requirement:RN-002",
              "entity:oportunidad",
              "mockup:m-report-dashboard"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del CRM",
            "description": "Componentes del CRM",
            "layout": "layered",
            "nodes": [
              {
                "id": "n1",
                "label": "CRM React (cartera, pipeline, tablero)",
                "shape": "box",
                "group": "presentación",
                "x": 40,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n2",
                "label": "API Express REST",
                "shape": "box",
                "group": "aplicación",
                "x": 260,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n3",
                "label": "Dominio de ventas (etapas, pronóstico, permisos)",
                "shape": "box",
                "group": "dominio",
                "x": 260,
                "y": 160,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              },
              {
                "id": "n4",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 480,
                "y": 40,
                "w": 180,
                "h": 64,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "d-01-e0",
                "from": "n1",
                "to": "n2",
                "label": "peticiones JSON",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e1",
                "from": "n2",
                "to": "n3",
                "label": "casos de uso",
                "kind": "flow",
                "dashed": false
              },
              {
                "id": "d-01-e2",
                "from": "n3",
                "to": "n4",
                "label": "entidades e historial",
                "kind": "data_flow",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Limpio y comercial, con color por etapa y estados siempre visibles",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y etapa activa"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos y oportunidades estancadas"
            }
          ],
          "typography": [
            "Sans compacta",
            "Números tabulares para importes"
          ],
          "components": [
            "Tarjeta de oportunidad",
            "Ficha de cliente con línea de tiempo",
            "Columna de pipeline"
          ],
          "navigation": "Navegación por cartera, pipeline, actividades y tablero",
          "responsive_notes": "El pipeline colapsa a lista por etapas en pantallas estrechas",
          "asset_sources": [
            "Tabler Icons",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-crm-contacts",
            "name": "CRM de contactos",
            "screen": "Cartera y ficha de cliente",
            "notes": "Búsqueda, lista de clientes y ficha con actividades recientes"
          },
          {
            "mockup_id": "m-kanban-board",
            "name": "Tablero Kanban",
            "screen": "Pipeline de oportunidades",
            "notes": "Columnas por etapa con tarjetas arrastrables"
          },
          {
            "mockup_id": "m-report-dashboard",
            "name": "Panel de indicadores",
            "screen": "Pronóstico y seguimiento",
            "notes": "Pronóstico ponderado con desglose por mes y responsable"
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "rest-api-design",
            "name": "Diseño de API REST",
            "purpose": "Recursos de clientes, contactos y oportunidades con filtros, paginación y errores uniformes.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "data-modeling",
            "name": "Modelado de datos",
            "purpose": "Entidades de la cartera y del pipeline con relaciones e índices que sostienen el pronóstico.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "authentication-authorization",
            "name": "Autenticación y autorización",
            "purpose": "Roles administrador y vendedor con cartera privada por responsable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Sobre uniforme con códigos estables para cierre terminal y validaciones.",
            "when": "implementación"
          },
          {
            "id": "sk-05",
            "skill_id": "unit-testing",
            "name": "Pruebas unitarias",
            "purpose": "Cálculo del pronóstico y transiciones de etapa probados con datos sembrados.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Pruebas del cálculo ponderado con oportunidades sembradas, de transiciones de etapa (incluido el cierre terminal) y de permisos por cartera.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Pronóstico y transiciones de etapa",
              "tools": [
                "Suite del lenguaje"
              ],
              "notes": "Importes en céntimos y probabilidades límite"
            },
            {
              "kind": "integration",
              "scope": "API, permisos e historial",
              "tools": [
                "Suite de integración"
              ],
              "notes": "Transacciones reales con PostgreSQL"
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "NIF duplicado rechazado",
              "given": "Un cliente con un NIF ya registrado",
              "when": "Se intenta crear otro con el mismo NIF",
              "then": "Alta rechazada con motivo y sin duplicados",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Un solo contacto principal",
              "given": "Un cliente con dos contactos",
              "when": "Se marca uno como principal",
              "then": "El otro deja de ser principal y ambos siguen en la ficha",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Oportunidad nace en primera etapa",
              "given": "Cliente activo y vendedor con sesión",
              "when": "Crea una oportunidad con importe y fecha de cierre",
              "then": "Aparece en la primera etapa con el importe guardado en céntimos",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Movimiento con historial",
              "given": "Oportunidad abierta en Propuesta",
              "when": "Se arrastra a Negociación",
              "then": "La tarjeta cambia de columna y el historial registra quién, cuándo y origen→destino",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Actividad actualiza última interacción",
              "given": "Cliente sin interacciones recientes",
              "when": "El vendedor registra una llamada",
              "then": "La llamada aparece en la ficha y la última interacción pasa a ser hoy",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pronóstico cuadra con el detalle",
              "given": "Cinco oportunidades abiertas sembradas",
              "when": "Se abre el tablero",
              "then": "El total es la suma de importe por probabilidad y excluye las cerradas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Búsqueda paginada",
              "given": "5000 clientes sembrados",
              "when": "Se busca por prefijo de nombre",
              "then": "Resultados correctos en menos de 300 ms y paginados",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Cartera privada por vendedor",
              "given": "Sesión de vendedor con clientes asignados",
              "when": "Intenta abrir la ficha de un cliente ajeno",
              "then": "Acceso denegado sin filtrar datos del cliente",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Segmentación por etiqueta",
              "given": "Clientes etiquetados como reformas",
              "when": "Se filtran cartera y pronóstico por esa etiqueta",
              "then": "Listas y pronóstico solo incluyen clientes etiquetados",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-001",
              "title": "Cierre terminal protegido",
              "given": "Oportunidad ganada",
              "when": "Se intenta mover de etapa",
              "then": "Movimiento rechazado con OPORTUNIDAD_CERRADA",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-11",
              "requirement": "RN-002",
              "title": "Importes y probabilidades acotados",
              "given": "Etapa con probabilidad 101 o importe con decimales",
              "when": "Se intenta guardar",
              "then": "La validación rechaza el valor con error claro",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-12",
              "requirement": "RN-003",
              "title": "Sin cliente ni responsable no hay oportunidad",
              "given": "Formulario de oportunidad sin responsable elegido",
              "when": "Se intenta crear",
              "then": "Error de validación y nada guardado",
              "level": "functional",
              "priority": "must"
            }
          ],
          "coverage_expected": "80 % en dominio de ventas y procesos críticos",
          "definition_of_done": [
            "Criterios de aceptación en verde",
            "Pronóstico verificado contra la suma manual del detalle sembrado",
            "Permisos probados con dos vendedores y un administrador"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "CRM desplegable",
            "kind": "despliegue",
            "format": "contenedor",
            "audience": "Operador",
            "contents": [
              "Build",
              "Migraciones",
              "Guía de despliegue"
            ]
          },
          {
            "id": "dl-02",
            "title": "Guía rápida del vendedor",
            "kind": "usuario",
            "format": "markdown",
            "audience": "Equipo comercial",
            "contents": [
              "Alta de cliente y contacto",
              "Registro de actividades",
              "Uso del pipeline"
            ]
          },
          {
            "id": "dl-03",
            "title": "Contrato de la API",
            "kind": "arquitectura",
            "format": "yaml",
            "audience": "Desarrollo",
            "contents": [
              "api/openapi.yaml",
              "Ejemplos de errores"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Editar el pronóstico a mano",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar etapas, probabilidades y alcance antes de implementar."
        },
        "notes": [
          {
            "id": "nt-01",
            "kind": "decision",
            "text": "El pronóstico se calcula desde el detalle; nadie lo captura a mano.",
            "status": "resolved",
            "resolution": "Aceptado en dec-01",
            "created_at": 1763337600
          },
          {
            "id": "nt-02",
            "kind": "risk",
            "text": "Las probabilidades por etapa pueden quedar desactualizadas y sesgar el pronóstico.",
            "status": "resolved",
            "resolution": "Mitigado: revisión trimestral de probabilidades por el administrador",
            "created_at": 1763337600
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Cartera de clientes y contactos",
                    "Oportunidades con pipeline por etapas",
                    "Actividades e historial",
                    "Pronóstico ponderado"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-database",
          "question_es": "¿Dónde vivirán los datos?",
          "question_en": "Where will the data live?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "postgres",
              "label_es": "PostgreSQL en el servidor",
              "label_en": "PostgreSQL on the server",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "PostgreSQL"
                }
              ]
            },
            {
              "id": "sqlite",
              "label_es": "SQLite para una instalación mínima",
              "label_en": "SQLite for a minimal install",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "SQLite"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "data_access",
                  "value": "Prisma con repositorios por entidad (SQL portable)"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ],
      "tpp_profile": "crm"
    },
    {
      "id": "rrhh-empleados",
      "types": [
        "gestión",
        "web"
      ],
      "name_es": "RRHH: empleados, contratos y vacaciones",
      "name_en": "HR: employees, contracts and leave",
      "summary_es": "Gestión de personas para pyme: expediente de empleado, contratos, solicitudes de vacaciones con aprobación y registro de asistencia, con roles y panel de métricas.",
      "summary_en": "People management for SMBs: employee records, contracts, leave requests with approval and attendance tracking, with roles and a metrics dashboard.",
      "expert_id": "ada-crudwell",
      "skills": [
        "rest-api-design",
        "data-modeling",
        "authentication-authorization",
        "error-handling-design",
        "unit-testing"
      ],
      "pieces": [
        "node-express-rest-base",
        "auth-jwt-express",
        "prisma-data-access",
        "error-envelope-rest",
        "pagination-cursor-sql"
      ],
      "mockups": [
        "m-admin-crud",
        "m-kanban-board",
        "m-report-dashboard"
      ],
      "resources": [
        "tabler",
        "lucide",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "TypeScript"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "gestión",
          "web"
        ],
        "non_goals": [
          "Nómina",
          "Evaluación del desempeño",
          "Portal de empleo"
        ],
        "visual_style": "Interfaz administrativa sobria y legible",
        "asset_sources": [
          "Tabler Icons",
          "Lucide"
        ],
        "mockup": "m-admin-crud"
      },
      "document": {
        "name": "RRHH: empleados, contratos y vacaciones",
        "schema_version": 1,
        "identity": {
          "name": "RRHH: empleados, contratos y vacaciones",
          "description": "Sistema de recursos humanos para una pyme que centraliza el expediente de cada empleado, sus contratos, las vacaciones y la asistencia.",
          "problem": "RRHH lleva empleados, contratos y vacaciones en hojas de cálculo sueltas: se pierden solicitudes, no hay saldo de vacaciones fiable y cada responsable consulta una versión distinta.",
          "vision": "Que cualquier responsable consulte en un solo lugar el estado de su equipo y resuelva una solicitud de vacaciones en menos de un minuto.",
          "goals": [
            "Centralizar el expediente de empleado",
            "Trazar contratos y fechas",
            "Aprobar vacaciones con saldo real"
          ],
          "specific_goals": [
            "Reducir a cero las solicitudes perdidas",
            "Calcular el saldo de vacaciones automáticamente",
            "Dar visibilidad de asistencia por departamento"
          ],
          "users": [
            "Administrador de RRHH (perfil técnico medio)",
            "Responsable de departamento ( aprueba vacaciones)",
            "Empleado (consulta y solicita)"
          ],
          "use_cases": [
            "Dar de alta un empleado con su contrato",
            "Solicitar y aprobar vacaciones",
            "Consultar asistencia y métricas del equipo"
          ],
          "scope": [
            "Expediente de empleados y departamentos",
            "Contratos",
            "Vacaciones con aprobación",
            "Registro de asistencia",
            "Roles y panel de métricas"
          ],
          "out_of_scope": [
            "Nómina y cálculo salarial",
            "Evaluación del desempeño",
            "Portal de empleo externo"
          ],
          "constraints": [
            "Datos personales protegidos: acceso por rol",
            "Sin dependencia de servicios de pago",
            "Desplegable en un VPS modesto"
          ],
          "success_metrics": [
            "100% de solicitudes con estado trazable",
            "Saldo de vacaciones correcto en todos los casos de prueba",
            "Alta de empleado en menos de 2 minutos"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Expediente de empleados",
            "statement": "RRHH puede crear, editar y dar de baja empleados con email único, departamento y puesto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se admiten dos empleados con el mismo email",
              "Un empleado inactivo sale de las listas activas sin perder su historial"
            ],
            "links": [
              "entity:empleado",
              "mockup:m-admin-crud",
              "process:p-alta-empleado"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "permission",
            "title": "Roles y permisos",
            "statement": "El sistema distingue admin, responsable y empleado; cada endpoint comprueba el rol antes de operar.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un empleado no puede editar expedientes ajenos",
              "Solo admin y responsable aprueban vacaciones"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Contratos por empleado",
            "statement": "Cada empleado tiene contratos con tipo, fechas y salario; solo uno vigente a la vez.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Al activar un contrato se desactiva el anterior",
              "Un contrato sin fecha fin se considera indefinido"
            ],
            "links": [
              "entity:contrato",
              "entity:empleado"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Solicitud de vacaciones",
            "statement": "El empleado solicita un rango de fechas y el sistema calcula los días y valida el saldo antes de registrar la petición como pendiente.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Una solicitud con días mayores que el saldo se rechaza con motivo",
              "La solicitud queda en estado pendiente hasta que se resuelve"
            ],
            "links": [
              "entity:solicitud_vacaciones",
              "mockup:m-kanban-board",
              "process:p-solicitar-vacaciones"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Aprobación de vacaciones",
            "statement": "El responsable aprueba o rechaza solicitudes pendientes de su departamento y el saldo se descuenta al aprobar.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Aprobar una solicitud descuenta sus días del saldo",
              "No se puede aprobar una solicitud ya resuelta"
            ],
            "links": [
              "entity:solicitud_vacaciones",
              "process:p-aprobar-vacaciones",
              "requirement:FR-002"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Registro de asistencia",
            "statement": "Se registra la entrada y salida de cada empleado por fecha y se calculan las horas de la jornada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se duplica la entrada de un empleado en la misma fecha",
              "Las horas se calculan a partir de entrada y salida"
            ],
            "links": [
              "entity:registro_asistencia"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Organigrama por departamento",
            "statement": "La vista de departamentos muestra sus empleados y el responsable asignado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cada departamento lista sus empleados activos",
              "El responsable se muestra con su nombre, no solo su id"
            ],
            "links": [
              "entity:departamento",
              "mockup:m-report-dashboard"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Panel de métricas de RRHH",
            "statement": "Un panel resume plantilla activa, solicitudes pendientes y horas registradas por departamento.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Las métricas se calculan desde los datos reales",
              "El panel distingue solicitudes pendientes de resueltas"
            ],
            "links": [
              "entity:empleado",
              "entity:solicitud_vacaciones",
              "mockup:m-report-dashboard"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Exportación de informes",
            "statement": "RRHH exporta a CSV el listado de empleados y el resumen de vacaciones del periodo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El CSV incluye las columnas del expediente visibles en pantalla",
              "La exportación respeta los filtros activos"
            ],
            "links": [
              "entity:empleado",
              "mockup:m-report-dashboard"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Saldo de vacaciones limitado",
            "statement": "El saldo disponible es los días anuales menos los aprobados en el año; nunca puede quedar negativo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El saldo nunca es negativo",
              "Los días rechazados no se descuentan"
            ],
            "links": [
              "entity:solicitud_vacaciones",
              "entity:empleado"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "empresarial",
            "title": "Pyme con varios departamentos",
            "summary": "Entre 10 y 200 empleados, responsables por departamento y un administrador de RRHH que centraliza.",
            "source_note": "Supuesto de la plantilla genérica."
          },
          {
            "id": "ctx-02",
            "kind": "legal",
            "title": "Protección de datos del empleado",
            "summary": "El expediente contiene datos personales; el acceso se limita por rol y se registra quién consulta qué.",
            "source_note": "Requisito de privacidad habitual; ajustar a la legislación local."
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "TypeScript",
          "framework": "Express + React",
          "style": "Monolito modular por capas",
          "database": "PostgreSQL",
          "data_access": "Prisma (repositorio por entidad)",
          "api_style": "REST JSON",
          "auth": "JWT con roles",
          "infrastructure": "Contenedor Docker",
          "hosting": "VPS propio o nube",
          "external_services": [
            "Correo transaccional"
          ],
          "dependencies": [
            "Node 20",
            "Express",
            "Prisma",
            "React",
            "PostgreSQL 16"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI/CD con migraciones"
        },
        "decisions": [
          {
            "id": "d-base",
            "topic": "base de datos",
            "choice": "PostgreSQL",
            "rationale": "Relaciones fuertes entre empleado, contrato y solicitudes; integridad referencial y transacciones para el saldo de vacaciones.",
            "alternatives": [
              "MySQL",
              "SQLite"
            ],
            "status": "accepted"
          },
          {
            "id": "d-lenguaje",
            "topic": "lenguaje y framework",
            "choice": "TypeScript con Express + React",
            "rationale": "Un solo lenguaje en cliente y servidor, tipado del contrato de API y ecosistema de pruebas maduro.",
            "alternatives": [
              "PHP Laravel",
              "Python FastAPI"
            ],
            "status": "accepted"
          },
          {
            "id": "d-autenticación",
            "topic": "autenticación",
            "choice": "JWT con roles",
            "rationale": "Roles de administrador, responsable y empleado sin estado de sesión en servidor; permisos comprobados en cada endpoint.",
            "alternatives": [
              "Sesiones con cookie",
              "OAuth externo"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Cuenta de acceso al sistema con su rol.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "email",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "password_hash",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "creado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "email"
              ],
              "rules": [
                "El rol es uno de: admin, responsable, empleado"
              ]
            },
            {
              "id": "departamento",
              "name": "departamento",
              "description": "Unidad organizativa que agrupa empleados.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "responsable_id",
                  "data_type": "uuid",
                  "nullable": true,
                  "key": "foreign",
                  "references": "empleado.id",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "responsable_id"
              ],
              "rules": [
                "Nombre único por departamento"
              ]
            },
            {
              "id": "empleado",
              "name": "empleado",
              "description": "Persona de la plantilla con su expediente.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "email",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "departamento_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "departamento.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puesto",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha_alta",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "activo",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": true,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dias_vacaciones_anuales",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "departamento_id",
                "email"
              ],
              "rules": [
                "Email único",
                "Un empleado inactivo no solicita vacaciones"
              ]
            },
            {
              "id": "contrato",
              "name": "contrato",
              "description": "Relación contractual de un empleado con la empresa.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "empleado_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "empleado.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha_inicio",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha_fin",
                  "data_type": "date",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "salario_bruto",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "vigente",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "empleado_id"
              ],
              "rules": [
                "Un solo contrato vigente por empleado"
              ]
            },
            {
              "id": "solicitud_vacaciones",
              "name": "solicitud_vacaciones",
              "description": "Petición de días de vacaciones con su estado de aprobación.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "empleado_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "empleado.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha_inicio",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha_fin",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dias",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "aprobado_por",
                  "data_type": "uuid",
                  "nullable": true,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "creado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "empleado_id",
                "estado"
              ],
              "rules": [
                "Estado: pendiente, aprobada, rechazada",
                "Los días no pueden exceder el saldo"
              ]
            },
            {
              "id": "registro_asistencia",
              "name": "registro_asistencia",
              "description": "Jornada registrada de un empleado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "empleado_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "empleado.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "entrada",
                  "data_type": "time",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "salida",
                  "data_type": "time",
                  "nullable": true,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "horas",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "empleado_id",
                "fecha"
              ],
              "rules": [
                "Una entrada por empleado y fecha"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-departamento-empleado",
              "kind": "one_to_many",
              "from": "departamento",
              "to": "empleado",
              "label": "agrupa"
            },
            {
              "id": "r-empleado-contrato",
              "kind": "one_to_many",
              "from": "empleado",
              "to": "contrato",
              "label": "tiene"
            },
            {
              "id": "r-empleado-solicitud_vacaciones",
              "kind": "one_to_many",
              "from": "empleado",
              "to": "solicitud_vacaciones",
              "label": "solicita"
            },
            {
              "id": "r-empleado-registro_asistencia",
              "kind": "one_to_many",
              "from": "empleado",
              "to": "registro_asistencia",
              "label": "registra"
            },
            {
              "id": "r-empleado-usuario",
              "kind": "one_to_one",
              "from": "empleado",
              "to": "usuario",
              "label": "accede como"
            }
          ],
          "seed_data": [
            "Departamentos: Dirección, Operaciones, Comercial",
            "Usuario admin inicial con rol admin",
            "Empleado de ejemplo con contrato vigente y 22 días de vacaciones"
          ],
          "migrations": [
            "001_esquema_inicial (usuarios, departamentos, empleados)",
            "002_contratos_vacaciones_asistencia",
            "003_indices_y_restricciones"
          ]
        },
        "processes": [
          {
            "id": "p-alta-empleado",
            "name": "Alta de empleado con contrato",
            "summary": "Crea el expediente y su primer contrato vigente.",
            "trigger": "RRHH pulsa «Nuevo empleado» y guarda el formulario",
            "inputs": [
              "empleado",
              "departamento"
            ],
            "outputs": [
              "empleado",
              "contrato"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "departamento",
                  "query": "id y nombre",
                  "into": "departamento"
                },
                {
                  "op": "si",
                  "condition": "departamento existe y email no duplicado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "empleado",
                      "value": "{nombre, email, departamento_id, puesto, fecha_alta, activo, dias_vacaciones_anuales}"
                    },
                    {
                      "op": "guardar",
                      "target": "contrato",
                      "value": "{empleado_id, tipo, fecha_inicio, salario_bruto, vigente: true}"
                    },
                    {
                      "op": "devolver",
                      "value": "empleado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Departamento inexistente o email duplicado",
                      "code": "EMPLEADO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "EMPLEADO_INVALIDO: departamento inexistente o email duplicado"
            ],
            "rules": [
              "El email es único",
              "El primer contrato queda vigente"
            ],
            "links": [
              "requirement:FR-001",
              "entity:empleado",
              "entity:contrato"
            ]
          },
          {
            "id": "p-solicitar-vacaciones",
            "name": "Solicitud de vacaciones",
            "summary": "Calcula días y valida saldo antes de registrar la petición.",
            "trigger": "El empleado envía un rango de fechas",
            "inputs": [
              "empleado",
              "solicitud_vacaciones"
            ],
            "outputs": [
              "solicitud_vacaciones"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "empleado",
                  "query": "id, activo y dias_vacaciones_anuales",
                  "into": "empleado"
                },
                {
                  "op": "consultar",
                  "target": "solicitud_vacaciones",
                  "query": "dias aprobados del empleado en el año",
                  "into": "aprobadas"
                },
                {
                  "op": "si",
                  "condition": "empleado activo y dias solicitados <= saldo disponible",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "solicitud_vacaciones",
                      "value": "{empleado_id, fecha_inicio, fecha_fin, dias, estado: pendiente}"
                    },
                    {
                      "op": "devolver",
                      "value": "solicitud_vacaciones"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Saldo insuficiente o empleado inactivo",
                      "code": "SALDO_INSUFICIENTE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "SALDO_INSUFICIENTE: los días exceden el saldo o el empleado está inactivo"
            ],
            "rules": [
              "El saldo se calcula con los días aprobados del año"
            ],
            "links": [
              "requirement:FR-004",
              "requirement:RN-01",
              "entity:solicitud_vacaciones"
            ]
          },
          {
            "id": "p-aprobar-vacaciones",
            "name": "Resolución de vacaciones",
            "summary": "El responsable aprueba o rechaza y se descuenta el saldo al aprobar.",
            "trigger": "Responsable abre una solicitud pendiente y decide",
            "inputs": [
              "solicitud_vacaciones",
              "usuario"
            ],
            "outputs": [
              "solicitud_vacaciones"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "solicitud_vacaciones",
                  "query": "id, estado y empleado_id",
                  "into": "solicitud"
                },
                {
                  "op": "si",
                  "condition": "solicitud pendiente y usuario puede_aprobar(solicitud)",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "solicitud_vacaciones",
                      "value": "{estado: aprobada, aprobado_por: usuario_id}"
                    },
                    {
                      "op": "devolver",
                      "value": "solicitud"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Solicitud ya resuelta o sin permiso",
                      "code": "SOLICITUD_NO_ACCESIBLE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "SOLICITUD_NO_ACCESIBLE: ya resuelta o el usuario no es responsable del departamento"
            ],
            "rules": [
              "Solo se aprueban solicitudes pendientes",
              "Aprobar descuenta días del saldo"
            ],
            "links": [
              "requirement:FR-005",
              "requirement:FR-002",
              "entity:solicitud_vacaciones"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del sistema de RRHH",
            "description": "Capas de la aplicación y su relación con los datos.",
            "layout": "layered",
            "nodes": [
              {
                "id": "ui",
                "label": "React (paneles y formularios)",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "api",
                "label": "API REST Express",
                "shape": "box",
                "group": "aplicación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "dominio",
                "label": "Servicios de RRHH",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "auth",
                "label": "Middleware de roles JWT",
                "shape": "box",
                "group": "aplicación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "datos",
                "label": "PostgreSQL vía Prisma",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-ui-api",
                "from": "ui",
                "to": "api",
                "label": "HTTP JSON",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-api-auth",
                "from": "api",
                "to": "auth",
                "label": "verifica rol",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-api-dominio",
                "from": "api",
                "to": "dominio",
                "label": "casos de uso",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-dominio-datos",
                "from": "dominio",
                "to": "datos",
                "label": "repositorios",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Interfaz administrativa sobria, densa en datos y legible",
          "palette": [
            {
              "name": "Morado",
              "hex": "#6B21A8",
              "usage": "Acciones primarias y navegación"
            },
            {
              "name": "Pizarra",
              "hex": "#0F172A",
              "usage": "Texto y fondos oscuros"
            },
            {
              "name": "Ámbar",
              "hex": "#F59E0B",
              "usage": "Avisos y estados pendientes"
            },
            {
              "name": "Verde",
              "hex": "#16A34A",
              "usage": "Confirmaciones y estados activos"
            }
          ],
          "typography": [
            "Montserrat para títulos",
            "Fuente de sistema para tablas y formularios"
          ],
          "components": [
            "Tabla con filtros y paginación",
            "Formulario lateral",
            "Tarjeta de métrica",
            "Modal de confirmación"
          ],
          "navigation": "Barra lateral por módulos; migas de pan en el detalle",
          "responsive_notes": "Tablas con scroll horizontal en móvil; formularios a una columna",
          "asset_sources": [
            "Tabler Icons",
            "Lucide",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-admin-crud",
            "name": "Expediente de empleados",
            "screen": "Listado y ficha de empleado",
            "notes": "Tabla con filtros por departamento y formulario lateral de alta."
          },
          {
            "mockup_id": "m-kanban-board",
            "name": "Tablero de vacaciones",
            "screen": "Solicitudes por estado",
            "notes": "Columnas pendiente / aprobada / rechazada con arrastre para resolver."
          },
          {
            "mockup_id": "m-report-dashboard",
            "name": "Panel de RRHH",
            "screen": "Métricas y organigrama",
            "notes": "Tarjetas de plantilla activa, pendientes y horas por departamento."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "rest-api-design",
            "name": "Diseño de API REST",
            "purpose": "Recursos y verbos coherentes para el contrato de RRHH.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "data-modeling",
            "name": "Modelado de datos",
            "purpose": "Entidades y relaciones íntegras del expediente.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "authentication-authorization",
            "name": "Autenticación y autorización",
            "purpose": "Roles y permisos por endpoint.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Sobre de error consistente y códigos de dominio.",
            "when": "implementación"
          },
          {
            "id": "sk-05",
            "skill_id": "unit-testing",
            "name": "Pruebas unitarias",
            "purpose": "Reglas de saldo y validaciones verificables.",
            "when": "pruebas"
          }
        ],
        "testing": {
          "strategy": "Pirámide de pruebas: unitarias de dominio (saldo, validaciones), integración de repositorios con PostgreSQL real y aceptación de cada flujo de requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Reglas de dominio y validaciones",
              "tools": [
                "Vitest"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Repositorios y transacciones contra PostgreSQL",
              "tools": [
                "Vitest",
                "Testcontainers"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Flujos de extremo a extremo de cada requerimiento",
              "tools": [
                "Playwright"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Expediente de empleados",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Expediente de empleados»",
              "then": "No se admiten dos empleados con el mismo email",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Roles y permisos",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Roles y permisos»",
              "then": "Un empleado no puede editar expedientes ajenos",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Contratos por empleado",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Contratos por empleado»",
              "then": "Al activar un contrato se desactiva el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Solicitud de vacaciones",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Solicitud de vacaciones»",
              "then": "Una solicitud con días mayores que el saldo se rechaza con motivo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Aprobación de vacaciones",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Aprobación de vacaciones»",
              "then": "Aprobar una solicitud descuenta sus días del saldo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Registro de asistencia",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Registro de asistencia»",
              "then": "No se duplica la entrada de un empleado en la misma fecha",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Organigrama por departamento",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Organigrama por departamento»",
              "then": "Cada departamento lista sus empleados activos",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Panel de métricas de RRHH",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Panel de métricas de RRHH»",
              "then": "Las métricas se calculan desde los datos reales",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Exportación de informes",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Exportación de informes»",
              "then": "El CSV incluye las columnas del expediente visibles en pantalla",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Saldo de vacaciones limitado",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Saldo de vacaciones limitado»",
              "then": "El saldo nunca es negativo",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Todos los requerimientos con su caso de aceptación en verde",
            "Migraciones aplicadas y datos semilla cargados sin errores",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias",
            "Revisión humana de la entrega antes de publicar"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de usuario y puesta en marcha",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Administrador y usuario final",
            "contents": [
              "Instalación",
              "Primeros pasos",
              "Preguntas frecuentes"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documentación técnica y de arquitectura",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Modelo de datos",
              "Decisiones técnicas",
              "Estructura de carpetas"
            ]
          },
          {
            "id": "dl-03",
            "title": "Contrato de API y datos",
            "kind": "api",
            "format": "OpenAPI + SQL",
            "audience": "Integradores",
            "contents": [
              "Endpoints",
              "Esquema de base de datos",
              "Datos semilla"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Exponer datos personales sin comprobar el rol",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar departamentos, días de vacaciones y roles antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar nombres, campos y alcance al negocio real antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización y el wizard permiten adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Expediente de empleados",
                    "Contratos",
                    "Vacaciones con aprobación"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-stack",
          "question_es": "¿Stack de implementación?",
          "question_en": "Implementation stack?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "node",
              "label_es": "Node (Express + React) + PostgreSQL",
              "label_en": "Node (Express + React) + PostgreSQL",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Express + React"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "TypeScript"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "PostgreSQL"
                }
              ]
            },
            {
              "id": "php",
              "label_es": "PHP (Laravel + Blade) + MySQL",
              "label_en": "PHP (Laravel + Blade) + MySQL",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Laravel + Blade"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "PHP"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "MySQL"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ],
      "tpp_profile": "web-app"
    },
    {
      "id": "facturacion-pyme",
      "types": [
        "gestión",
        "finanzas"
      ],
      "name_es": "Facturación pyme con impuestos y cobros",
      "name_en": "SMB invoicing with taxes and payments",
      "summary_es": "Emisión de facturas para pyme: clientes, productos, líneas con impuestos, numeración correlativa, cobros parciales y panel de ventas e IVA.",
      "summary_en": "Invoicing for SMBs: customers, products, taxed lines, sequential numbering, partial payments and a sales/VAT dashboard.",
      "expert_id": "fint-sterling",
      "skills": [
        "domain-driven-design",
        "transactions-isolation",
        "data-modeling",
        "error-handling-design"
      ],
      "pieces": [
        "node-express-rest-base",
        "auth-jwt-express",
        "prisma-data-access",
        "error-envelope-rest",
        "pagination-cursor-sql"
      ],
      "mockups": [
        "m-pos-checkout",
        "m-report-dashboard",
        "m-admin-crud"
      ],
      "resources": [
        "tabler",
        "lucide",
        "googlefonts"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "TypeScript"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "gestión",
          "finanzas"
        ],
        "non_goals": [
          "Contabilidad completa",
          "Presentación telemática",
          "Pasarela de pago"
        ],
        "visual_style": "Interfaz administrativa sobria y legible",
        "asset_sources": [
          "Tabler Icons",
          "Lucide"
        ],
        "mockup": "m-pos-checkout"
      },
      "document": {
        "name": "Facturación pyme con impuestos y cobros",
        "schema_version": 1,
        "identity": {
          "name": "Facturación pyme con impuestos y cobros",
          "description": "Sistema de facturación para una pyme que emite facturas con impuestos, controla cobros y resume ventas e IVA repercutido.",
          "problem": "La pyme factura en una hoja de cálculo sin numeración fiable, calcula el IVA a mano y no sabe qué facturas están cobradas: se duplican números y se pierden cobros.",
          "vision": "Emitir una factura correcta en menos de un minuto y saber en todo momento qué se ha cobrado y qué IVA hay que repercutir.",
          "goals": [
            "Numeración correlativa sin huecos",
            "Cálculo automático de impuestos",
            "Control de cobros por factura"
          ],
          "specific_goals": [
            "Eliminar números de factura duplicados",
            "Calcular base, IVA y total por línea",
            "Conciliar cobros parciales y totales"
          ],
          "users": [
            "Administrador (configura impuestos y series)",
            "Empleado de facturación (emite y cobra)",
            "Contable (consulta ventas e IVA)"
          ],
          "use_cases": [
            "Emitir una factura con varias líneas",
            "Registrar un cobro parcial",
            "Consultar el IVA del trimestre"
          ],
          "scope": [
            "Clientes y productos",
            "Facturas con líneas e impuestos",
            "Numeración por serie",
            "Cobros",
            "Panel de ventas e IVA"
          ],
          "out_of_scope": [
            "Contabilidad completa y asientos",
            "Presentación telemática de impuestos",
            "Pasarela de pago en línea"
          ],
          "constraints": [
            "La numeración no puede tener huecos ni duplicados",
            "Los importes se calculan con precisión decimal",
            "Sin servicios de pago externos"
          ],
          "success_metrics": [
            "Cero facturas duplicadas en pruebas de concurrencia",
            "Total e IVA correctos en todos los casos",
            "Estado de cobro visible por factura"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Clientes y productos",
            "statement": "Se gestionan clientes con NIF único y productos con precio e impuesto por defecto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se admiten dos clientes con el mismo NIF",
              "Un producto inactivo no se ofrece al facturar"
            ],
            "links": [
              "entity:cliente",
              "entity:producto",
              "mockup:m-admin-crud"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "permission",
            "title": "Roles y permisos de facturación",
            "statement": "Solo usuarios autorizados emiten facturas y registran cobros; el contable tiene acceso de lectura.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un usuario de solo lectura no puede emitir",
              "Registrar un cobro requiere rol de facturación"
            ],
            "links": [
              "entity:factura"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Emisión de factura con líneas",
            "statement": "Una factura agrupa líneas de producto con cantidad, precio e impuesto y calcula base, impuestos y total.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El total es la suma de bases más impuestos de todas las líneas",
              "Una factura sin líneas no se puede emitir"
            ],
            "links": [
              "entity:factura",
              "entity:linea_factura",
              "mockup:m-pos-checkout",
              "process:p-emitir-factura"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Numeración correlativa por serie",
            "statement": "Al emitir, la factura toma el siguiente número de su serie y el contador avanza dentro de la misma transacción.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Dos emisiones concurrentes no producen el mismo número",
              "La numeración no deja huecos al confirmar"
            ],
            "links": [
              "entity:serie",
              "entity:factura",
              "process:p-emitir-factura"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "business_rule",
            "title": "Cálculo de impuestos",
            "statement": "Cada línea calcula su base y su impuesto según el tipo; la factura suma los impuestos por tipo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El impuesto de línea es base por tipo",
              "El desglose por tipo cuadra con el total de impuestos"
            ],
            "links": [
              "entity:linea_factura",
              "entity:factura"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Registro de cobros",
            "statement": "Se registran cobros parciales o totales contra una factura emitida y se actualiza su estado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un cobro mayor que el pendiente se rechaza",
              "Al cobrar el total la factura pasa a estado cobrada"
            ],
            "links": [
              "entity:cobro",
              "entity:factura",
              "process:p-registrar-cobro"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Panel de ventas e IVA",
            "statement": "Un panel resume ventas del periodo, IVA repercutido por tipo y facturas pendientes de cobro.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Las ventas suman solo facturas emitidas",
              "El IVA por tipo coincide con el desglose de las facturas"
            ],
            "links": [
              "entity:factura",
              "mockup:m-report-dashboard"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Consulta y filtrado de facturas",
            "statement": "El listado filtra por cliente, serie, estado y fechas con paginación.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los filtros se combinan correctamente",
              "La paginación no repite ni omite facturas"
            ],
            "links": [
              "entity:factura",
              "mockup:m-admin-crud"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Exportación del libro de facturas",
            "statement": "Se exporta a CSV el libro de facturas emitidas del periodo con base, impuestos y total.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El CSV incluye una fila por factura emitida",
              "Los importes exportados cuadran con el panel"
            ],
            "links": [
              "entity:factura",
              "mockup:m-report-dashboard"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Factura emitida inmutable",
            "statement": "Una factura emitida no se edita en sus importes; los errores se corrigen con una factura rectificativa.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Editar importes de una factura emitida se rechaza",
              "El estado borrador sí permite edición"
            ],
            "links": [
              "entity:factura"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "negocio",
            "title": "Facturación de una pyme de servicios",
            "summary": "Volumen moderado de facturas mensuales con IVA general y reducido; cobros a veces parciales.",
            "source_note": "Supuesto de la plantilla genérica."
          },
          {
            "id": "ctx-02",
            "kind": "legal",
            "title": "Requisitos de numeración e impuestos",
            "summary": "Las facturas exigen numeración correlativa por serie y desglose de base e impuestos; ajustar tipos a la legislación local.",
            "source_note": "Normativa de facturación habitual; verificar el país de uso."
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "TypeScript",
          "framework": "Express + React",
          "style": "Monolito modular por capas",
          "database": "PostgreSQL",
          "data_access": "Prisma (repositorio por entidad)",
          "api_style": "REST JSON",
          "auth": "JWT con roles",
          "infrastructure": "Contenedor Docker",
          "hosting": "VPS propio o nube",
          "external_services": [
            "Correo transaccional"
          ],
          "dependencies": [
            "Node 20",
            "Express",
            "Prisma",
            "React",
            "PostgreSQL 16"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI/CD con migraciones"
        },
        "decisions": [
          {
            "id": "d-base",
            "topic": "base de datos",
            "choice": "PostgreSQL",
            "rationale": "Transacciones ACID para numeración correlativa y cobros; tipo numeric para importes exactos.",
            "alternatives": [
              "MySQL",
              "SQLite"
            ],
            "status": "accepted"
          },
          {
            "id": "d-cálculo",
            "topic": "cálculo de importes",
            "choice": "Aritmética decimal en servidor",
            "rationale": "Evita errores de coma flotante en base, IVA y total; el cliente solo muestra.",
            "alternatives": [
              "Cálculo en cliente",
              "Enteros en céntimos"
            ],
            "status": "accepted"
          },
          {
            "id": "d-numeración",
            "topic": "numeración",
            "choice": "Serie con contador transaccional",
            "rationale": "Un contador por serie dentro de la transacción de emisión garantiza correlativo sin huecos.",
            "alternatives": [
              "UUID como número",
              "Numeración manual"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "cliente",
              "name": "cliente",
              "description": "Destinatario de las facturas.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nif",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "email",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "direccion",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "creado_en",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "nif"
              ],
              "rules": [
                "NIF único por cliente"
              ]
            },
            {
              "id": "producto",
              "name": "producto",
              "description": "Bien o servicio facturable con su precio e impuesto.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio_unitario",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo_impuesto",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "activo",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": [
                "El precio y el impuesto no pueden ser negativos"
              ]
            },
            {
              "id": "serie",
              "name": "serie",
              "description": "Serie de numeración con su contador.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "codigo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "ejercicio",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "siguiente_numero",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "codigo",
                "ejercicio"
              ],
              "rules": [
                "Una serie por ejercicio"
              ]
            },
            {
              "id": "factura",
              "name": "factura",
              "description": "Documento de venta con estado de cobro.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cliente_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "cliente.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "serie_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "serie.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "numero",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "base",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "impuestos",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "total",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cobrado",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "cliente_id",
                "serie_id",
                "estado"
              ],
              "rules": [
                "Número único por serie y ejercicio",
                "Estado: borrador, emitida, cobrada"
              ]
            },
            {
              "id": "linea_factura",
              "name": "linea_factura",
              "description": "Concepto facturado con cantidad, precio e impuesto.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "factura_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "factura.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "producto_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "producto.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cantidad",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio_unitario",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo_impuesto",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "base_linea",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "impuesto_linea",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "factura_id"
              ],
              "rules": [
                "La base de línea es cantidad por precio"
              ]
            },
            {
              "id": "cobro",
              "name": "cobro",
              "description": "Pago recibido contra una factura.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "factura_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "factura.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "importe",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "date",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "metodo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "factura_id"
              ],
              "rules": [
                "El importe cobrado no puede exceder el total"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-cliente-factura",
              "kind": "one_to_many",
              "from": "cliente",
              "to": "factura",
              "label": "recibe"
            },
            {
              "id": "r-serie-factura",
              "kind": "one_to_many",
              "from": "serie",
              "to": "factura",
              "label": "numera"
            },
            {
              "id": "r-factura-linea_factura",
              "kind": "one_to_many",
              "from": "factura",
              "to": "linea_factura",
              "label": "contiene"
            },
            {
              "id": "r-producto-linea_factura",
              "kind": "one_to_many",
              "from": "producto",
              "to": "linea_factura",
              "label": "se factura como"
            },
            {
              "id": "r-factura-cobro",
              "kind": "one_to_many",
              "from": "factura",
              "to": "cobro",
              "label": "se cobra con"
            }
          ],
          "seed_data": [
            "Serie A del ejercicio en curso con contador 1",
            "IVA general 21% y reducido 10%",
            "Cliente y producto de ejemplo"
          ],
          "migrations": [
            "001_clientes_productos_series",
            "002_facturas_lineas_cobros",
            "003_restriccion_numero_unico_por_serie"
          ]
        },
        "processes": [
          {
            "id": "p-emitir-factura",
            "name": "Emisión de factura",
            "summary": "Calcula importes, toma número de serie y persiste en una transacción.",
            "trigger": "El usuario confirma una factura con líneas",
            "inputs": [
              "factura",
              "linea_factura",
              "serie"
            ],
            "outputs": [
              "factura",
              "serie"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "serie",
                  "query": "id y siguiente_numero",
                  "into": "serie"
                },
                {
                  "op": "si",
                  "condition": "factura tiene lineas y usuario puede_emitir",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "linea_factura",
                      "value": "{factura_id, producto_id, cantidad, precio_unitario, tipo_impuesto, base_linea, impuesto_linea}"
                    },
                    {
                      "op": "guardar",
                      "target": "factura",
                      "value": "{cliente_id, serie_id, numero: serie.siguiente_numero, base, impuestos, total, estado: emitida}"
                    },
                    {
                      "op": "guardar",
                      "target": "serie",
                      "value": "{siguiente_numero: serie.siguiente_numero + 1}"
                    },
                    {
                      "op": "devolver",
                      "value": "factura"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Factura sin líneas o sin permiso",
                      "code": "FACTURA_INVALIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "FACTURA_INVALIDA: sin líneas o el usuario no puede emitir"
            ],
            "rules": [
              "Número y contador avanzan en la misma transacción",
              "Los importes se calculan en decimal"
            ],
            "links": [
              "requirement:FR-003",
              "requirement:FR-004",
              "entity:factura",
              "entity:serie"
            ]
          },
          {
            "id": "p-registrar-cobro",
            "name": "Registro de cobro",
            "summary": "Aplica un cobro y actualiza el estado de la factura.",
            "trigger": "Se recibe un pago contra una factura emitida",
            "inputs": [
              "cobro",
              "factura"
            ],
            "outputs": [
              "cobro",
              "factura"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "factura",
                  "query": "id, total, cobrado y estado",
                  "into": "factura"
                },
                {
                  "op": "si",
                  "condition": "factura emitida y importe <= total - cobrado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "cobro",
                      "value": "{factura_id, importe, fecha, metodo}"
                    },
                    {
                      "op": "guardar",
                      "target": "factura",
                      "value": "{cobrado: factura.cobrado + importe, estado: calculado}"
                    },
                    {
                      "op": "devolver",
                      "value": "cobro"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "El cobro excede el pendiente o la factura no está emitida",
                      "code": "COBRO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "COBRO_INVALIDO: importe mayor que el pendiente o factura no emitida"
            ],
            "rules": [
              "El estado pasa a cobrada cuando cobrado iguala total"
            ],
            "links": [
              "requirement:FR-006",
              "entity:cobro",
              "entity:factura"
            ]
          },
          {
            "id": "p-resumir-iva",
            "name": "Resumen de ventas e IVA",
            "summary": "Agrega ventas e impuestos del periodo para el panel.",
            "trigger": "El contable abre el panel y elige periodo",
            "inputs": [
              "factura",
              "linea_factura"
            ],
            "outputs": [
              "factura"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "factura",
                  "query": "emitidas del periodo con base, impuestos y total",
                  "into": "facturas"
                },
                {
                  "op": "guardar",
                  "target": "repositorio",
                  "value": "{ventas: suma(total), iva_por_tipo: agrupado, pendientes: no cobradas}"
                },
                {
                  "op": "devolver",
                  "value": "resumen"
                }
              ]
            },
            "errors": [
              "PERIODO_INVALIDO: fechas de inicio posteriores a fin"
            ],
            "rules": [
              "Solo se agregan facturas emitidas",
              "El IVA se agrupa por tipo"
            ],
            "links": [
              "requirement:FR-007",
              "entity:factura"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes de facturación",
            "description": "Emisión transaccional y consulta de ventas.",
            "layout": "layered",
            "nodes": [
              {
                "id": "ui",
                "label": "React (facturación y panel)",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "api",
                "label": "API REST Express",
                "shape": "box",
                "group": "aplicación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "dominio",
                "label": "Servicio de facturación",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "tx",
                "label": "Transacción de emisión",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "datos",
                "label": "PostgreSQL (numeric)",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-ui-api",
                "from": "ui",
                "to": "api",
                "label": "HTTP JSON",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-api-dominio",
                "from": "api",
                "to": "dominio",
                "label": "casos de uso",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-dominio-tx",
                "from": "dominio",
                "to": "tx",
                "label": "numera y calcula",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-tx-datos",
                "from": "tx",
                "to": "datos",
                "label": "ACID",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Interfaz administrativa sobria, densa en datos y legible",
          "palette": [
            {
              "name": "Morado",
              "hex": "#6B21A8",
              "usage": "Acciones primarias y navegación"
            },
            {
              "name": "Pizarra",
              "hex": "#0F172A",
              "usage": "Texto y fondos oscuros"
            },
            {
              "name": "Ámbar",
              "hex": "#F59E0B",
              "usage": "Avisos y estados pendientes"
            },
            {
              "name": "Verde",
              "hex": "#16A34A",
              "usage": "Confirmaciones y estados activos"
            }
          ],
          "typography": [
            "Montserrat para títulos",
            "Fuente de sistema para tablas y formularios"
          ],
          "components": [
            "Tabla con filtros y paginación",
            "Formulario lateral",
            "Tarjeta de métrica",
            "Modal de confirmación"
          ],
          "navigation": "Barra lateral por módulos; migas de pan en el detalle",
          "responsive_notes": "Tablas con scroll horizontal en móvil; formularios a una columna",
          "asset_sources": [
            "Tabler Icons",
            "Lucide",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-pos-checkout",
            "name": "Editor de factura",
            "screen": "Líneas e importes",
            "notes": "Rejilla de líneas con cantidad, precio e impuesto y totales en vivo."
          },
          {
            "mockup_id": "m-report-dashboard",
            "name": "Panel de ventas e IVA",
            "screen": "Métricas del periodo",
            "notes": "Ventas, IVA por tipo y pendientes de cobro."
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Clientes y productos",
            "screen": "Catálogos",
            "notes": "Tablas con filtros y formulario de alta."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "domain-driven-design",
            "name": "Diseño guiado por el dominio",
            "purpose": "Modelar factura, línea y cobro con invariantes claras.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "transactions-isolation",
            "name": "Transacciones y aislamiento",
            "purpose": "Numeración correlativa y cobros sin condiciones de carrera.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "data-modeling",
            "name": "Modelado de datos",
            "purpose": "Esquema con importes decimales y relaciones íntegras.",
            "when": "diseño"
          },
          {
            "id": "sk-04",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Códigos de dominio para emisión y cobro inválidos.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de cálculo decimal e invariantes, integración de la transacción de emisión con concurrencia real y aceptación de cada flujo de facturación.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Reglas de dominio y validaciones",
              "tools": [
                "Vitest"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Repositorios y transacciones contra PostgreSQL",
              "tools": [
                "Vitest",
                "Testcontainers"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Flujos de extremo a extremo de cada requerimiento",
              "tools": [
                "Playwright"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Clientes y productos",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Clientes y productos»",
              "then": "No se admiten dos clientes con el mismo NIF",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Roles y permisos de facturación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Roles y permisos de facturación»",
              "then": "Un usuario de solo lectura no puede emitir",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Emisión de factura con líneas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Emisión de factura con líneas»",
              "then": "El total es la suma de bases más impuestos de todas las líneas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Numeración correlativa por serie",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Numeración correlativa por serie»",
              "then": "Dos emisiones concurrentes no producen el mismo número",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Cálculo de impuestos",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Cálculo de impuestos»",
              "then": "El impuesto de línea es base por tipo",
              "level": "acceptance",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Registro de cobros",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Registro de cobros»",
              "then": "Un cobro mayor que el pendiente se rechaza",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Panel de ventas e IVA",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Panel de ventas e IVA»",
              "then": "Las ventas suman solo facturas emitidas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Consulta y filtrado de facturas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Consulta y filtrado de facturas»",
              "then": "Los filtros se combinan correctamente",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Exportación del libro de facturas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Exportación del libro de facturas»",
              "then": "El CSV incluye una fila por factura emitida",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Factura emitida inmutable",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Factura emitida inmutable»",
              "then": "Editar importes de una factura emitida se rechaza",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Todos los requerimientos con su caso de aceptación en verde",
            "Migraciones aplicadas y datos semilla cargados sin errores",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias",
            "Revisión humana de la entrega antes de publicar"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de usuario y puesta en marcha",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Administrador y usuario final",
            "contents": [
              "Instalación",
              "Primeros pasos",
              "Preguntas frecuentes"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documentación técnica y de arquitectura",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Modelo de datos",
              "Decisiones técnicas",
              "Estructura de carpetas"
            ]
          },
          {
            "id": "dl-03",
            "title": "Contrato de API y datos",
            "kind": "api",
            "format": "OpenAPI + SQL",
            "audience": "Integradores",
            "contents": [
              "Endpoints",
              "Esquema de base de datos",
              "Datos semilla"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Calcular importes con coma flotante",
            "Editar importes de una factura emitida"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar tipos de impuesto, series y moneda antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar nombres, campos y alcance al negocio real antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización y el wizard permiten adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Clientes y productos",
                    "Facturas con impuestos",
                    "Cobros"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-stack",
          "question_es": "¿Stack de implementación?",
          "question_en": "Implementation stack?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "node",
              "label_es": "Node (Express + React) + PostgreSQL",
              "label_en": "Node (Express + React) + PostgreSQL",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Express + React"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "TypeScript"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "PostgreSQL"
                }
              ]
            },
            {
              "id": "php",
              "label_es": "PHP (Laravel + Blade) + MySQL",
              "label_en": "PHP (Laravel + Blade) + MySQL",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Laravel + Blade"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "PHP"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "MySQL"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ],
      "tpp_profile": "web-app"
    },
    {
      "id": "inventario-pos",
      "types": [
        "gestión",
        "logística"
      ],
      "name_es": "Inventario y punto de venta",
      "name_en": "Inventory and point of sale",
      "summary_es": "Control de stock y caja para comercio: productos con existencias, movimientos de entrada y salida, ventas en mostrador, proveedores y alertas de stock mínimo.",
      "summary_en": "Stock and checkout control for retail: products with stock, inbound/outbound movements, counter sales, suppliers and low-stock alerts.",
      "expert_id": "logis-truck",
      "skills": [
        "data-modeling",
        "transactions-isolation",
        "rest-api-design",
        "error-handling-design"
      ],
      "pieces": [
        "node-express-rest-base",
        "auth-jwt-express",
        "prisma-data-access",
        "error-envelope-rest",
        "pagination-cursor-sql"
      ],
      "mockups": [
        "m-pos-checkout",
        "m-logistics-tracking",
        "m-admin-crud",
        "m-report-dashboard"
      ],
      "resources": [
        "tabler",
        "lucide"
      ],
      "brief": {
        "platforms": [
          "web"
        ],
        "languages": [
          "TypeScript"
        ],
        "databases": [
          "PostgreSQL"
        ],
        "project_types": [
          "gestión",
          "logística"
        ],
        "non_goals": [
          "Facturación fiscal",
          "Tienda en línea",
          "Multi-almacén"
        ],
        "visual_style": "Interfaz administrativa sobria y legible",
        "asset_sources": [
          "Tabler Icons",
          "Lucide"
        ],
        "mockup": "m-pos-checkout"
      },
      "document": {
        "name": "Inventario y punto de venta",
        "schema_version": 1,
        "identity": {
          "name": "Inventario y punto de venta",
          "description": "Sistema de inventario y punto de venta para un comercio que controla existencias, registra ventas y repone stock con proveedores.",
          "problem": "El comercio no sabe qué hay en almacén: las ventas no descuentan stock fiable, se venden productos agotados y las reposiciones se hacen tarde y sin registro.",
          "vision": "Que cada venta descuente stock al instante y el responsable sepa qué reponer antes de quedarse sin producto.",
          "goals": [
            "Stock exacto por producto",
            "Venta en mostrador que descuenta existencias",
            "Reposición con alerta de mínimo"
          ],
          "specific_goals": [
            "Cero ventas de producto agotado",
            "Trazar cada movimiento de entrada y salida",
            "Alertar al llegar al stock mínimo"
          ],
          "users": [
            "Cajero (vende en mostrador)",
            "Responsable de almacén (entradas y ajustes)",
            "Administrador (productos y proveedores)"
          ],
          "use_cases": [
            "Cobrar una venta de varios productos",
            "Registrar una entrada de proveedor",
            "Consultar alertas de stock mínimo"
          ],
          "scope": [
            "Productos y existencias",
            "Movimientos de stock",
            "Ventas en mostrador",
            "Proveedores y entradas",
            "Alertas de stock mínimo"
          ],
          "out_of_scope": [
            "Facturación fiscal completa",
            "Tienda en línea",
            "Multi-almacén con transferencias"
          ],
          "constraints": [
            "El stock nunca puede quedar negativo",
            "Cada venta es una transacción que descuenta existencias",
            "Sin servicios externos de pago"
          ],
          "success_metrics": [
            "Stock correcto tras cada venta en pruebas",
            "Ninguna venta de producto agotado",
            "Alertas emitidas al cruzar el mínimo"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Catálogo de productos",
            "statement": "Se gestionan productos con SKU único, precio, coste, stock y stock mínimo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se admiten dos productos con el mismo SKU",
              "Un producto inactivo no se ofrece en el punto de venta"
            ],
            "links": [
              "entity:producto",
              "mockup:m-admin-crud"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "permission",
            "title": "Roles y permisos del comercio",
            "statement": "Cajero vende, almacén registra entradas y admin gestiona productos; cada acción comprueba el rol.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un cajero no puede ajustar stock a mano",
              "Solo almacén y admin registran entradas"
            ],
            "links": [
              "entity:usuario"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Venta en mostrador",
            "statement": "El cajero arma un ticket con varias líneas y lo cobra; la venta descuenta el stock de cada producto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Una venta con un producto sin existencias se rechaza",
              "Al cobrar, el stock de cada línea queda descontado"
            ],
            "links": [
              "entity:venta",
              "entity:linea_venta",
              "entity:producto",
              "mockup:m-pos-checkout",
              "process:p-cobrar-venta"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Movimientos de stock",
            "statement": "Toda entrada, salida o ajuste genera un movimiento trazable con usuario, motivo y fecha.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cada cambio de stock tiene un movimiento asociado",
              "Una salida mayor que el stock se rechaza"
            ],
            "links": [
              "entity:movimiento_stock",
              "entity:producto",
              "process:p-entrada-stock"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Entradas de proveedor",
            "statement": "Se registra una entrada de mercancía de un proveedor que suma existencias y deja movimiento.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La entrada suma la cantidad al stock del producto",
              "Queda registrado el proveedor y el motivo"
            ],
            "links": [
              "entity:movimiento_stock",
              "entity:proveedor",
              "process:p-entrada-stock"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "business_rule",
            "title": "Alertas de stock mínimo",
            "statement": "El sistema marca los productos cuyo stock cae en o por debajo del mínimo y los lista para reponer.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un producto en mínimo aparece en la lista de reposición",
              "La alerta se recalcula tras cada movimiento"
            ],
            "links": [
              "entity:producto",
              "mockup:m-logistics-tracking"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Panel de inventario y ventas",
            "statement": "Un panel resume valor del stock, ventas del día y productos bajo mínimo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El valor del stock suma coste por existencias",
              "Las ventas del día excluyen tickets anulados"
            ],
            "links": [
              "entity:producto",
              "entity:venta",
              "mockup:m-report-dashboard"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Anulación de venta",
            "statement": "Una venta cobrada puede anularse y devuelve el stock de sus líneas mediante movimientos.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Anular una venta repone el stock de cada línea",
              "Una venta ya anulada no se puede anular de nuevo"
            ],
            "links": [
              "entity:venta",
              "entity:movimiento_stock",
              "process:p-anular-venta"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Exportación de inventario",
            "statement": "Se exporta a CSV el inventario actual con stock, mínimo y valor por producto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El CSV incluye una fila por producto activo",
              "El valor exportado cuadra con el panel"
            ],
            "links": [
              "entity:producto",
              "mockup:m-report-dashboard"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Stock nunca negativo",
            "statement": "Ninguna operación puede dejar el stock de un producto por debajo de cero; la venta y la salida se validan antes de aplicar.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El stock nunca es negativo tras cualquier operación",
              "Las operaciones concurrentes no sobrevenden"
            ],
            "links": [
              "entity:producto",
              "entity:movimiento_stock"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "operativo",
            "title": "Comercio con un solo almacén",
            "summary": "Mostrador con caja, almacén trasero y reposición periódica a proveedores; un solo punto de venta.",
            "source_note": "Supuesto de la plantilla genérica."
          },
          {
            "id": "ctx-02",
            "kind": "negocio",
            "title": "Margen y rotación",
            "summary": "Interesa conocer el coste del stock y qué productos rotan; la reposición se decide por mínimo y consumo.",
            "source_note": "Necesidad habitual de un comercio minorista."
          }
        ],
        "architecture": {
          "platform": "web",
          "language": "TypeScript",
          "framework": "Express + React",
          "style": "Monolito modular por capas",
          "database": "PostgreSQL",
          "data_access": "Prisma (repositorio por entidad)",
          "api_style": "REST JSON",
          "auth": "JWT con roles",
          "infrastructure": "Contenedor Docker",
          "hosting": "VPS propio o nube",
          "external_services": [
            "Correo transaccional"
          ],
          "dependencies": [
            "Node 20",
            "Express",
            "Prisma",
            "React",
            "PostgreSQL 16"
          ],
          "environments": [
            "desarrollo",
            "producción"
          ],
          "deploy_strategy": "CI/CD con migraciones"
        },
        "decisions": [
          {
            "id": "d-base",
            "topic": "base de datos",
            "choice": "PostgreSQL",
            "rationale": "Transacciones para descontar stock en la venta y bloqueo de fila que evita sobreventa concurrente.",
            "alternatives": [
              "MySQL",
              "SQLite"
            ],
            "status": "accepted"
          },
          {
            "id": "d-control",
            "topic": "control de stock",
            "choice": "Movimiento como fuente de verdad",
            "rationale": "Las existencias se derivan de movimientos de entrada y salida; cada cambio queda trazado y es auditable.",
            "alternatives": [
              "Contador editable a mano",
              "Stock solo en memoria"
            ],
            "status": "accepted"
          },
          {
            "id": "d-punto",
            "topic": "punto de venta",
            "choice": "Venta transaccional con bloqueo",
            "rationale": "La venta bloquea las filas de producto, valida existencias y descuenta en una transacción.",
            "alternatives": [
              "Descuento asíncrono",
              "Sin validación de stock"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "producto",
              "name": "producto",
              "description": "Artículo a la venta con su stock y mínimo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "sku",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio_venta",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "coste",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "stock",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "stock_minimo",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "activo",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "sku"
              ],
              "rules": [
                "SKU único",
                "El stock no puede ser negativo"
              ]
            },
            {
              "id": "proveedor",
              "name": "proveedor",
              "description": "Suministrador de productos.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "contacto",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "email",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [],
              "rules": [
                "Nombre único por proveedor"
              ]
            },
            {
              "id": "movimiento_stock",
              "name": "movimiento_stock",
              "description": "Entrada o salida que cambia las existencias de un producto.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "producto_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "producto.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cantidad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "motivo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "producto_id",
                "fecha"
              ],
              "rules": [
                "Tipo: entrada, salida, ajuste",
                "La cantidad de salida no excede el stock"
              ]
            },
            {
              "id": "venta",
              "name": "venta",
              "description": "Ticket de mostrador con su total.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "total",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "usuario_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "usuario.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "fecha",
                "estado"
              ],
              "rules": [
                "Estado: cobrada, anulada"
              ]
            },
            {
              "id": "linea_venta",
              "name": "linea_venta",
              "description": "Producto y cantidad vendidos en un ticket.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "venta_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "venta.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "producto_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "producto.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cantidad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "precio_unitario",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "subtotal",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "venta_id"
              ],
              "rules": [
                "El subtotal es cantidad por precio"
              ]
            },
            {
              "id": "usuario",
              "name": "usuario",
              "description": "Cuenta del personal con su rol.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "email",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rol",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "password_hash",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "email"
              ],
              "rules": [
                "Rol: cajero, almacen, admin"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-producto-movimiento_stock",
              "kind": "one_to_many",
              "from": "producto",
              "to": "movimiento_stock",
              "label": "mueve"
            },
            {
              "id": "r-venta-linea_venta",
              "kind": "one_to_many",
              "from": "venta",
              "to": "linea_venta",
              "label": "contiene"
            },
            {
              "id": "r-producto-linea_venta",
              "kind": "one_to_many",
              "from": "producto",
              "to": "linea_venta",
              "label": "se vende en"
            },
            {
              "id": "r-usuario-venta",
              "kind": "one_to_many",
              "from": "usuario",
              "to": "venta",
              "label": "cobra"
            },
            {
              "id": "r-proveedor-movimiento_stock",
              "kind": "one_to_many",
              "from": "proveedor",
              "to": "movimiento_stock",
              "label": "abastece"
            }
          ],
          "seed_data": [
            "Productos de ejemplo con stock y mínimo",
            "Proveedor genérico",
            "Usuario cajero y usuario admin"
          ],
          "migrations": [
            "001_productos_proveedores_usuarios",
            "002_movimientos_ventas_lineas",
            "003_restriccion_stock_no_negativo"
          ]
        },
        "processes": [
          {
            "id": "p-cobrar-venta",
            "name": "Cobro de venta",
            "summary": "Valida existencias, descuenta stock y registra el ticket en una transacción.",
            "trigger": "El cajero confirma el ticket",
            "inputs": [
              "venta",
              "linea_venta",
              "producto"
            ],
            "outputs": [
              "venta",
              "movimiento_stock",
              "producto"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "producto",
                  "query": "id, stock y activo de cada linea",
                  "into": "productos"
                },
                {
                  "op": "si",
                  "condition": "todos los productos activos y stock >= cantidad",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "venta",
                      "value": "{fecha, total, usuario_id, estado: cobrada}"
                    },
                    {
                      "op": "guardar",
                      "target": "linea_venta",
                      "value": "{venta_id, producto_id, cantidad, precio_unitario, subtotal}"
                    },
                    {
                      "op": "guardar",
                      "target": "movimiento_stock",
                      "value": "{producto_id, tipo: salida, cantidad, motivo: venta, usuario_id}"
                    },
                    {
                      "op": "guardar",
                      "target": "producto",
                      "value": "{stock: stock - cantidad}"
                    },
                    {
                      "op": "devolver",
                      "value": "venta"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Producto agotado o inactivo",
                      "code": "STOCK_INSUFICIENTE"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "STOCK_INSUFICIENTE: alguna línea excede las existencias"
            ],
            "rules": [
              "El descuento y el movimiento ocurren en la misma transacción",
              "Se bloquea la fila del producto"
            ],
            "links": [
              "requirement:FR-003",
              "requirement:RN-01",
              "entity:venta",
              "entity:producto"
            ]
          },
          {
            "id": "p-entrada-stock",
            "name": "Entrada de mercancía",
            "summary": "Suma existencias y deja movimiento de entrada con proveedor.",
            "trigger": "Almacén registra una recepción",
            "inputs": [
              "movimiento_stock",
              "producto",
              "proveedor"
            ],
            "outputs": [
              "movimiento_stock",
              "producto"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "producto",
                  "query": "id y stock",
                  "into": "producto"
                },
                {
                  "op": "si",
                  "condition": "producto existe y cantidad > 0 y usuario puede_registrar_entrada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "movimiento_stock",
                      "value": "{producto_id, tipo: entrada, cantidad, motivo, usuario_id}"
                    },
                    {
                      "op": "guardar",
                      "target": "producto",
                      "value": "{stock: stock + cantidad}"
                    },
                    {
                      "op": "devolver",
                      "value": "movimiento_stock"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Producto inexistente, cantidad inválida o sin permiso",
                      "code": "ENTRADA_INVALIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "ENTRADA_INVALIDA: producto inexistente, cantidad no positiva o sin permiso"
            ],
            "rules": [
              "La entrada siempre suma al stock"
            ],
            "links": [
              "requirement:FR-005",
              "requirement:FR-004",
              "entity:movimiento_stock",
              "entity:producto"
            ]
          },
          {
            "id": "p-anular-venta",
            "name": "Anulación de venta",
            "summary": "Devuelve el stock de las líneas y marca el ticket como anulado.",
            "trigger": "Se solicita anular un ticket cobrado",
            "inputs": [
              "venta",
              "linea_venta",
              "producto"
            ],
            "outputs": [
              "venta",
              "movimiento_stock",
              "producto"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "venta",
                  "query": "id, estado y lineas",
                  "into": "venta"
                },
                {
                  "op": "si",
                  "condition": "venta cobrada y usuario puede_anular",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "movimiento_stock",
                      "value": "{producto_id, tipo: entrada, cantidad, motivo: anulacion, usuario_id}"
                    },
                    {
                      "op": "guardar",
                      "target": "producto",
                      "value": "{stock: stock + cantidad}"
                    },
                    {
                      "op": "guardar",
                      "target": "venta",
                      "value": "{estado: anulada}"
                    },
                    {
                      "op": "devolver",
                      "value": "venta"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Venta no cobrada, ya anulada o sin permiso",
                      "code": "ANULACION_INVALIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "ANULACION_INVALIDA: la venta no está cobrada, ya está anulada o falta permiso"
            ],
            "rules": [
              "Anular repone exactamente las cantidades vendidas"
            ],
            "links": [
              "requirement:FR-008",
              "entity:venta",
              "entity:producto"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes de inventario y POS",
            "description": "Venta transaccional y trazabilidad de stock.",
            "layout": "layered",
            "nodes": [
              {
                "id": "ui",
                "label": "React (POS y paneles)",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "api",
                "label": "API REST Express",
                "shape": "box",
                "group": "aplicación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "dominio",
                "label": "Servicio de inventario",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "tx",
                "label": "Transacción de venta",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "datos",
                "label": "PostgreSQL",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-ui-api",
                "from": "ui",
                "to": "api",
                "label": "HTTP JSON",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-api-dominio",
                "from": "api",
                "to": "dominio",
                "label": "casos de uso",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-dominio-tx",
                "from": "dominio",
                "to": "tx",
                "label": "descuenta stock",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-tx-datos",
                "from": "tx",
                "to": "datos",
                "label": "bloqueo de fila",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Interfaz administrativa sobria, densa en datos y legible",
          "palette": [
            {
              "name": "Morado",
              "hex": "#6B21A8",
              "usage": "Acciones primarias y navegación"
            },
            {
              "name": "Pizarra",
              "hex": "#0F172A",
              "usage": "Texto y fondos oscuros"
            },
            {
              "name": "Ámbar",
              "hex": "#F59E0B",
              "usage": "Avisos y estados pendientes"
            },
            {
              "name": "Verde",
              "hex": "#16A34A",
              "usage": "Confirmaciones y estados activos"
            }
          ],
          "typography": [
            "Montserrat para títulos",
            "Fuente de sistema para tablas y formularios"
          ],
          "components": [
            "Tabla con filtros y paginación",
            "Formulario lateral",
            "Tarjeta de métrica",
            "Modal de confirmación"
          ],
          "navigation": "Barra lateral por módulos; migas de pan en el detalle",
          "responsive_notes": "Tablas con scroll horizontal en móvil; formularios a una columna",
          "asset_sources": [
            "Tabler Icons",
            "Lucide",
            "Google Fonts"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-pos-checkout",
            "name": "Punto de venta",
            "screen": "Ticket de mostrador",
            "notes": "Búsqueda de producto, líneas y total con cobro rápido."
          },
          {
            "mockup_id": "m-logistics-tracking",
            "name": "Reposición y alertas",
            "screen": "Stock bajo mínimo",
            "notes": "Lista de productos a reponer con su mínimo y existencias."
          },
          {
            "mockup_id": "m-admin-crud",
            "name": "Productos y proveedores",
            "screen": "Catálogos",
            "notes": "Tablas con filtros y formularios de alta."
          },
          {
            "mockup_id": "m-report-dashboard",
            "name": "Panel de inventario",
            "screen": "Métricas de stock y ventas",
            "notes": "Valor del stock, ventas del día y productos bajo mínimo."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "data-modeling",
            "name": "Modelado de datos",
            "purpose": "Producto, movimiento y venta con integridad de stock.",
            "when": "diseño"
          },
          {
            "id": "sk-02",
            "skill_id": "transactions-isolation",
            "name": "Transacciones y aislamiento",
            "purpose": "Descuento de stock sin sobreventa concurrente.",
            "when": "implementación"
          },
          {
            "id": "sk-03",
            "skill_id": "rest-api-design",
            "name": "Diseño de API REST",
            "purpose": "Recursos de inventario y venta coherentes.",
            "when": "diseño"
          },
          {
            "id": "sk-04",
            "skill_id": "error-handling-design",
            "name": "Diseño de errores",
            "purpose": "Códigos de stock insuficiente y operación inválida.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la regla de stock no negativo, integración de venta concurrente con PostgreSQL real y aceptación de cada flujo de inventario y caja.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Reglas de dominio y validaciones",
              "tools": [
                "Vitest"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Repositorios y transacciones contra PostgreSQL",
              "tools": [
                "Vitest",
                "Testcontainers"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Flujos de extremo a extremo de cada requerimiento",
              "tools": [
                "Playwright"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Catálogo de productos",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Catálogo de productos»",
              "then": "No se admiten dos productos con el mismo SKU",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Roles y permisos del comercio",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Roles y permisos del comercio»",
              "then": "Un cajero no puede ajustar stock a mano",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Venta en mostrador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Venta en mostrador»",
              "then": "Una venta con un producto sin existencias se rechaza",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Movimientos de stock",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Movimientos de stock»",
              "then": "Cada cambio de stock tiene un movimiento asociado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Entradas de proveedor",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Entradas de proveedor»",
              "then": "La entrada suma la cantidad al stock del producto",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Alertas de stock mínimo",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Alertas de stock mínimo»",
              "then": "Un producto en mínimo aparece en la lista de reposición",
              "level": "acceptance",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Panel de inventario y ventas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Panel de inventario y ventas»",
              "then": "El valor del stock suma coste por existencias",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Anulación de venta",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Anulación de venta»",
              "then": "Anular una venta repone el stock de cada línea",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Exportación de inventario",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Exportación de inventario»",
              "then": "El CSV incluye una fila por producto activo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Stock nunca negativo",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Stock nunca negativo»",
              "then": "El stock nunca es negativo tras cualquier operación",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Todos los requerimientos con su caso de aceptación en verde",
            "Migraciones aplicadas y datos semilla cargados sin errores",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias",
            "Revisión humana de la entrega antes de publicar"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de usuario y puesta en marcha",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Administrador y usuario final",
            "contents": [
              "Instalación",
              "Primeros pasos",
              "Preguntas frecuentes"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documentación técnica y de arquitectura",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Modelo de datos",
              "Decisiones técnicas",
              "Estructura de carpetas"
            ]
          },
          {
            "id": "dl-03",
            "title": "Contrato de API y datos",
            "kind": "api",
            "format": "OpenAPI + SQL",
            "audience": "Integradores",
            "contents": [
              "Endpoints",
              "Esquema de base de datos",
              "Datos semilla"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar requerimientos no aprobados",
            "Dejar stock negativo en ninguna operación",
            "Descontar stock fuera de una transacción"
          ],
          "workflow": [
            "Leer el contrato completo antes de tocar código",
            "Implementar por proceso con sus pruebas",
            "Verificar cada criterio de aceptación antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Evaluación del documento sin hallazgos críticos",
            "Revisión humana de la entrega"
          ],
          "notes": "Plantilla genérica curada: ajustar productos, mínimos y roles antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar nombres, campos y alcance al negocio real antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización y el wizard permiten adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Productos y existencias",
                    "Movimientos de stock",
                    "Ventas en mostrador"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-stack",
          "question_es": "¿Stack de implementación?",
          "question_en": "Implementation stack?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "node",
              "label_es": "Node (Express + React) + PostgreSQL",
              "label_en": "Node (Express + React) + PostgreSQL",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Express + React"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "TypeScript"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "PostgreSQL"
                }
              ]
            },
            {
              "id": "php",
              "label_es": "PHP (Laravel + Blade) + MySQL",
              "label_en": "PHP (Laravel + Blade) + MySQL",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Laravel + Blade"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "PHP"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "database",
                  "value": "MySQL"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ],
      "tpp_profile": "erp"
    },
    {
      "id": "game-2d-match3",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Puzzle 2D de combinar (match-3)",
      "name_en": "2D match-3 puzzle",
      "summary_es": "Puzzle de intercambiar fichas adyacentes para alinear tres o más, con cascadas, objetivos por nivel y puntuación por combos.",
      "summary_en": "Swap adjacent tiles to align three or more, with cascades, level goals and combo scoring.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-physics-collision"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art brillante con fichas de colores de alto contraste",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Puzzle 2D de combinar (match-3)",
        "schema_version": 1,
        "identity": {
          "name": "Puzzle 2D de combinar (match-3)",
          "description": "Puzzle 2D donde el jugador intercambia fichas adyacentes para alinear tres o más del mismo color y cumplir el objetivo del nivel.",
          "problem": "Los puzzles de combinar requieren una lógica de tablero, cascadas y objetivos que es fácil implementar mal: combinaciones no detectadas o estados imposibles.",
          "vision": "Un puzzle relajante pero con profundidad, donde cada movimiento cuenta y las cascadas recompensan la planificación.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de combinar fichas",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Tablero y combinaciones",
            "Objetivos por nivel"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de combinar fichas corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de combinar fichas con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Intercambio y combinación",
            "statement": "El jugador intercambia dos fichas adyacentes; si se alinean tres o más del mismo color, se eliminan y se puntúa.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un intercambio que no produce combinación se revierte",
              "Tres o más fichas iguales en línea se eliminan"
            ],
            "links": [
              "entity:tablero",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Cascadas y objetivo del nivel",
            "statement": "Tras eliminar, las fichas caen y rellenan el tablero pudiendo encadenar cascadas; el nivel se supera al cumplir su objetivo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Las cascadas se resuelven hasta estabilizar el tablero",
              "El nivel se supera al alcanzar el objetivo antes de agotar movimientos"
            ],
            "links": [
              "entity:tablero",
              "entity:nivel",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Solo intercambios adyacentes válidos",
            "statement": "Únicamente se permiten intercambios entre fichas ortogonalmente adyacentes que produzcan una combinación; el tablero nunca queda sin movimientos posibles.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un intercambio no adyacente se rechaza",
              "Si no hay movimientos posibles el tablero se reordena"
            ],
            "links": [
              "entity:tablero"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Puzzle match-3",
            "summary": "Género casual de alinear tres o más fichas iguales mediante intercambios adyacentes.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "tablero",
              "name": "tablero",
              "description": "Rejilla de fichas del nivel con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "ancho",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "alto",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "celdas",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "movimientos_restantes",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id"
              ],
              "rules": [
                "Las celdas codifican el color de cada ficha"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-tablero",
              "kind": "one_to_one",
              "from": "partida",
              "to": "tablero",
              "label": "tiene"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Intercambio y cascadas",
            "summary": "Valida el intercambio, elimina combinaciones y resuelve cascadas.",
            "trigger": "El jugador arrastra una ficha sobre otra adyacente",
            "inputs": [
              "tablero",
              "partida"
            ],
            "outputs": [
              "tablero",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "tablero",
                  "query": "celdas y movimientos_restantes",
                  "into": "tablero"
                },
                {
                  "op": "si",
                  "condition": "fichas adyacentes y el intercambio produce combinacion",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "tablero",
                      "value": "{celdas: tras_eliminar_y_rellenar, movimientos_restantes: movimientos - 1}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: puntos_combo, modo: normal}"
                    },
                    {
                      "op": "devolver",
                      "value": "tablero"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Intercambio inválido: no adyacente o sin combinación",
                      "code": "INTERCAMBIO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "INTERCAMBIO_INVALIDO: fichas no adyacentes o sin combinación resultante"
            ],
            "rules": [
              "Las cascadas se resuelven hasta estabilizar",
              "El tablero siempre tiene al menos un movimiento posible"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:tablero"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del puzzle match-3",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art brillante con fichas de colores de alto contraste",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Detección de alineaciones y caída de fichas en la rejilla.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Intercambio y combinación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Intercambio y combinación»",
              "then": "Un intercambio que no produce combinación se revierte",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Cascadas y objetivo del nivel",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Cascadas y objetivo del nivel»",
              "then": "Las cascadas se resuelven hasta estabilizar el tablero",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Solo intercambios adyacentes válidos",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Solo intercambios adyacentes válidos»",
              "then": "Un intercambio no adyacente se rechaza",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Tablero y combinaciones"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-runner",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Runner 2D de carrera infinita",
      "name_en": "2D endless runner",
      "summary_es": "Carrera infinita con salto y deslizamiento para esquivar obstáculos, velocidad creciente, distancia como puntuación y récords.",
      "summary_en": "Endless runner with jump and slide to dodge obstacles, increasing speed, distance scoring and records.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-physics-collision"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art dinámico con parallax y siluetas legibles",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Runner 2D de carrera infinita",
        "schema_version": 1,
        "identity": {
          "name": "Runner 2D de carrera infinita",
          "description": "Juego de carrera infinita donde el personaje avanza automáticamente y el jugador salta o se desliza para esquivar obstáculos.",
          "problem": "Un runner mal ajustado genera obstáculos imposibles o colisiones injustas que frustran al jugador en segundos.",
          "vision": "Una carrera tensa y justa donde la habilidad y el ritmo deciden cuánto llegas.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de esquivar obstáculos",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Generación de obstáculos",
            "Velocidad creciente"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de carrera infinita corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de carrera infinita con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Salto, deslizamiento y obstáculos",
            "statement": "El jugador salta o se desliza con un toque; los obstáculos se generan por delante con separación alcanzable.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Saltar esquiva un obstáculo bajo y deslizarse uno alto",
              "Nunca se generan dos obstáculos imposibles de esquivar seguidos"
            ],
            "links": [
              "entity:obstaculo",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Velocidad creciente y distancia",
            "statement": "La velocidad aumenta con la distancia recorrida y la puntuación es la distancia sobrevivida.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La velocidad crece de forma gradual y acotada",
              "La puntuación refleja la distancia real recorrida"
            ],
            "links": [
              "entity:partida",
              "entity:obstaculo",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Colisión termina la partida",
            "statement": "Chocar con un obstáculo sin la acción correcta termina la partida y registra la distancia como puntuación final.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Una colisión no evitada pasa la partida a terminada",
              "La distancia final se guarda como récord si supera al anterior"
            ],
            "links": [
              "entity:obstaculo",
              "entity:partida"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Endless runner",
            "summary": "Género de avance automático con obstáculos generados y dificultad creciente.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "obstaculo",
              "name": "obstaculo",
              "description": "Elemento generado que el jugador debe esquivar.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "posicion_x",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "altura",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "superado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "posicion_x"
              ],
              "rules": [
                "Tipo: bajo (saltar), alto (deslizar)"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-obstaculo",
              "kind": "one_to_many",
              "from": "partida",
              "to": "obstaculo",
              "label": "genera"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Generación y colisión",
            "summary": "Genera obstáculos por delante y resuelve la colisión según la acción del jugador.",
            "trigger": "El personaje avanza y aparece un obstáculo",
            "inputs": [
              "obstaculo",
              "partida"
            ],
            "outputs": [
              "obstaculo",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "obstaculo",
                  "query": "tipo y posicion_x del siguiente",
                  "into": "obstaculo"
                },
                {
                  "op": "si",
                  "condition": "accion_correcta(salto o deslizamiento) segun tipo",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "obstaculo",
                      "value": "{superado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: distancia, estado: en_curso}"
                    },
                    {
                      "op": "devolver",
                      "value": "obstaculo"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{estado: terminada}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: distancia, modo: infinito}"
                    },
                    {
                      "op": "generar_error",
                      "message": "Colisión: la partida termina",
                      "code": "COLISION"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "COLISION: el jugador no realizó la acción correcta a tiempo"
            ],
            "rules": [
              "La separación entre obstáculos siempre es alcanzable",
              "La velocidad está acotada"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:obstaculo"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del endless runner",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art dinámico con parallax y siluetas legibles",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Colisiones justas y generación de obstáculos alcanzables.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Salto, deslizamiento y obstáculos",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Salto, deslizamiento y obstáculos»",
              "then": "Saltar esquiva un obstáculo bajo y deslizarse uno alto",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Velocidad creciente y distancia",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Velocidad creciente y distancia»",
              "then": "La velocidad crece de forma gradual y acotada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Colisión termina la partida",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Colisión termina la partida»",
              "then": "Una colisión no evitada pasa la partida a terminada",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Generación de obstáculos"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-tower-defense",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Defensa de torres 2D",
      "name_en": "2D tower defense",
      "summary_es": "Defensa de torres por oleadas: coloca y mejora torres con una economía de recursos para detener enemigos antes de que lleguen a la base.",
      "summary_en": "Wave-based tower defense: place and upgrade towers with a resource economy to stop enemies before they reach the base.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-ai-behavior-trees"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art táctico con caminos y torres distinguibles",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Defensa de torres 2D",
        "schema_version": 1,
        "identity": {
          "name": "Defensa de torres 2D",
          "description": "Juego de defensa donde el jugador coloca torres en un mapa para detener oleadas de enemigos que avanzan hacia la base.",
          "problem": "Sin una economía y un pathfinding claros, las torres se colocan en cualquier sitio y las oleadas resultan triviales o imposibles.",
          "vision": "Una defensa estratégica donde cada torre colocada y cada mejora importan.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de colocar y mejorar torres",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Oleadas de enemigos",
            "Economía y mejoras"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de defensa de torres corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de defensa de torres con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Colocación de torres y oleadas",
            "statement": "El jugador coloca torres en celdas válidas gastando recursos; los enemigos avanzan por el camino en oleadas.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "No se coloca una torre sobre el camino ni en celda ocupada",
              "Colocar una torre descuenta su coste de los recursos"
            ],
            "links": [
              "entity:torre",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Mejoras y economía",
            "statement": "Las torres se mejoran gastando recursos y los enemigos derrotados otorgan recursos para seguir construyendo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Mejorar una torre aumenta su daño o alcance",
              "Derrotar un enemigo suma recursos"
            ],
            "links": [
              "entity:torre",
              "entity:partida",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Enemigos que llegan restan vidas",
            "statement": "Cada enemigo que alcanza la base resta una vida; al llegar a cero la partida termina.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un enemigo que llega a la base resta exactamente una vida",
              "Con cero vidas la partida pasa a terminada"
            ],
            "links": [
              "entity:partida",
              "entity:torre"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Tower defense",
            "summary": "Género de colocar defensas estáticas para detener oleadas de enemigos móviles.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "torre",
              "name": "torre",
              "description": "Defensa colocada en el mapa con nivel y alcance.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "celda_x",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "celda_y",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_mejora",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "alcance",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "danio",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "celda_x",
                "celda_y"
              ],
              "rules": [
                "Una torre por celda",
                "No se coloca sobre el camino"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-torre",
              "kind": "one_to_many",
              "from": "partida",
              "to": "torre",
              "label": "despliega"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Colocación y oleada",
            "summary": "Valida la colocación de torres y resuelve el avance y daño de la oleada.",
            "trigger": "El jugador coloca una torre o comienza una oleada",
            "inputs": [
              "torre",
              "partida"
            ],
            "outputs": [
              "torre",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "torre",
                  "query": "celdas ocupadas y recursos de la partida",
                  "into": "estado"
                },
                {
                  "op": "si",
                  "condition": "celda valida y libre y recursos >= coste",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "torre",
                      "value": "{partida_id, tipo, celda_x, celda_y, nivel_mejora: 1, alcance, danio}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: recursos - coste}"
                    },
                    {
                      "op": "devolver",
                      "value": "torre"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Celda inválida, ocupada o recursos insuficientes",
                      "code": "COLOCACION_INVALIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "COLOCACION_INVALIDA: celda no válida, ocupada o sin recursos"
            ],
            "rules": [
              "Las torres no se colocan sobre el camino",
              "Cada enemigo derrotado otorga recursos"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:torre"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes de defensa de torres",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art táctico con caminos y torres distinguibles",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-ai-behavior-trees",
            "name": "IA de enemigos",
            "purpose": "Pathfinding y comportamiento de oleadas predecible y justo.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Colocación de torres y oleadas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Colocación de torres y oleadas»",
              "then": "No se coloca una torre sobre el camino ni en celda ocupada",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Mejoras y economía",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Mejoras y economía»",
              "then": "Mejorar una torre aumenta su daño o alcance",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Enemigos que llegan restan vidas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Enemigos que llegan restan vidas»",
              "then": "Un enemigo que llega a la base resta exactamente una vida",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Oleadas de enemigos"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-breakout",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Rompe ladrillos 2D (breakout)",
      "name_en": "2D breakout / brick breaker",
      "summary_es": "Breakout clásico: mueve la pala para rebotar la bola, rompe ladrillos por niveles, gestiona vidas y suma puntuación por ladrillo.",
      "summary_en": "Classic breakout: move the paddle to bounce the ball, break bricks across levels, manage lives and score per brick.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-physics-collision"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art neón con ladrillos de colores y bola brillante",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Rompe ladrillos 2D (breakout)",
        "schema_version": 1,
        "identity": {
          "name": "Rompe ladrillos 2D (breakout)",
          "description": "Juego donde el jugador mueve una pala horizontal para mantener la bola en juego y destruir todos los ladrillos del nivel.",
          "problem": "Una física de rebote mal calculada hace la bola impredecible o la atraviesa todo, rompiendo la diversión del breakout.",
          "vision": "Un breakout preciso y satisfactorio donde el ángulo de la pala decide el rebote.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de rebotar la bola y romper ladrillos",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Física de rebote",
            "Ladrillos por nivel"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de romper ladrillos corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de romper ladrillos con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Pala y rebote de la bola",
            "statement": "La pala se mueve horizontalmente y la bola rebota en ella con un ángulo dependiente del punto de contacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El ángulo de rebote depende de dónde golpea la bola en la pala",
              "La bola rebota en paredes y techo sin perder velocidad"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Ladrillos y niveles",
            "statement": "La bola destruye ladrillos al impactar; al limpiar todos se avanza de nivel con una disposición nueva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un ladrillo con resistencia uno se destruye al primer impacto",
              "Limpiar todos los ladrillos avanza de nivel"
            ],
            "links": [
              "entity:ladrillo",
              "entity:nivel",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Perder la bola resta vida",
            "statement": "Si la bola cae por debajo de la pala se pierde una vida; con cero vidas la partida termina.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Perder la bola resta exactamente una vida",
              "Con cero vidas la partida pasa a terminada"
            ],
            "links": [
              "entity:partida",
              "entity:ladrillo"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Breakout / brick breaker",
            "summary": "Género de pala y bola que destruye ladrillos mediante rebotes.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "ladrillo",
              "name": "ladrillo",
              "description": "Bloque destruible con resistencia y puntos.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fila",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "columna",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "resistencia",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntos",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "destruido",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "fila",
                "columna"
              ],
              "rules": [
                "Un ladrillo por celda",
                "Resistencia cero significa destruido"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-ladrillo",
              "kind": "one_to_many",
              "from": "partida",
              "to": "ladrillo",
              "label": "contiene"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Rebote y destrucción",
            "summary": "Resuelve el rebote de la bola y la destrucción de ladrillos.",
            "trigger": "La bola impacta la pala, una pared o un ladrillo",
            "inputs": [
              "ladrillo",
              "partida"
            ],
            "outputs": [
              "ladrillo",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "ladrillo",
                  "query": "celda impactada y resistencia",
                  "into": "ladrillo"
                },
                {
                  "op": "si",
                  "condition": "impacto en ladrillo no destruido",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "ladrillo",
                      "value": "{resistencia: resistencia - 1, destruido: resistencia - 1 == 0}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: puntos, modo: normal}"
                    },
                    {
                      "op": "devolver",
                      "value": "ladrillo"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{estado: vida_perdida}"
                    },
                    {
                      "op": "generar_error",
                      "message": "La bola cayó: se pierde una vida",
                      "code": "BOLA_PERDIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "BOLA_PERDIDA: la bola cayó por debajo de la pala"
            ],
            "rules": [
              "El rebote conserva la velocidad",
              "El ángulo depende del punto de contacto en la pala"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:ladrillo"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del breakout",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art neón con ladrillos de colores y bola brillante",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Rebotes precisos y detección de impacto bola-ladrillo.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Pala y rebote de la bola",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pala y rebote de la bola»",
              "then": "El ángulo de rebote depende de dónde golpea la bola en la pala",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Ladrillos y niveles",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ladrillos y niveles»",
              "then": "Un ladrillo con resistencia uno se destruye al primer impacto",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Perder la bola resta vida",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Perder la bola resta vida»",
              "then": "Perder la bola resta exactamente una vida",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Física de rebote"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-snake",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Serpiente 2D (snake)",
      "name_en": "2D snake",
      "summary_es": "Snake clásico: guía la serpiente para comer y crecer, esquiva tu propio cuerpo y los muros, con velocidad creciente y récord de longitud.",
      "summary_en": "Classic snake: guide the snake to eat and grow, avoid your own body and walls, with increasing speed and length records.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-physics-collision"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art minimalista con rejilla y serpiente de alto contraste",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Serpiente 2D (snake)",
        "schema_version": 1,
        "identity": {
          "name": "Serpiente 2D (snake)",
          "description": "Juego donde el jugador dirige una serpiente que crece al comer; chocar contra el muro o su propio cuerpo termina la partida.",
          "problem": "Un snake con paso variable o colisiones imprecisas produce muertes injustas y crecimiento incorrecto de la serpiente.",
          "vision": "Un snake tenso y preciso donde cada giro cuenta y la longitud es el trofeo.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de comer y crecer",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Crecimiento de la serpiente",
            "Colisión con cuerpo y muro"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de serpiente corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de serpiente con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Movimiento y crecimiento",
            "statement": "La serpiente avanza por la rejilla en la dirección elegida y crece una celda al comer la comida.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Comer aumenta la longitud en exactamente uno",
              "No se permite girar 180 grados sobre sí misma"
            ],
            "links": [
              "entity:serpiente",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Velocidad y comida",
            "statement": "La velocidad aumenta con la longitud y la comida aparece en una celda libre aleatoria.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La comida nunca aparece sobre el cuerpo de la serpiente",
              "La velocidad crece de forma acotada con la longitud"
            ],
            "links": [
              "entity:serpiente",
              "entity:partida",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Colisión termina la partida",
            "statement": "Chocar contra el muro o contra el propio cuerpo termina la partida y registra la longitud como puntuación.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Chocar con el muro o el cuerpo pasa la partida a terminada",
              "La longitud final se guarda como récord si supera al anterior"
            ],
            "links": [
              "entity:serpiente",
              "entity:partida"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Snake",
            "summary": "Género de serpiente que crece al comer y muere al chocar consigo misma o el muro.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "serpiente",
              "name": "serpiente",
              "description": "Cuerpo de la serpiente como secuencia de celdas.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "celdas",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "direccion",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "longitud",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "comida_x",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "comida_y",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id"
              ],
              "rules": [
                "La dirección es una de: arriba, abajo, izquierda, derecha"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-serpiente",
              "kind": "one_to_one",
              "from": "partida",
              "to": "serpiente",
              "label": "controla"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Avance y colisión",
            "summary": "Avanza la serpiente, resuelve comer y detecta colisiones.",
            "trigger": "Cada paso de la serpiente en la rejilla",
            "inputs": [
              "serpiente",
              "partida"
            ],
            "outputs": [
              "serpiente",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "serpiente",
                  "query": "celdas, direccion y comida",
                  "into": "serpiente"
                },
                {
                  "op": "si",
                  "condition": "cabeza no choca con muro ni cuerpo",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "serpiente",
                      "value": "{celdas: avanzadas, longitud: longitud + (comio ? 1 : 0), comida_x, comida_y}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: longitud}"
                    },
                    {
                      "op": "devolver",
                      "value": "serpiente"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{estado: terminada}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: longitud, modo: clasico}"
                    },
                    {
                      "op": "generar_error",
                      "message": "Colisión: la partida termina",
                      "code": "COLISION"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "COLISION: la cabeza chocó con el muro o el propio cuerpo"
            ],
            "rules": [
              "La comida aparece en celda libre",
              "No se permite giro de 180 grados"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:serpiente"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del snake",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art minimalista con rejilla y serpiente de alto contraste",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Colisión en rejilla y crecimiento correcto del cuerpo.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Movimiento y crecimiento",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Movimiento y crecimiento»",
              "then": "Comer aumenta la longitud en exactamente uno",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Velocidad y comida",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Velocidad y comida»",
              "then": "La comida nunca aparece sobre el cuerpo de la serpiente",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Colisión termina la partida",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Colisión termina la partida»",
              "then": "Chocar con el muro o el cuerpo pasa la partida a terminada",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Crecimiento de la serpiente"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-blocks",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Bloques 2D (apilar y completar líneas)",
      "name_en": "2D block stacking",
      "summary_es": "Juego de apilar piezas que caen: rota y coloca para completar líneas, sube de nivel con la velocidad y suma puntos por línea y combo.",
      "summary_en": "Falling-piece stacking: rotate and place to clear lines, level up with speed and score per line and combo.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-physics-collision"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art geométrico con piezas de colores distinguibles",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Bloques 2D (apilar y completar líneas)",
        "schema_version": 1,
        "identity": {
          "name": "Bloques 2D (apilar y completar líneas)",
          "description": "Juego donde piezas de bloques caen y el jugador las rota y coloca para completar líneas horizontales que se eliminan.",
          "problem": "Sin una rotación con kicks y un bloqueo correcto, las piezas se solapan o no encajan junto a paredes, arruinando el juego.",
          "vision": "Un juego de bloques fluido donde la planificación y los reflejos se recompensan con combos.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de rotar y apilar piezas",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Rotación y caída de piezas",
            "Líneas y nivel"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de apilar bloques corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de apilar bloques con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Rotación y caída de piezas",
            "statement": "La pieza cae a paso constante; el jugador la mueve y rota con kicks para encajarla junto a paredes y otras piezas.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Una rotación que solaparía se desplaza con un kick válido",
              "La pieza no puede solaparse con celdas ocupadas"
            ],
            "links": [
              "entity:pieza",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Líneas completas y nivel",
            "statement": "Al fijar la pieza, las líneas horizontales completas se eliminan y suman puntos; el nivel y la velocidad suben con las líneas.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Una línea completa se elimina y desplaza las superiores",
              "El nivel sube al alcanzar el umbral de líneas"
            ],
            "links": [
              "entity:pieza",
              "entity:nivel",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Tablero lleno termina la partida",
            "statement": "Si una pieza nueva no cabe en el tablero al aparecer, la partida termina y se registra la puntuación.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Una pieza que no cabe al aparecer pasa la partida a terminada",
              "La puntuación final se guarda como récord si supera al anterior"
            ],
            "links": [
              "entity:pieza",
              "entity:partida"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Block stacking / tetris",
            "summary": "Género de piezas que caen y se apilan para completar líneas.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "pieza",
              "name": "pieza",
              "description": "Pieza activa con forma, rotación y posición.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "forma",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "rotacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "pos_x",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "pos_y",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tablero",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id"
              ],
              "rules": [
                "La rotación es un índice de 0 a 3",
                "El tablero codifica las celdas ocupadas"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-pieza",
              "kind": "one_to_one",
              "from": "partida",
              "to": "pieza",
              "label": "tiene activa"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Caída, fijado y líneas",
            "summary": "Mueve la pieza, la fija al tocar suelo y elimina líneas completas.",
            "trigger": "La pieza cae un paso o el jugador la rota/mueve",
            "inputs": [
              "pieza",
              "partida"
            ],
            "outputs": [
              "pieza",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "pieza",
                  "query": "forma, rotacion, pos y tablero",
                  "into": "pieza"
                },
                {
                  "op": "si",
                  "condition": "movimiento o rotacion valida sin solape",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "pieza",
                      "value": "{pos_x, pos_y, rotacion, tablero: tras_fijar_y_limpiar}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: puntos_lineas, modo: normal}"
                    },
                    {
                      "op": "devolver",
                      "value": "pieza"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{estado: terminada}"
                    },
                    {
                      "op": "generar_error",
                      "message": "La pieza no cabe: la partida termina",
                      "code": "TABLERO_LLENO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "TABLERO_LLENO: la pieza nueva no cabe al aparecer"
            ],
            "rules": [
              "La rotación aplica kicks válidos",
              "Las líneas completas se eliminan y desplazan el tablero"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:pieza"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del juego de bloques",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art geométrico con piezas de colores distinguibles",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Solape de piezas, kicks de rotación y fijado en rejilla.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Rotación y caída de piezas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Rotación y caída de piezas»",
              "then": "Una rotación que solaparía se desplaza con un kick válido",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Líneas completas y nivel",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Líneas completas y nivel»",
              "then": "Una línea completa se elimina y desplaza las superiores",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Tablero lleno termina la partida",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Tablero lleno termina la partida»",
              "then": "Una pieza que no cabe al aparecer pasa la partida a terminada",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Rotación y caída de piezas"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-shooter",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Shooter 2D de naves (shmup)",
      "name_en": "2D space shooter",
      "summary_es": "Shooter vertical de naves: dispara a oleadas de enemigos, esquiva sus proyectiles, recoge power-ups y suma puntos por derribo.",
      "summary_en": "Vertical space shooter: shoot enemy waves, dodge their bullets, collect power-ups and score per kill.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-ai-behavior-trees"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art espacial con naves y proyectiles de alto contraste",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Shooter 2D de naves (shmup)",
        "schema_version": 1,
        "identity": {
          "name": "Shooter 2D de naves (shmup)",
          "description": "Juego de nave donde el jugador dispara a oleadas de enemigos que descienden, esquiva sus proyectiles y recoge mejoras.",
          "problem": "Un shmup con patrones de bala injustos o colisiones imprecisas resulta frustrante; los power-ups mal escalados rompen la dificultad.",
          "vision": "Un shooter intenso y justo donde la posición y el timing lo son todo.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de disparar y esquivar",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Oleadas de enemigos",
            "Power-ups"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de naves espacial corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de naves espacial con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Disparo y enemigos",
            "statement": "La nave dispara hacia arriba y destruye enemigos de la oleada; cada derribo suma puntos.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un impacto de bala del jugador destruye un enemigo básico",
              "Cada derribo suma su valor a la puntuación"
            ],
            "links": [
              "entity:nave",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Oleadas y power-ups",
            "statement": "Las oleadas traen patrones de enemigos y algunos derribos sueltan power-ups que mejoran el arma o dan vida.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Recoger un power-up de arma sube su nivel hasta el máximo",
              "Cada oleada es superable con la habilidad esperada"
            ],
            "links": [
              "entity:nave",
              "entity:nivel",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Impacto enemigo resta vida",
            "statement": "Un proyectil enemigo o una colisión con un enemigo resta una vida; con cero vidas la partida termina.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un impacto enemigo resta exactamente una vida",
              "Con cero vidas la partida pasa a terminada"
            ],
            "links": [
              "entity:nave",
              "entity:partida"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Space shooter / shmup",
            "summary": "Género de nave que dispara a oleadas de enemigos y esquiva proyectiles.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "nave",
              "name": "nave",
              "description": "Nave del jugador con vidas, arma y power-ups.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "pos_x",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "pos_y",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "vidas",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_arma",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "enemigos",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id"
              ],
              "rules": [
                "Las vidas no pueden ser negativas",
                "El nivel de arma tiene un máximo"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-nave",
              "kind": "one_to_one",
              "from": "partida",
              "to": "nave",
              "label": "pilota"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Disparo y oleada",
            "summary": "Resuelve disparos, impactos enemigos y recogida de power-ups.",
            "trigger": "El jugador dispara o un enemigo impacta",
            "inputs": [
              "nave",
              "partida"
            ],
            "outputs": [
              "nave",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nave",
                  "query": "pos, vidas, nivel_arma y enemigos",
                  "into": "nave"
                },
                {
                  "op": "si",
                  "condition": "bala del jugador impacta enemigo",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nave",
                      "value": "{enemigos: tras_derribo, nivel_arma: si_powerup}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: puntos_derribo, modo: normal}"
                    },
                    {
                      "op": "devolver",
                      "value": "nave"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "nave",
                      "value": "{vidas: vidas - 1}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{estado: vidas == 0 ? terminada : en_curso}"
                    },
                    {
                      "op": "generar_error",
                      "message": "Impacto enemigo: se pierde una vida",
                      "code": "IMPACTO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "IMPACTO: un proyectil o enemigo alcanzó la nave"
            ],
            "rules": [
              "Los patrones de oleada son superables",
              "El nivel de arma está acotado"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:nave"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del shooter espacial",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art espacial con naves y proyectiles de alto contraste",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-ai-behavior-trees",
            "name": "IA de enemigos",
            "purpose": "Patrones de oleada y de disparo predecibles y justos.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Disparo y enemigos",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Disparo y enemigos»",
              "then": "Un impacto de bala del jugador destruye un enemigo básico",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Oleadas y power-ups",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Oleadas y power-ups»",
              "then": "Recoger un power-up de arma sube su nivel hasta el máximo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Impacto enemigo resta vida",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Impacto enemigo resta vida»",
              "then": "Un impacto enemigo resta exactamente una vida",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Oleadas de enemigos"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-idle-farm",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Granja idle 2D (clicker)",
      "name_en": "2D idle farm / clicker",
      "summary_es": "Juego idle de granja: produce recursos con clics y mejoras automáticas, reinvierte en producción y progresa incluso offline.",
      "summary_en": "Idle farm game: produce resources with clicks and automated upgrades, reinvest into production and progress even offline.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-design-document"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art acogedor de granja con iconos de recursos claros",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Granja idle 2D (clicker)",
        "schema_version": 1,
        "identity": {
          "name": "Granja idle 2D (clicker)",
          "description": "Juego incremental donde el jugador produce recursos con clics, compra mejoras que automatizan la producción y reinvierte para crecer.",
          "problem": "Un idle sin una economía exponencial bien calibrada se estanca o se desborda; el progreso offline mal calculado rompe la confianza.",
          "vision": "Una granja que crece contigo, satisfactoria tanto en sesiones activas como al volver.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de producir y mejorar",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Producción automática",
            "Progreso offline"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego idle de granja corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de idle de granja con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Producción y mejoras",
            "statement": "El jugador produce con clics y compra mejoras que aumentan la producción automática por segundo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Comprar una mejora descuenta su coste y sube la tasa por segundo",
              "La producción automática nunca excede la capacidad del recurso"
            ],
            "links": [
              "entity:recurso",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Progreso offline",
            "statement": "Al volver, el juego calcula la producción acumulada desde la última sesión respetando la capacidad.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El progreso offline se calcula con el tiempo real transcurrido",
              "La producción offline se topa en la capacidad del recurso"
            ],
            "links": [
              "entity:recurso",
              "entity:partida",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Economía acotada",
            "statement": "La cantidad de un recurso nunca es negativa ni supera su capacidad; los costes crecen de forma controlada.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Ningún recurso queda negativo tras una compra",
              "La cantidad se topa en la capacidad"
            ],
            "links": [
              "entity:recurso"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Idle / clicker",
            "summary": "Género incremental de producción automática y mejora continua con progreso offline.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "recurso",
              "name": "recurso",
              "description": "Recurso producible con su cantidad y tasa por segundo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "tipo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "cantidad",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "por_segundo",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "capacidad",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "ultimo_calculo",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "tipo"
              ],
              "rules": [
                "La cantidad no puede ser negativa",
                "La producción no excede la capacidad"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-recurso",
              "kind": "one_to_many",
              "from": "partida",
              "to": "recurso",
              "label": "produce"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Producción y mejora",
            "summary": "Acumula producción por segundo y aplica compras de mejora.",
            "trigger": "Pasa el tiempo o el jugador compra una mejora",
            "inputs": [
              "recurso",
              "partida"
            ],
            "outputs": [
              "recurso",
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "recurso",
                  "query": "cantidad, por_segundo, capacidad y ultimo_calculo",
                  "into": "recurso"
                },
                {
                  "op": "si",
                  "condition": "coste de mejora <= cantidad disponible",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "recurso",
                      "value": "{cantidad: min(capacidad, cantidad + por_segundo * dt) - coste, por_segundo: nueva_tasa, ultimo_calculo: ahora}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: produccion_total}"
                    },
                    {
                      "op": "devolver",
                      "value": "recurso"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "Recursos insuficientes para la mejora",
                      "code": "SIN_RECURSOS"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "SIN_RECURSOS: la cantidad no cubre el coste de la mejora"
            ],
            "rules": [
              "La producción se topa en la capacidad",
              "El progreso offline usa el tiempo real transcurrido"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:recurso"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes de la granja idle",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art acogedor de granja con iconos de recursos claros",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-design-document",
            "name": "Documento de diseño de juego",
            "purpose": "Calibrado de la economía incremental y del progreso offline.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Producción y mejoras",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Producción y mejoras»",
              "then": "Comprar una mejora descuenta su coste y sube la tasa por segundo",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Progreso offline",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Progreso offline»",
              "then": "El progreso offline se calcula con el tiempo real transcurrido",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Economía acotada",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Economía acotada»",
              "then": "Ningún recurso queda negativo tras una compra",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Producción automática"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-memory",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Memoria 2D de parejas",
      "name_en": "2D memory / matching pairs",
      "summary_es": "Juego de memoria: voltea cartas para encontrar parejas, con intentos limitados, cronómetro y niveles con más cartas.",
      "summary_en": "Memory game: flip cards to find pairs, with limited attempts, a timer and levels with more cards.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-design-document"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art limpio con dorso de carta uniforme y símbolos distinguibles",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Memoria 2D de parejas",
        "schema_version": 1,
        "identity": {
          "name": "Memoria 2D de parejas",
          "description": "Juego donde el jugador voltea cartas de dos en dos para encontrar todas las parejas del tablero antes de agotar los intentos.",
          "problem": "Un memory que permite voltear más de dos cartas o que no baraja bien produce partidas inconsistentes o triviales.",
          "vision": "Un memory relajante que entrena la memoria y recompensa la concentración.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de encontrar parejas",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Volteo y emparejado",
            "Intentos y cronómetro"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de memoria de parejas corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de memoria de parejas con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Volteo y emparejado",
            "statement": "El jugador voltea dos cartas; si coinciden quedan emparejadas, si no se vuelven a ocultar tras un instante.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Dos cartas con el mismo símbolo quedan emparejadas",
              "Dos cartas distintas se ocultan de nuevo tras mostrarse"
            ],
            "links": [
              "entity:carta",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Intentos, tiempo y niveles",
            "statement": "Cada pareja fallida consume un intento; el nivel se supera al emparejar todo antes de agotar intentos, y sube el número de cartas.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un fallo resta un intento",
              "Emparejar todas las cartas supera el nivel"
            ],
            "links": [
              "entity:carta",
              "entity:nivel",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Solo dos cartas volteadas a la vez",
            "statement": "No se pueden voltear más de dos cartas simultáneamente ni una carta ya emparejada; el tablero siempre tiene parejas resolubles.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Voltear una tercera carta antes de resolver se ignora",
              "Una carta emparejada no se puede voltear"
            ],
            "links": [
              "entity:carta"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Memory / matching pairs",
            "summary": "Género de voltear cartas para encontrar parejas idénticas.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "carta",
              "name": "carta",
              "description": "Carta del tablero con símbolo, posición y estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "simbolo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "posicion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "volteada",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "emparejada",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "posicion"
              ],
              "rules": [
                "Cada símbolo aparece exactamente dos veces"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-carta",
              "kind": "one_to_many",
              "from": "partida",
              "to": "carta",
              "label": "reparte"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Volteo y resolución",
            "summary": "Voltea cartas y resuelve si forman pareja o se ocultan.",
            "trigger": "El jugador toca una carta oculta",
            "inputs": [
              "carta",
              "partida"
            ],
            "outputs": [
              "carta",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "carta",
                  "query": "simbolo, volteada y emparejada de la seleccionada",
                  "into": "carta"
                },
                {
                  "op": "si",
                  "condition": "menos de dos volteadas y carta no emparejada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "carta",
                      "value": "{volteada: true, emparejada: coincide_con_la_otra}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: puntos_pareja, modo: normal}"
                    },
                    {
                      "op": "devolver",
                      "value": "carta"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede voltear: ya hay dos o está emparejada",
                      "code": "VOLTEO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "VOLTEO_INVALIDO: ya hay dos cartas volteadas o la carta está emparejada"
            ],
            "rules": [
              "Cada símbolo aparece exactamente dos veces",
              "Las cartas fallidas se ocultan tras mostrarse"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:carta"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes del juego de memoria",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art limpio con dorso de carta uniforme y símbolos distinguibles",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-design-document",
            "name": "Documento de diseño de juego",
            "purpose": "Calibrado de intentos, tiempo y progresión de cartas.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Volteo y emparejado",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Volteo y emparejado»",
              "then": "Dos cartas con el mismo símbolo quedan emparejadas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Intentos, tiempo y niveles",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Intentos, tiempo y niveles»",
              "then": "Un fallo resta un intento",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Solo dos cartas volteadas a la vez",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Solo dos cartas volteadas a la vez»",
              "then": "Voltear una tercera carta antes de resolver se ignora",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Volteo y emparejado"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "id": "game-2d-racing",
      "types": [
        "videojuegos",
        "juego 2d"
      ],
      "name_es": "Carreras 2D top-down",
      "name_en": "2D top-down racing",
      "summary_es": "Carreras cenitales por vueltas: conduce, toma curvas y adelanta rivales, con posición en carrera, tiempos por vuelta y récords.",
      "summary_en": "Top-down lap racing: drive, take corners and overtake rivals, with race position, lap times and records.",
      "expert_id": "kai-sprite",
      "skills": [
        "game-loop-architecture",
        "entity-component-system",
        "game-save-systems",
        "game-physics-collision"
      ],
      "pieces": [
        "sqlite-schema-migrations",
        "ci-windows-desktop"
      ],
      "mockups": [
        "m-game-hud-2d",
        "m-settings-center"
      ],
      "resources": [
        "kenney",
        "pixelfrog",
        "opengameart",
        "freesound"
      ],
      "brief": {
        "platforms": [
          "desktop"
        ],
        "languages": [
          "GDScript"
        ],
        "databases": [
          "SQLite local"
        ],
        "project_types": [
          "videojuegos",
          "juego 2d"
        ],
        "non_goals": [
          "Multijugador",
          "Microtransacciones",
          "Editor de niveles para usuarios"
        ],
        "visual_style": "Pixel-art de circuito con coches y trazada distinguibles",
        "asset_sources": [
          "Kenney Assets",
          "OpenGameArt"
        ],
        "mockup": "m-game-hud-2d"
      },
      "document": {
        "name": "Carreras 2D top-down",
        "schema_version": 1,
        "identity": {
          "name": "Carreras 2D top-down",
          "description": "Juego de carreras con vista cenital donde el jugador completa vueltas a un circuito, adelanta rivales y busca el mejor tiempo.",
          "problem": "Sin una física de conducción y un control de vueltas fiables, los coches atraviesan el circuito o se cuentan vueltas incorrectas.",
          "vision": "Una carrera competitiva donde la trazada y el ritmo deciden la posición.",
          "goals": [
            "Mecánica central sólida y divertida",
            "Progreso y puntuación claros",
            "Partida guardable y reanudable"
          ],
          "specific_goals": [
            "Bucle estable a 60 fps",
            "Dominar la mecánica de conducir y adelantar",
            "Récords y logros persistentes"
          ],
          "users": [
            "Jugador casual (teclado o mando)",
            "Jugador que busca récord"
          ],
          "use_cases": [
            "Jugar una partida completa",
            "Superar niveles y batir el récord",
            "Ajustar dificultad y controles"
          ],
          "scope": [
            "Bucle y control",
            "Niveles y progreso",
            "Puntuación y récord",
            "Guardado",
            "Ajustes y pausa",
            "Conducción y vueltas",
            "Rivales y posición"
          ],
          "out_of_scope": [
            "Multijugador",
            "Microtransacciones",
            "Editor de niveles para usuarios"
          ],
          "constraints": [
            "Sin conexión a internet",
            "Ejecutable de escritorio modesto",
            "Arte 2D con licencia libre"
          ],
          "success_metrics": [
            "60 fps estables en partidas largas",
            "Guardado restaura el estado exacto",
            "Mecánica verificada en playtesting"
          ]
        },
        "requirements": [
          {
            "id": "fr-001",
            "code": "FR-001",
            "kind": "functional",
            "title": "Bucle de juego y control",
            "statement": "El juego de carreras cenitales corre a paso fijo con control responsive y pausa sin deriva.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "El bucle mantiene 60 fps estables en partidas largas",
              "El control responde sin retraso perceptible"
            ],
            "links": [
              "entity:partida",
              "mockup:m-game-hud-2d",
              "process:p-bucle"
            ]
          },
          {
            "id": "fr-002",
            "code": "FR-002",
            "kind": "functional",
            "title": "Niveles y progreso",
            "statement": "El jugador avanza por niveles de de carreras cenitales con dificultad creciente y desbloqueo ordenado.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un nivel se desbloquea al superar el anterior",
              "La dificultad crece de forma controlada"
            ],
            "links": [
              "entity:nivel",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-003",
            "code": "FR-003",
            "kind": "functional",
            "title": "Puntuación y récord",
            "statement": "La partida suma puntos según la mecánica y guarda el récord por modo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La puntuación nunca es negativa",
              "El récord se conserva entre sesiones"
            ],
            "links": [
              "entity:puntuacion",
              "entity:partida",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "fr-004",
            "code": "FR-004",
            "kind": "functional",
            "title": "Guardado y carga",
            "statement": "La partida se guarda de forma atómica y se carga restaurando el estado exacto.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cargar una partida restaura nivel, puntuación y estado",
              "Un guardado interrumpido no corrompe el save anterior"
            ],
            "links": [
              "entity:partida",
              "process:p-progreso"
            ]
          },
          {
            "id": "fr-005",
            "code": "FR-005",
            "kind": "functional",
            "title": "Ajustes del jugador",
            "statement": "El jugador configura volumen, dificultad y controles desde el centro de ajustes.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Los ajustes persisten entre sesiones",
              "Cambiar la dificultad afecta a las partidas nuevas"
            ],
            "links": [
              "entity:ajuste",
              "mockup:m-settings-center"
            ]
          },
          {
            "id": "fr-006",
            "code": "FR-006",
            "kind": "functional",
            "title": "Pausa y reanudación",
            "statement": "El juego se pausa con un botón y se reanuda sin perder estado ni saltar tiempo.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Pausar congela la simulación",
              "Reanudar continúa exactamente donde se pausó"
            ],
            "links": [
              "entity:partida"
            ]
          },
          {
            "id": "fr-007",
            "code": "FR-007",
            "kind": "functional",
            "title": "Conducción y vueltas",
            "statement": "El coche acelera, frena y gira con física cenital; cruzar la meta en el sentido correcto suma una vuelta.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Cruzar la meta en sentido correcto incrementa la vuelta en uno",
              "Cruzar en sentido contrario no cuenta vuelta"
            ],
            "links": [
              "entity:coche",
              "mockup:m-game-hud-2d",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-008",
            "code": "FR-008",
            "kind": "functional",
            "title": "Rivales y posición",
            "statement": "Los rivales siguen la trazada y la posición en carrera se calcula por vuelta y progreso respecto a ellos.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "La posición refleja vuelta y progreso real respecto a los rivales",
              "Adelantar a un rival mejora la posición"
            ],
            "links": [
              "entity:coche",
              "entity:nivel",
              "process:p-mecanica"
            ]
          },
          {
            "id": "fr-009",
            "code": "FR-009",
            "kind": "functional",
            "title": "Logros y estadísticas",
            "statement": "El juego registra logros y estadísticas de partidas (mejor puntuación, niveles superados).",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Un logro se desbloquea una sola vez",
              "Las estadísticas reflejan partidas reales"
            ],
            "links": [
              "entity:puntuacion",
              "mockup:m-game-hud-2d"
            ]
          },
          {
            "id": "rn-01",
            "code": "RN-01",
            "kind": "business_rule",
            "title": "Salir de pista penaliza",
            "statement": "Salir de la trazada reduce la velocidad del coche; el mejor tiempo por vuelta se guarda como récord.",
            "priority": "must",
            "status": "approved",
            "acceptance": [
              "Salir de pista aplica una penalización de velocidad",
              "El mejor tiempo de vuelta se conserva entre sesiones"
            ],
            "links": [
              "entity:coche",
              "entity:partida"
            ]
          }
        ],
        "contexts": [
          {
            "id": "ctx-01",
            "kind": "referencia",
            "title": "Top-down racing",
            "summary": "Género de carreras con vista cenital, vueltas a un circuito y rivales.",
            "source_note": "Género 2D de referencia ampliamente conocido."
          },
          {
            "id": "ctx-02",
            "kind": "tecnologico",
            "title": "Godot 4 en escritorio",
            "summary": "Juego 2D local con Godot 4, exportación a Windows/Linux/macOS y save en SQLite.",
            "source_note": "Stack por defecto de la plantilla."
          }
        ],
        "architecture": {
          "platform": "desktop",
          "language": "GDScript",
          "framework": "Godot 4",
          "style": "Entity-component por escenas",
          "database": "SQLite local",
          "data_access": "Repositorio de save serializado",
          "api_style": "ninguna",
          "auth": "ninguna",
          "infrastructure": "Ejecutable local",
          "hosting": "itch.io o tiendas",
          "external_services": [],
          "dependencies": [
            "Godot 4"
          ],
          "environments": [
            "desarrollo",
            "publicación"
          ],
          "deploy_strategy": "empaquetado por plataforma"
        },
        "decisions": [
          {
            "id": "d-motor",
            "topic": "motor",
            "choice": "Godot 4",
            "rationale": "Motor 2D maduro, escenas componibles y exportación a escritorio sin royalties.",
            "alternatives": [
              "Unity",
              "LÖVE"
            ],
            "status": "accepted"
          },
          {
            "id": "d-persistencia",
            "topic": "persistencia",
            "choice": "SQLite local",
            "rationale": "Save atómico y consultable para partidas, niveles y récords sin servidor.",
            "alternatives": [
              "JSON en disco",
              "Resource de Godot"
            ],
            "status": "accepted"
          },
          {
            "id": "d-arquitectura",
            "topic": "arquitectura de juego",
            "choice": "Entity-component por escenas",
            "rationale": "Mecánicas componibles sin jerarquías frágiles; bucle desacoplado del render.",
            "alternatives": [
              "Herencia profunda",
              "Singleton global"
            ],
            "status": "accepted"
          }
        ],
        "data_model": {
          "entities": [
            {
              "id": "partida",
              "name": "partida",
              "description": "Sesión de juego guardable con su estado.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "estado",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nivel_actual",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "puntuacion",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "datos_save",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "estado"
              ],
              "rules": [
                "Estado: en_curso, pausada, terminada"
              ]
            },
            {
              "id": "nivel",
              "name": "nivel",
              "description": "Escenario o fase con su dificultad y desbloqueo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "indice",
                  "data_type": "int",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "nombre",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "dificultad",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "desbloqueado",
                  "data_type": "bool",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "indice"
              ],
              "rules": [
                "El índice es único y correlativo"
              ]
            },
            {
              "id": "puntuacion",
              "name": "puntuacion",
              "description": "Registro de puntuación asociado a una partida.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "fecha",
                  "data_type": "timestamp",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "modo",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id",
                "valor"
              ],
              "rules": [
                "El valor no puede ser negativo"
              ]
            },
            {
              "id": "ajuste",
              "name": "ajuste",
              "description": "Preferencia del jugador (volumen, dificultad, controles).",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "clave",
                  "data_type": "text",
                  "nullable": false,
                  "key": "unique",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "valor",
                  "data_type": "text",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "clave"
              ],
              "rules": [
                "Clave única por ajuste"
              ]
            },
            {
              "id": "coche",
              "name": "coche",
              "description": "Coche del jugador con posición, vuelta y tiempo.",
              "fields": [
                {
                  "name": "id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "primary",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "partida_id",
                  "data_type": "uuid",
                  "nullable": false,
                  "key": "foreign",
                  "references": "partida.id",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "pos_x",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "pos_y",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "angulo",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "vuelta",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "mejor_tiempo",
                  "data_type": "decimal",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                },
                {
                  "name": "posicion_carrera",
                  "data_type": "int",
                  "nullable": false,
                  "key": "none",
                  "references": "",
                  "default_value": "",
                  "constraints": []
                }
              ],
              "indexes": [
                "partida_id"
              ],
              "rules": [
                "La vuelta no puede disminuir",
                "Salir de pista aplica penalización"
              ]
            }
          ],
          "relations": [
            {
              "id": "r-partida-puntuacion",
              "kind": "one_to_many",
              "from": "partida",
              "to": "puntuacion",
              "label": "registra"
            },
            {
              "id": "r-partida-coche",
              "kind": "one_to_one",
              "from": "partida",
              "to": "coche",
              "label": "conduce"
            }
          ],
          "seed_data": [
            "Nivel 1 desbloqueado",
            "Ajustes por defecto (volumen 80, dificultad normal)",
            "Récords a cero"
          ],
          "migrations": [
            "001_partidas_niveles",
            "002_puntuaciones_ajustes",
            "003_tabla_del_genero"
          ]
        },
        "processes": [
          {
            "id": "p-bucle",
            "name": "Bucle de juego",
            "summary": "Actualiza la simulación a paso fijo y la puntuación.",
            "trigger": "Cada tick del bucle mientras la partida está en curso",
            "inputs": [
              "partida"
            ],
            "outputs": [
              "partida"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "partida",
                  "query": "id, estado y nivel_actual",
                  "into": "partida"
                },
                {
                  "op": "si",
                  "condition": "partida en_curso y no pausada",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{puntuacion: puntuacion + delta, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "estado_actualizado"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "La partida no está en curso",
                      "code": "PARTIDA_NO_ACTIVA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PARTIDA_NO_ACTIVA: la partida está pausada o terminada"
            ],
            "rules": [
              "El paso es fijo e independiente del framerate"
            ],
            "links": [
              "requirement:FR-001",
              "requirement:FR-003",
              "entity:partida"
            ]
          },
          {
            "id": "p-progreso",
            "name": "Progreso y guardado",
            "summary": "Desbloquea el siguiente nivel y guarda la partida de forma atómica.",
            "trigger": "El jugador supera un nivel o guarda la partida",
            "inputs": [
              "partida",
              "nivel"
            ],
            "outputs": [
              "partida",
              "nivel"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "nivel",
                  "query": "indice y desbloqueado del siguiente",
                  "into": "siguiente"
                },
                {
                  "op": "si",
                  "condition": "nivel superado",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "nivel",
                      "value": "{desbloqueado: true}"
                    },
                    {
                      "op": "guardar",
                      "target": "partida",
                      "value": "{nivel_actual: nivel_actual + 1, datos_save, estado}"
                    },
                    {
                      "op": "devolver",
                      "value": "partida"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "generar_error",
                      "message": "No se puede avanzar sin superar el nivel",
                      "code": "PROGRESO_INVALIDO"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "PROGRESO_INVALIDO: el nivel actual no se ha superado"
            ],
            "rules": [
              "El guardado es atómico y versionado"
            ],
            "links": [
              "requirement:FR-002",
              "requirement:FR-004",
              "entity:nivel",
              "entity:partida"
            ]
          },
          {
            "id": "p-mecanica",
            "name": "Conducción y meta",
            "summary": "Aplica la física del coche y detecta el cruce de meta para contar vueltas.",
            "trigger": "El jugador acelera/gira o el coche cruza la meta",
            "inputs": [
              "coche",
              "partida"
            ],
            "outputs": [
              "coche",
              "partida",
              "puntuacion"
            ],
            "pseudocode": {
              "statements": [
                {
                  "op": "consultar",
                  "target": "coche",
                  "query": "pos, angulo, vuelta y si esta en pista",
                  "into": "coche"
                },
                {
                  "op": "si",
                  "condition": "cruce de meta en sentido correcto",
                  "then_body": [
                    {
                      "op": "guardar",
                      "target": "coche",
                      "value": "{vuelta: vuelta + 1, mejor_tiempo: min(mejor_tiempo, tiempo_vuelta), posicion_carrera}"
                    },
                    {
                      "op": "guardar",
                      "target": "puntuacion",
                      "value": "{partida_id, valor: puntos_vuelta, modo: carrera}"
                    },
                    {
                      "op": "devolver",
                      "value": "coche"
                    }
                  ],
                  "else_body": [
                    {
                      "op": "guardar",
                      "target": "coche",
                      "value": "{pos_x, pos_y, angulo, velocidad_penalizada}"
                    },
                    {
                      "op": "generar_error",
                      "message": "Cruce inválido o fuera de pista",
                      "code": "VUELTA_INVALIDA"
                    }
                  ]
                }
              ]
            },
            "errors": [
              "VUELTA_INVALIDA: cruce en sentido contrario o coche fuera de pista"
            ],
            "rules": [
              "Salir de pista penaliza la velocidad",
              "La vuelta nunca disminuye"
            ],
            "links": [
              "requirement:FR-007",
              "requirement:FR-008",
              "requirement:RN-01",
              "entity:coche"
            ]
          }
        ],
        "diagrams": [
          {
            "id": "d-01",
            "kind": "components",
            "title": "Componentes de carreras top-down",
            "description": "Bucle, escenas, mecánica y persistencia.",
            "layout": "layered",
            "nodes": [
              {
                "id": "bucle",
                "label": "Bucle de juego (paso fijo)",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "escenas",
                "label": "Escenas y nodos Godot",
                "shape": "rounded",
                "group": "presentación",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "mecanica",
                "label": "Sistemas de mecánica (ECS)",
                "shape": "box",
                "group": "dominio",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "fisica",
                "label": "Física y colisiones 2D",
                "shape": "box",
                "group": "motor",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              },
              {
                "id": "save",
                "label": "Guardado SQLite",
                "shape": "cylinder",
                "group": "datos",
                "x": 0,
                "y": 0,
                "w": 160,
                "h": 60,
                "fill": "",
                "links": []
              }
            ],
            "edges": [
              {
                "id": "e-bucle-mecanica",
                "from": "bucle",
                "to": "mecanica",
                "label": "actualiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-escenas-mecanica",
                "from": "escenas",
                "to": "mecanica",
                "label": "renderiza",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-fisica",
                "from": "mecanica",
                "to": "fisica",
                "label": "colisiones",
                "kind": "dependency",
                "dashed": false
              },
              {
                "id": "e-mecanica-save",
                "from": "mecanica",
                "to": "save",
                "label": "persiste",
                "kind": "dependency",
                "dashed": false
              }
            ]
          }
        ],
        "visual": {
          "identity": "Tropikal Studio",
          "style": "Pixel-art de circuito con coches y trazada distinguibles",
          "palette": [
            {
              "name": "Turquesa",
              "hex": "#2DD4BF",
              "usage": "Acciones primarias y estados activos"
            },
            {
              "name": "Petróleo",
              "hex": "#0F2E2B",
              "usage": "Fondos y superficies"
            },
            {
              "name": "Ámbar",
              "hex": "#F5B841",
              "usage": "Avisos, peligro y puntuación"
            }
          ],
          "typography": [
            "Fuente pixel legible a 720p",
            "Fuente de sistema para menús"
          ],
          "components": [
            "HUD compacto",
            "Menú de pausa modal",
            "Pantalla de resultados"
          ],
          "navigation": "Pausa con un botón; navegación por teclado y mando",
          "responsive_notes": "UI escala con resolución; HUD anclado a esquinas",
          "asset_sources": [
            "Kenney Assets",
            "OpenGameArt",
            "PixelFrog"
          ],
          "references": []
        },
        "mockups": [
          {
            "mockup_id": "m-game-hud-2d",
            "name": "HUD del juego",
            "screen": "Pantalla de juego",
            "notes": "HUD compacto con puntuación, vidas/progreso y botón de pausa."
          },
          {
            "mockup_id": "m-settings-center",
            "name": "Centro de ajustes",
            "screen": "Menú de opciones",
            "notes": "Volumen, dificultad y controles; accesible desde pausa y menú principal."
          }
        ],
        "skills": [
          {
            "id": "sk-01",
            "skill_id": "game-loop-architecture",
            "name": "Arquitectura de bucle de juego",
            "purpose": "Paso fijo, interpolación y pausa sin deriva.",
            "when": "implementación"
          },
          {
            "id": "sk-02",
            "skill_id": "entity-component-system",
            "name": "Sistema entidad-componente",
            "purpose": "Mecánicas componibles sin jerarquías frágiles.",
            "when": "diseño"
          },
          {
            "id": "sk-03",
            "skill_id": "game-save-systems",
            "name": "Sistemas de guardado",
            "purpose": "Save atómico, versionado y migrable.",
            "when": "implementación"
          },
          {
            "id": "sk-04",
            "skill_id": "game-physics-collision",
            "name": "Física y colisiones 2D",
            "purpose": "Física de conducción cenital y límites de pista.",
            "when": "implementación"
          }
        ],
        "testing": {
          "strategy": "Unitarias de la mecánica con GUT, integración de escenas y física en Godot headless y playtesting de aceptación de cada requerimiento.",
          "levels": [
            {
              "kind": "unit",
              "scope": "Lógica de mecánica y reglas con GUT",
              "tools": [
                "GUT"
              ],
              "notes": ""
            },
            {
              "kind": "integration",
              "scope": "Escenas y física en Godot headless",
              "tools": [
                "Godot headless"
              ],
              "notes": ""
            },
            {
              "kind": "acceptance",
              "scope": "Playtesting de cada requerimiento de juego",
              "tools": [
                "Playtesting manual"
              ],
              "notes": ""
            }
          ],
          "cases": [
            {
              "id": "c-01",
              "requirement": "FR-001",
              "title": "Bucle de juego y control",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Bucle de juego y control»",
              "then": "El bucle mantiene 60 fps estables en partidas largas",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-02",
              "requirement": "FR-002",
              "title": "Niveles y progreso",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Niveles y progreso»",
              "then": "Un nivel se desbloquea al superar el anterior",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-03",
              "requirement": "FR-003",
              "title": "Puntuación y récord",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Puntuación y récord»",
              "then": "La puntuación nunca es negativa",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-04",
              "requirement": "FR-004",
              "title": "Guardado y carga",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Guardado y carga»",
              "then": "Cargar una partida restaura nivel, puntuación y estado",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-05",
              "requirement": "FR-005",
              "title": "Ajustes del jugador",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Ajustes del jugador»",
              "then": "Los ajustes persisten entre sesiones",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-06",
              "requirement": "FR-006",
              "title": "Pausa y reanudación",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Pausa y reanudación»",
              "then": "Pausar congela la simulación",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-07",
              "requirement": "FR-007",
              "title": "Conducción y vueltas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Conducción y vueltas»",
              "then": "Cruzar la meta en sentido correcto incrementa la vuelta en uno",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-08",
              "requirement": "FR-008",
              "title": "Rivales y posición",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Rivales y posición»",
              "then": "La posición refleja vuelta y progreso real respecto a los rivales",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-09",
              "requirement": "FR-009",
              "title": "Logros y estadísticas",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Logros y estadísticas»",
              "then": "Un logro se desbloquea una sola vez",
              "level": "functional",
              "priority": "must"
            },
            {
              "id": "c-10",
              "requirement": "RN-01",
              "title": "Salir de pista penaliza",
              "given": "Sistema con los datos semilla y la configuración de la plantilla",
              "when": "Se ejecuta la capacidad «Salir de pista penaliza»",
              "then": "Salir de pista aplica una penalización de velocidad",
              "level": "acceptance",
              "priority": "must"
            }
          ],
          "coverage_expected": "Un caso de aceptación por requerimiento (cobertura 1:1).",
          "definition_of_done": [
            "Bucle estable a 60 fps sin deriva en partidas largas",
            "Guardado y carga restauran el estado exacto de la partida",
            "Todos los requerimientos con su caso de aceptación verificado",
            "Evaluación del documento sin hallazgos críticos ni inconsistencias"
          ]
        },
        "deliverables": [
          {
            "id": "dl-01",
            "title": "Guía de juego y controles",
            "kind": "usuario",
            "format": "Markdown",
            "audience": "Jugador",
            "contents": [
              "Cómo se juega",
              "Controles",
              "Objetivo y puntuación"
            ]
          },
          {
            "id": "dl-02",
            "title": "Documento de diseño (GDD) técnico",
            "kind": "tecnico",
            "format": "Markdown",
            "audience": "Equipo de desarrollo",
            "contents": [
              "Mecánica central",
              "Arquitectura de escenas",
              "Modelo de guardado"
            ]
          },
          {
            "id": "dl-03",
            "title": "Build y guía de publicación",
            "kind": "despliegue",
            "format": "ZIP + Markdown",
            "audience": "Publicador",
            "contents": [
              "Ejecutable por plataforma",
              "Requisitos",
              "Pasos de publicación"
            ]
          }
        ],
        "instructions": {
          "autonomy": "guided",
          "must_read_order": [
            "PROMPTPROJECT.md",
            "01-requerimientos",
            "03-datos/modelo-datos.md",
            "02-arquitectura",
            "07-testing/casos-prueba.md"
          ],
          "forbidden": [
            "Inventar mecánicas no aprobadas",
            "Acoplar la lógica de juego al framerate",
            "Instalar dependencias no listadas en arquitectura"
          ],
          "workflow": [
            "Leer el GDD y el contrato antes de tocar código",
            "Implementar la mecánica central con sus pruebas",
            "Verificar cada criterio de aceptación y el guardado antes de marcar hecho"
          ],
          "verification": [
            "Suite de pruebas en verde",
            "Bucle y guardado verificados en partidas reales",
            "Evaluación del documento sin hallazgos críticos"
          ],
          "notes": "Plantilla genérica curada: ajustar dificultad, arte y alcance del género antes de implementar."
        },
        "notes": [
          {
            "id": "n-01",
            "kind": "decision",
            "text": "La plantilla es genérica: ajustar dificultad, arte y alcance del género antes de implementar.",
            "status": "resolved",
            "resolution": "Se acepta como punto de partida; la customización permite adaptarla sin reescribir el contrato.",
            "created_at": 0
          }
        ]
      },
      "customization": [
        {
          "id": "q-name",
          "question_es": "¿Cómo se llamará su proyecto?",
          "question_en": "What will your project be called?",
          "help_es": "La plantilla trae un nombre genérico; escriba el suyo. Todo lo demás ya está respondido.",
          "help_en": "The template ships a generic name; write yours. Everything else is already answered.",
          "options": [],
          "text_field": {
            "label_es": "Nombre del proyecto",
            "label_en": "Project name",
            "op": {
              "module": "identity",
              "op": "set",
              "field": "name",
              "value_from": "text"
            }
          }
        },
        {
          "id": "q-scope",
          "question_es": "¿Con qué alcance arranca?",
          "question_en": "Which scope do you start with?",
          "help_es": "El alcance esencial quita lo accesorio; puede volver a añadirlo después en Arquitectura.",
          "help_en": "The essential scope removes the extras; you can add them back later in Architecture.",
          "options": [
            {
              "id": "full",
              "label_es": "Alcance completo de la plantilla",
              "label_en": "Full template scope",
              "recommended": true,
              "ops": []
            },
            {
              "id": "essential",
              "label_es": "Alcance esencial (quita lo accesorio)",
              "label_en": "Essential scope (drops extras)",
              "recommended": false,
              "ops": [
                {
                  "module": "requirements",
                  "op": "remove",
                  "target": "FR-009"
                },
                {
                  "module": "testing.cases",
                  "op": "remove",
                  "target": "c-09"
                },
                {
                  "module": "deliverables",
                  "op": "remove",
                  "target": "dl-03"
                },
                {
                  "module": "identity",
                  "op": "set",
                  "field": "scope",
                  "value": [
                    "Bucle y control",
                    "Niveles y progreso",
                    "Guardado",
                    "Conducción y vueltas"
                  ]
                }
              ]
            }
          ]
        },
        {
          "id": "q-engine",
          "question_es": "¿Motor y lenguaje del juego?",
          "question_en": "Game engine and language?",
          "help_es": "La plantilla ya trae una elección razonada; cámbiela solo si su caso lo pide.",
          "help_en": "The template already ships a reasoned choice; change it only if your case needs it.",
          "options": [
            {
              "id": "godot",
              "label_es": "Godot 4 + GDScript",
              "label_en": "Godot 4 + GDScript",
              "recommended": true,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Godot 4"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "GDScript"
                }
              ]
            },
            {
              "id": "unity",
              "label_es": "Unity + C#",
              "label_en": "Unity + C#",
              "recommended": false,
              "ops": [
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "framework",
                  "value": "Unity 2022 LTS"
                },
                {
                  "module": "architecture",
                  "op": "set",
                  "field": "language",
                  "value": "C#"
                }
              ]
            }
          ]
        },
        {
          "id": "q-autonomy",
          "question_es": "¿Cómo trabajará el agente con este proyecto?",
          "question_en": "How will the agent work with this project?",
          "help_es": "Guiado revisa cada paso con usted; con aprobación aplica lotes revisados.",
          "help_en": "Guided reviews each step with you; with approval it applies reviewed batches.",
          "options": [
            {
              "id": "guided",
              "label_es": "Guiado, paso a paso",
              "label_en": "Guided, step by step",
              "recommended": true,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "guided"
                }
              ]
            },
            {
              "id": "approval",
              "label_es": "Autónomo con aprobación de lotes",
              "label_en": "Autonomous with batch approval",
              "recommended": false,
              "ops": [
                {
                  "module": "instructions",
                  "op": "set",
                  "field": "autonomy",
                  "value": "autonomous_with_approval"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}