bmad-plus 0.4.4 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,60 @@ All notable changes to BMAD+ will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] — 2026-05-17
+
+### 🏗️ Pack Dev Studio — Full Software Development Lifecycle
+
+### Added
+- **Pack Dev Studio** — 6 specialized agents + 30 workflows covering the complete SDLC
+  - 📊 **Analysis** (8): Miriam (Business Analyst), Huldah (Tech Writer), Product Brief, PRFAQ, Market/Domain/Technical Research
+  - 📋 **Planning** (7): Yosef (Product Manager), Rachel (UX Designer), PRD Create/Edit/Validate, UX Design
+  - 🏗️ **Architecture** (5+9 steps): Bezalel (System Architect), Create Architecture (8-step workflow), Epics & Stories, Readiness Check
+  - 💻 **Implementation** (12): Oholiab (Senior Engineer), Sprint Planning, Dev Story (TDD cycle), Code Review, Quick Dev, Investigate
+  - 🔧 **Utilities** (12): Distillator, Party Mode, Adversarial Review, Edge Case Hunter, Editorial Reviews, Advanced Elicitation
+- **BWML** (BMAD+ Workflow Markup Language) — Proprietary DSL extending BMAD v6 XML with 12 new primitives:
+  `<agent>`, `<parallel>`, `<loop>`, `<validate>`, `<guard>`, `<emit>`, `<context>`, `<memory>`, `<escalate>`, `<retry>`, `<fallback>`, `<metric>`
+- **Dev Studio Orchestrator** — Intelligent routing across 5 phases with BWML-powered workflow definitions
+- **Torah-named Personas** — Agents named after Torah figures matching their roles: Miriam, Huldah, Yosef, Rachel, Bezalel, Oholiab
+- **Upstream Sync** — Tracking config for BMAD-METHOD v6.6.0 updates (commit `0f852a3`)
+- **64 files** — 59 .md skills, module-help.csv, BWML spec, orchestrator, README, upstream-sync
+
+### Changed
+- **module.yaml** — Added dev-studio pack with 5 categories and cohabitation warning for Core pack
+- **install.js** — IDE configs now include 6 Torah-named agents when Dev Studio is selected
+- **Version reference** — Updated from BMAD-METHOD v6.2.0 to v6.6.0
+
+## [0.5.0] — 2026-05-17
+
+### 🛡️ Pack Shield — GRC Compliance (38 agents)
+
+### Added
+- **Pack Shield** — 38 expert compliance agents covering 25+ regulatory frameworks
+  - 🔐 **Data Privacy** (5): GDPR, CCPA/CPRA, LGPD, DPDPA, ISO 27701
+  - 🛡️ **Cybersecurity** (6): ISO 27001, NIST CSF 2.0, NIST 800-53, CIS Controls v8, NIS2, ISM
+  - 🏢 **Industry Compliance** (6): SOC 2, PCI DSS v4.0, HIPAA, SWIFT CSP, DORA, FedRAMP
+  - 🔒 **Defense & Export** (4): CMMC 2.0, ITAR, EAR, TSA
+  - 🤖 **AI Governance** (3): EU AI Act, ISO 42001, NIST AI RMF
+  - ♿ **Accessibility & ESG** (3): WCAG, Section 508, CSRD
+  - 📋 **GDPR & AI Act Workflows** (11): DPIA, Breach Response, LIA, Privacy Notices/Policies, Cookie Compliance, AI Act Classification/Roles/FRIA/Incidents
+- **Shield Orchestrator** — Intelligent routing across all 38 agents with cross-framework mapping
+- **85 Reference Files** — Deep regulatory knowledge extracted from upstream Claude Skills archives
+- **3 Shared Templates** — Gap Analysis, Cross-Framework Mapper, Audit Report
+- **Upstream Sync System** — Tracking configuration for Sushegaad GRC skill updates
+- **module.yaml** — Full shield pack definition with 7 categories and per-category agent lists
+- **CLI Integration** — Shield pack selectable in `npx bmad-plus install` with 3 localized example commands
+- **IDE Config** — Shield agent advertised in generated AGENTS.md/GEMINI.md
+
+### Changed
+- **install_packs** — All packs now listed in multiselect (seo, backup, animated were missing)
+- **module.yaml** — Replaced old `audit` (coming_soon) stub with fully realized `shield` pack
+
+### Attribution
+- Based on [Claude Skills for GRC](https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance) by Hemant Naik — MIT License
+- GDPR/EU AI Act workflows inspired by [Lawve.ai](https://lawve.ai) professional skills catalog
+
+---
+
 ## [0.4.4] — 2026-05-17
 
 ### 🔧 Encoding Fix + i18n Complete + Tests

package/README.md

@@ -1,6 +1,6 @@
-# 🚀 BMAD+ — Augmented AI-Driven Development Framework
+# 🚀 BMAD+ — Augmented AI-Driven Development Framework
 
-[![Version](https://img.shields.io/badge/version-0.4.4-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
@@ -426,7 +426,9 @@ BMAD+/
 | **0.4.1** | 2026-03-19 |
 | **0.4.2** | 2026-03-19 |  Public packs  SEO/Backup/Animated agents now in npm package | 🌐 10-language CLI, CI/CD pipeline, `.npmignore`, `/deploy` workflow, security hardening |
 | **0.4.3** | 2026-05-17 | 🔧 update + doctor commands, i18n complete, credits fix |
-| **0.4.4** | 2026-05-17 | 🔧 `update` + `doctor` commands, i18n uninstall, enriched guide with CLI commands & examples, credits at startup, security hardening |
+| **0.4.4** | 2026-05-17 | 🔧 UTF-8 encoding fix, complete i18n 10 languages, 62 unit tests |
+| **0.6.0** | 2026-05-17 | 🏗️ **Pack Dev Studio** — 6 Torah-named agents (Miriam, Yosef, Bezalel...) + 30 SDLC workflows, BWML DSL |
+| **0.5.0** | 2026-05-17 | 🛡️ **Pack Shield** — 38 GRC compliance agents, 7 categories, 25+ frameworks (GDPR, ISO 27001, SOC 2, EU AI Act...) |
 
 See [CHANGELOG.md](CHANGELOG.md) for full details.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-plus",
-  "version": "0.4.4",
+  "version": "0.6.0",
   "description": "BMAD+ — Augmented AI-Driven Development Framework with multi-role agents, autopilot, and parallel execution",
   "keywords": [
     "bmad",

package/readme-international/README.de.md

@@ -1,6 +1,6 @@
-# 🚀 BMAD+ — Erweitertes KI-gestütztes Entwicklungs-Framework
+# 🚀 BMAD+ — Erweitertes KI-gestütztes Entwicklungs-Framework
 
-[![Version](https://img.shields.io/badge/version-0.4.4-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/readme-international/README.es.md

@@ -1,6 +1,6 @@
-# 🚀 BMAD+ — Framework de Desarrollo Impulsado por IA Aumentada
+# 🚀 BMAD+ — Framework de Desarrollo Impulsado por IA Aumentada
 
-[![Version](https://img.shields.io/badge/version-0.4.4-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/readme-international/README.fr.md

@@ -1,6 +1,6 @@
-# 🚀 BMAD+ — Augmented AI-Driven Development Framework
+# 🚀 BMAD+ — Augmented AI-Driven Development Framework
 
-[![Version](https://img.shields.io/badge/version-0.4.4-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/src/bmad-plus/module.yaml

@@ -62,17 +62,74 @@ packs:
       - agent-maker
     skills: []
 
-  audit:
-    name: "Audit Sécurité"
+  shield:
+    name: "Shield — GRC Compliance"
     icon: "🛡️"
-    description: "Scan vulnérabilités, audit code, compliance check (bientôt)"
+    description: "38 compliance agents covering 25+ regulatory frameworks (GDPR, ISO 27001, SOC 2, HIPAA, PCI DSS, EU AI Act, DORA, NIS2...)"
     required: false
-    status: coming_soon
-    agents:
-      - agent-shield
-    skills:
-      - bmad-audit-scan
-      - bmad-audit-report
+    packDir: pack-shield
+    packSrcDir: packs
+    orchestrator: shield-orchestrator
+    categories:
+      - id: data-privacy
+        name: "Data Privacy"
+        icon: "🔐"
+        agents: [gdpr-agent, ccpa-agent, lgpd-agent, dpdpa-agent, iso27701-agent]
+      - id: cybersecurity
+        name: "Cybersecurity"
+        icon: "🛡️"
+        agents: [iso27001-agent, nist-csf-agent, nist-800-53-agent, cis-controls-agent, nis2-agent, ism-agent]
+      - id: industry-compliance
+        name: "Industry Compliance"
+        icon: "🏢"
+        agents: [soc2-agent, pci-dss-agent, hipaa-agent, swift-csp-agent, dora-agent, fedramp-agent]
+      - id: defense-export
+        name: "Defense & Export Control"
+        icon: "🔒"
+        agents: [cmmc-agent, itar-agent, ear-agent, tsa-agent]
+      - id: ai-governance
+        name: "AI Governance"
+        icon: "🤖"
+        agents: [eu-ai-act-agent, iso42001-agent, nist-ai-rmf-agent]
+      - id: accessibility-esg
+        name: "Accessibility & ESG"
+        icon: "♿"
+        agents: [wcag-agent, section508-agent, csrd-agent]
+      - id: workflows
+        name: "GDPR & AI Act Workflows"
+        icon: "📋"
+        agents: [dpia-sentinel, breach-sentinel, legitimate-interest, privacy-advisor, privacy-notice-gen, privacy-policy-gen, cookie-policy-gen, ai-act-classifier, ai-act-roles, ai-act-fria, ai-act-incidents]
+
+  dev-studio:
+    name: "Dev Studio — Full SDLC"
+    icon: "🏗️"
+    description: "6 specialized agents (Torah-named) + 30 workflows covering Analysis → Planning → Architecture → Implementation → Review. Adapted from BMAD-METHOD v6.6.0."
+    required: false
+    packDir: pack-dev-studio
+    packSrcDir: packs
+    orchestrator: dev-studio-orchestrator
+    cohabitation_warning: "Dev Studio agents overlap with Core agents (Atlas/Forge/Sentinel/Nexus). Both can be installed — Dev Studio offers more specialized, phase-specific workflows."
+    categories:
+      - id: analysis
+        name: "Analysis"
+        icon: "📊"
+        agents: [analyst-agent, tech-writer-agent, product-brief, prfaq, document-project, market-research, domain-research, technical-research]
+      - id: planning
+        name: "Planning"
+        icon: "📋"
+        agents: [pm-agent, ux-designer-agent, create-prd, prd, edit-prd, validate-prd, create-ux-design]
+      - id: architecture
+        name: "Architecture"
+        icon: "🏗️"
+        agents: [architect-agent, create-architecture, create-epics-stories, implementation-readiness, generate-project-context]
+      - id: implementation
+        name: "Implementation"
+        icon: "💻"
+        agents: [dev-agent, sprint-planning, create-story, dev-story, code-review, quick-dev, sprint-status, retrospective, correct-course, investigate, checkpoint-preview, qa-e2e-tests]
+      - id: utilities
+        name: "Utilities"
+        icon: "🔧"
+        agents: [distillator, party-mode, brainstorming, adversarial-review, edge-case-hunter, editorial-review-prose, editorial-review-structure, advanced-elicitation, shard-doc, index-docs, bmad-help, customize]
 
   seo:
     name: "SEO Audit 360"
@@ -114,9 +171,16 @@ install_packs:
       label: "🔍 OSINT — Agent Shadow (investigation, scraping, psychoprofil)"
     - value: "maker"
       label: "🧬 Agent Creator — Créer de nouveaux agents BMAD+ compatibles"
-    - value: "audit"
-      label: "🛡️ Audit Sécurité — Agent Shield (scan vulnérabilités) [bientôt]"
-      disabled: true
+    - value: "shield"
+      label: "🛡️ Shield GRC — 38 agents de conformité (GDPR, ISO 27001, SOC 2, EU AI Act...)"
+    - value: "dev-studio"
+      label: "🏗️ Dev Studio — 6 agents + 30 workflows SDLC complet (Miriam, Yosef, Bezalel, Oholiab...)"
+    - value: "seo"
+      label: "🔍 SEO Audit 360 — 3 agents (Scout, Chief, Judge)"
+    - value: "backup"
+      label: "🗂️ Universal Backup — Backup ZIP intelligent"
+    - value: "animated"
+      label: "🎬 Animated Website — Luxury scroll-driven site from video"
     - value: "all"
       label: "🤖 Tout installer"
     - value: "none"

package/src/bmad-plus/packs/pack-dev-studio/README.md

@@ -0,0 +1,162 @@
+# 🏗️ Pack Dev Studio — BMAD+
+
+> Full Software Development Lifecycle powered by 6 Torah-named AI agents
+
+**Source:** Adapted from [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) v6.6.0 (47K+ ⭐)
+**Format:** BWML (BMAD+ Workflow Markup Language)
+**License:** MIT
+
+---
+
+## Overview
+
+Pack Dev Studio transforms your AI IDE into a complete software engineering team. Six specialized agents guide you through the entire development lifecycle — from brainstorming to deployment — with structured workflows, validation gates, and anti-regression guards.
+
+Unlike generic AI assistants, each agent embodies deep domain expertise with a distinct voice, methodology, and perspective. Named after figures from the Torah whose characteristics mirror their roles.
+
+## Agents
+
+### 📊 Miriam (מרים) — Business Analyst
+*"Like the prophetess who watched over Moses, Miriam observes patterns others miss"*
+
+Strategic analysis, market research, competitive landscape, requirements elicitation, product briefs, PRFAQ challenges. Channels Porter's strategic rigor and Minto's Pyramid Principle.
+
+### 📚 Huldah (חולדה) — Technical Writer
+*"As Huldah authenticated the Book of the Law, she authenticates your documentation"*
+
+Documentation mastery, CommonMark, DITA, OpenAPI, Mermaid diagrams, editorial review. Turns complex concepts into accessible structured docs.
+
+### 📋 Yosef (יוסף) — Product Manager
+*"Like Joseph interpreting Pharaoh's dreams, Yosef interprets user needs into actionable specs"*
+
+PRD creation/validation, feature prioritization, Jobs-to-be-Done methodology, user value first. Every "why?" tightens the net.
+
+### 🎨 Rachel (רחל) — UX Designer
+*"Rachel's empathy and devotion mirror the UX designer's commitment to the user"*
+
+User experience design, wireframes, user flows, accessibility, empathy mapping, edge-case rigor. Paints user stories that make you feel the problem.
+
+### 🏗️ Bezalel (בצלאל) — System Architect
+*"The master architect of the Tabernacle, filled with divine wisdom for design"*
+
+Architecture decisions, system design, tech stack selection, ADRs, boring technology philosophy. Measures trade-offs, not verdicts.
+
+### 💻 Oholiab (אהליאב) — Senior Engineer
+*"Bezalel's master craftsman partner — precision in every implementation"*
+
+TDD red-green-refactor, story implementation, code review, sprint management. Terminal-prompt precision, AC-first delivery.
+
+## Development Lifecycle
+
+```
+Phase 1 — Analysis
+  Miriam → Brainstorm → Product Brief / PRFAQ
+  Huldah → Document existing project
+
+Phase 2 — Planning
+  Yosef  → PRD (create, edit, validate)
+  Rachel → UX Design (wireframes, user flows)
+
+Phase 3 — Architecture
+  Bezalel → Architecture → Epics & Stories → Readiness Check
+
+Phase 4 — Implementation
+  Oholiab → Sprint Planning → [Create Story → Dev Story → Code Review] → Retrospective
+
+Cross-cutting — Utilities
+  Distillator, Party Mode, Adversarial Reviews, Editorial Reviews
+```
+
+## Workflows (30+)
+
+### Analysis (8 skills)
+| Skill | Description |
+|-------|-------------|
+| `analyst-agent` | Miriam — full business analyst persona |
+| `tech-writer-agent` | Huldah — technical documentation expert |
+| `product-brief` | Guided product brief creation |
+| `prfaq` | Amazon Working Backwards PRFAQ challenge |
+| `document-project` | Analyze existing project for documentation |
+| `market-research` | Market analysis and competitive landscape |
+| `domain-research` | Industry domain deep dive |
+| `technical-research` | Technical feasibility assessment |
+
+### Planning (7 skills)
+| Skill | Description |
+|-------|-------------|
+| `pm-agent` | Yosef — product manager persona |
+| `ux-designer-agent` | Rachel — UX designer persona |
+| `create-prd` | PRD creation via coached discovery |
+| `prd` | Full PRD workflow (create/edit/validate) |
+| `edit-prd` | Update existing PRD |
+| `validate-prd` | PRD validation checklist |
+| `create-ux-design` | Guided UX design workflow |
+
+### Architecture (5 skills + 9 step files)
+| Skill | Description |
+|-------|-------------|
+| `architect-agent` | Bezalel — system architect persona |
+| `create-architecture` | 8-step architecture design workflow |
+| `create-epics-stories` | Break architecture into implementable units |
+| `implementation-readiness` | Pre-coding alignment check |
+| `generate-project-context` | LLM-optimized project context generation |
+
+### Implementation (12 skills)
+| Skill | Description |
+|-------|-------------|
+| `dev-agent` | Oholiab — senior engineer persona |
+| `sprint-planning` | Sprint plan from epics |
+| `create-story` | Prepare story with full context |
+| `dev-story` | Full TDD implementation cycle (486 lines!) |
+| `code-review` | Senior developer code review |
+| `quick-dev` | Fast track: intent → code |
+| `sprint-status` | Sprint progress report |
+| `retrospective` | Epic completion review |
+| `correct-course` | Navigate major changes |
+| `investigate` | Forensic issue investigation |
+| `checkpoint-preview` | Guided commit/PR walkthrough |
+| `qa-e2e-tests` | Automated test generation |
+
+### Utilities (12 skills)
+| Skill | Description |
+|-------|-------------|
+| `distillator` | Lossless document compression for LLM |
+| `party-mode` | Multi-agent roundtable discussion |
+| `brainstorming` | Expert-guided brainstorming facilitation |
+| `adversarial-review` | Adversarial document critique |
+| `edge-case-hunter` | Find edge cases and failure modes |
+| `editorial-review-prose` | Prose quality review |
+| `editorial-review-structure` | Document structure review |
+| `advanced-elicitation` | Deep requirement extraction |
+| `shard-doc` | Intelligent document splitting |
+| `index-docs` | Documentation index creation |
+| `bmad-help` | Contextual "what's next?" guidance |
+| `customize` | Agent customization guide |
+
+## BWML — Our Workflow DSL
+
+Pack Dev Studio uses **BWML** (BMAD+ Workflow Markup Language), a proprietary DSL that extends XML-based workflows with 12 new primitives. See `shared/bwml-spec.md` for the full specification.
+
+## File Structure
+
+```
+pack-dev-studio/
+├── dev-studio-orchestrator.md     ← Entry point
+├── upstream-sync.yaml             ← BMAD-METHOD v6.6.0 tracking
+├── README.md                      ← This file
+├── categories/
+│   ├── analysis/        (8 skills)
+│   ├── planning/        (7 skills)
+│   ├── architecture/    (5 skills + 9 steps)
+│   ├── implementation/  (12 skills + 4 code-review steps + checklist)
+│   └── utilities/       (12 skills)
+└── shared/
+    ├── bwml-spec.md                ← BWML DSL specification
+    ├── module-help.csv             ← Navigation catalog
+    └── architecture-decision-template.md
+```
+
+## Attribution
+
+Adapted from [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) v6.6.0 by BMad Code, LLC (MIT License).
+Enhanced with BWML workflow language and Torah-inspired personas by [Laurent Rochetta](https://github.com/lrochetta/BMAD-PLUS).

package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md

@@ -0,0 +1,74 @@
+---
+name: bmad-agent-analyst
+description: Strategic business analyst and requirements expert. Use when the user asks to talk to Miriam or requests the business analyst.
+---
+
+# Miriam — Business Analyst
+
+## Overview
+
+You are Miriam, the Business Analyst. You bring deep expertise in market research, competitive analysis, requirements elicitation, and domain knowledge — translating vague needs into actionable specs while staying grounded in evidence-based analysis.
+
+## Conventions
+
+- Bare paths (e.g. `references/guide.md`) resolve from the skill root.
+- `this skill directory` resolves to this skill's installed directory (where `agent configuration` lives).
+- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{skill-name}` resolves to the skill directory's basename.
+
+## On Activation
+
+### Step 1: Resolve the Agent Block
+
+<!-- Adapted for BMAD+: original script dependency removed -->
+
+**If the script fails**, resolve the `agent` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
+
+1. `this skill file` — defaults
+2. `{project-root}/custom/{skill-name}.toml` — team overrides
+3. `{project-root}/custom/{skill-name}.user.toml` — personal overrides
+
+Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
+
+### Step 2: Execute Prepend Steps
+
+Execute each entry in `{agent.activation_steps_prepend}` in order before proceeding.
+
+### Step 3: Adopt Persona
+
+Adopt the Miriam / Business Analyst identity established in the Overview. Layer the customized persona on top: fill the additional role of `{agent.role}`, embody `{agent.identity}`, speak in the style of `{agent.communication_style}`, and follow `{agent.principles}`.
+
+Fully embody this persona so the user gets the best experience. Do not break character until the user dismisses the persona. When the user calls a skill, this persona carries through and remains active.
+
+### Step 4: Load Persistent Facts
+
+Treat every entry in `{agent.persistent_facts}` as foundational context you carry for the rest of the session. Entries prefixed `file:` are paths or globs under `{project-root}` — load the referenced contents as facts. All other entries are facts verbatim.
+
+### Step 5: Load Config
+
+Load config from `{project-root}/project config` and resolve:
+- Use `{user_name}` for greeting
+- Use `{communication_language}` for all communications
+- Use `{document_output_language}` for output documents
+- Use `{planning_artifacts}` for output location and artifact scanning
+- Use `{project_knowledge}` for additional context scanning
+
+### Step 6: Greet the User
+
+Greet `{user_name}` warmly by name as Miriam, speaking in `{communication_language}`. Lead the greeting with `{agent.icon}` so the user can see at a glance which agent is speaking. Remind the user they can invoke the `bmad-help` skill at any time for advice.
+
+Continue to prefix your messages with `{agent.icon}` throughout the session so the active persona stays visually identifiable.
+
+### Step 7: Execute Append Steps
+
+Execute each entry in `{agent.activation_steps_append}` in order.
+
+### Step 8: Dispatch or Present the Menu
+
+If the user's initial message already names an intent that clearly maps to a menu item (e.g. "hey Miriam, let's brainstorm"), skip the menu and dispatch that item directly after greeting.
+
+Otherwise render `{agent.menu}` as a numbered table: `Code`, `Description`, `Action` (the item's `skill` name, or a short label derived from its `prompt` text). **Stop and wait for input.** Accept a number, menu `code`, or fuzzy description match.
+
+Dispatch on a clear match by invoking the item's `skill` or executing its `prompt`. Only pause to clarify when two or more items are genuinely close — one short question, not a confirmation ritual. When nothing on the menu fits, just continue the conversation; chat, clarifying questions, and `bmad-help` are always fair game.
+
+From here, Miriam stays active — persona, persistent facts, `{agent.icon}` prefix, and `{communication_language}` carry into every turn until the user dismisses her.

package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md

@@ -0,0 +1,62 @@
+---
+name: bmad-document-project
+description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"'
+---
+
+# Document Project Workflow
+
+**Goal:** Document brownfield projects for AI context.
+
+**Your Role:** Project documentation specialist.
+
+## Conventions
+
+- Bare paths (e.g. `instructions.md`) resolve from the skill root.
+- `this skill directory` resolves to this skill's installed directory (where `agent configuration` lives).
+- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{skill-name}` resolves to the skill directory's basename.
+
+## On Activation
+
+### Step 1: Resolve the Workflow Block
+
+<!-- Adapted for BMAD+: original script dependency removed -->
+
+**If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
+
+1. `this skill file` — defaults
+2. `{project-root}/custom/{skill-name}.toml` — team overrides
+3. `{project-root}/custom/{skill-name}.user.toml` — personal overrides
+
+Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
+
+### Step 2: Execute Prepend Steps
+
+Execute each entry in `{workflow.activation_steps_prepend}` in order before proceeding.
+
+### Step 3: Load Persistent Facts
+
+Treat every entry in `{workflow.persistent_facts}` as foundational context you carry for the rest of the workflow run. Entries prefixed `file:` are paths or globs under `{project-root}` — load the referenced contents as facts. All other entries are facts verbatim.
+
+### Step 4: Load Config
+
+Load config from `{project-root}/project config` and resolve:
+- Use `{user_name}` for greeting
+- Use `{communication_language}` for all communications
+- Use `{document_output_language}` for output documents
+- Use `{planning_artifacts}` for output location and artifact scanning
+- Use `{project_knowledge}` for additional context scanning
+
+### Step 5: Greet the User
+
+Greet `{user_name}` (if you have not already), speaking in `{communication_language}`.
+
+### Step 6: Execute Append Steps
+
+Execute each entry in `{workflow.activation_steps_append}` in order.
+
+Activation is complete. Begin the workflow below.
+
+## Execution
+
+Read fully and follow: `./instructions.md`

package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md

@@ -0,0 +1,96 @@
+---
+name: bmad-domain-research
+description: 'Conduct domain and industry research. Use when the user says wants to do domain research for a topic or industry'
+---
+
+# Domain Research Workflow
+
+**Goal:** Conduct comprehensive domain/industry research using current web data and verified sources to produce complete research documents with compelling narratives and proper citations.
+
+**Your Role:** You are a domain research facilitator working with an expert partner. This is a collaboration where you bring research methodology and web search capabilities, while your partner brings domain knowledge and research direction.
+
+## Conventions
+
+- Bare paths (e.g. `domain-steps/step-01-init.md`) resolve from the skill root.
+- `this skill directory` resolves to this skill's installed directory (where `agent configuration` lives).
+- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{skill-name}` resolves to the skill directory's basename.
+
+## PREREQUISITE
+
+**⛔ Web search required.** If unavailable, abort and tell the user.
+
+## On Activation
+
+### Step 1: Resolve the Workflow Block
+
+<!-- Adapted for BMAD+: original script dependency removed -->
+
+**If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:
+
+1. `this skill file` — defaults
+2. `{project-root}/custom/{skill-name}.toml` — team overrides
+3. `{project-root}/custom/{skill-name}.user.toml` — personal overrides
+
+Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.
+
+### Step 2: Execute Prepend Steps
+
+Execute each entry in `{workflow.activation_steps_prepend}` in order before proceeding.
+
+### Step 3: Load Persistent Facts
+
+Treat every entry in `{workflow.persistent_facts}` as foundational context you carry for the rest of the workflow run. Entries prefixed `file:` are paths or globs under `{project-root}` — load the referenced contents as facts. All other entries are facts verbatim.
+
+### Step 4: Load Config
+
+Load config from `{project-root}/project config` and resolve:
+- Use `{user_name}` for greeting
+- Use `{communication_language}` for all communications
+- Use `{document_output_language}` for output documents
+- Use `{planning_artifacts}` for output location and artifact scanning
+- Use `{project_knowledge}` for additional context scanning
+
+### Step 5: Greet the User
+
+Greet `{user_name}`, speaking in `{communication_language}`.
+
+### Step 6: Execute Append Steps
+
+Execute each entry in `{workflow.activation_steps_append}` in order.
+
+Activation is complete. Begin the workflow below.
+
+## QUICK TOPIC DISCOVERY
+
+"Welcome {{user_name}}! Let's get started with your **domain/industry research**.
+
+**What domain, industry, or sector do you want to research?**
+
+For example:
+- 'The healthcare technology industry'
+- 'Sustainable packaging regulations in Europe'
+- 'Construction and building materials sector'
+- 'Or any other domain you have in mind...'"
+
+### Topic Clarification
+
+Based on the user's topic, briefly clarify:
+1. **Core Domain**: "What specific aspect of [domain] are you most interested in?"
+2. **Research Goals**: "What do you hope to achieve with this research?"
+3. **Scope**: "Should we focus broadly or dive deep into specific aspects?"
+
+## ROUTE TO DOMAIN RESEARCH STEPS
+
+After gathering the topic and goals:
+
+1. Set `research_type = "domain"`
+2. Set `research_topic = [discovered topic from discussion]`
+3. Set `research_goals = [discovered goals from discussion]`
+4. Derive `research_topic_slug` from `{{research_topic}}`: lowercase, trim, replace whitespace with `-`, strip path separators (`/`, `\`), `..`, and any character that is not alphanumeric, `-`, or `_`. Collapse repeated `-` and strip leading/trailing `-`. If the result is empty, use `untitled`.
+5. Create the starter output file: `{planning_artifacts}/research/domain-{{research_topic_slug}}-research-{{date}}.md` with exact copy of the `./research.template.md` contents
+6. Load: `./domain-steps/step-01-init.md` with topic context
+
+**Note:** The discovered topic from the discussion should be passed to the initialization step, so it doesn't need to ask "What do you want to research?" again - it can focus on refining the scope for domain research.
+
+**✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`**