bmad-studio 0.1.0

package/_bmad/_config/ides/claude-code.yaml

@@ -0,0 +1,5 @@
+ide: claude-code
+configured_date: 2026-03-17T01:03:21.264Z
+last_updated: 2026-03-17T01:03:21.264Z
+configuration:
+  _noConfigNeeded: true

package/_bmad/_config/manifest.yaml

@@ -0,0 +1,42 @@
+installation:
+  version: 6.2.0
+  installDate: 2026-03-17T01:03:21.085Z
+  lastUpdated: 2026-03-17T01:03:21.085Z
+modules:
+  - name: core
+    version: 6.2.0
+    installDate: 2026-03-17T01:03:20.568Z
+    lastUpdated: 2026-03-17T01:03:20.568Z
+    source: built-in
+    npmPackage: null
+    repoUrl: null
+  - name: bmm
+    version: 6.2.0
+    installDate: 2026-03-17T01:03:16.573Z
+    lastUpdated: 2026-03-17T01:03:20.568Z
+    source: built-in
+    npmPackage: null
+    repoUrl: null
+  - name: bmb
+    version: 1.0.2
+    installDate: 2026-03-17T01:03:17.897Z
+    lastUpdated: 2026-03-17T01:03:20.830Z
+    source: external
+    npmPackage: bmad-builder
+    repoUrl: https://github.com/bmad-code-org/bmad-builder
+  - name: tea
+    version: 1.7.0
+    installDate: 2026-03-17T01:03:19.385Z
+    lastUpdated: 2026-03-17T01:03:21.085Z
+    source: external
+    npmPackage: bmad-method-test-architecture-enterprise
+    repoUrl: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise
+  - name: dept-aem
+    version: 1.0.0
+    installDate: '2026-03-21T13:02:12.857Z'
+    lastUpdated: '2026-03-21T13:02:12.857Z'
+    source: custom
+    npmPackage: null
+    repoUrl: null
+ides:
+  - claude-code

package/_bmad/_config/skill-manifest.csv

@@ -0,0 +1,48 @@
+canonicalId,name,description,module,path,install_to_bmad
+"bmad-advanced-elicitation","bmad-advanced-elicitation","Push the LLM to reconsider, refine, and improve its recent output.","core","_bmad/core/skills/bmad-advanced-elicitation/SKILL.md","true"
+"bmad-brainstorming","bmad-brainstorming","Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods. Use when the user says help me brainstorm or help me ideate.","core","_bmad/core/skills/bmad-brainstorming/SKILL.md","true"
+"bmad-distillator","bmad-distillator","Lossless LLM-optimized compression of source documents. Use when the user requests to 'distill documents' or 'create a distillate'.","core","_bmad/core/skills/bmad-distillator/SKILL.md","true"
+"bmad-editorial-review-prose","bmad-editorial-review-prose","Clinical copy-editor that reviews text for communication issues. Use when user says review for prose or improve the prose","core","_bmad/core/skills/bmad-editorial-review-prose/SKILL.md","true"
+"bmad-editorial-review-structure","bmad-editorial-review-structure","Structural editor that proposes cuts, reorganization, and simplification while preserving comprehension. Use when user requests structural review or editorial review of structure","core","_bmad/core/skills/bmad-editorial-review-structure/SKILL.md","true"
+"bmad-help","bmad-help","Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad","core","_bmad/core/skills/bmad-help/SKILL.md","true"
+"bmad-index-docs","bmad-index-docs","Generates or updates an index.md to reference all docs in the folder. Use if user requests to create or update an index of all files in a specific folder","core","_bmad/core/skills/bmad-index-docs/SKILL.md","true"
+"bmad-party-mode","bmad-party-mode","Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations. Use when user requests party mode.","core","_bmad/core/skills/bmad-party-mode/SKILL.md","true"
+"bmad-review-adversarial-general","bmad-review-adversarial-general","Perform a Cynical Review and produce a findings report. Use when the user requests a critical review of something","core","_bmad/core/skills/bmad-review-adversarial-general/SKILL.md","true"
+"bmad-review-edge-case-hunter","bmad-review-edge-case-hunter","Walk every branching path and boundary condition in content, report only unhandled edge cases. Orthogonal to adversarial review - method-driven not attitude-driven. Use when you need exhaustive edge-case analysis of code, specs, or diffs.","core","_bmad/core/skills/bmad-review-edge-case-hunter/SKILL.md","true"
+"bmad-shard-doc","bmad-shard-doc","Splits large markdown documents into smaller, organized files based on level 2 (default) sections. Use if the user says perform shard document","core","_bmad/core/skills/bmad-shard-doc/SKILL.md","true"
+"bmad-create-prd","bmad-create-prd","Create a PRD from scratch. Use when the user says ""lets create a product requirements document"" or ""I want to create a new PRD""","core","_bmad/core/tasks/bmad-create-prd/SKILL.md","true"
+"bmad-create-product-brief","bmad-create-product-brief","Create product brief through collaborative discovery. Use when the user says ""lets create a product brief"" or ""help me create a project brief""","bmm","_bmad/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md","true"
+"bmad-product-brief-preview","bmad-product-brief-preview","Create or update product briefs through guided or autonomous discovery. Use when the user requests to 'create a product brief', 'help me create a project brief', or 'update my product brief'.","bmm","_bmad/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md","true"
+"bmad-domain-research","bmad-domain-research","Conduct domain and industry research. Use when the user says ""lets create a research report on [domain or industry]""","bmm","_bmad/bmm/workflows/1-analysis/research/bmad-domain-research/SKILL.md","true"
+"bmad-market-research","bmad-market-research","Conduct market research on competition and customers. Use when the user says ""create a market research report about [business idea]"".","bmm","_bmad/bmm/workflows/1-analysis/research/bmad-market-research/SKILL.md","true"
+"bmad-technical-research","bmad-technical-research","Conduct technical research on technologies and architecture. Use when the user says ""create a technical research report on [topic]"".","bmm","_bmad/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md","true"
+"bmad-create-ux-design","bmad-create-ux-design","Plan UX patterns and design specifications. Use when the user says ""lets create UX design"" or ""create UX specifications"" or ""help me plan the UX""","bmm","_bmad/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md","true"
+"bmad-edit-prd","bmad-edit-prd","Edit an existing PRD. Use when the user says ""edit this PRD"".","bmm","_bmad/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md","true"
+"bmad-validate-prd","bmad-validate-prd","Validate a PRD against standards. Use when the user says ""validate this PRD"" or ""run PRD validation""","bmm","_bmad/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md","true"
+"bmad-check-implementation-readiness","bmad-check-implementation-readiness","Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says ""check implementation readiness"".","bmm","_bmad/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/SKILL.md","true"
+"bmad-create-architecture","bmad-create-architecture","Create architecture solution design decisions for AI agent consistency. Use when the user says ""lets create architecture"" or ""create technical architecture"" or ""create a solution design""","bmm","_bmad/bmm/workflows/3-solutioning/bmad-create-architecture/SKILL.md","true"
+"bmad-create-epics-and-stories","bmad-create-epics-and-stories","Break requirements into epics and user stories. Use when the user says ""create the epics and stories list""","bmm","_bmad/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/SKILL.md","true"
+"bmad-code-review","bmad-code-review","Review code changes adversarially using parallel review layers (Blind Hunter, Edge Case Hunter, Acceptance Auditor) with structured triage into actionable categories. Use when the user says ""run code review"" or ""review this code""","bmm","_bmad/bmm/workflows/4-implementation/bmad-code-review/SKILL.md","true"
+"bmad-correct-course","bmad-correct-course","Manage significant changes during sprint execution. Use when the user says ""correct course"" or ""propose sprint change""","bmm","_bmad/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md","true"
+"bmad-create-story","bmad-create-story","Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says ""create the next story"" or ""create story [story identifier]""","bmm","_bmad/bmm/workflows/4-implementation/bmad-create-story/SKILL.md","true"
+"bmad-dev-story","bmad-dev-story","Execute story implementation following a context filled story spec file. Use when the user says ""dev this story [story file]"" or ""implement the next story in the sprint plan""","bmm","_bmad/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md","true"
+"bmad-retrospective","bmad-retrospective","Post-epic review to extract lessons and assess success. Use when the user says ""run a retrospective"" or ""lets retro the epic [epic]""","bmm","_bmad/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md","true"
+"bmad-sprint-planning","bmad-sprint-planning","Generate sprint status tracking from epics. Use when the user says ""run sprint planning"" or ""generate sprint plan""","bmm","_bmad/bmm/workflows/4-implementation/bmad-sprint-planning/SKILL.md","true"
+"bmad-sprint-status","bmad-sprint-status","Summarize sprint status and surface risks. Use when the user says ""check sprint status"" or ""show sprint status""","bmm","_bmad/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md","true"
+"bmad-document-project","bmad-document-project","Document brownfield projects for AI context. Use when the user says ""document this project"" or ""generate project docs""","bmm","_bmad/bmm/workflows/bmad-document-project/SKILL.md","true"
+"bmad-generate-project-context","bmad-generate-project-context","Create project-context.md with AI rules. Use when the user says ""generate project context"" or ""create project context""","bmm","_bmad/bmm/workflows/bmad-generate-project-context/SKILL.md","true"
+"bmad-qa-generate-e2e-tests","bmad-qa-generate-e2e-tests","Generate end to end automated tests for existing features. Use when the user says ""create qa automated tests for [feature]""","bmm","_bmad/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md","true"
+"bmad-quick-dev","bmad-quick-dev","Implement a Quick Tech Spec for small changes or features. Use when the user provides a quick tech spec and says ""implement this quick spec"" or ""proceed with implementation of [quick tech spec]""","bmm","_bmad/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md","true"
+"bmad-quick-dev-new-preview","bmad-quick-dev-new-preview","Implements any user intent, requirement, story, bug fix or change request by producing clean working code artifacts that follow the project's existing architecture, patterns and conventions. Use when the user wants to build, fix, tweak, refactor, add or modify any code, component or feature.","bmm","_bmad/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md","true"
+"bmad-quick-spec","bmad-quick-spec","Very quick process to create implementation-ready quick specs for small changes or features. Use when the user says ""create a quick spec"" or ""generate a quick tech spec""","bmm","_bmad/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md","true"
+"bmad-agent-builder","bmad-agent-builder","Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to ""Create an Agent"", ""Optimize an Agent"" or ""Edit an Agent"".","bmb","_bmad/bmb/skills/bmad-agent-builder/SKILL.md","true"
+"bmad-workflow-builder","bmad-workflow-builder","Builds workflows and skills through conversational discovery and validates existing ones. Use when the user requests to ""build a workflow"", ""modify a workflow"", ""quality check workflow"", or ""optimize skill"".","bmb","_bmad/bmb/skills/bmad-workflow-builder/SKILL.md","true"
+"bmad-teach-me-testing","bmad-teach-me-testing","Teach testing progressively through structured sessions. Use when user says ""lets learn testing"" or ""I want to study test practices""","tea","_bmad/tea/workflows/testarch/bmad-teach-me-testing/SKILL.md","true"
+"bmad-testarch-atdd","bmad-testarch-atdd","Generate failing acceptance tests using TDD cycle. Use when the user says ""lets write acceptance tests"" or ""I want to do ATDD""","tea","_bmad/tea/workflows/testarch/bmad-testarch-atdd/SKILL.md","true"
+"bmad-testarch-automate","bmad-testarch-automate","Expand test automation coverage for codebase. Use when user says ""lets expand test coverage"" or ""I want to automate tests""","tea","_bmad/tea/workflows/testarch/bmad-testarch-automate/SKILL.md","true"
+"bmad-testarch-ci","bmad-testarch-ci","Scaffold CI/CD quality pipeline with test execution. Use when the user says ""lets setup CI pipeline"" or ""I want to create quality gates""","tea","_bmad/tea/workflows/testarch/bmad-testarch-ci/SKILL.md","true"
+"bmad-testarch-framework","bmad-testarch-framework","Initialize test framework with Playwright or Cypress. Use when the user says ""lets setup test framework"" or ""I want to initialize testing framework""","tea","_bmad/tea/workflows/testarch/bmad-testarch-framework/SKILL.md","true"
+"bmad-testarch-nfr","bmad-testarch-nfr","Assess NFRs like performance security and reliability. Use when the user says ""lets assess NFRs"" or ""I want to evaluate non-functional requirements""","tea","_bmad/tea/workflows/testarch/bmad-testarch-nfr/SKILL.md","true"
+"bmad-testarch-test-design","bmad-testarch-test-design","Create system-level or epic-level test plans. Use when the user says ""lets design test plan"" or ""I want to create test strategy""","tea","_bmad/tea/workflows/testarch/bmad-testarch-test-design/SKILL.md","true"
+"bmad-testarch-test-review","bmad-testarch-test-review","Review test quality using best practices validation. Use when user says ""lets review tests"" or ""I want to evaluate test quality""","tea","_bmad/tea/workflows/testarch/bmad-testarch-test-review/SKILL.md","true"
+"bmad-testarch-trace","bmad-testarch-trace","Generate traceability matrix and quality gate decision. Use when the user says ""lets create traceability matrix"" or ""I want to analyze test coverage""","tea","_bmad/tea/workflows/testarch/bmad-testarch-trace/SKILL.md","true"

package/_bmad/_config/task-manifest.csv

@@ -0,0 +1 @@
+name,displayName,description,module,path,standalone,canonicalId

package/_bmad/_config/tool-manifest.csv

@@ -0,0 +1 @@
+name,displayName,description,module,path,standalone,canonicalId

package/_bmad/_config/workflow-manifest.csv

@@ -0,0 +1 @@
+name,description,module,path,canonicalId

package/_bmad/bmb/config.yaml

@@ -0,0 +1,13 @@
+# BMB Module Configuration
+# Generated by BMAD installer
+# Version: 6.2.0
+# Date: 2026-03-17T01:03:20.532Z
+
+bmad_builder_output_folder: "{project-root}/_bmad-output/skills"
+bmad_builder_reports: "{project-root}/_bmad-output/reports"
+
+# Core Configuration Values
+user_name: Jonathan
+communication_language: English
+document_output_language: English
+output_folder: "{project-root}/_bmad-output"

package/_bmad/bmb/module-help.csv

@@ -0,0 +1,7 @@
+module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs,
+bmb,anytime,Create Agent,CA,,skill:bmad-agent-builder,bmad-agent-builder,false,,Create Mode,"Build a new agent skill from scratch through guided conversational discovery.",output_folder,"agent skill",
+bmb,anytime,Edit Agent,EA,,skill:bmad-agent-builder,bmad-agent-builder,false,,Edit Mode,"Edit, convert or fix an existing agent skill.",output_folder,"agent skill",
+bmb,anytime,Optimize Agent,OA,,skill:bmad-agent-builder,bmad-agent-builder,false,,Validate Mode,"Quality check, validate, review or optimize an existing agent skill.",output_folder,"quality report",
+bmb,anytime,Create Workflow,CW,,skill:bmad-workflow-builder,bmad-workflow-builder,false,,Create Mode,"Build a new workflow or skill from scratch through guided conversational discovery.",output_folder,"workflow or skill",
+bmb,anytime,Edit Workflow,EW,,skill:bmad-workflow-builder,bmad-workflow-builder,false,,Edit Mode,"Edit, convert or fix an existing workflow or skill.",output_folder,"workflow or skill",
+bmb,anytime,Optimize Workflow,OW,,skill:bmad-workflow-builder,bmad-workflow-builder,false,,Validate Mode,"Quality check, validate, review or optimize an existing workflow or skill.",output_folder,"quality report",

package/_bmad/bmb/skills/bmad-agent-builder/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: bmad-agent-builder
+description: Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".
+argument-hint: "--headless or -H to not prompt user, initial input for create, path to existing skill with keywords optimize, edit, validate"
+---
+
+# Agent Builder
+
+## Overview
+
+This skill helps you build AI agents through conversational discovery and iterative refinement. Act as an architect guide, walking users through six phases: intent discovery, capabilities strategy, requirements gathering, drafting, building, and testing. Your output is a complete skill structure — named personas with optional memory, capabilities, and autonomous modes — ready to integrate into the BMad Method ecosystem.
+
+## Vision: Build More, Architect Dreams
+
+You're helping dreamers, builders, doers, and visionaries create the AI agents of their dreams.
+
+**What they're building:**
+
+Agents are **skills with named personas, capabilities and optional memory** — not just simple menu systems, workflow routers or wrappers. An agent is someone you talk to. It may have capabilities it knows how to do internally. It may work with external skills. Those skills might come from a module that bundles everything together. When you launch an agent it knows you, remembers you, reminds you of things you may have even forgotten, help create insights, and is your operational assistant in any regard the user will desire. Your mission: help users build agents that truly serve them — capturing their vision completely, even the parts they haven't articulated yet. Probe deeper, suggest what they haven't considered, and build something that exceeds what they imagined.
+
+**The bigger picture:**
+
+These agents become part of the BMad Method ecosystem — personal companions that remember, domain experts for any field, workflow facilitators, entire modules for limitless purposes.
+
+**Your output:** A skill structure that wraps the agent persona, ready to integrate into a module or use standalone.
+
+## On Activation
+
+1. Load bmb config variables via `bmad-init` skill — store as `{var-name}` for all vars returned. If the skill does not exist, do your best to infer the users name and language. Greet user as `{user_name}`, use `{communication_language}` for all communications.
+
+2. Detect user's intent from their request:
+
+**Autonomous/Headless Mode Detection:** If the user passes `--headless` or`-H` flags, or if their intent clearly indicates non-interactive execution, set `{headless_mode}=true` and pass to all sub-prompts.
+
+3. Route by intent.
+
+## Build Process
+
+This is the core creative path — where agent ideas become reality. Through six phases of conversational discovery, you guide users from a rough vision to a complete, tested agent skill structure. This covers building new agents from scratch, converting non-compliant formats, editing existing agents, and applying improvements or fixes.
+
+Agents are named personas with optional memory, capabilities, autonomous modes, and personality. The build process includes a lint gate for structural validation. When building or modifying agents that include scripts, unit tests are created alongside the scripts and run as part of validation.
+
+Load `build-process.md` to begin.
+
+## Quality Optimizer
+
+For agents that already work but could work *better*. This is comprehensive validation and performance optimization — structure compliance, prompt craft, execution efficiency, enhancement opportunities, and more. Uses deterministic lint scripts for instant structural checks and LLM scanner subagents for judgment-based analysis, all run in parallel.
+
+Run this anytime you want to assess and improve an existing agent's quality.
+
+Load `quality-optimizer.md` — it orchestrates everything including scan modes, autonomous handling, and remediation options.
+
+---
+
+## Quick Reference
+
+| Intent | Trigger Phrases | Route |
+|--------|----------------|-------|
+| **Builder** | "build/create/design/convert/edit/fix an agent", "new agent" | Load `build-process.md` |
+| **Quality Optimizer** | "quality check", "validate", "review/optimize/improve agent" | Load `quality-optimizer.md` |
+| **Unclear** | — | Present the two options above and ask |
+
+Pass `{headless_mode}` flag to all routes. Use Todo List to track progress through multi-step flows. Use subagents for parallel work (quality scanners, web research or document review).
+
+Help the user create amazing Agents!

package/_bmad/bmb/skills/bmad-agent-builder/assets/SKILL-template.md

@@ -0,0 +1,97 @@
+---
+name: bmad-{module-code-or-empty}-agent-{agent-name}
+description: {skill-description} # Format: [4-6 word summary]. [trigger: "User wants to talk to or ask {displayName}" or "{title}" or "{role}"]
+---
+
+# {displayName}
+
+## Overview
+
+{overview-template}
+
+{if-headless}
+## Activation Mode Detection
+
+**Check activation context immediately:**
+
+1. **Autonomous mode**: Skill invoked with `--headless` or `-H` flag or with task parameter
+   - Look for `--headless` in the activation context
+   - If `--headless:{task-name}` → run that specific autonomous task
+   - If just `--headless` → run default autonomous wake behavior
+   - Load and execute `headless-wake.md` with task context
+   - Do NOT load config, do NOT greet user, do NOT show menu
+   - Execute task, write results, exit silently
+
+2. **Interactive mode** (default): User invoked the skill directly
+   - Proceed to `## On Activation` section below
+
+**Example headless activation:**
+```bash
+# Autonomous - default wake
+/bmad-{agent-skill-name} --headless
+
+# Autonomous - specific task
+/bmad-{agent-skill-name} --headless:refine-memories
+```
+{/if-headless}
+
+## Identity
+{Who is this agent? One clear sentence.}
+
+## Communication Style
+{How does this agent communicate? Be specific with examples.}
+
+## Principles
+- {Guiding principle 1}
+- {Guiding principle 2}
+- {Guiding principle 3}
+
+{if-sidecar}
+## Sidecar
+Memory location: `_bmad/_memory/{skillName}-sidecar/`
+
+Load `references/memory-system.md` for memory discipline and structure.
+{/if-sidecar}
+
+## On Activation
+
+1. **Load config via bmad-init skill** — Store all returned vars for use:
+   - Use `{user_name}` from config for greeting
+   - Use `{communication_language}` from config for all communications
+   - Store any other config variables as `{var-name}` and use appropriately
+
+{if-autonomous}
+2. **If autonomous mode** — Load and run `autonomous-wake.md` (default wake behavior), or load the specified prompt and execute its autonomous section without interaction
+
+3. **If interactive mode** — Continue with steps below:
+{/if-autonomous}
+{if-no-autonomous}
+2. **Continue with steps below:**
+{/if-no-autonomous}
+   {if-sidecar}- **Check first-run** — If no `{skillName}-sidecar/` folder exists in `_bmad/_memory/`, load `init.md` for first-run setup
+   - **Load access boundaries** — Read `_bmad/_memory/{skillName}-sidecar/access-boundaries.md` to enforce read/write/deny zones (load before any file operations)
+   - **Load memory** — Read `_bmad/_memory/{skillName}-sidecar/index.md` for essential context and previous session{/if-sidecar}
+   - **Load manifest** — Read `bmad-manifest.json` to set `{capabilities}` list of actions the agent can perform (internal prompts and available skills)
+   - **Greet the user** — Welcome `{user_name}`, speaking in `{communication_language}` and applying your persona and principles throughout the session
+   {if-sidecar}- **Check for autonomous updates** — Briefly check if autonomous tasks ran since last session and summarize any changes{/if-sidecar}
+   - **Present menu from bmad-manifest.json** — Generate menu dynamically by reading all capabilities from bmad-manifest.json:
+
+   ```
+   {if-sidecar}Last time we were working on X. Would you like to continue, or:{/if-sidecar}{if-no-sidecar}What would you like to do today?{/if-no-sidecar}
+
+   {if-sidecar}💾 **Tip:** You can ask me to save our progress to memory at any time.{/if-sidecar}
+
+   **Available capabilities:**
+   (For each capability in bmad-manifest.json capabilities array, display as:)
+   {number}. [{menu-code}] - {description} → {prompt}:{name} or {skill}:{name}
+   ```
+
+   **Menu generation rules:**
+   - Read bmad-manifest.json and iterate through `capabilities` array
+   - For each capability: show sequential number, menu-code in brackets, description, and invocation type
+   - Type `prompt` → show `prompt:{name}`, type `skill` → show `skill:{name}`
+   - DO NOT hardcode menu examples — generate from actual manifest data
+
+**CRITICAL Handling:** When user selects a code/number, consult the bmad-manifest.json capability mapping:
+- **prompt:{name}** — Load and use the actual prompt from `{name}.md` — DO NOT invent the capability on the fly
+- **skill:{name}** — Invoke the skill by its exact registered name

package/_bmad/bmb/skills/bmad-agent-builder/assets/autonomous-wake.md

@@ -0,0 +1,37 @@
+---
+name: autonomous-wake
+description: Default autonomous wake behavior — runs when --headless or -H is passed with no specific task.
+---
+
+# Autonomous Wake
+
+You're running autonomously. No one is here. No task was specified. Execute your default wake behavior and exit.
+
+## Context
+
+- Memory location: `_bmad/_memory/{skillName}-sidecar/`
+- Activation time: `{current-time}`
+
+## Instructions
+
+- Don't ask questions
+- Don't wait for input
+- Don't greet anyone
+- Execute your default wake behavior
+- Write results to memory
+- Exit
+
+## Default Wake Behavior
+
+{default-autonomous-behavior}
+
+## Logging
+
+Append to `_bmad/_memory/{skillName}-sidecar/autonomous-log.md`:
+
+```markdown
+## {YYYY-MM-DD HH:MM} - Autonomous Wake
+
+- Status: {completed|actions taken}
+- {relevant-details}
+```

package/_bmad/bmb/skills/bmad-agent-builder/assets/init-template.md

@@ -0,0 +1,47 @@
+{if-module}
+# First-Run Setup for {displayName}
+
+Welcome! Setting up your workspace.
+
+## Memory Location
+
+Creating `_bmad/_memory/{skillName}-sidecar/` for persistent memory.
+
+## Initial Structure
+
+Creating:
+- `index.md` — essential context, active work
+- `patterns.md` — your preferences I learn
+- `chronology.md` — session timeline
+
+Configuration will be loaded from your module's config.yaml.
+
+{custom-init-questions}
+
+## Ready
+
+Setup complete! I'm ready to help.
+{/if-module}
+
+{if-standalone}
+# First-Run Setup for {displayName}
+
+Welcome! Let me set up for this environment.
+
+## Memory Location
+
+Creating `_bmad/_memory/{skillName}-sidecar/` for persistent memory.
+
+{custom-init-questions}
+
+## Initial Structure
+
+Creating:
+- `index.md` — essential context, active work, saved paths above
+- `patterns.md` — your preferences I learn
+- `chronology.md` — session timeline
+
+## Ready
+
+Setup complete! I'm ready to help.
+{/if-standalone}

package/_bmad/bmb/skills/bmad-agent-builder/assets/memory-system.md

@@ -0,0 +1,129 @@
+# Memory System for {displayName}
+
+**Memory location:** `_bmad/_memory/{skillName}-sidecar/`
+
+## Core Principle
+
+Tokens are expensive. Only remember what matters. Condense everything to its essence.
+
+## File Structure
+
+### `index.md` — Primary Source
+
+**Load on activation.** Contains:
+- Essential context (what we're working on)
+- Active work items
+- User preferences (condensed)
+- Quick reference to other files if needed
+
+**Update:** When essential context changes (immediately for critical data).
+
+### `access-boundaries.md` — Access Control (Required for all agents)
+
+**Load on activation.** Contains:
+- **Read access** — Folders/patterns this agent can read from
+- **Write access** — Folders/patterns this agent can write to
+- **Deny zones** — Explicitly forbidden folders/patterns
+- **Created by** — Agent builder at creation time, confirmed/adjusted during init
+
+**Template structure:**
+```markdown
+# Access Boundaries for {displayName}
+
+## Read Access
+- {folder-path-or-pattern}
+- {another-folder-or-pattern}
+
+## Write Access
+- {folder-path-or-pattern}
+- {another-folder-or-pattern}
+
+## Deny Zones
+- {explicitly-forbidden-path}
+```
+
+**Critical:** On every activation, load these boundaries first. Before any file operation (read/write), verify the path is within allowed boundaries. If uncertain, ask user.
+
+{if-standalone}
+- **User-configured paths** — Additional paths set during init (journal location, etc.) are appended here
+{/if-standalone}
+
+### `patterns.md` — Learned Patterns
+
+**Load when needed.** Contains:
+- User's quirks and preferences discovered over time
+- Recurring patterns or issues
+- Conventions learned
+
+**Format:** Append-only, summarized regularly. Prune outdated entries.
+
+### `chronology.md` — Timeline
+
+**Load when needed.** Contains:
+- Session summaries
+- Significant events
+- Progress over time
+
+**Format:** Append-only. Prune regularly; keep only significant events.
+
+## Memory Persistence Strategy
+
+### Write-Through (Immediate Persistence)
+
+Persist immediately when:
+1. **User data changes** — preferences, configurations
+2. **Work products created** — entries, documents, code, artifacts
+3. **State transitions** — tasks completed, status changes
+4. **User requests save** — explicit `[SM] - Save Memory` capability
+
+### Checkpoint (Periodic Persistence)
+
+Update periodically after:
+- N interactions (default: every 5-10 significant exchanges)
+- Session milestones (completing a capability/task)
+- When file grows beyond target size
+
+### Save Triggers
+
+**After these events, always update memory:**
+- {save-trigger-1}
+- {save-trigger-2}
+- {save-trigger-3}
+
+**Memory is updated via the `[SM] - Save Memory` capability which:**
+1. Reads current index.md
+2. Updates with current session context
+3. Writes condensed, current version
+4. Checkpoints patterns.md and chronology.md if needed
+
+## Write Discipline
+
+Before writing to memory, ask:
+
+1. **Is this worth remembering?**
+   - If no → skip
+   - If yes → continue
+
+2. **What's the minimum tokens that capture this?**
+   - Condense to essence
+   - No fluff, no repetition
+
+3. **Which file?**
+   - `index.md` → essential context, active work
+   - `patterns.md` → user quirks, recurring patterns, conventions
+   - `chronology.md` → session summaries, significant events
+
+4. **Does this require index update?**
+   - If yes → update `index.md` to point to it
+
+## Memory Maintenance
+
+Regularly (every few sessions or when files grow large):
+1. **Condense verbose entries** — Summarize to essence
+2. **Prune outdated content** — Move old items to chronology or remove
+3. **Consolidate patterns** — Merge similar entries
+4. **Update chronology** — Archive significant past events
+
+## First Run
+
+If sidecar doesn't exist, load `init.md` to create the structure.