Listez les workflows de Dev Studio et préparez un lot de contexte en lecture seule pour l’un d’eux, afin que votre assistant l’exécute avec les instructions exactes livrées dans votre projet.
Dev Studio est le pack de six personas (Miriam, Huldah, Yosef, Rachel, Bezalel, Oholiab) et de 38 workflows comme product-brief, validate-prd ou investigate. Un workflow est une procédure en Markdown que votre assistant suit. bmad-plus studio n’exécute rien : list montre le catalogue, et prepare réunit en un seul lot tout ce dont l’assistant a besoin pour un workflow (la configuration, les instructions livrées, les fichiers que vous désignez), avec une empreinte pour chaque fichier. C’est pour qui veut un départ reproductible, ou un script qui remet le lot à un assistant.
Lit .agents/skills/pack-dev-studio/ (le catalogue shared/catalog.json, le fichier de la persona, celui du workflow et les ressources vers lesquelles il renvoie), _bmad/config.yaml, vos fichiers --input et le rapport précédent s’il existe.
N’écrit rien. Ni le rapport, ni cache, ni configuration. Le chemin de rapport qu’elle propose est <output_folder>/dev-studio/<workflow-id>.md (par défaut _bmad-output/dev-studio/<workflow-id>.md) ; c’est votre assistant qui l’écrira plus tard.
N’ouvre aucune connexion réseau et ne lance aucun processus. Le lot est plafonné à 2 Mio.
Demande le pack Dev Studio : npx bmad-plus install --packs core,dev-studio.
Chaque workflow déclare ce dont il a besoin. Quand cela manque, prepare affiche quand même le lot mais signale needs-input et sort avec le code 2, ce qui permet à un script de demander plus avant d’appeler l’assistant.
Types d’entrée du catalogue
Type
Exige
Exemples
request
Un texte --request ou au moins un fichier --input.
product-brief, create-prd, create-architecture
project
Un texte --request ou au moins un fichier --input.
investigate, quick-dev, code-review
artifact
Au moins un fichier --input.
validate-prd, edit-prd, dev-story
none
Rien.
déclaré par le catalogue pour les workflows sans entrée
Le statut de prepare est needs-input : il manque au workflow sa demande ou son fichier d’entrée.
1
Erreur : pack non installé, workflow inconnu, entrée invalide, configuration illisible. Avec --json, l’erreur est affichée sous la forme {"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 vraie liste compte 38 workflows ; les lignes marquées « ... » sont omises ici.
npx bmad-plus studio list
Sortie capturée lors d’une exécution réelle. Source: Rejoué avec le paquet 0.23.0 (packs Core et Dev Studio) dans un projet jetable ; lignes omises là où c’est indiqué
Préparer un workflow auquel il manque son entrée
$ 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) ---...# Code de sortie 2. Les valeurs affichées dépendent de votre _bmad/config.yaml ; les longs corps d’instructions qui suivent sont omis (« ... »).
npx bmad-plus studio prepare validate-prd
Sortie capturée lors d’une exécution réelle. Source: Rejoué avec le paquet 0.23.0 (packs Core et Dev Studio) dans un projet jetable ; le chemin du projet est remplacé par /work/app et les longs corps d’instructions sont omis
Le résumé texte affiche, dans l’ordre : le workflow et son statut, le dossier du projet, la demande, la configuration résolue, les champs de configuration qui sont retombés sur une valeur par défaut, le chemin de rapport proposé, ce qui manque encore, puis chaque fichier d’instructions et chaque fichier d’entrée avec son SHA-256. Si un rapport existe déjà au chemin proposé, son contenu suit sous « Continue existing report », pour que l’assistant reprenne au lieu de recommencer. Avec --json, les mêmes données forment un seul objet avec schemaVersion, status (ready ou needs-input), execution: "host-managed", executed: false, catalogSha256, instructions, inputs et missingInputs.
Remarque· Préparé ne veut pas dire exécuté
Le lot prouve que les instructions ont été livrées et quels octets elles contenaient. Il ne prouve pas que l’assistant les a suivies, et rien dedans n’écrit le rapport ni ne lance de tests. Les agents indépendants, la navigation et l’exécution de commandes dépendent de votre assistant.
Un product brief à partir d’une demande d’une ligne#
Dev Studio est installé. Vous voulez que Miriam parte d’un périmètre précis, avec les instructions exactes consignées par empreinte.
Dans votre assistant IA
Miriam, utilise product-brief pour définir le plus petit outil de tri de tickets utile à notre équipe support. Si la CLI est disponible, lance d’abord `npx bmad-plus studio prepare product-brief --request "Définir le plus petit outil de tri de tickets utile" --json` et travaille à partir de ce lot.
Ce que vous devriez obtenir La commande affiche un lot de statut ready, executed: false, le chemin de rapport proposé _bmad-output/dev-studio/product-brief.md et les instructions livrées avec leurs empreintes. Miriam suit ensuite la procédure product-brief et écrit le rapport à ce chemin ; la commande elle-même n’a rien écrit.
validate-prd est un workflow de type artifact : il lui faut le fichier à valider.
Dans votre assistant IA
Yosef, validate-prd sur docs/prd.md. Prépare le contexte avec `npx bmad-plus studio prepare validate-prd --input docs/prd.md --json` et ne rapporte une observation que si tu peux montrer le texte qui l’appuie.
Ce que vous devriez obtenir Sans --input, la commande afficherait needs-input et sortirait avec 2. Avec lui, le statut est ready, le fichier figure sous inputs avec son SHA-256 et le rapport proposé est _bmad-output/dev-studio/validate-prd.md. Yosef valide ce contenu exact.