bmad-method 6.0.0-alpha.8 → 6.0.1

package/website/src/styles/custom.css

@@ -0,0 +1,509 @@
+/**
+ * BMAD Method Documentation - Custom Styles for Starlight
+ * Electric Blue theme optimized for dark mode
+ *
+ * CSS Variable Mapping:
+ * Docusaurus → Starlight
+ * --ifm-color-primary → --sl-color-accent
+ * --ifm-background-color → --sl-color-bg
+ * --ifm-font-color-base → --sl-color-text
+ */
+
+/* ============================================
+   COLOR PALETTE - Light Mode
+   ============================================ */
+:root {
+  --ai-banner-height: 2.75rem;
+  --sl-nav-height: 6.25rem; /* Base nav height (~3.5rem) + banner height (2.75rem) */
+
+  /* Full-width content - override Starlight's default 45rem/67.5rem */
+  --sl-content-width: 65rem;
+
+  /* Primary accent colors - purple to match Docusaurus */
+  --sl-color-accent-low: #e0e0ff;
+  --sl-color-accent: #5E5ED0;
+  --sl-color-accent-high: #3333CC;
+
+  /* Text colors */
+  --sl-color-white: #1e293b;
+  --sl-color-gray-1: #334155;
+  --sl-color-gray-2: #475569;
+  --sl-color-gray-3: #64748b;
+  --sl-color-gray-4: #94a3b8;
+  --sl-color-gray-5: #cbd5e1;
+  --sl-color-gray-6: #e2e8f0;
+  --sl-color-black: #f8fafc;
+
+  /* Font settings */
+  --sl-font: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue',
+    Arial, sans-serif;
+  --sl-text-base: 1rem;
+  --sl-line-height: 1.7;
+
+  /* Code highlighting */
+  --sl-color-bg-inline-code: rgba(94, 94, 208, 0.1);
+}
+
+/* ============================================
+   COLOR PALETTE - Dark Mode (Primary Focus)
+   ============================================ */
+:root[data-theme='dark'] {
+  /* Full-width content - override Starlight's default */
+  --sl-content-width: 65rem;
+
+  /* Primary accent colors - purple to match Docusaurus */
+  --sl-color-accent-low: #2a2a5a;
+  --sl-color-accent: #8C8CFF;
+  --sl-color-accent-high: #B9B9FF;
+
+  /* Background colors */
+  --sl-color-bg: #1b1b1d;
+  --sl-color-bg-nav: #1b1b1d;
+  --sl-color-bg-sidebar: #1b1b1d;
+  --sl-color-hairline-light: rgba(140, 140, 255, 0.1);
+  --sl-color-hairline: rgba(140, 140, 255, 0.15);
+
+  /* Text colors */
+  --sl-color-white: #f8fafc;
+  --sl-color-gray-1: #e2e8f0;
+  --sl-color-gray-2: #cbd5e1;
+  --sl-color-gray-3: #94a3b8;
+  --sl-color-gray-4: #64748b;
+  --sl-color-gray-5: #475569;
+  --sl-color-gray-6: #334155;
+  --sl-color-black: #1b1b1d;
+
+  /* Code highlighting */
+  --sl-color-bg-inline-code: rgba(140, 140, 255, 0.15);
+}
+
+/* ============================================
+   TYPOGRAPHY
+   ============================================ */
+.sl-markdown-content h1 {
+  margin-bottom: 1.5rem;
+}
+
+.sl-markdown-content h2 {
+  margin-top: 2.5rem;
+  margin-bottom: 1rem;
+}
+
+.sl-markdown-content h3 {
+  margin-top: 2rem;
+  margin-bottom: 0.75rem;
+}
+
+.sl-markdown-content p {
+  margin-bottom: 1.25rem;
+}
+
+/* ============================================
+   SIDEBAR & NAVIGATION
+   Clean styling inspired by React Native docs
+   ============================================ */
+
+/* Base transition for all sidebar links */
+.sidebar-content a {
+  transition:
+    background-color 0.15s ease,
+    color 0.15s ease,
+    border-color 0.15s ease;
+  border-radius: 4px;
+}
+
+/* Top-level sidebar items (Diataxis categories) */
+.sidebar-content > ul > li > details > summary,
+.sidebar-content > ul > li > a {
+  font-weight: 700;
+  font-size: 0.9375rem;
+  padding: 0.5rem 0.75rem;
+}
+
+/* Nested sidebar items */
+.sidebar-content ul ul a {
+  font-weight: 500;
+  font-size: 0.875rem;
+  padding: 0.375rem 0.75rem;
+  padding-left: 1.5rem;
+  border-left: 3px solid transparent;
+}
+
+/* Deep nested items */
+.sidebar-content ul ul ul a {
+  font-weight: 400;
+  font-size: 0.8125rem;
+  padding-left: 2.25rem;
+}
+
+/* Active state - thin left accent bar */
+.sidebar-content a[aria-current='page'] {
+  background-color: rgba(94, 94, 208, 0.08);
+  color: var(--sl-color-accent);
+  border-left-color: var(--sl-color-accent);
+  font-weight: 600;
+}
+
+:root[data-theme='dark'] .sidebar-content a[aria-current='page'] {
+  background-color: rgba(140, 140, 255, 0.1);
+  color: var(--sl-color-accent-high);
+  border-left-color: var(--sl-color-accent);
+}
+
+/* Hover states */
+.sidebar-content a:hover {
+  background-color: rgba(0, 0, 0, 0.05);
+}
+
+:root[data-theme='dark'] .sidebar-content a:hover {
+  background-color: rgba(255, 255, 255, 0.05);
+}
+
+/* Section spacing */
+.sidebar-content > ul > li {
+  margin-top: 0.75rem;
+}
+
+.sidebar-content > ul > li:first-child {
+  margin-top: 0;
+}
+
+/* Lighter chevrons/carets */
+.sidebar-content summary::marker,
+.sidebar-content details > summary::after {
+  opacity: 0.4;
+}
+
+.sidebar-content summary:hover::marker,
+.sidebar-content details > summary:hover::after {
+  opacity: 0.6;
+}
+
+/* ============================================
+   LAYOUT - Full width content
+   ============================================ */
+.content-panel {
+  width: 100%;
+  margin: 0 auto;
+}
+
+/* Full-width workflow diagram iframe */
+.sl-markdown-content > iframe:first-child {
+  width: 100vw !important;
+  margin-left: calc(50% - 50vw);
+  border-radius: 0 !important;
+  border-left: none !important;
+  border-right: none !important;
+}
+
+/* Main content area */
+main {
+  min-width: 0;
+}
+
+.sl-markdown-content {
+  min-width: 0;
+  overflow-wrap: break-word;
+  word-wrap: break-word;
+}
+
+/* Hide breadcrumbs if desired */
+/* Uncomment to hide:
+nav[aria-label="Breadcrumb"] {
+  display: none;
+}
+*/
+
+/* ============================================
+   NAVBAR
+   ============================================ */
+header.header {
+  padding: 0 !important; /* Remove all padding for full-width banner */
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
+  height: var(--sl-nav-height) !important;
+  display: flex;
+  flex-direction: column;
+}
+
+header.header .header.sl-flex {
+  padding: 0 1.5rem;
+  height: calc(var(--sl-nav-height) - var(--ai-banner-height));
+  width: 100%;
+}
+
+:root[data-theme='dark'] header.header {
+  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
+}
+
+.site-title {
+  font-weight: 700;
+  margin-left: 0;
+  padding-left: 0;
+}
+
+/* Logo sizing - constrain to reasonable size */
+.site-title img {
+  height: 2.5rem;
+  width: auto;
+}
+
+/* Social links styling */
+.social-icons a {
+  padding: 0.5rem;
+  transition:
+    background-color 0.15s ease,
+    color 0.15s ease;
+  border-radius: 6px;
+}
+
+.social-icons a:hover {
+  background-color: rgba(0, 0, 0, 0.05);
+}
+
+:root[data-theme='dark'] .social-icons a:hover {
+  background-color: rgba(255, 255, 255, 0.05);
+}
+
+/* ============================================
+   CARDS
+   ============================================ */
+.card {
+  border-radius: 12px;
+  border: 2px solid var(--sl-color-gray-5);
+  background-color: var(--sl-color-bg);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
+  transition:
+    transform 0.2s ease,
+    box-shadow 0.2s ease,
+    border-color 0.2s ease;
+}
+
+.card:hover {
+  transform: translateY(-3px);
+  border-color: var(--sl-color-accent);
+  box-shadow: 0 8px 24px rgba(94, 94, 208, 0.15);
+}
+
+:root[data-theme='dark'] .card {
+  background: linear-gradient(145deg, rgba(30, 41, 59, 0.6), rgba(15, 23, 42, 0.8));
+  border-color: rgba(140, 140, 255, 0.2);
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+}
+
+:root[data-theme='dark'] .card:hover {
+  border-color: rgba(140, 140, 255, 0.5);
+  box-shadow:
+    0 8px 32px rgba(140, 140, 255, 0.2),
+    0 0 0 1px rgba(140, 140, 255, 0.1);
+}
+
+/* Starlight card grid */
+.sl-link-card {
+  border-radius: 12px;
+  border: 2px solid var(--sl-color-gray-5);
+  transition:
+    transform 0.2s ease,
+    box-shadow 0.2s ease,
+    border-color 0.2s ease;
+}
+
+.sl-link-card:hover {
+  transform: translateY(-3px);
+  border-color: var(--sl-color-accent);
+}
+
+:root[data-theme='dark'] .sl-link-card {
+  border-color: rgba(140, 140, 255, 0.2);
+}
+
+:root[data-theme='dark'] .sl-link-card:hover {
+  border-color: rgba(140, 140, 255, 0.5);
+}
+
+/* ============================================
+   BUTTONS
+   ============================================ */
+.sl-flex a[href],
+button {
+  transition:
+    background-color 0.2s ease,
+    transform 0.1s ease;
+}
+
+.sl-flex a[href]:hover,
+button:hover {
+  transform: translateY(-1px);
+}
+
+/* ============================================
+   MISC ENHANCEMENTS
+   ============================================ */
+
+/* Prevent horizontal scrollbar from full-viewport-width breakout elements (e.g. iframe) */
+html {
+  overflow-x: clip;
+}
+
+/* Smooth scrolling */
+@media (prefers-reduced-motion: no-preference) {
+  html {
+    scroll-behavior: smooth;
+  }
+}
+
+/* Disable hover animations for users who prefer reduced motion */
+@media (prefers-reduced-motion: reduce) {
+  .card:hover,
+  .sl-link-card:hover {
+    transform: none;
+  }
+}
+
+/* Better link underlines */
+.sl-markdown-content a:not(.sl-link-card) {
+  text-decoration-thickness: 1px;
+  text-underline-offset: 2px;
+}
+
+/* Table styling */
+table {
+  display: table;
+  width: 100%;
+}
+
+:root[data-theme='dark'] table {
+  border-color: rgba(140, 140, 255, 0.1);
+}
+
+:root[data-theme='dark'] table th {
+  background-color: rgba(140, 140, 255, 0.05);
+}
+
+:root[data-theme='dark'] table tr:nth-child(2n) {
+  background-color: rgba(140, 140, 255, 0.02);
+}
+
+/* Blockquotes */
+blockquote {
+  border-left-color: var(--sl-color-accent);
+  background-color: rgba(94, 94, 208, 0.05);
+  border-radius: 0 8px 8px 0;
+  padding: 1rem 1.25rem;
+}
+
+/* ============================================
+   ADMONITIONS (Starlight Asides)
+   Rounded, no left border bar
+   ============================================ */
+.starlight-aside {
+  margin-bottom: 1.5rem;
+  padding: 1.25rem 1.5rem;
+  border-radius: 12px;
+  border: none;
+  border-left: 0;
+  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.08);
+}
+
+/* Tip aside */
+.starlight-aside--tip {
+  background-color: rgba(16, 185, 129, 0.08);
+}
+
+.starlight-aside--tip .starlight-aside__title {
+  color: #047857;
+}
+
+:root[data-theme='dark'] .starlight-aside--tip {
+  background-color: rgba(16, 185, 129, 0.12);
+}
+
+:root[data-theme='dark'] .starlight-aside--tip .starlight-aside__title {
+  color: #34d399;
+}
+
+/* Note aside */
+.starlight-aside--note {
+  background-color: rgba(94, 94, 208, 0.08);
+}
+
+.starlight-aside--note .starlight-aside__title {
+  color: #5C5CCC;
+}
+
+:root[data-theme='dark'] .starlight-aside--note {
+  background-color: rgba(140, 140, 255, 0.12);
+}
+
+:root[data-theme='dark'] .starlight-aside--note .starlight-aside__title {
+  color: #8C8CFF;
+}
+
+/* Caution aside */
+.starlight-aside--caution {
+  background-color: rgba(245, 158, 11, 0.1);
+}
+
+.starlight-aside--caution .starlight-aside__title {
+  color: #a14908;
+}
+
+:root[data-theme='dark'] .starlight-aside--caution {
+  background-color: rgba(245, 158, 11, 0.15);
+}
+
+:root[data-theme='dark'] .starlight-aside--caution .starlight-aside__title {
+  color: #fbbf24;
+}
+
+/* Danger aside */
+.starlight-aside--danger {
+  background-color: rgba(239, 68, 68, 0.1);
+}
+
+.starlight-aside--danger .starlight-aside__title {
+  color: #be1c1c;
+}
+
+:root[data-theme='dark'] .starlight-aside--danger {
+  background-color: rgba(239, 68, 68, 0.15);
+}
+
+:root[data-theme='dark'] .starlight-aside--danger .starlight-aside__title {
+  color: #f87171;
+}
+
+/* Aside icon styling */
+.starlight-aside__icon svg {
+  width: 1.25rem;
+  height: 1.25rem;
+}
+
+/* ============================================
+   FOOTER - No custom styling needed
+   The only <footer> in Starlight is the content footer
+   (meta/pagination), which should stay transparent.
+   ============================================ */
+
+/* ============================================
+   RESPONSIVE ADJUSTMENTS
+   ============================================ */
+@media (max-width: 72rem) {
+  .content-panel {
+    max-width: 100%;
+  }
+}
+
+/* Responsive padding on navbar row only - banner stays full-width */
+@media (min-width: 50rem) {
+  header.header .header.sl-flex {
+    padding-left: 1rem;
+    padding-right: 2.5rem;
+  }
+}
+
+@media (min-width: 72rem) {
+  header.header .header.sl-flex {
+    padding-left: 1rem;
+    padding-right: 3rem;
+  }
+}

package/.bmad/_cfg/agent-manifest.csv

@@ -1,11 +0,0 @@
-name,displayName,title,icon,role,identity,communicationStyle,principles,module,path
-"bmad-master","BMad Master","BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator","🧙","Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator","Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.","Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.","Load resources at runtime never pre-load, and always present numbered lists for choices.","core","bmad/core/agents/bmad-master.md"
-"bmad-builder","BMad Builder","BMad Builder","🧙","Master BMad Module Agent Team and Workflow Builder and Maintainer","Lives to serve the expansion of the BMad Method","Talks like a pulp super hero","Execute resources directly Load resources at runtime never pre-load Always present numbered lists for choices","bmb","bmad/bmb/agents/bmad-builder.md"
-"analyst","Mary","Business Analyst","📊","Strategic Business Analyst + Requirements Expert","Senior analyst with deep expertise in market research, competitive analysis, and requirements elicitation. Specializes in translating vague needs into actionable specs.","Systematic and probing. Connects dots others miss. Structures findings hierarchically. Uses precise unambiguous language. Ensures all stakeholder voices heard.","Every business challenge has root causes waiting to be discovered. Ground findings in verifiable evidence. Articulate requirements with absolute precision.","bmm","bmad/bmm/agents/analyst.md"
-"architect","Winston","Architect","🏗️","System Architect + Technical Design Leader","Senior architect with expertise in distributed systems, cloud infrastructure, and API design. Specializes in scalable patterns and technology selection.","Pragmatic in technical discussions. Balances idealism with reality. Always connects decisions to business value and user impact. Prefers boring tech that works.","User journeys drive technical decisions. Embrace boring technology for stability. Design simple solutions that scale when needed. Developer productivity is architecture.","bmm","bmad/bmm/agents/architect.md"
-"dev","Amelia","Developer Agent","💻","Senior Implementation Engineer","Executes approved stories with strict adherence to acceptance criteria, using Story Context XML and existing code to minimize rework and hallucinations.","Succinct and checklist-driven. Cites specific paths and AC IDs. Asks clarifying questions only when inputs missing. Refuses to invent when info lacking.","Story Context XML is the single source of truth. Reuse existing interfaces over rebuilding. Every change maps to specific AC. Tests pass 100% or story isn't done.","bmm","bmad/bmm/agents/dev.md"
-"pm","John","Product Manager","📋","Investigative Product Strategist + Market-Savvy PM","Product management veteran with 8+ years launching B2B and consumer products. Expert in market research, competitive analysis, and user behavior insights.","Direct and analytical. Asks WHY relentlessly. Backs claims with data and user insights. Cuts straight to what matters for the product.","Uncover the deeper WHY behind every requirement. Ruthless prioritization to achieve MVP goals. Proactively identify risks. Align efforts with measurable business impact.","bmm","bmad/bmm/agents/pm.md"
-"sm","Bob","Scrum Master","🏃","Technical Scrum Master + Story Preparation Specialist","Certified Scrum Master with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories.","Task-oriented and efficient. Focused on clear handoffs and precise requirements. Eliminates ambiguity. Emphasizes developer-ready specs.","Strict boundaries between story prep and implementation. Stories are single source of truth. Perfect alignment between PRD and dev execution. Enable efficient sprints.","bmm","bmad/bmm/agents/sm.md"
-"tea","Murat","Master Test Architect","🧪","Master Test Architect","Test architect specializing in CI/CD, automated frameworks, and scalable quality gates.","Data-driven and pragmatic. Strong opinions weakly held. Calculates risk vs value. Knows when to test deep vs shallow.","Risk-based testing. Depth scales with impact. Quality gates backed by data. Tests mirror usage. Flakiness is critical debt. Tests first AI implements suite validates.","bmm","bmad/bmm/agents/tea.md"
-"tech-writer","paige","Technical Writer","📚","Technical Documentation Specialist + Knowledge Curator","Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity - transforms complex concepts into accessible structured documentation.","Patient and supportive. Uses clear examples and analogies. Knows when to simplify vs when to be detailed. Celebrates good docs helps improve unclear ones.","Documentation is teaching. Every doc helps someone accomplish a task. Clarity above all. Docs are living artifacts that evolve with code.","bmm","bmad/bmm/agents/tech-writer.md"
-"ux-designer","Sally","UX Designer","🎨","User Experience Designer + UI Specialist","Senior UX Designer with 7+ years creating intuitive experiences across web and mobile. Expert in user research, interaction design, AI-assisted tools.","Empathetic and user-focused. Uses storytelling for design decisions. Data-informed but creative. Advocates strongly for user needs and edge cases.","Every decision serves genuine user needs. Start simple evolve through feedback. Balance empathy with edge case attention. AI tools accelerate human-centered design.","bmm","bmad/bmm/agents/ux-designer.md"

package/.bmad/_cfg/agents/bmb-bmad-builder.customize.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here

package/.bmad/_cfg/agents/bmm-analyst.customize.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here

package/.bmad/_cfg/agents/bmm-architect.customize.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here

package/.bmad/_cfg/agents/bmm-dev.customize.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here