# studio

> Lista los workflows de Dev Studio y prepara un lote de contexto de solo lectura para uno de ellos, para que tu asistente lo ejecute con las instrucciones exactas incluidas en tu proyecto.

Canonical: https://bmad-plus.rochetta.fr/es/docs/reference/cli-studio/
Language: es
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT

Documentación de BMAD+ › [Referencia](https://bmad-plus.rochetta.fr/es/docs/reference/) › studio

Dev Studio es el pack con seis perfiles (personas: Miriam, Huldah, Yosef, Rachel, Bezalel, Oholiab) y 38 workflows como `product-brief`, `validate-prd` o `investigate`. Un workflow es un procedimiento en Markdown que sigue tu asistente. `bmad-plus studio` no ejecuta nada: `list` muestra el catálogo y `prepare` reúne en un solo lote todo lo que el asistente necesita para un workflow (la configuración, las instrucciones incluidas, los archivos que indiques), con una huella por archivo. Es para quien quiere un arranque reproducible, o un script que entrega el lote a un asistente.

<a id="synopsis"></a>
## Sinopsis

**En la terminal de tu proyecto**

```sh
npx bmad-plus studio list [--json] [-d <path>]
npx bmad-plus studio prepare <workflow> [--request <text>] [--input <file> ...] [--json] [-d <path>]
```

**Argumentos y opciones de studio**

| Opción | Argumento | Por defecto | Qué hace |
| --- | --- | --- | --- |
| `<action>` | `list` o `prepare` | obligatorio | Cualquier otro valor falla con `Use studio list or studio prepare WORKFLOW.` |
| `[workflow]` | id de workflow o alias | ninguno | Obligatorio en `prepare`, rechazado en `list`. Los alias `bmad-<id>` y `bmad-plus-<id>` también funcionan. |
| `-d, --directory <path>` | carpeta | carpeta actual | Proyecto instalado que se lee. |
| `--request <text>` | texto | vacío | Alcance de la tarea para el asistente, hasta 256 KiB. |
| `--input <file>` | archivo relativo al proyecto | ninguno | Repetible, como máximo 32 archivos. Cada uno debe ser un archivo de texto UTF-8 de hasta 256 KiB dentro del proyecto. |
| `--json` | - | desactivado | Imprime el lote completo en JSON en vez del resumen de texto. |

<a id="reads-writes"></a>
## Qué lee y qué escribe

- Lee `.agents/skills/pack-dev-studio/` (el catálogo `shared/catalog.json`, el archivo del perfil (persona), el del workflow y los recursos a los que enlaza), `_bmad/config.yaml`, tus archivos `--input` y el informe anterior si existe.
- No escribe nada. Ni el informe, ni caché, ni configuración. La ruta de informe que propone es `<output_folder>/dev-studio/<workflow-id>.md` (por defecto `_bmad-output/dev-studio/<workflow-id>.md`); tu asistente lo escribirá después.
- No abre ninguna conexión de red ni lanza ningún proceso. El lote está limitado a 2 MiB.
- Necesita el pack Dev Studio: `npx bmad-plus install --packs core,dev-studio`.

<a id="input-kinds"></a>
### Tipos de entrada

Cada workflow declara lo que necesita. Si falta, `prepare` imprime igualmente el lote pero informa `needs-input` y sale con el código 2, de modo que un script puede pedir más antes de llamar al asistente.

**Tipos de entrada del catálogo**

| Tipo | Exige | Ejemplos |
| --- | --- | --- |
| `request` | Un texto `--request` o al menos un archivo `--input`. | `product-brief`, `create-prd`, `create-architecture` |
| `project` | Un texto `--request` o al menos un archivo `--input`. | `investigate`, `quick-dev`, `code-review` |
| `artifact` | Al menos un archivo `--input`. | `validate-prd`, `edit-prd`, `dev-story` |
| `none` | Nada. | declarado por el catálogo para los workflows sin entrada |

<a id="exit-codes"></a>
## Códigos de salida

**Códigos de salida de studio**

| Código | Significado |
| --- | --- |
| 0 | `list` tuvo éxito, o el estado de `prepare` es `ready`. |
| 2 | El estado de `prepare` es `needs-input`: al workflow le falta su petición o su archivo de entrada. |
| 1 | Error: pack no instalado, workflow desconocido, entrada inválida, configuración ilegible. Con `--json` el error se imprime como `{"schemaVersion":1,"status":"error","error":"..."}`. |

<a id="real-output"></a>
## Leer la salida

**Listar el catálogo (primeras líneas)**

```text
$ npx bmad-plus studio list
product-brief (analyst-agent; input: request)
prfaq (analyst-agent; input: request)
document-project (tech-writer-agent; input: project)
market-research (analyst-agent; input: request)
domain-research (analyst-agent; input: request)
technical-research (analyst-agent; input: request)
create-prd (pm-agent; input: request)
prd (pm-agent; input: request)
edit-prd (pm-agent; input: artifact)
validate-prd (pm-agent; input: artifact)
...
investigate (dev-agent; input: project)
# La lista real tiene 38 workflows; las líneas marcadas «...» se omiten aquí.
```

Salida capturada de una ejecución real. Fuente: Reproducido con el paquete 0.23.0 (packs Core y Dev Studio) en un proyecto desechable; líneas omitidas donde se indica

**Preparar un workflow al que le falta su entrada**

```text
$ npx bmad-plus studio prepare validate-prd
validate-prd: needs-input — prepared for the host, not executed.
Project: /work/app
Request: (none supplied)
Resolved configuration:
{
  "user_name": "Developer",
  "communication_language": "English",
  "document_output_language": "English",
  "output_folder": "_bmad-output",
  "project_name": "app"
}
Defaulted fields: (none)
Proposed report: _bmad-output/dev-studio/validate-prd.md
Supply a project artifact with --input RELATIVE_FILE.

--- shared/execution.md (b8152ec5057fc79749aa7b0823fa35c241c6a0c3f13d12716fa3aae11bcbf354) ---
...
# Código de salida 2. Los valores mostrados dependen de tu _bmad/config.yaml; los cuerpos de instrucciones largos que siguen se omiten («...»).
```

Salida capturada de una ejecución real. Fuente: Reproducido con el paquete 0.23.0 (packs Core y Dev Studio) en un proyecto desechable; la ruta del proyecto se sustituye por /work/app y los cuerpos de instrucciones largos se omiten

El resumen de texto imprime, por orden: el workflow y su estado, la carpeta del proyecto, la petición, la configuración resuelta, los campos de configuración que cayeron en un valor por defecto, la ruta de informe propuesta, lo que aún falta y luego cada archivo de instrucciones y cada archivo de entrada con su SHA-256. Si ya existe un informe en la ruta propuesta, su contenido sigue bajo «Continue existing report», para que el asistente continúe en vez de empezar de cero. Con `--json`, los mismos datos forman un único objeto con `schemaVersion`, `status` (`ready` o `needs-input`), `execution: "host-managed"`, `executed: false`, `catalogSha256`, `instructions`, `inputs` y `missingInputs`.

> **Nota · Preparado no significa ejecutado** El lote prueba que las instrucciones se entregaron y qué bytes eran. No prueba que el asistente las siguiera, y nada en él escribe el informe ni ejecuta pruebas. Los agentes independientes, la navegación y la ejecución de comandos dependen de tu asistente.

<a id="errors"></a>
## Errores y qué hacer

Los errores se imprimen como `Dev Studio: <message>` en el flujo de error.

**Errores de studio**

| Mensaje | Causa | Qué hacer |
| --- | --- | --- |
| `Dev Studio is not installed. Run bmad-plus install --packs core,dev-studio` | La carpeta no tiene `.agents/skills/pack-dev-studio`. | Instala el pack, o pasa `--directory` con el proyecto correcto. |
| `Use studio list or studio prepare WORKFLOW.` | Acción desconocida, `list` con un workflow, o `prepare` sin él. | Revisa la sinopsis de arriba. |
| `Unknown Dev Studio workflow: <name>` | El nombre no es un id de workflow ni un alias. | Ejecuta `studio list` y copia un id. |
| `Invalid or oversized workflow inputs` | La petición supera 256 KiB o se dieron más de 32 archivos `--input`. | Acorta la petición, pasa menos archivos. |
| `Resource is not bounded text: <file>` | Una entrada falta, es binaria o supera 256 KiB. | Señala un archivo de texto UTF-8 más pequeño dentro del proyecto. |
| `Expected a portable relative file path: <file>` | La ruta de `--input` es absoluta, contiene `..`, una letra de unidad u otros caracteres no admitidos. | Usa una ruta relativa al proyecto, con separadores `/`. |
| `Prepared context exceeds 2 MiB` | Instrucciones, entradas e informe anterior suman demasiado. | Pasa menos entradas, o más pequeñas. |
| `_bmad/config.yaml: <key> must be a nonempty string` | Una clave conocida de la configuración está vacía o no es texto. | Corrige el valor; consulta la página de configuración. |
| `Dev Studio catalog disagrees with registry routes` o `Unsupported Dev Studio catalog` | Los archivos del pack instalado se editaron o están incompletos. | Ejecuta `doctor`, luego reinstala o actualiza el pack. |

<a id="examples"></a>
## Ejemplos

<a id="example-cli-studio-brief-from-request"></a>
### Un product brief a partir de una petición de una línea

Dev Studio está instalado. Quieres que Miriam parta de un alcance preciso, con las instrucciones exactas registradas por huella.

**En tu asistente de IA**

```text
Miriam, usa product-brief para definir la herramienta de triaje de incidencias más pequeña que sea útil para nuestro equipo de soporte. Si la CLI está disponible, ejecuta primero `npx bmad-plus studio prepare product-brief --request "Definir la herramienta de triaje más pequeña que sea útil" --json` y trabaja a partir de ese lote.
```

**Lo que deberías obtener** El comando imprime un lote con estado `ready`, `executed: false`, la ruta de informe propuesta `_bmad-output/dev-studio/product-brief.md` y las instrucciones incluidas con sus huellas. Miriam sigue después el procedimiento `product-brief` y escribe el informe en esa ruta; el comando en sí no escribió nada.

<a id="example-cli-studio-validate-prd"></a>
### Validar un PRD que ya tienes

`validate-prd` es un workflow de tipo `artifact`: necesita el archivo a validar.

**En tu asistente de IA**

```text
Yosef, validate-prd sobre docs/prd.md. Prepara el contexto con `npx bmad-plus studio prepare validate-prd --input docs/prd.md --json` y solo informa de un hallazgo si puedes señalar el texto que lo respalda.
```

**Lo que deberías obtener** Sin `--input`, el comando imprimiría `needs-input` y saldría con 2. Con él, el estado es `ready`, el archivo aparece en `inputs` con su SHA-256 y el informe propuesto es `_bmad-output/dev-studio/validate-prd.md`. Yosef valida ese contenido exacto.

**Véase también**

- [La CLI de un vistazo y los códigos de salida](https://bmad-plus.rochetta.fr/es/docs/reference/cli-overview/)
- [install: añadir el pack dev-studio](https://bmad-plus.rochetta.fr/es/docs/reference/cli-install/)
- [doctor comprueba los recursos del pack](https://bmad-plus.rochetta.fr/es/docs/reference/cli-doctor/)
- [El archivo de configuración](https://bmad-plus.rochetta.fr/es/docs/reference/config-yaml/)
- [Solución de problemas](https://bmad-plus.rochetta.fr/es/docs/faq/troubleshooting/)

[Documentación de BMAD+](https://bmad-plus.rochetta.fr/es/docs/) · [Referencia](https://bmad-plus.rochetta.fr/es/docs/reference/)

[Código en GitHub](https://github.com/lrochetta/BMAD-PLUS)