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.
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.
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.
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
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":"..."}.
$ npx bmad-plus studio listproduct-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í.
npx bmad-plus studio list
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
$ npx bmad-plus studio prepare validate-prdvalidate-prd: needs-input — prepared for the host, not executed.Project: /work/appRequest: (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.mdSupply 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 («...»).
npx bmad-plus studio prepare validate-prd
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.
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
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.
validate-prd es un workflow de tipo artifact: necesita el archivo a validar.
En tu asistente de IA
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.