zugzbot 1.3.0 → 1.4.0

package/.opencode/agents/sdd-coder.md

@@ -62,7 +62,7 @@ Eres el Programador de Código (sdd-coder) del arnés SDD. Tu trabajo es codific
 
 <f2_implementation>
   <bootstrap_obligatorio>
-    **Acción Inicial (Bloqueante)**: Antes de codificar, debes leer `.openspec/active-brief.md` (o `.opencode/active-brief.md` si existiera) y el archivo de diseño `.openspec/DESIGN.md` (o el `.openspec/design-assets/<brandId>/DESIGN.md` activo) para asimilar todos los requerimientos, contratos de la iteración y las guías estéticas de diseño en tu contexto.
+    **Acción Inicial (Bloqueante)**: Antes de codificar, debes leer `.openspec/active-brief.md` (o `.opencode/active-brief.md` si existiera) y el archivo `.openspec/DESIGN.md` activo para asimilar todos los requerimientos y contratos de la iteración. El arnés ya no inyecta marcas externas: el tema base es `shadcn-zinc` nativo del template `nextjs-shadcn/src/app/globals.css`.
     1. **Verifica Estado**: Si indica `Bootstrap Status: OK`, salta directamente al paso 4.
     2. **Detecta Stack**: Next.js/React (`sdd_bootstrap_nextjs_shadcn`), FastAPI/Python (`sdd_bootstrap_fastapi`) o Agnostico/Scripting (`sdd_bootstrap_agnostic`).
     3. **Ejecuta Bootstrap**: Llama a la herramienta del stack instalando dependencias (con `install: true` y `force: false`). Para `sdd_bootstrap_agnostic`, indica el `language` adecuado (ej: `google-apps-script`, `python`, `javascript`, `bash` o `plano`).
@@ -91,11 +91,11 @@ Eres el Programador de Código (sdd-coder) del arnés SDD. Tu trabajo es codific
 </f2_implementation>
 
 <coding_cheatsheet>
-- **Linear/Brand tokens**: Los tokens se inyectan en `globals.css` vía CSS vars. PROHIBIDO reescribir `globals.css` desde cero o usar colores Hex manuales en componentes. Usa variables como `var(--color-brand-primary)`.
+- **Tokens de tema**: Los tokens viven en `globals.css` vía CSS vars (`--background`, `--foreground`, `--primary`, etc.). PROHIBIDO reescribir `globals.css` desde cero o usar colores Hex hardcodeados (`bg-white`, `text-black`) en componentes. Usa siempre variables semánticas (`bg-background`, `text-foreground`, `border-border`).
 - **Estado**: Declara estados centralizados con `useState` en el componente padre (`owner` o `AppLayout`) y pásalos como props. Evita declarar estados compartidos en hijos.
 - **Instalación de Shadcn Segura**: La herramienta de shadcn a utilizar en F2 es `npx shadcn@latest add <componentes>` (o simplemente `npx shadcn add`). Utiliza siempre la última versión final estable de Shadcn para garantizar la compatibilidad con Tailwind v4 y permitir la descarga de bloques complejos de la comunidad y del registro oficial (como dashboards, sidebars y formularios modernos) sin errores 404.
 - **Next.js & Tailwind v4 Style Resolution**: En Tailwind v4, si `globals.css` importa `@import "shadcn/tailwind.css";`, debes asegurarte de instalar el paquete ejecutable `shadcn` ejecutando `npm install shadcn` o el compilador fallará.
-- **PROHIBIDO SOBREESCRIBIR GLOBALS.CSS (Preservación del Tema Shadcn)**: Tienes ESTRICTAMENTE PROHIBIDO sobreescribir el archivo `globals.css` a mano borrando sus variables. Si necesitas alterar colores o aplicar el estilo de una marca, usa OBLIGATORIAMENTE la herramienta `sdd_design_apply_brand_tokens`. Si el contrato dice diseño "default" o "Shadcn", NO TOQUES el CSS original. Borrar las variables semánticas rompe los componentes de Shadcn.
+- **PROHIBIDO SOBREESCRIBIR GLOBALS.CSS (Preservación del Tema Shadcn)**: Tienes ESTRICTAMENTE PROHIBIDO sobreescribir `globals.css` borrando sus variables semánticas. El tema `shadcn-zinc` del template ya provee todas las vars necesarias para claro/oscuro. Si necesitas custom tokens, agregarlos en un bloque nuevo al FINAL del archivo (después del `@theme inline` original) sin tocar las vars existentes. Borrar las vars originales rompe los componentes de Shadcn.
 - **Next.js Auth Redirects robustas (Evitar bucles/parpadeo)**:
   - Usa siempre `router.replace("/")` en lugar de `push` para redirecciones de login.
   - Para evitar efectos concurrentes o solapados en Strict Mode, usa un `useRef(false)` en redirecciones asíncronas para dispararlas solo una vez.
@@ -105,7 +105,8 @@ Eres el Programador de Código (sdd-coder) del arnés SDD. Tu trabajo es codific
 </coding_cheatsheet>
 
 <design_standards>
-  - **Alineación con DESIGN.md e Instanciación de Bloques**: Lee obligatoriamente `.openspec/design-assets/<brandId>/DESIGN.md` y asimila los layouts para recrear diseños premium con grids, sidebars y headers. Quedan prohibidos los MVPs de página flotante. Es **obligatorio** que si la vista requiere un dashboard, panel lateral, login o registro, utilices primero las herramientas MCP de Shadcn (`shadcn_search_items_in_registries` filtrando por `types: ["block"]`) para buscar bloques oficiales. Observa los ejemplos con `shadcn_get_item_examples_from_registries` y compón la vista. Distribuye y compón estos bloques prehechos enlazándolos con el backend en lugar de inventar la UI desde cero.
+  - **Diseño = `shadcn-zinc` por defecto**: El tema base viene del template `nextjs-shadcn/src/app/globals.css`. NO leas `.openspec/design-assets/<brandId>/DESIGN.md` (ese flujo está deprecado desde v1.4.0). Si el usuario pidió custom tokens en el contrato, agregarlos al final de `globals.css` sin tocar las vars originales.
+  - **Alineación con DESIGN.md e Instanciación de Bloques**: Para recrear diseños premium con grids, sidebars y headers, es **obligatorio** que si la vista requiere un dashboard, panel lateral, login o registro, utilices primero las herramientas MCP de Shadcn (`shadcn_search_items_in_registries` filtrando por `types: ["block"]`) para buscar bloques oficiales. Observa los ejemplos con `shadcn_get_item_examples_from_registries` y compón la vista. Distribuye y compón estos bloques prehechos enlazándolos con el backend en lugar de inventar la UI desde cero.
   - **Uso Obligatorio del MCP de Shadcn (Cero Alucinaciones)**: Tienes PROHIBIDO alucinar o inventar la API, las props o los subcomponentes requeridos de los componentes de Shadcn (especialmente en componentes compuestos como Select, Tooltip, Dialog, DropdownMenu). Antes de escribir el código que use estos componentes, DEBES usar la herramienta `shadcn_get_item_examples_from_registries` para ver la implementación real, los imports exactos y su composición obligatoria.
   - **Self-audit pre-transición (BLOQUEANTE)**: Antes de entregar, ejecuta este bloque en una sola corrida de terminal. Si el linter o el tipado TypeScript fallan, debes corregirlos antes de transicionar (el test suite completo queda delegado al Tester en F3 para ahorrar tus turnos):
     ```bash

package/.opencode/agents/sdd-orchestrator.md

@@ -38,7 +38,7 @@ Eres el coordinador principal del arnés de desarrollo SDD (Spec-Driven Developm
 - **Stack UI Exclusivo**: Toda interfaz de usuario debe usar únicamente **Shadcn UI**.
 - **Límite de `todowrite`**: Llama a `todowrite` MÁXIMO 2 veces por sesión: al inicio para crear la lista de fases y al final para marcar todo completado en bloque. No lo actualices en cada transición.
 - **Modo de Verificación ("Console" vs "Visual")**: Si es `console`, queda PROHIBIDO para ti y todos los subagentes usar Playwright o navegadores.
-- **Herramientas Específicas**: Usa siempre `sdd_list_design_recommendations` en vez de list-references directas, e inicia specs con `sdd_set_phase` (transacción atómica).
+- **Herramientas Específicas**: Inicia specs con `sdd_set_phase` (transacción atómica). El arnés ya no inyecta marcas externas: el default de diseño es `shadcn-zinc` nativo del template `nextjs-shadcn`.
 - **Ruta de Capturas**: Guarda cualquier screenshot de Playwright en `.openspec/ts-<nombre>.png`.
 - **Sistema de Memoria (Brain)**: Consulta el cerebro con `sdd_get_initial_session_data` al inicio (F0/F1) para entender el historial del proyecto. Guarda los aprendizajes clave al final en `<completion>` con `brain_save_memory`.
 - **Modo Autopiloto (`/loop`)**: Si se detecta `loopMode: true` o comando `/loop`, autotomará el 100% de las decisiones recomendadas por defecto. Tienes PROHIBIDO usar la tool `question` en autopiloto.

package/.opencode/agents/sdd-spec-writer.md

@@ -25,7 +25,7 @@ Eres el Diseñador de Contratos (sdd-spec-writer) del flujo SDD. Tu único traba
 - **Solo Contratos y Diseño**: Tienes prohibido escribir código de aplicación (`.py`, `.ts`, `.tsx`, etc.). Solo generas el contrato en `contract.json` bajo la carpeta spec asignada y mantienes `.openspec/DESIGN.md`.
 - **Sin Carpetas Duplicadas**: Escribe siempre en la carpeta activa especificada en la tarea o en `activeContract`. No llames a `sdd_create_spec_folder` si ya existe.
 - **Sin Acciones de Orquestación**: Tienes prohibido pedir aprobación directa al usuario o usar `sdd_set_phase`.
-- **Restricción de Archivos**: El enforcer del arnés bloquea mecánicamente cualquier intento de escribir o modificar archivos fuera de la carpeta del spec actual, `.openspec/DESIGN.md` o `.openspec/design-assets/`.
+- **Restricción de Archivos**: El enforcer del arnés bloquea mecánicamente cualquier intento de escribir o modificar archivos fuera de la carpeta del spec actual y `.openspec/DESIGN.md`. El directorio `.openspec/design-assets/` ya no se usa (flujo deprecado desde v1.4.0).
 </constraints>
 
 <contract_structure>
@@ -49,12 +49,11 @@ Antes de declarar firmas de componentes o APIs externas en el contrato, **debes*
 </mcp_validation>
 
 <omd_reference_loading>
-**Diseño de Oh My Design (OBLIGATORIO)**: Si existe un `reference_id` activo en la tarea o en `.omd/init-context.json`, debes cargar la especificación utilizando la herramienta `get_design_md` del MCP `oh-my-design`.
-Extrae los tokens canónicos (paleta de colores, escala de bordes, tipografía, sombras) y embeberlos en el campo `tokens` dentro del `contract.json`. Esto garantiza el acoplamiento directo entre el contrato y `.openspec/DESIGN.md`.
+**Diseño por defecto = `shadcn-zinc`**: El arnés ya no carga marcas externas. El tema base es el del template `nextjs-shadcn/src/app/globals.css` (zinc nativo, modo claro/oscuro via variables CSS semánticas). NO declares `brandId` ni `designTokens` en el contrato a menos que el usuario haya pedido custom tokens explícitamente. En ese caso, agregalos al campo `design.tokens` como JSON inline (paleta, radios, fuentes) y el Coder los inyectará al final de `globals.css` sin tocar las vars originales.
 </omd_reference_loading>
 
 <design_standards>
-- **Alineación con DESIGN.md**: Debes leer obligatoriamente `.openspec/design-assets/<brandId>/DESIGN.md` para extraer los tokens de diseño. Basándote además en los ejemplos HTML interactivos (`preview.html`, `preview-dark.html`) correspondientes de la marca, define en el contrato los layouts exactos (sidebars, grids, headers) a implementar.
+- **Alineación con DESIGN.md**: El archivo `.openspec/DESIGN.md` activo contiene el estado del contrato actual. Si el usuario pidió custom tokens, declara el bloque `design.tokens` en el contrato. Si no, omítelo y deja que el Coder use el default `shadcn-zinc` del template.
 - **Diseño Premium y Bloques Shadcn**: El contrato debe instruir el uso de bloques prehechos oficiales de Shadcn (`dashboard-01`, `sidebar-01` al `16`, `login-01` al `05`, `signup-01` al `05`, etc.) mediante el skill `shadcn-templates` (Sección 3.1) alineado a la guía del `DESIGN.md`. Quedan prohibidos los MVPs de pantalla única flotante. El spec-writer debe usar proactivamente las herramientas MCP (`shadcn_search_items_in_registries`, `shadcn_list_items_in_registries`) para identificar qué bloques de tipo `registry:block` o `registry:ui` se adecuan a la necesidad y declararlos en `frontend.components` y `files_affected`.
 - **Escenarios de Test**:
   - Si `verificationMode === "console"`, genera únicamente escenarios de tipo `unit` o `integration` (entre 3 y 5 escenarios en total). No generes escenarios de tipo `visual` ni tests basados en browser.

package/.opencode/commands/loop.md

@@ -12,7 +12,7 @@ Estás ejecutando el ciclo SDD en modo **Autopiloto Autónomo** para resolver la
 ## Instrucciones de Autopiloto Obligatorias:
 1. Activa inmediatamente el modo piloto en el estado llamando a `sdd_set_phase` pasándole `phase: "F1_CONTRACT"`, un `spec_name` descriptivo en kebab-case, `loopMode: true`, `loopTargetIterations: N` (si el usuario ingresó un número en su comando, ej: `/loop 3` o `iteraciones=3`; por defecto 1), y `loopCurrentIteration: 1`.
 2. Tienes estrictamente prohibido usar la herramienta `question` para pedir confirmaciones de diseño, stack o contratos.
-3. Elige los valores recomendados por defecto de forma autónoma (Next.js 16, Console mode, primer diseño recomendado por la marca en oh-my-design).
+3. Elige los valores recomendados por defecto de forma autónoma (Next.js 16, Console mode, diseño `shadcn-zinc` nativo del template).
 4. No te detengas en las verificaciones humanas (HIL): asume la aprobación si el linter y los tests pasan satisfactoriamente.
 5. Registra de forma proactiva tus hallazgos, decisiones e iteraciones en el Brain (`brain_save_memory`).
 6. Al finalizar cada ciclo en `<completion>`, si `loopCurrentIteration < loopTargetIterations`, autoevalúa el producto, propón exactamente una (1) mejora clave de UX/UI o usabilidad, e inicia automáticamente el siguiente ciclo de mejora regresando a `F0_DETECT` / `F1_CONTRACT` incrementando `loopCurrentIteration`. No desactives `loopMode` hasta llegar a la última iteración.

package/.opencode/plugins/loop-enforcer.ts

@@ -231,7 +231,6 @@ export const LoopEnforcerPlugin: Plugin = async ({ project, client, $, directory
           const isAllowedSpecWriterFile =
             targetFilePath.includes(".openspec/specs/") ||
             targetFilePath.includes(".openspec/DESIGN.md") ||
-            targetFilePath.includes(".openspec/design-assets/") ||
             targetFilePath.endsWith("contract-schema.json")
 
           if (!isAllowedSpecWriterFile) {

package/.opencode/plugins/sdd-bridge.ts

@@ -452,7 +452,7 @@ export const SddBridgePlugin: Plugin = async ({ project, client, $, directory, w
         }
         // Live-refresh the canonical _sessions.jsonl so future sessions
         // can read compact history (1 line per contract) instead of full MD exports.
-        if (input?.tool === "sdd_set_phase" || input?.tool === "sdd_select_design" || input?.tool === "sdd_create_spec_folder") {
+        if (input?.tool === "sdd_set_phase" || input?.tool === "sdd_create_spec_folder") {
           try {
             const metrics = readMetrics()
             const state = readState()

package/.opencode/scripts/lint-charts.js

@@ -39,8 +39,7 @@ const IGNORE_DIRS = new Set([
   "coverage",
   ".openspec/cache",
   ".openspec/__tests__",
-  ".opencode/templates",
-  ".opencode/oh-my-design"
+  ".opencode/templates"
 ])
 
 // Patrones prohibidos: cualquier chartConfig que envuelva una variable CSS

package/.opencode/skills/sdd-foundation-overview/SKILL.md

@@ -24,18 +24,17 @@ F4 → deployer genera Dockerfile + build + verify
 - **Stack**: Next.js 16 + Shadcn UI + Tailwind v4 (frontend), FastAPI + Pydantic (backend)
 - **Verificación**: `console` (5x más rápido que `visual`)
 - **Persistencia**: localStorage (mock frontend), SQLite (backend simple)
-- **Diseño**: primer recomendado por Oh My Design para la categoría del usuario
+- **Diseño**: `shadcn-zinc` nativo (default; sin marcas externas)
 
 ## Atajos críticos
 
 | Atajo | Ahorro |
 |---|---|
-| `sdd_list_design_recommendations({ use_case: "all" })` en F0 | 4 calls → 1 |
 | `sdd_set_phase({ phase: "F1_CONTRACT", spec_name: "..." })` atómico | Crea carpeta sin race |
-| `sdd_select_design({ brandId: "..." })` | Copia DESIGN.md |
 | `brain_read_memory({ category: ... })` en F0 y F3 inicio | Previene errores históricos |
 | Skill `sdd-quickstart` en F1 | Plantilla pre-rellenada (~1 min vs 3+ min) |
-| `sdd_apply_brand_tokens({ tokens: ... })` en F2 | Inyecta tokens sin romper shadcn |
+| `sdd_catalog_list_blocks({ registry: "all" })` en F1 | Lista shadcn/basecn/reactbits en 1 call |
+| `sdd_lucide_validate_lucide_icons_batch({ icons: [...] })` en F1 | Valida lote de iconos en 1 call |
 | `sdd_generate_dockerfile({ stack: "nextjs", port: 3000 })` en F4 | Genera 3 archivos en 1 call |
 
 ## Reglas duras

package/.opencode/skills/sdd-methodology/SKILL.md

@@ -35,23 +35,24 @@ Cada fase tiene un **gate explícito** (HIL del usuario) antes de transicionar a
 
 | Atajo | Cuándo | Ahorro |
 |---|---|---|
-| `sdd_list_design_recommendations({ use_case: "all" })` | F0 | 4 llamadas a `oh-my-design_list_references` → 1 |
 | `sdd_set_phase({ phase: "F1_CONTRACT", spec_name: "..." })` | F0→F1 | Crea la carpeta del spec atómicamente, sin race de timestamp |
-| `sdd_select_design({ brandId: "nike" })` | F0 | Copia DESIGN.md al path canónico `.openspec/design-assets/<brandId>/` |
 | `brain_read_memory({ category: ... })` | F0-F4 | Consulta el cerebro del proyecto para recuperar aprendizajes y evitar errores históricos |
 | `brain_save_memory({ category: ... })` | F2, F4 | Guarda aprendizajes, errores técnicos resueltos y decisiones de diseño en el cerebro |
 | Skill `sdd-quickstart` | F1 | Plantilla de `contract.json` pre-rellenada + test_scenarios recurrentes |
-| `sdd_apply_brand_tokens({ tokens: ... })` | F2 | Inyecta tokens de marca en `globals.css` sin romper variables shadcn |
+| `sdd_lucide_validate_lucide_icons_batch({ icons: [...] })` | F1 | Valida lote completo de iconos Lucide en 1 call (vs 1 por icono) |
+| `sdd_catalog_list_blocks({ registry: "all" })` | F1 | Lista candidatos de shadcn/basecn/reactbits en 1 call |
 | `sdd_generate_dockerfile({ stack: "nextjs", port: 3000 })` | F4 | Genera Dockerfile + .dockerignore + docker-compose.yml en 1 call |
 | `_sessions.jsonl` | Histórico | 1 línea por contrato (vs 18K+ líneas de MD export) |
 
+> **Diseño**: el arnés ya no inyecta marcas externas. El default es `shadcn-zinc` nativo del template `nextjs-shadcn`. Si el usuario quiere tokens custom, lo hace explícito en F2 con edición manual de `globals.css`.
+
 ---
 
 ## 3. Trampas del Flujo Maestro (EVITAR siempre)
 
-### Trampa 1: Listar marcas de diseño una por una
-**NO HAGAS**: Hacer múltiples llamadas a `oh-my-design_list_references` para mostrar opciones al usuario en F0.
-**HAZ**: Haz una única llamada consolidada a `sdd_list_design_recommendations({ use_case: "all", max_per_category: 3 })`.
+### Trampa 1: Preguntar marca de diseño al usuario en F0
+**NO HAGAS**: Preguntar al usuario "¿qué marca/diseño quieres?" o asumir tokens custom por defecto.
+**HAZ**: Asumir `shadcn-zinc` nativo. El template `nextjs-shadcn/src/app/globals.css` ya viene con todas las variables semánticas para tema claro/oscuro. El usuario puede pedir custom en F2 si quiere.
 
 ### Trampa 2: Crear la carpeta del spec en 2 steps
 **NO HAGAS**: Llamar a `sdd_create_spec_folder("mi-spec")` y luego a `sdd_set_phase("F1_CONTRACT", ...)` por separado (causa race conditions en el timestamp).
@@ -111,10 +112,7 @@ Cada fase tiene un **gate explícito** (HIL del usuario) antes de transicionar a
 │   ├── archive/                  # Contratos completados
 │   │   ├── _sessions.jsonl       # 1 línea por contrato (histórico compacto)
 │   │   └── <archived_specs>/
-│   ├── design-assets/<brandId>/  # ÚNICA ruta canónica de DESIGN.md
-│   │   ├── DESIGN.md
-│   │   ├── preview.html
-│   │   └── preview-dark.html
+│   ├── DESIGN.md                 # Resumen del spec activo (actualizado por sdd_save_active_brief)
 │   ├── .playwright/              # (transient, se borra en F0_DETECT)
 │   ├── sdd_state.json
 │   └── .sdd_session_metrics.json

package/.opencode/skills/sdd-quickstart/SKILL.md

@@ -36,9 +36,8 @@ Copia el siguiente JSON y rellena los huecos. Los campos sin `{{...}}` se mantie
     "persistence": "{{localStorage|sqlite|postgresql}}"
   },
   "design": {
-    "brand": "{{BRAND_ID}}",
-    "reference": ".openspec/design-assets/{{BRAND_ID}}/DESIGN.md",
-    "tokens": "{{PEGA_AQUI_LOS_TOKENS_EXTRAIDOS_CON_oh-my-design_get_design_md}}"
+    "system": "shadcn-zinc-default",
+    "tokens": "inherited from .opencode/templates/nextjs-shadcn/src/app/globals.css (zinc native)"
   },
   "stack": {
     "core": ["Next.js 16", "Shadcn UI", "Tailwind CSS v4", "{{PERSISTENCE}}"],
@@ -265,10 +264,8 @@ Para un dashboard o panel estándar, usa esta plantilla **reducida** de **~80 l
 ## 3. Anti-patrones a evitar en el contrato
 
 - **Inconsistencia de nombres de componentes (CRÍTICO)**: Los nombres declarados en `frontend.components[].name` del contrato son **un compromiso inmutable**. El spec-writer DEBE usar exactamente estos mismos nombres al crear las pruebas unitarias/integración, y el coder DEBE usarlos para crear los componentes de producción. **PROHIBIDO renombrar o cambiar de PascalCase a kebab-case en archivos de test**. Si el contrato dice `CalculatorPanel`, el archivo de test se llamará `CalculatorPanel.test.tsx` y no se debe cambiar a `CalculatorPage.test.tsx` (esto causó fallas de compilación con imports rotos en la sesión 1374).
-- **NO busques iconos uno por uno**: PROHIBIDO usar `lucide-icons_fuzzy_search_icons` de forma repetitiva en un loop para cada icono. Usa la herramienta optimizada por lotes `sdd_validate_lucide_icons_batch` pasándole todo el arreglo de nombres de iconos que desees usar en una sola llamada.
-- **NO uses `read` para DESIGN.md**: Para extraer los tokens de diseño de una marca, usa siempre `oh-my-design_get_design_md(brandId)` o lee selectivamente, no leas el archivo entero que consume miles de tokens de input innecesariamente.
-- **NO embebas código TSX en el contrato.** El contrato es declarativo (qué, no cómo).
-- **NO dupliques los tokens de `.openspec/design-assets/<brandId>/DESIGN.md` línea por línea.** Usa el tool `oh-my-design_get_design_md` y pega el bloque `tokens` completo UNA vez.
+- **NO busques iconos uno por uno**: PROHIBIDO usar `lucide-icons_fuzzy_search_icons` de forma repetitiva en un loop para cada icono. Usa la herramienta optimizada por lotes `sdd_validate_lucide_icons_batch` (tool `sdd_lucide_validate_lucide_icons_batch`) pasándole todo el arreglo de nombres de iconos que desees usar en una sola llamada.
+- **NO embabes código TSX en el contrato.** El contrato es declarativo (qué, no cómo).
 - **NO escribas más de 5-6 `test_scenarios`** para modo `console`. Más de eso no acelera la entrega, solo retrasa F2.
 - **NO incluyas escenarios `visual` o `e2e` si `verificationMode` es `console`.** El tester los rechazará.
 - **NO omitas la disposición espacial y propuesta de Layout**: El spec-writer DEBE proponer un bosquejo textual o diagrama ASCII de la disposición espacial de la UI en F1 (ej. layouts con sidebar lateral para configuración o paneles complejos en lugar de simples pestañas tradicionales planas) y acordar anchos de pantalla generosos (`max-w-6xl` o superior, evitando el limitante `max-w-3xl`) con el usuario antes de transicionar a F2. Esto previene reestructuraciones estéticas costosas y asegura entregas de alta gama a la primera.
@@ -282,8 +279,7 @@ Para un dashboard o panel estándar, usa esta plantilla **reducida** de **~80 l
 [orchestrator] → sdd_set_phase({ phase: "F1_CONTRACT", spec_name: "..." })
 [spec-writer]  → skill sdd-quickstart       ← ESTA SKILL
 [spec-writer]  → read .opencode/contract-schema.json
-[spec-writer]  → oh-my-design_get_design_md(brandId)  (si aplica)
-[spec-writer]  → write .openspec/specs/.../contract.json (rellenando plantilla)
+[spec-writer]  → write .openspec/specs/.../contract.json (rellenando plantilla; design=shadcn-zinc-default)
 [spec-writer]  → sdd_set_phase({ phase: "F2_IMPLEMENTATION" })
 ```
 

package/.opencode/tools/sdd_core.ts

@@ -2,7 +2,6 @@ import { tool } from "@opencode-ai/plugin"
 import fs from "fs"
 import path from "path"
 import { execSync } from "child_process"
-import { RECOMMENDED_BRANDS } from "./sdd_design"
 
 // Helper to safely resolve root directory (avoiding OpenCode bug where worktree is '/' in non-git repos)
 const getRoot = (context: any) => {
@@ -528,15 +527,18 @@ export const get_initial_session_data = tool({
       } catch (e) {}
     }
 
-    // Get design recommendations
-    const recommendations = RECOMMENDED_BRANDS
-
+    // Diseño por defecto: zinc nativo de Shadcn. El harness ya no inyecta
+    // marcas externas (oh-my-design removido en v1.4.0); si el usuario quiere
+    // custom tokens, lo hace explicitamente en F2 via edicion manual de globals.css.
     const response: any = {
       status: "SUCCESS",
       state: currentState,
       brainMemory,
-      designRecommendations: recommendations,
-      note: "Inicialización completada. No es necesario que llames a sdd_get_state, brain_read_memory o sdd_list_design_recommendations por separado."
+      design: {
+        default: "shadcn-zinc",
+        note: "Diseño por defecto = shadcn zinc nativo. Sin marcas externas."
+      },
+      note: "Inicialización completada. No es necesario que llames a sdd_get_state o brain_read_memory por separado."
     }
     if (cleanedCount > 0) {
       response.cleanedArtifacts = cleanedCount

package/.opencode/tools/sdd_lucide.ts

@@ -0,0 +1,112 @@
+import { tool } from "@opencode-ai/plugin"
+import fs from "fs"
+import path from "path"
+import { execSync } from "child_process"
+
+// ============================================================================
+// SDD Lucide Icons Tool
+// ============================================================================
+//
+// Validacion batch de iconos de Lucide React. Antes vivia en sdd_design.ts
+// (junto con tools de oh-my-design). Se independizo para que sobreviva a
+// la remocion de oh-my-design (sigue siendo util para spec-writer cuando
+// declara iconos en el contract.json).
+//
+// Fuentes de validacion (en orden de prioridad):
+//   1. node_modules/lucide-react: introspeccion real de los exports del paquete
+//   2. static_common_list: ~110 iconos mas usados como fallback rapido
+//   3. pascal_case_fallback: cualquier PascalCase se asume valido
+// ============================================================================
+
+const getRoot = (context: any): string => {
+  if (context?.directory && context.directory !== "/") return context.directory
+  if (context?.worktree && context.worktree !== "/") return context.worktree
+  if (context?.cwd && context.directory !== "/") return context.directory
+  return process.cwd()
+}
+
+// Lista de iconos comunes como fallback cuando lucide-react no esta instalado
+// (ej. durante F1 cuando todavia no se ha corrido el bootstrap del target).
+const COMMON_ICONS = new Set([
+  "Sun", "Moon", "Plus", "Trash2", "History", "Clock", "Calculator", "User", "Settings",
+  "Home", "ChevronLeft", "ChevronRight", "ChevronUp", "ChevronDown", "Search", "X", "Check",
+  "Edit", "Menu", "LogOut", "LogIn", "Lock", "Mail", "Phone", "MapPin", "Calendar", "Upload",
+  "Download", "ExternalLink", "Eye", "EyeOff", "AlertCircle", "CheckCircle", "Info", "HelpCircle",
+  "Bell", "Share2", "Copy", "File", "Folder", "Image", "Video", "Music", "Play", "Pause",
+  "Server", "Database", "Terminal", "Code", "Grid", "List", "Filter", "Heart", "Star",
+  "ArrowRight", "ArrowLeft", "ArrowUp", "ArrowDown", "RefreshCw", "Send", "Activity", "Briefcase",
+  "Camera", "Cloud", "Compass", "Cpu", "CreditCard", "DollarSign", "DownloadCloud", "Edit2", "Edit3",
+  "FileText", "Gift", "Globe", "Hash", "Key", "Laptop", "Map", "MessageCircle", "MessageSquare",
+  "Mic", "Monitor", "Package", "Paperclip", "Percent", "Power", "Printer", "Radio", "RotateCcw",
+  "Save", "Scissors", "Shield", "ShoppingBag", "ShoppingCart", "Slider", "Sliders", "Smartphone",
+  "Speaker", "Tablet", "Tag", "Target", "ThumbsUp", "ThumbsDown", "ToggleLeft", "ToggleRight",
+  "Trash", "TrendingUp", "TrendingDown", "Truck", "Tv", "Type", "Umbrella", "Unlock", "UploadCloud",
+  "Users", "Volume2", "VolumeX", "Wifi", "Wind", "Zap"
+])
+
+export const validate_lucide_icons_batch = tool({
+  description:
+    "Valida un lote de nombres de iconos de Lucide React. " +
+    "Si el proyecto target tiene `lucide-react` instalado, introspecciona " +
+    "los exports reales. Si no, usa una lista estatica de iconos comunes " +
+    "(~110) o acepta cualquier PascalCase como fallback. " +
+    "Util para que el spec-writer valide iconos antes de declararlos en " +
+    "el contract.json (frontend.icons).",
+  args: {
+    icons: tool.schema
+      .array(tool.schema.string())
+      .describe("Lista de nombres de iconos a validar (ej: ['Sun', 'Moon', 'Plus']).")
+  },
+  async execute(args, context) {
+    const root = getRoot(context)
+    const results: Record<string, { valid: boolean; source: string }> = {}
+
+    let hasNodeModules = false
+    let exportsList: Set<string> | null = null
+
+    const lucidePath = path.resolve(root, "node_modules/lucide-react")
+    if (fs.existsSync(lucidePath)) {
+      try {
+        const nodeScript = `
+          const lucide = require('lucide-react');
+          console.log(JSON.stringify(Object.keys(lucide)));
+        `
+        const output = execSync(
+          `node -e "${nodeScript.replace(/"/g, '\\"')}"`,
+          { cwd: root, stdio: "pipe" }
+        ).toString()
+        const keys = JSON.parse(output) as string[]
+        exportsList = new Set(keys)
+        hasNodeModules = true
+      } catch (e) {
+        // lucide-react instalado pero introspeccion fallo: cae a fallback
+      }
+    }
+
+    for (const icon of args.icons) {
+      if (hasNodeModules && exportsList) {
+        results[icon] = {
+          valid: exportsList.has(icon),
+          source: "node_modules/lucide-react"
+        }
+      } else {
+        const isPascalCase = /^[A-Z][a-zA-Z0-9]*$/.test(icon)
+        const inCommon = COMMON_ICONS.has(icon)
+        results[icon] = {
+          valid: inCommon || isPascalCase,
+          source: inCommon ? "static_common_list" : "pascal_case_fallback"
+        }
+      }
+    }
+
+    return JSON.stringify(
+      {
+        status: "SUCCESS",
+        validatedAt: new Date().toISOString(),
+        results
+      },
+      null,
+      2
+    )
+  }
+})

package/README.md

@@ -63,8 +63,6 @@ El desarrollo se ejecuta secuencialmente a través de cinco fases estrictas, con
 
 El arnés inyecta y habilita automáticamente varios servidores MCP avanzados en tu espacio de trabajo para dar soporte contextual al bot:
 
-*   📚 **`oh-my-design` (MCP de Diseño Offline)**:
-    Servidor oficial que empaqueta **246 marcas de diseño icónicas** (Toss, Stripe, Supabase, Linear, etc.). Permite buscar especificaciones estéticas (`DESIGN.md`), paletas de colores exactas, tipografía y plantillas HTML interactivas de previsualización 100% offline (sin llamadas a APIs ni coste de tokens).
 *   🎨 **`shadcn` (MCP de Interfaz de Usuario)**:
     Permite explorar, buscar e instalar de forma instantánea componentes del registro oficial de Shadcn UI (botones, inputs, cards, dashboards completos) directamente desde la terminal.
 *   🔍 **`context7` (MCP de Consultas de Documentación)**:
@@ -161,11 +159,7 @@ Si deseas realizar modificaciones en este instalador o probar el código localme
 Para publicar una nueva versión de Zugzbot en el registro público de NPM:
 
 1.  Incrementa la versión en el `package.json` de la raíz (ej. `1.0.1`).
-2.  Compila el servidor standalone de `oh-my-design` (si modificaste código TypeScript del MCP) ejecutando en la carpeta `.opencode/oh-my-design/packages/mcp`:
-    ```bash
-    npm run build
-    ```
-3.  Inicia sesión y publica desde la raíz de tu proyecto:
+2.  Inicia sesión y publica desde la raíz de tu proyecto:
     ```bash
     npm login
     npm publish --access public

package/opencode.json

@@ -20,7 +20,6 @@
   "permission": {
     "*": "allow",
     "skill": {
-      "omd-*": "allow",
       "stack-validator": "allow",
       "sdd-foundation-overview": "allow",
       "sdd-methodology": "allow",
@@ -45,15 +44,6 @@
     "opencode-notificator"
   ],
   "mcp": {
-    "oh-my-design": {
-      "type": "local",
-      "command": [
-        "node",
-        "./.opencode/oh-my-design/packages/mcp/dist/index.mjs"
-      ],
-      "enabled": true,
-      "purpose": "Busca, consulta y aplica temas de diseño (Toss, Stripe, Supabase, etc.)."
-    },
     "shadcn": {
       "type": "local",
       "command": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zugzbot",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Fácil instalador del arnés SDD de Zugzbot para proyectos OpenCode",
   "type": "module",
   "bin": {
@@ -20,8 +20,6 @@
     ".opencode/tools/",
     ".opencode/scripts/",
     ".opencode/contract-schema.json",
-    ".opencode/oh-my-design/design-md/",
-    ".opencode/oh-my-design/packages/mcp/dist/",
     ".utils/export_opencode_session.py",
     ".utils/toggle_model.py"
   ],

package/.opencode/oh-my-design/design-md/11st/.verification.md

@@ -1,37 +0,0 @@
-# 11st — Verification Notes (2026-06-09)
-
-## Proof — Tier 1 live inspect
-
-**Inspected:** 2026-06-09
-**Method:** playwright getComputedStyle (live DOM)
-**Sources:**
-- https://www.11st.co.kr (homepage, live DOM)
-- https://about.11st.co.kr (brand/company surface)
-
-Live DOM inspection of https://www.11st.co.kr was performed with the global
-Playwright (chromium, headless, `--disable-http2`), navigating to `networkidle`
-and dismissing overlays before running `getComputedStyle` on body, headings,
-buttons, links, search input, product/price elements, and a full-tree color
-scan. The homepage chrome is intentionally grayscale (`#666666` body on
-`#111111` headings over a white field); the brand red surfaces on active/focused
-states and discount accents. Over 10 real samples collected; representative set
-below.
-
-### Raw samples
-- body → color `rgb(102, 102, 102)` (#666666), font-family `"Noto Sans KR", "Helvetica Neue", "Apple SD Gothic Neo", "맑은 고딕", "Malgun Gothic", 돋움, dotum, sans-serif`, font-size 14px, line-height 21px
-- h1 / h2 → color `rgb(102, 102, 102)` (#666666), font-size 14px, font-weight 700, line-height 21px
-- active search tab (LI.focused, 통합검색) → color `#ff0038`, font-size 16px; tab border-radius `25px 25px 0px`
-- discount/related accent (EM) → color `#f43142`
-- discount price (강조) → color `#111111`, font-size 24px, font-weight 700 ("2,749,000")
-- base price figure → color `#111111`, font-size 16px, font-weight 400 ("할인모음가2,749,000원")
-- strikethrough original price (판매가) → color `#a9a9a9`, font-size 13px ("판매가3,190,420원")
-- search input → font-size 16px, fg `rgb(102, 102, 102)` (#666666)
-- nav/links → color `rgb(102, 102, 102)` (#666666), 14px; emphasis link `rgb(17, 17, 17)` (#111111) 17px
-- canvas → white field (`#ffffff`); structural hairlines `#eeeeee`
-
-## Country sources
-
-Korean brand-owned / regional sources (not getdesign/refero/google favicon):
-- https://www.11st.co.kr — 11st (11번가) official storefront, live DOM source of truth
-- https://about.11st.co.kr — Eleven Street Co., Ltd. official company/brand site (회사소개)
-- https://apps.apple.com/kr/app/11번가/id412759628 — 11st official iOS app, App Store KR listing (brand-owned product surface)