[x] SpecBox Engine · v6.49.0 «Cláusula» · 2026-11-19

Todo lo que hay entre la spec y la evidencia.

El engine es fair source y gratis, también en producción. Aquí está entero: los cuatro comandos, los agentes, las herramientas MCP y los hooks que bloquean, con las cifras que publica cada versión.

Fair source, con licencia FSL-1.1-ALv2: gratis para cualquier uso, también en producción y con clientes, salvo ofrecer un producto o un servicio que compita con SpecBox. Leer la licencia

agentes
13
herramientas MCP
218
comandos
27
versión de la extensión
v6.49.0

Foto del 2026-11-19 18:43 UTC

El pipeline

Cuatro comandos. Entre cada uno, un control.

Cada comando deja algo que puedes revisar, y no se pasa al siguiente sin superar su control.

Ver una entrega real, paso a paso
  1. 01/discovery

    Antes de escribir una línea: para quién es (ICP) y qué trabajo le resuelve (JTBD), en una conversación guiada.

    Dejadoc/discovery/<feature>/icp_jtbd.md
    ControlEl discovery tiene que quedar completo (READY_FOR_PRD) para pasar al PRD.
  2. 02/prd

    Historias, casos de uso y criterios de aceptación medibles, directamente en tu board.

    DejaUS · UC · AC en el board
    ControlDefinition Quality Gate: cada criterio tiene que ser específico, medible y comprobable.
  3. 03/plan

    Plan técnico por fases, componentes y el diseño de cada pantalla con los tokens del sistema.

    Dejadoc/plans/<feature>_plan.md + diseños
    ControlCada plan deja escrita su fuente de diseño: los tokens del sistema, no un brand kit aparte.
  4. 04/implement

    Rama, fases aisladas, código, tests y PR. Los agentes se reparten el trabajo y el orquestador coordina.

    DejaPR + un recibo por criterio
    ControlAG-08 da GO o NO-GO en cada fase y AG-09 acepta o rechaza cada caso de uso: sin los dos no hay merge.

Control

Lo que no se negocia.

Un fichero de instrucciones sugiere. En el engine, los gates deciden, los hooks bloquean y el self-healing repara, con un límite.

Gates que deciden

  • Definition Quality GateEn /prd. Un criterio que no es específico, medible y comprobable se rechaza y se propone otro.
  • AG-08 · Quality AuditorEn cada fase de /implement. GO o NO-GO: con NO-GO la fase no avanza.
  • AG-09 · AceptaciónEn /implement. Acepta, acepta con condiciones o rechaza cada caso de uso según sus criterios y su evidencia.
  • /feedbackLo que encuentra una persona probando invalida el veredicto: un fallo crítico o mayor bloquea el merge.

Aparte y bajo demanda: /audit hace una auditoría ISO/IEC 25010 con informe en PDF.

Hooks que bloquean

  • quality-first-guard.mjsNo se modifica un fichero que no se ha leído.
  • spec-guard.mjsSin un caso de uso activo, o en main, no se escribe código.
  • commit-spec-guard.mjsNingún commit en main.
  • pre-commit-lint.mjsLint a cero antes de cada commit.
  • no-bypass-guard.mjsNi --no-verify, ni push --force, ni reset --hard.
  • design-system-gate.mjsEn autopilot, ningún color ni fuente fuera del sistema de diseño.
  • healing-budget-guard.mjsOcho intentos de reparación como máximo.

Self-healing, con límite

Cuando una fase falla, el engine intenta repararse antes de pedir ayuda: dos intentos por fase y ocho por implementación; si fallan dos fases seguidas, para.

  1. 1
    Auto-fixCorrige lint, formato e imports (por ejemplo, eslint --fix).
  2. 2
    PatchDiagnostica y arregla la causa: un import que falta, un tipo incorrecto, una ruta mal resuelta.
  3. 3
    RollbackVuelve al último estado limpio, marca el checkpoint como fallido y reintenta la fase.
  4. 4
    Una personaSi la fase sigue fallando, para y escala con el diagnóstico escrito.
Por qué bloquean
En marzo de 2026 un agente implementó nueve casos de uso saltándose el pipeline y dejó el board vacío y sin trazabilidad. Ese día nacieron los bloqueos.

Inventario

Todo lo que trae, contado desde el código.

Agentes, comandos y herramientas salen del inventario que publica cada versión del engine: ninguna cifra está escrita a mano.

13 agentes

El orquestador nunca escribe código: coordina, delega y consolida.

  • Orchestrator
  • AG-01 Feature Generator
  • AG-02 UI/UX Designer
  • AG-03 DB Specialist
  • AG-04 QA & Validation
  • AG-05 n8n Specialist
  • AG-06 Google Stitch MCP
  • AG-07 Apps Script Specialist
  • AG-08 Quality Auditor
  • AG-09a Acceptance Tester
  • AG-09b Acceptance Validator
  • AG-10 Developer Tester
  • /audit ISO/IEC 25010

27 comandos

Los cuatro del pipeline primero; después, los que lo rodean: calidad, diseño, backends, pagos y releases.

  • /discovery
  • /prd
  • /plan
  • /implement
  • /acceptance-check
  • /adapt-ui
  • /app-init
  • /app-sync
  • /audit
  • /check-designs
  • /compliance
  • /design-review
  • /explore
  • /feedback
  • /fix
  • /handoff
  • /manual-test
  • /optimize-agents
  • /quality-gate
  • /queue-review
  • /quickstart
  • /release
  • /stripe-connect
  • /stripe-standard
  • /stripe-switch-account
  • /switch-backend
  • /visual-setup

218 herramientas MCP

En un solo servidor, alojado en mcp.specbox.build. Los módulos con más herramientas:

  • 21 spec_driven Historias, casos de uso y criterios, con cualquier backend
  • 17 stitch Proxy completo de Google Stitch
  • 16 state Checkpoints, healing y sesiones
  • 12 migration Cambio de backend sin perder avance
  • 11 onboarding Alta, actualización y matriz de versiones
  • 8 spec_mutations Alta y edición de historias, casos y criterios
  • 7 coordination Identidad, reservas y ramas
  • 7 enforcement

Y 119 herramientas más en otros 42 módulos.

Se adapta a tu proyecto

Tu board, tu stack y tus servicios.

Dónde vive tu tracking

Cuatro backends con la misma interfaz, y migración entre ellos sin perder avance.

  • TrelloBoards con tarjetas de US, UC y AC
  • PlaneEn la nube o en tu servidor
  • FreeFormJSON en tu repositorio, sin API externa
  • NativePostgres compartido por todo el equipo
SpecBox CloudEl panel del ecosistema: sesiones, auditoría y progreso en cloud.specbox.build.

Stacks

  • Flutter
  • React
  • Go
  • Python
  • Google Apps Script

Servicios

  • Supabase
  • Neon
  • Stripe
  • Firebase
  • n8n

Extensión para VSCode

Instalación guiada, actualización automática e inicio de sesión con GitHub.

EmbedBuild.specbox-engine · v6.49.0

Evolución

Cada versión, con lo que evita.

Lo último que ha cambiado en el engine, con su sección de seguridad cuando la tiene. Todas las versiones están en producción.

Changelog completo en GitHub

v6.49.0

Cláusula 2026-11-19 Versión actual
  • El contrato de cada criterio: .quality/evidence/<feature>/acceptance/contract.json con las precondiciones (AC-NN.preN), las postcondiciones (AC-NN.postN) y lo que el criterio no d…
  • Módulo puro server/acceptance_contract.py con su espejo lib/acceptance-contract.mjs y prueba de paridad
  • Tool pura nueva check_acceptance_contract: qué criterios no tienen contrato, cuáles lo tienen incompleto, qué entradas no valen y, con results.json, qué pruebas no citan una pre y…
  • AG-09a lo escribe antes de las pruebas (Paso 7.5.0 de /implement) y cada prueba cita lo que comprueba: etiquetas @pre:AC-01.pre1 @post:AC-01.post1, o un comentario contract: en lo…

Seguridad: qué evita esta versión

  • check_acceptance_contract es pura: solo lee el contrato y los resultados que recibe, sin tablero, disco ni identidad. Por eso la plantilla de permisos la deja correr sin preguntar, como las demás tools de solo lectura. Tiene topes antes de leer: 512 KB el contrato, 5 MB los resultados, 200 criterios, 50 condiciones por clase y 2000 caracteres por texto. Un JSON con NaN, un anidamiento sin fin o un carácter suelto responden INVALID_CONTRACT o INVALID_RESULTS, nunca un fallo. Tiene su fila en el modelo de amenazas.

v6.48.0

Remiendo 2026-11-19
  • /fix, skill nueva (context: direct)
  • Antes de tocar el tablero escribe una prueba que reproduce el bug y comprueba que falla por el bug, en la carpeta de pruebas normal (nunca en las de aceptación), y también en la r…
  • Crea la UC con un criterio en la historia indicada o en «Arreglos sin PRD» (con uc_id explícito, validate_ac_quality y update_uc(no_prd_reason=…))
  • start_uc, rama fix/UC-XXXX-<slug>, commit de la prueba sola, el arreglo, el recibo con la prueba y los ficheros antes del CI, el visto bueno independiente (evaluador aislado en «a…

v6.47.0

Spec viva 2026-11-19
  • El radio de impacto del cambio
  • Hook nuevo impact-radius-guard (PreToolUse de git commit): clasifica el commit en contrato de API, migración de datos, dependencias o código interno por sus ficheros, y lo dice en…
  • Un contrato es openapi, swagger, .proto, schema*.graphql, .graphqls o un cambio en los parámetros de una función pública de los ficheros de impact.signature_globs
  • Tool nueva use_enforcement_skip: el hook gasta la aprobación de una persona en un intento concreto (el commit y la huella del contenido que decide la clase)

Seguridad: qué evita esta versión

  • Una aprobación no se inventa en local (native): la guarda el tablero con quién, cuándo, por qué y desde qué sesión, y se gasta ligada al commit y a la huella del contenido.
  • El documento de comportamiento solo se escribe dentro del repositorio del canon, sin .. ni enlaces simbólicos, y un <!-- o --> de un criterio va como texto.
  • El hook solo manda with_behavior_doc a un servidor que lo conoce (/health, 6.47.0 o posterior).

v6.46.0

La puerta 2026-11-19
  • Los ficheros de una UC cerrada
  • complete_uc(files, repo) guarda los ficheros que cambió su PR en meta.closed_files y, con repo, en la lista de ese repositorio
  • Si se vuelve a cerrar, se suman
  • Tool nueva get_closed_uc_files: qué UC cerradas del mismo repositorio cambiaron unas rutas, con la propuesta de revisar sus criterios

Seguridad: qué evita esta versión

  • Una exclusión no puede colgar el servidor compartido: los globs se comparan en tiempo lineal, con un tope de trabajo por llamada (EXCLUDE_TOO_COSTLY, que en «block» falla) y hasta 20 comodines.
  • Una rama no afloja su propia puerta: las exclusiones y los prefijos salen de la rama base, y en «block» fallan una rama de más de 20 000 ficheros o una ruta de más de 1024 caracteres.

v6.45.0

Hilo conductor 2026-11-19
  • El contrato del plan
  • Cada fase de un plan de /plan lleva una línea Criterios: (los AC que cubre) y otra Ficheros: (los que espera tocar)
  • server/plan_contract.py lo lee
  • Tool nueva check_plan_contract: devuelve uncovered (criterios sin fase), incomplete_phases (fases sin sus dos líneas), unattributed (criterios sin su UC en un plan de varias) y ok

Seguridad: qué evita esta versión

  • El recibo de Trello y Plane se valida al leerlo: un texto que imite el bloque no se toma por un recibo si no es el JSON que escribe el engine.
Versiones anteriores (25)

v6.44.0

Visto previo 2026-11-19
  • Aprobar los criterios antes de implementar
  • Guarda la huella de los criterios vigentes (id y texto, server/approval.py) con quién y cuándo
  • La llama la sesión que habla con la persona
  • Reescribir un criterio, añadir uno o retirarlo cambia la huella: la UC queda «stale» hasta otra aprobación

Seguridad: qué evita esta versión

  • El contexto de quien aprueba no lo declara el modelo: lo pone el hook agent-identity con lo que Claude Code da a los hooks.
  • La tabla nueva está cerrada a los roles públicos, con seguridad por filas y la política restrictiva del board.

v6.43.0

Para siempre 2026-11-19
  • Retirar un criterio en vez de borrarlo
  • Un id retirado no se vuelve a usar
  • import_spec con on_existing_uc
  • name y los campos que cambian;

Seguridad: qué evita esta versión

  • La tabla nueva está cerrada a los roles públicos, con seguridad por filas y la política restrictiva del board, como el resto (0024).

v6.42.0

Otra mirada 2026-11-18
  • Revisión independiente antes de fusionar
  • una persona que la acepta en el panel, en cualquier nivel de autopilot;
  • en autopilot «agresivo», y en FreeForm (sin panel), el veredicto «aceptada» de un evaluador aislado (subagente AG-09b) en otro contexto
  • Una devolución posterior la detiene

Seguridad: qué evita esta versión

  • El contexto de quien revisa no lo declara el modelo. Lo pone el hook agent-identity con lo que Claude Code da a los hooks; un veredicto del mismo contexto que implementó se rechaza.
  • Solo cifras en el coste. report_uc_usage rechaza todo lo que no sea un entero o un identificador corto, la tabla uc_usage no tiene columnas de texto y el hook nunca envía texto de la conversación.
  • Las tablas nuevas están cerradas a los roles públicos, con seguridad por filas y la política restrictiva de denegación, como el resto del board.

v6.41.0

Con recibo 2026-11-18
  • complete_uc exige cada criterio con evidencia que pasa
  • En «block», complete_uc devuelve AC_WITHOUT_PASSING_EVIDENCE con cada criterio y su motivo (not_done, no_evidence, failing_evidence)
  • En «warn», cierra y la respuesta lleva enforcement_warnings con esos criterios
  • Una UC empezada antes de que la medida pasara a «block» cierra con aviso; un salto con skip_enforcement y motivo deja cerrar una vez

Seguridad: qué evita esta versión

  • Lo que se fusiona y se cierra está demostrado — complete_uc y merge-guard comprueban los recibos en el servidor o en el tablero, no en lo que dice el agente; merge-guard solo lee (get_uc con la identidad del dispositivo, o items.json) y, sin datos, no detiene nada.
  • El autor de un recibo de FreeForm es un nombre, no texto libre — marked_by se recorta a 100 caracteres en una línea, y en native se ignora: firma siempre el developer de la sesión.

v6.40.0

Por escrito 2026-11-18
  • Cada criterio dice cómo se comprueba
  • Entra por import_spec ({text, verification}), add_ac, add_uc, update_ac y update_ac_batch; un valor que no es de los cuatro devuelve INVALID_VERIFICATION
  • Native y FreeForm lo guardan en el meta del criterio
  • validate_ac_quality avisa no_verification en un criterio que no la dice; el aviso no cuenta para el umbral

Seguridad: qué evita esta versión

  • check_prd_format no añade superficie — recibe el texto del PRD en la llamada y no lee el tablero ni el disco ni guarda nada; la plantilla de permisos la pone entre las de solo lectura.
  • Una tool solo escribe la forma de comprobación de un criterio — los backends aceptan de las tools solo las claves de AC_META_KEYS (verification); el sello de reglas, los recibos y el veredicto los sigue escribiendo únicamente el propio backend.

v6.39.0

Umbral 2026-11-18
  • start_uc comprueba la calidad de la spec antes de reservar
  • en «block», una UC sin criterios o con menos criterios buenos que el umbral devuelve AC_QUALITY_BELOW_THRESHOLD con cada criterio y su motivo
  • en «warn», arranca y la respuesta lleva el aviso;
  • una UC anterior a la regla, o con un salto pedido con skip_enforcement, arranca

Seguridad: qué evita esta versión

  • El gate lo decide el servidor, antes de tocar el tablero — start_uc comprueba las dos medidas antes de reservar (en native, después de identificar a quien llama): un cliente con skills anteriores no se lo salta, y un arranque detenido no deja reserva ni UC movida.
  • Un salto vale para un arranque — se gasta con la fila del proyecto bloqueada, así que dos start_uc a la vez no aprovechan el mismo salto.
  • Los eventos de bloqueo guardan la medida y la UC, no la spec — ni el texto de los criterios ni las marcas pendientes pasan al registro de auditoría.

v6.38.1

Sin atascos 2026-11-18
  • La copia gestionada del engine vuelve a actualizarse
  • la reconstrucción instala con npm ci (si no puede, sin lock) y nunca reescribe el package-lock.json;
  • el package-lock.json versionado lleva la licencia de package.json, y una prueba lo comprueba;
  • antes de cambiar de versión, la extensión restaura ese fichero, así que una copia ya atascada pasa a la versión nueva

v6.38.0

Lo justo 2026-11-18
  • El CLAUDE.md de plantilla pasa de 390 a 160 líneas
  • Medida context_budget
  • Medida spec_in_pr y hook prd-sync-guard
  • La zona «roadmap» solo viaja cuando se pide

Seguridad: qué evita esta versión

  • Las prohibiciones de permisos siguen en el CLAUDE.md compacto — la zona permisos mantiene que no se lee ~/.ssh, ~/.specbox ni .env y que no se usa curl ni wget; upgrade_project la actualiza sin tocar settings.local.json.
  • upgrade_project no lee ni escribe el disco del cliente — el CLAUDE.md llega como contenido y vuelve como contenido; el servidor no lo guarda.
  • El registro del presupuesto de contexto guarda tamaños, no el texto — cada línea lleva la tool, los tokens estimados, el presupuesto, el modo y el resultado; nunca el encargo del subagente.
  • El motivo «sin PRD» no admite credenciales — update_uc(no_prd_reason=...) rechaza un texto que parece una credencial, porque el motivo queda en el tablero y lo ve quien revisa la UC.

v6.37.0

A la vista 2026-11-18
  • La UC activa queda marcada en el proyecto
  • uc-lifecycle-guard deja de avisar en falso
  • spec-guard revisa la reserva de verdad
  • Los hooks leen el bloque specbox de settings.local.json, que escriben onboard_project y la extensión

Seguridad: qué evita esta versión

  • Escribir código de una UC que ya no es tuya se detiene — spec-guard comprueba con el tablero la reserva que guarda el marcador: si se liberó o la tiene otra persona, la escritura se señala y hay que volver a empezar la UC o coordinarse.
  • La consulta de la reserva solo responde a miembros del proyecto — get_uc_reservation usa la identidad del dispositivo o de la sesión; un proyecto ajeno responde como si no existiera y la respuesta solo lleva quién tiene la reserva, cuándo y en qué rama.

v6.36.0

Convivencia 2026-11-18
  • Un modo por medida y por proyecto
  • Antes de endurecer, un informe
  • No cambia nada en su trabajo
  • Quien administra el proyecto decide cuándo endurecer

v6.35.0

Palabra 2026-11-18
  • Las zonas automáticas de app_spec entran al empezar la sesión
  • El presupuesto de contexto vigila a los subagentes
  • Un proyecto nuevo nace con el control de discovery en «warn»
  • add_uc sigue la numeración de la historia

Seguridad: qué evita esta versión

  • Configurar FreeForm desde la extensión no pisa los ajustes del proyecto — al conectar un proyecto FreeForm, la extensión conserva los ajustes y las variables de entorno que ya tenía settings.local.json; esta versión solo añade el modo del discovery cuando el fichero no existía, y el flujo de conexión no cambia en lo que toca a credenciales.

v6.34.0

Foto fija 2026-11-12
  • get_marketplace_stats lee la foto diaria
  • Lista de superficies de la base
  • El workflow marketplace-stats.yml y scripts/fetch-marketplace-stats.mjs: escribían en un fichero ignorado y no guardaban nada (#348)
  • La lista de superficies aprobadas ya no aprueba lo que no existe

Seguridad: qué evita esta versión

  • La lista de superficies aprobadas ya no aprueba lo que no existe — public.site_funnel sale de la lista: si algún día volviera a crearse una función con ese nombre y abierta a más roles, la comprobación de la base la marcaría en lugar de darla por buena.
  • get_marketplace_stats solo da cifras públicas — las visitas y clones de GitHub, que la foto diaria también guarda, no salen de la herramienta.

v6.33.1

A la primera 2026-11-11
  • Una instalación nueva cuenta en su primer arranque
  • changelog-security-check termina el rango de una versión ya etiquetada en su etiqueta: un commit que llega a main después de una release es de la siguiente y ya no rompe la prueba…
  • test-npm-publish-and-wait.sh demuestra «sin espera» con una sola consulta a npm, no con el texto «after 0s», que fallaba cuando la máquina iba cargada (#345)
  • CI del engine en local

Seguridad: qué evita esta versión

  • Búsqueda de claves antes de cada PR — el CI local pasa gitleaks por todo el historial del repositorio. Los falsos positivos revisados (claves inventadas de las pruebas y la clave pública de Supabase de la extensión) quedan fijados uno a uno por su huella, así que una clave nueva, en cualquier fichero, para la PR.

v6.33.0

Latido 2026-11-11
  • Latido diario anónimo (vscode-extension/src/heartbeat.ts, UC-11802)
  • Sección de telemetría de uso en vscode-extension/README.md (la ficha del Marketplace) y README.es.md: qué se envía, cada cuánto y cómo desactivarlo
  • La activación se registra
  • Con la telemetría de VS Code desactivada no se envía nada y ni siquiera se crea el identificador

v6.32.0

Sello 2026-11-10
  • Migración 0035_ac_text_change_resets_done.sql (y su copia en supabase/migrations): un trigger BEFORE UPDATE OF text deja sin hacer un criterio hecho que cambia de texto y pone su…
  • commit y repo en el recibo de mark_ac y mark_ac_batch: el commit con el que se comprobó el criterio (de 7 a 40 hexadecimales) y su repositorio (owner/nombre)
  • get_uc da en cada criterio hecho repeatable_test y, si ningún recibo test pasa, la marca sin_prueba_que_se_repita en flags
  • Un criterio aceptado ya no se puede reescribir conservando su aceptación: cambiar el texto de un criterio hecho, por cualquier vía, lo deja pendiente y anula la aceptación de su UC

Seguridad: qué evita esta versión

  • Un criterio aceptado ya no se puede reescribir conservando su aceptación: cambiar el texto de un criterio hecho, por cualquier vía, lo deja pendiente y anula la aceptación de su UC.
  • El MCP alojado ya no se puede desplegar desde fuera de GitHub: el webhook del repositorio que llamaba al panel anterior se ha borrado y el despliegue solo sale de una fusión en main.

v6.31.0

Mudanza 2026-11-08
  • server/coordination/rate_limit.py
  • Un solo cliente ya no puede acaparar el MCP alojado ni la base que hay detrás: ninguna identidad pasa de 1.200 llamadas por hora ni de 5.000 al día
  • get_uc lee solo la UC pedida y su historia, sin las UC hermanas: en una UC de una historia grande pasa de 19–20 KB a 3–4 KB
  • La extensión de VS Code envía el evento de activación a supabase.specbox.build con la clave publicable de la pila propia (la misma que lleva el site), en vez de al proyecto de Sup…

Seguridad: qué evita esta versión

  • Un solo cliente ya no puede acaparar el MCP alojado ni la base que hay detrás: ninguna identidad pasa de 1.200 llamadas por hora ni de 5.000 al día. Pasado el límite, la tool no se ejecuta y responde RATE_LIMITED con los segundos que faltan (retry_after_s); las llamadas rechazadas no cuentan y quedan en el registro de accesos. El tope por minuto sigue siendo el de UC-3903.

v6.30.0

Juego limpio 2026-10-28
  • NOTICE
  • SERVICES.md
  • La plantilla de proyecto solo deja usar sin preguntar las tools del MCP que leen
  • Licencia: el engine, la CLI (specbox en npm) y la extensión pasan de BSL 1.1 (engine) y MIT (CLI y extensión) a la FSL-1.1-ALv2 (Functional Source License 1.1 con licencia futura…

Seguridad: qué evita esta versión

  • La plantilla de proyecto solo deja usar sin preguntar las tools del MCP que leen. Una prueba compara esa lista con las tools del servidor y falla si se cuela una que crea, cambia, borra, reserva, marca o informa, así que permitir la lectura nunca abre la puerta a una escritura sin confirmar.

v6.29.2

Tesela 2026-10-28
  • FreeForm en fragmentos
  • specbox hooks status|update y «SpecBox: Update Project Hooks» en la extensión: listan los hooks del proyecto que difieren de los publicados y los actualizan sin pisar los que se c…
  • build_execution_context y aggregate_phase_outputs: /implement calcula su contexto y el agregado de Spec-Code Sync con estas tools, sin clon del engine ni Python (#324, UC-11202)
  • keep_theme_directives en stitch_generate_screen_v2: con un Design System aplicado, la respuesta dice qué líneas de tema quitó del prompt y este parámetro las conserva (#322, UC-11…

Seguridad: qué evita esta versión

  • La clave de Stitch no pasa por la conversación. El ayudante de cabeceras la envía en X-Stitch-Api-Key con cada petición al MCP, como el token del board, desde STITCH_API_KEY o stitch.apiKey del .claude/settings.local.json del proyecto. El MCP alojado nunca toma una clave de su propio entorno, y stitch_set_api_key, que la recibía como argumento, queda obsoleta y lo dice en su respuesta (#323, UC-11301).

v6.29.1

Bisagra 2026-10-27
  • La extensión pide la cuenta también en FreeForm
  • scripts/smoke-freeform-remote.mjs: recorre el flujo FreeForm contra los dos nombres del MCP tras cada despliegue y en /release (doc/runbooks/mcp-smoke-freeform.md) (#309, UC-11012)
  • La plantilla de proyectos sigue prohibiendo leer las credenciales de ~/.specbox (los .json de su raíz, credentials/ y backups/), también a través de un enlace, y editar cualquier…
  • FreeForm con el MCP alojado

Seguridad: qué evita esta versión

  • La plantilla de proyectos sigue prohibiendo leer las credenciales de ~/.specbox (los .json de su raíz, credentials/ y backups/), también a través de un enlace, y editar cualquier cosa de ~/.specbox; ya no prohíbe leer el clon del engine al que enlazan las skills (#308, UC-11009).

v6.29.0

Candado 2026-10-27
  • Las tools de solo lectura del MCP (planes, diseños, hooks, skills, prompts de agentes, documentación de arquitectura e infraestructura, baselines, evidencias y logs de sesión) sol…
  • Un servidor remoto ya no arranca sin SPECBOX_TRANSPORT_AUTH, así que perder la variable en un despliegue no deja las tools abiertas sin token (#299)
  • La imagen del servidor instala exactamente las versiones de requirements.lock, comprobando el hash de cada paquete, con mcp 1.30 o superior, que limita las sesiones abiertas en el…
  • La plantilla de proyectos ya no deja ejecutar comandos ni abrir webs sin preguntar, y prohíbe leer o editar ~/.ssh y ~/.specbox, leer .env y usar curl o wget (#300)

Seguridad: qué evita esta versión

  • Las tools de solo lectura del MCP (planes, diseños, hooks, skills, prompts de agentes, documentación de arquitectura e infraestructura, baselines, evidencias y logs de sesión) solo leen dentro de su carpeta: un nombre absoluto, con .., con barra invertida o un enlace que apunta fuera se responde como un nombre que no existe (#298).
  • Un servidor remoto ya no arranca sin SPECBOX_TRANSPORT_AUTH, así que perder la variable en un despliegue no deja las tools abiertas sin token (#299).
  • La imagen del servidor instala exactamente las versiones de requirements.lock, comprobando el hash de cada paquete, con mcp 1.30 o superior, que limita las sesiones abiertas en el transporte HTTP (#299).
  • La plantilla de proyectos ya no deja ejecutar comandos ni abrir webs sin preguntar, y prohíbe leer o editar ~/.ssh y ~/.specbox, leer .env y usar curl o wget (#300).
  • La extensión de VS Code no ejecuta código de la carpeta abierta: solo corre install-ext.mjs del clon gestionado y en una carpeta de confianza, una carpeta solo cuenta como engine si es de confianza, e instalar, el onboarding, configurar el MCP e iniciar sesión piden confianza (#301).
  • El clon gestionado sigue las versiones publicadas (etiquetas vX.Y.Z), no main (#301).

v6.28.0

Plural 2026-10-26
  • Todas las sesiones vivas de un proyecto
  • La lista de sesiones vivas queda cerrada a los roles públicos como el resto del board: corre con los derechos de quien consulta y solo la leen el servidor y el panel con su rol de…
  • La publicación de la extensión compara la etiqueta con su versión
  • v_live_sessions y session no cambian: los siguen leyendo el vistazo, el Inicio del teléfono y la ficha del panel

Seguridad: qué evita esta versión

  • La lista de sesiones vivas queda cerrada a los roles públicos como el resto del board: corre con los derechos de quien consulta y solo la leen el servidor y el panel con su rol de servicio, que aplican la pertenencia al proyecto; quien no es miembro recibe lo mismo que si el proyecto no existiera (#296).

v6.27.0

Bolsillo 2026-10-25
  • Latido de cada sesión de Claude Code
  • Decisiones aplazadas del autopilot en el board
  • Eventos que merecen un aviso
  • El latido de una sesión solo lleva campos enumerados o de forma fija (proyecto, desarrollador, UC, fase, espera y horas), nunca texto de specs, prompts ni rutas

Seguridad: qué evita esta versión

  • El latido de una sesión solo lleva campos enumerados o de forma fija (proyecto, desarrollador, UC, fase, espera y horas), nunca texto de specs, prompts ni rutas. Su tabla queda cerrada a los roles públicos; solo los miembros del proyecto la escriben y la leen, una sesión ajena no se sobrescribe y lo ajeno responde como lo inexistente (#289).
  • El hook del latido usa la credencial del dispositivo, nunca bloquea ni escribe en la conversación, y un fallo queda en .quality/logs/heartbeat.log como mucho una vez por minuto (#289).
  • Las decisiones aplazadas aplican la pertenencia al proyecto en cada tool y lo ajeno responde como lo inexistente. Se rechazan las que llevan credenciales y las que nunca se aplazan (irreversibles o que definen la feature), y la sesión que las recoge al arrancar las recibe marcadas como datos, no como instrucciones (#290).
  • Los eventos de aviso no guardan texto de specs ni datos personales, su tabla queda cerrada a los roles públicos y un evento que no se puede apuntar nunca impide el cambio del board (#291).

v6.26.1

Extensión 2026-10-22
  • El icono de la extensión mide 1024×1024: el mismo dibujo, reescalado, para que el Marketplace acepte la publicación (#286)
  • vscode-extension/tests/marketplace-icon.test.mjs falla si el icono que declara package.json pasa de 1024×1024 (202 pruebas en la extensión, todas verdes)

v6.26.0

Extensión 2026-10-22
  • La copia gestionada se repara sola
  • Workflow extension-windows.yml: las pruebas de skills con junctions reales en windows-latest (Node 20, 22 y 24) en cada PR que toca la instalación o el diagnóstico
  • La extensión ya no puede borrar ficheros fuera de su carpeta a través de un acceso de ~/.claude/skills: si un acceso apunta a otra carpeta (la copia del engine o una carpeta propi…
  • La reparación de la copia del engine solo escribe en ~/.specbox/specbox-engine y solo los ficheros que git da por borrados: nunca descarta un cambio ni toca una copia en otra carp…

Seguridad: qué evita esta versión

  • La extensión ya no puede borrar ficheros fuera de su carpeta a través de un acceso de ~/.claude/skills: si un acceso apunta a otra carpeta (la copia del engine o una carpeta propia de la persona), se quita el acceso y lo que hay detrás no se toca (#279).
  • La reparación de la copia del engine solo escribe en ~/.specbox/specbox-engine y solo los ficheros que git da por borrados: nunca descarta un cambio ni toca una copia en otra carpeta (#281).

v6.25.0

Lienzo 2026-10-10
  • /design-review import <feature> <artboard…> trae los artboards aprobados de un lienzo a doc/design/<feature>/: su fuente, una vista HTML congelada (pintada con el motor del propio…
  • Lienzo por feature en /plan (Paso 6.0b), con la herramienta Artifact y el tipo Design: canvas.mjs scaffold coloca dos artboards por pantalla (1440 y 390) desde el brief, con el si…
  • Sistema del proyecto para el lienzo (/visual-setup 2.9.3, ds-artifact.mjs): publica design-system.tokens.json como Artifact del tipo Design System, con tokens validados, un tokens…
  • /design-review comments <feature> convierte cada hilo del lienzo en una corrección en su artboard o, si es un cambio de alcance, en un feedback del AC afectado (pasos de /feedback…

Seguridad: qué evita esta versión

  • Las guardias bloquean de verdad, antes de la acción y con el motivo para el agente (exit 2): no-bypass-guard para --no-verify, los push forzados que no son --force-with-lease y reset --hard, y commit-spec-guard para un commit en main de un proyecto spec-driven (#265).
  • pre-commit-lint pasa el linter del repositorio a los ficheros del commit antes de hacerlo, y los avisos que no bloquean llegan al agente como nota (additionalContext); una prueba recorre todos los hooks registrados (#265).
  • La puerta de diseño bloquea una página que lleve piezas del motor del lienzo (support.js, <x-dc>, DCLogic, /_blob/…) (#266).

Que tus agentes demuestren lo que hicieron.

Instala la extensión, abre Claude Code y empieza con /discovery. El primer recibo llega con el primer criterio cerrado.

O desde la paleta de VSCode:ext install EmbedBuild.specbox-engine