Referencia del builder

Referencia Datos para consultar mientras trabajas. No está pensada para leerse entera.

Datos para consultar mientras usas el tablero: cada acción del buscador ⌘K, los atajos de teclado y qué hace cada filtro. Si lo que buscas es aprender a usarlo, empieza por la guía del builder.

La barra superior no tiene botones para todo: casi todo vive en el buscador ⌘K (Ctrl+K en Windows y Linux) y en el menú ⋯. Se escribe lo que quieres y se pulsa Enter.

En ⌘K puedes:

Escribes	Qué hace
el número o el nombre de una spec	salta a esa tarjeta y la abre
«validar»	ejecuta la validación real del proyecto
«aprobar»	abre la pestaña de aprobación de la spec que tengas abierta
«decisión»	abre la bitácora para registrar una decisión
«informes»	regenera STATUS.md y el roadmap
«PNG»	exporta el grafo como imagen
«plantillas»	abre la galería de plantillas
«asistente»	abre el asistente que propone un tablero entero
«conectar»	te dice cómo conectar tu agente
«tour»	vuelve a lanzar el recorrido guiado
«idioma»	cambia entre español e inglés
«guardar»	fuerza el guardado ahora
«dashboard»	abre la página de estado

Dentro de ⌘K te mueves con ↑ y ↓, ejecutas con Enter y cierras con Esc.

Atajos de teclado, para cuando ya te lo sabes:

Tecla	Qué hace
I	pone una nota de Idea en el centro
E	pone una nota de Épica
G	pone un grupo: un marco titulado que agrupa lo que caiga dentro
S	abre el formulario de spec nueva
⌘K / Ctrl+K	abre el buscador
⌘Z / Ctrl+Z	deshace
⇧⌘Z / Ctrl+Shift+Z	rehace
Supr o Retroceso	borra la nota o la unión seleccionada (las tarjetas de spec no se borran así, y te explica por qué)
⌘Enter / Ctrl+Enter	confirma en los campos de texto largos (nota, asistente, petición a la IA)
Esc	cancela la edición
← →	avanza y retrocede en el tour

Las cuatro teclas I, E, G y S solo funcionan cuando no estás escribiendo en un campo.

Los grupos son los marcos titulados de JSON Canvas, los mismos que usa Obsidian. Un grupo no guarda una lista de lo que contiene: contiene lo que cae dentro de su rectángulo, y eso se recalcula solo cada vez que arrastras algo. Por eso:

• Arrastra el marco por su título y se lleva consigo todo lo que tenga dentro.
• Arrastra una tarjeta hacia dentro y pasa a pertenecerle; sácala y deja de pertenecerle. No hay nada que confirmar.
• Si dos marcos se solapan, la tarjeta es del más pequeño de los que la contienen por completo.
• Borrar un marco no borra sus tarjetas: se quedan exactamente donde estaban.
• Con el marco seleccionado aparecen las asas para redimensionarlo; doble clic en el título para renombrarlo.

El archivo que se guarda es JSON Canvas puro: el grupo conserva su etiqueta, su color y su fondo, y ninguna tarjeta guarda a qué grupo pertenece, porque el formato no tiene ese campo. Así el mismo board.canvas sigue abriéndose en Obsidian.

Cuando el tablero no se puede leer. Si specs/board.canvas existe pero está roto —un merge de git que dejó marcadores <<<<<<<, un JSON a medias—, el builder no te enseña una cuadrícula por defecto como si fuera tu tablero. Se para, te dice la ruta del archivo y te ofrece dos salidas: arreglarlo a mano y volver a leerlo, o descartarlo y empezar de cero. Hasta que elijas una, el guardado automático queda desactivado, para que ningún gesto tuyo escriba encima de lo que aún se puede recuperar. Si eliges descartar, tu archivo se conserva como board.canvas.bak.

Ese respaldo también se escribe solo: la primera vez que el builder guarda en cada sesión del servidor, copia antes lo que hubiera en board.canvas. Es una copia por sesión, no un historial — para eso está git.

Lo que el builder no pinta, lo devuelve intacto. El tablero admite los cuatro tipos de nodo de JSON Canvas: texto, archivo, enlace y grupo. El builder pinta unos con más detalle que otros, pero al guardar devuelve todos los campos tal como llegaron: la url de un enlace, el subpath de un archivo, los lados y el color de una unión, y cualquier campo que una versión futura del formato añada. Los colores de las uniones sólo se recalculan cuando cambias su propósito.

Los atajos y los diálogos. Las teclas I, E, G y S no hacen nada mientras haya un diálogo abierto —un modal, el tour, el menú ⋯—, sólo cuando el lienzo está a la vista. El panel de detalle de una spec no cuenta como diálogo: es un panel, y los atajos siguen funcionando con él abierto.

Los filtros de la segunda franja no ocultan nada: atenúan lo que no coincide, para que el tablero no cambie de forma mientras miras. Son tres: pendientes (specs sin aprobar), con avisos (specs con errores del gate) y con deriva (specs cuyo código cambió después de aprobarlas). A la derecha de esa franja tienes el recuento: cuántas specs, cuántas uniones y el zoom.

Las siete configuraciones de cliente

Qué archivo escribe connect en cada cliente, y qué escribes tú para que atienda la cola. Detalles del comando en la guía del builder.

Cliente	Archivo	Clave	Atender la cola
Claude Code	.mcp.json	mcpServers.sdd	/sdd-serve
Codex	.codex/config.toml	[mcp_servers.sdd]	/sdd-serve
Cursor	.cursor/mcp.json	mcpServers.sdd	/sdd-serve
VS Code	.vscode/mcp.json	servers.sdd	prompt MCP sdd_serve_requests
Windsurf	.windsurf/mcp_config.json	mcpServers.sdd	prompt MCP sdd_serve_requests
Gemini CLI	.gemini/settings.json	mcpServers.sdd	/sdd:serve
opencode	opencode.json	mcp.sdd	/sdd-serve