Workbench

Workbench es la cola de revisión para handoffs de script, DATA, layout y XML entregados a Genie por clientes Local MCP como Codex, Cursor, Claude Desktop u otro agente IDE local.

Mantiene visible y bajo control del usuario el trabajo de agentes externos. MCP puede preparar un prompt o borrador XML, pero el staging normal de Workbench no ejecuta proveedores, modifica FileMaker ni aplica código durante la llamada de herramienta. La única excepción es el ajuste beta explícito Automatically create scripts in FileMaker, que puede ejecutar el flujo revisado Create Script para stages de script compatibles desde clientes locales de confianza.

Dónde aparece

Abre Workbench desde la barra de herramientas con el icono de checklist.

Los items Workbench muestran:

título
modo: CODE, DATA o LAYOUT
cliente fuente
estado
script objetivo o destino del handoff cuando esté disponible
prompt, notas o resumen del artefacto
notas de revisión
advertencias
botones de acción

El selector superior separa:

Pending: items pendientes de revisión o acción
Submitted: items ya enviados a Genie, con estado enviado, fuente, script objetivo y las mismas advertencias/acciones visibles cuando correspondan

Workbench mostrando secciones Pending y Submitted para borradores de script

Según el item preparado, Workbench puede mostrar:

Run: enviarse por Genie
Apply: aplicar un artefacto revisado al script actual mediante el flujo protegido
Create Script: importar un borrador compatible como script FileMaker nuevo
Preview: inspeccionar el XML preparado antes de actuar
Copy: copiar el prompt o artefacto preparado
Remove: quitarse de la cola

Panel Workbench con items CODE preparados por Codex

Borrador de script Workbench con Apply, Create Script, Preview, Copy y Remove

Workbench tambien puede recibir borradores XML brutos desde clientes MCP. En los builds actuales, las tarjetas se mantienen compactas: el destino, las notas, las advertencias y las acciones siguen visibles, mientras que el XML bruto se abre con Preview en lugar de expandirse inline por defecto.

Tarjeta Workbench con script objetivo, advertencias y sin vista XML inline

Qué ocurre cuando ejecutas un item

Ejecutar un item hace el mismo tipo de trabajo que enviar un prompt desde el composer.

Genie:

aplica cualquier selección de metadatos guardada con el item
añade el prompt al chat
cambia al modo preparado
entra en el pipeline normal de Genie

Para CODE, eso significa admisión Stage A, generación Stage B, reducción AST cuando esté disponible, revisión preview/copy/apply y seguridad nativa de Script Workspace. Para DATA, se mantienen las confirmaciones y guardarraíles SQL habituales.

Cómo deben preparar trabajo los agentes MCP

Un agente IDE debería llamar a genie_get_capabilities antes del staging. Ese resultado explica qué pertenece a CODE, DATA, genie_query, planificación normal o instrucciones manuales de FileMaker.

Para trabajo de scripts con metadatos, el agente deberia llamar a genie_metadata con action: "parse_selection" y pasar el metadata_selection devuelto al mismo item de genie_scripts que lo necesite.

Contrato de staging CODE

Los items CODE Workbench son intencionalmente estrechos.

Prepara CODE solo para:

un nuevo script FileMaker
una edición basada en contenido exacto leído del archivo activo o en contexto adjunto/seleccionado

Usa genie_scripts para nuevos scripts y ediciones del script activo. Usa result_type: "new_script" para crear y result_type: "delta_edit" para editar.

Para delta_edit, lee primero el contenido exacto con genie_scripts action:get_content y usa las filas numeradas como anclas. merge_ready:false no bloquea la validación ni el staging; solo indica que no está disponible la fusión segura del script completo. Abre o selecciona el script de destino antes de Apply.

No prepares:

varios scripts en un solo prompt
prompts create or replace
ediciones de scripts nombrados sin contenido exacto en vivo ni contexto adjunto
CREATE TABLE, ALTER TABLE, INSERT, UPDATE, DELETE, TRUNCATE u otro SQL DATA
prompts ASK o de planificación
prompts QUERY de solo lectura
ocurrencias de tabla, relaciones, layouts, botones, Web Viewers, portales, objetos de layout o cambios de privilegios/seguridad

Borradores XML brutos

El staging XML bruto sirve para borradores FileMaker XML producidos por un agente que deben revisarse dentro de Genie en lugar de pegarse directamente desde un chat externo.

Los borradores External XML no son salida de modelo validada por Stage A/B. Trata la advertencia como parte del contrato: previsualiza el XML, copialo si quieres inspeccionarlo en otro lugar y aplica solo cuando confies en el artefacto.

Para un borrador de script nuevo compatible, Create Script prepara el formato de importación de FileMaker únicamente cuando eliges esa acción. Genie muestra el progreso y confirma la creación del script. Las conversiones no compatibles fallan de forma segura y mantienen disponibles Preview, Copy o el flujo Apply aplicable.

Notificaciones de Genie que confirman la preparación y creación correcta de un script FileMaker

Enrutamiento DATA y QUERY

QUERY no es un stage Workbench. Usa genie_query para trabajo SELECT de vista previa o ejecución fuera de Workbench.

Usa genie_stage_data para escrituras SQL de FileMaker admitidas y DDL de tablas/campos que el usuario confirmará en Genie. No mezcles DATA y CODE en el mismo item.

Los rechazos son guía

Las entregas Workbench no admitidas devuelven resultados MCP normales ok: false. Normalmente no son errores de transporte.

Esos resultados pueden incluir recommended_actions, recommended_tool_calls, recommended_resources, stage_prompt_template o metadata_precheck. El agente IDE debe inspeccionar, separar, reescribir o presentar instrucciones manuales de FileMaker localmente y luego volver a preparar solo el trabajo admitido por Genie.