Pack Dev Studio: seis perfiles (personas) y 38 workflows
Dev Studio cubre el ciclo de vida del software con seis perfiles (personas) y 38 workflows con nombre, del brief a la revisión de código. Instalación, catálogo por fase, ejemplos, CLI studio, límites.
Dev Studio te da un equipo de software completo en forma de procedimientos escritos. Seis perfiles (personas), cada uno con un rol, ejecutan 38 workflows con nombre repartidos en cinco fases: análisis, planificación, arquitectura, implementación y utilidades. Nombras el perfil o el workflow, y tu herramienta de programación con IA lee las instrucciones y las ejecuta con sus propias herramientas. Es el pack que conviene cuando quieres un procedimiento concreto y repetible (validar un PRD, escribir una arquitectura, investigar un fallo) en lugar de una conversación libre.
Dev Studio es un pack empaquetado en .agents/skills/pack-dev-studio/, más la habilidad de despacho dev-studio en .agents/skills/dev-studio/. El pack contiene el orquestador dev-studio-orchestrator.md, el shared/catalog.json legible por máquina (perfiles, workflows, alias, tipos de entrada, recursos requeridos), la guía de ejecución shared/execution.md, un README y categories/ con un archivo Markdown por perfil y por workflow. Cada workflow responde al menos a tres nombres: <id>, bmad-<id> y bmad-plus-<id>, de modo que bmad-plus-validate-prd y validate-prd llevan al mismo procedimiento.
Un perfil (persona) es un conjunto de instrucciones, no un proceso en ejecución. Elige el rol que necesita la tarea; Atlas, Forge, Sentinel y Nexus de Core pueden coexistir con estas seis.
La columna Entrada indica qué necesita un workflow. Uno de tipo petición necesita tu petición o un archivo. Uno de tipo artefacto necesita al menos un archivo existente, por ejemplo el PRD que validar. Uno de tipo proyecto necesita una petición o un archivo y trabaja sobre el proyecto. El workflow bmad-help no necesita nada. El contexto que falta se señala como entrada necesaria en lugar de adivinarse.
Úsalo al comienzo de una idea. Tipo de entrada: petición.
En tu asistente de IA
Miriam, usa product-brief para definir una aplicación de listas de inspección para nuestros técnicos de campo. Trabajan a menudo en sótanos sin red: di qué implica eso para el primer alcance.
Lo que deberías obtener Un informe con el problema de producto, el público y el primer alcance útil, escrito por defecto en _bmad-output/dev-studio/product-brief.md.
Úsalo cuando un código no tiene documentación utilizable. Tipo de entrada: proyecto.
En tu asistente de IA
Huldah, ejecuta document-project en este repositorio. Documenta solo lo que puedas respaldar con archivos que realmente abriste y enumera lo que no pudiste verificar.
Lo que deberías obtener Documentación basada en archivos del proyecto inspeccionados, con los puntos sin verificar señalados, guardada en _bmad-output/dev-studio/document-project.md salvo que fijes otra carpeta de salida.
Úsalo antes de que empiece la arquitectura. Tipo de entrada: artefacto, así que el archivo es obligatorio.
En tu asistente de IA
Yosef, ejecuta validate-prd sobre docs/prd.md.
Lo que deberías obtener Hallazgos sobre los requisitos basados en evidencias, cada uno ligado a lo que el archivo dice realmente, en _bmad-output/dev-studio/validate-prd.md. Si falta el archivo, el workflow indica que necesita entrada.
Úsalo antes de la capa visual. Si el pack Design está instalado, Atelier se encarga de las reglas visuales y de accesibilidad y los flujos de Rachel alimentan su intake.
En tu asistente de IA
Rachel, ejecuta create-ux-design para el onboarding de nuevos usuarios: desde la creación de la cuenta hasta su primera factura guardada. Cubre los estados vacío, error y sin conexión.
Lo que deberías obtener Flujos de usuario, estados de interacción y comprobaciones de aceptación en _bmad-output/dev-studio/create-ux-design.md.
Úsalo cuando los requisitos estén cerrados. El workflow avanza por pasos y puede reanudarse desde un informe anterior.
En tu asistente de IA
Bezalel, diseña la arquitectura de la aplicación de reserva de citas descrita en docs/prd.md. Registra cada decisión con sus alternativas y compromisos.
Lo que deberías obtener Decisiones técnicas, límites y compromisos, registrados en _bmad-output/dev-studio/create-architecture.md con la plantilla de decisión de arquitectura. Continúa con create-epics-stories e implementation-readiness para comprobar que el plan es coherente.
Úsalo para fallos de causa poco clara. Tipo de entrada: proyecto, con la descripción como petición o como archivo.
En tu asistente de IA
Oholiab, usa investigate para reproducir la importación que falla descrita en docs/issue.md.
Lo que deberías obtener Hipótesis, evidencias de reproducción y la siguiente acción, en _bmad-output/dev-studio/investigate.md. Solo entonces tiene sentido una corrección, por ejemplo con quick-dev.
Preparar un lote de contexto de solo lectura desde el terminal#
Úsalo para ver exactamente qué recibirá un workflow. Prepara, no ejecuta: sigue siendo tu asistente quien trabaja.
En tu asistente de IA
npx bmad-plus studio prepare validate-prd --input docs/prd.md --json
Lo que deberías obtener Un lote de solo lectura: la configuración resuelta, los textos de instrucciones entregados con sus hashes SHA-256, el contenido y los hashes de los archivos de entrada y la ruta de informe propuesta. Los archivos de entrada deben existir dentro del proyecto y --input puede repetirse. Si no se aporta una entrada requerida (ningún --input en un workflow de tipo artefacto), el comando termina con código 2 y el estado needs-input, mientras que una ruta --input inexistente es un error (código de salida 1); nunca escribe el entregable, ejecuta pruebas ni certifica que un modelo siguiera el workflow.
Úsalo cuando conoces el objetivo pero no el nombre del workflow. bmad-help no requiere entrada.
En tu asistente de IA
Miriam, ejecuta bmad-help: tengo un PRD a medio escribir y una fecha límite. ¿Qué workflows de Dev Studio debo ejecutar, en qué orden y cuáles puedo omitir?
Lo que deberías obtener Las rutas pertinentes y un siguiente paso justificado. Para un PRD a medio escribir, suele significar terminar primero los requisitos (prd o edit-prd), luego validate-prd y después create-architecture. Los identificadores de workflow de la respuesta son sugerencias, no disparadores automáticos.
Los informes van por defecto a _bmad-output/dev-studio/<workflow-id>.md, ajustado a la carpeta de salida configurada. Los cambios de código se quedan en el proyecto real. Un informe registra el alcance, las entradas, las decisiones, el trabajo hecho, las comprobaciones, las preguntas abiertas y la siguiente acción. Al reanudar, el workflow lee el informe anterior y revalida las entradas que cambiaron. Un informe nunca autoriza a sobrescribir tus cambios ni a repetir una publicación.
Ajustes leídos de _bmad/config.yaml (cada clave tiene un valor por defecto; project_name recurre al nombre de la carpeta, aquí demo-app)
user_name: user
communication_language: English
document_output_language: English
output_folder: _bmad-output
project_name: demo-app
Un archivo ausente es válido. Un archivo mal formado, o un campo conocido no válido, es un error. project_name toma por defecto el nombre de la carpeta. Tu petición actual y las instrucciones de tu anfitrión prevalecen sobre las preferencias de idioma de la configuración.
Node.js 20 para el instalador y el comando opcional studio. Ni Python, ni clave, ni flujo propio que salga de tu máquina: studio list y studio prepare solo leen archivos locales. Lo que tu asistente envía a su modelo depende de tu herramienta anfitriona. Los workflows de investigación necesitan fuentes accesibles para respaldar afirmaciones factuales actuales, y lo dicen cuando no las tienen.
El orquestador es un rol de instrucciones. No envía notificaciones, no hace commits y no publica nada por sí mismo. Los agentes paralelos independientes, la navegación y la ejecución de comandos dependen de tu anfitrión; cuando un solo asistente interpreta varias perspectivas debe decirlo, y las comprobaciones no disponibles siguen visibles. Ningún workflow garantiza código sin defectos ni un resumen sin pérdidas.
Nota· Sin intérprete BWML
La antigua notación de workflow de estilo XML (BWML) y la personalización TOML no tienen intérprete ni resolutor en este pack. Una nota de migración del pack describe el comportamiento sustituto admitido: procedimientos Markdown simples, el catálogo y _bmad/config.yaml.
Consejo· Solapamiento con Core y Design
Dev Studio se solapa con Atlas, Forge, Sentinel y Nexus; ambos pueden convivir, así que elige el perfil cuyo workflow quieras. Para las pantallas, Rachel o Atelier se encarga de una pantalla concreta y el traspaso dice cuál.
Nota· Procedencia
Dev Studio es un pack original escrito por Laurent Rochetta: seis agentes especializados del ciclo de vida del software y 38 workflows, redactados como instrucciones originales de BMAD+. Los nombres de los perfiles y el linaje de los workflows reconocen a BMAD-METHOD, de BMad Code, LLC (licencia MIT, base v6.6.0); no se incluye ningún runtime upstream.