zugzbot 1.1.5 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -152,8 +152,33 @@ El `@sdd-spec-writer` utiliza de manera proactiva el MCP `shadcn` (`shadcn_searc
|
|
|
152
152
|
### Fase F2 (Implementation)
|
|
153
153
|
El `@sdd-coder` utiliza el template base `nextjs-shadcn`. Si el contrato no detalla todos los sub-componentes o el Coder necesita verificar el comportamiento de un bloque antes de acoplarlo con el backend, debe ejecutar `shadcn_get_item_examples_from_registries` para ver ejemplos funcionales del componente real. Tras ejecutar la instalación con `npx shadcn@latest add`, el Coder debe contrastar los archivos inyectados con el mapa del contrato y limpiar de inmediato cualquier archivo redundante (como una página de inicio duplicada) que no coincida con el router oficial.
|
|
154
154
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
155
|
+
## 5. Catálogo Externo Oficial: Shadcn UI Blocks (Akash)
|
|
156
|
+
|
|
157
|
+
Además del catálogo nativo de Shadcn UI, dispones de acceso autónomo a más de 200 bloques de alta calidad del repositorio **Shadcn UI Blocks (por Akash)**. Si necesitas un layout, sección o componente complejo (ej. hero, footer, pricing, login, dashboard), **debes** explorar este catálogo y proponerlo.
|
|
158
|
+
|
|
159
|
+
### 5.1 Flujo de Descubrimiento (Fase F1 - Spec-Writer)
|
|
160
|
+
Si el usuario solicita una interfaz genérica o tú detectas que un bloque complejo ahorraría tiempo, consulta la lista maestra de bloques en tiempo real:
|
|
161
|
+
- **Comando a usar:** Ejecuta la herramienta `webfetch` apuntando a la API de GitHub:
|
|
162
|
+
`webfetch("https://api.github.com/repos/akash3444/shadcn-ui-blocks/contents/public/r/radix")`
|
|
163
|
+
- **Análisis de resultados:** El JSON devuelto listará todos los bloques (`hero-01.json`, `footer-05.json`, `pricing-02.json`, etc.). Filtra mentalmente los que coincidan con la necesidad.
|
|
164
|
+
|
|
165
|
+
### 5.2 Selección de Bloques
|
|
166
|
+
Cuando existan múltiples opciones para un mismo tipo de bloque (ej. 10 footers distintos):
|
|
167
|
+
- **Modo Asistido (Por defecto):** Utiliza la herramienta `question` o lista en el chat las opciones disponibles, proporcionando la URL visual del catálogo (`https://www.shadcnui-blocks.com/blocks/categories/[categoria]`) para que el usuario pueda verlos y elegir. *Ejemplo: "He encontrado 5 tipos de Footers, puedes verlos aquí. ¿Cuál prefieres (footer-01 a footer-05)?"*.
|
|
168
|
+
- **Modo Autopiloto (`/loop`):** Si estás actuando de forma 100% autónoma sin interacción del usuario, lee el código fuente de 2 o 3 opciones al azar utilizando `webfetch("https://raw.githubusercontent.com/akash3444/shadcn-ui-blocks/main/public/r/radix/[bloque].json")` para analizar qué código encaja mejor con la petición (ej. si pide newsletter, busca uno con `<Input>`) y elígelo autónomamente.
|
|
169
|
+
|
|
170
|
+
### 5.3 Inyección e Instalación (Contrato y Coder)
|
|
171
|
+
- **Spec-Writer (F1):** En el `contract.json`, dentro de `frontend.components`, anota el bloque utilizando la URL remota directa:
|
|
172
|
+
```json
|
|
173
|
+
"frontend": {
|
|
174
|
+
"components": [
|
|
175
|
+
"https://shadcnui-blocks.com/r/radix/footer-04.json"
|
|
176
|
+
]
|
|
177
|
+
}
|
|
178
|
+
```
|
|
179
|
+
- **Coder (F2):** Para instalar estos bloques externos, utiliza la capacidad nativa de la CLI v3 de Shadcn. Ejecuta directamente el comando apuntando a la URL:
|
|
180
|
+
```bash
|
|
181
|
+
npx shadcn@latest add https://shadcnui-blocks.com/r/radix/footer-04.json
|
|
182
|
+
```
|
|
183
|
+
La CLI se encargará automáticamente de descargar el código y resolver dependencias internas (ej. instalar `separator` o `button` si el bloque lo requiere). No es necesario configurar nada en el `components.json`.
|
|
159
184
|
|