Replace Agent Dialog Gate with Design Log entry point in all 29 activity
workflows (phases 2-8). Replace "Update agent dialog" with "Update design log"
in 90+ step files across phases 5, 7, and 8. Update data files, guides,
presentations, and templates to reference design log instead of agent dialogs.
Only the deprecated _agent-dialogs/ archive folder retains original references.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Remove Agent Dialog Gate from all 9 activity workflows and the main
workflow.md initialization. Replace with a single 00-design-log.md file
containing Backlog, Current, Design Loop Status, and Log sections.
- Rewrite workflow.md adaptive dashboard to read from design log only
- Create 00-design-log.template.md, delete old 00-progress.template.md
- Update installer.js: agent-experiences folder replaces agent-dialogs
- Rename 00-progress.md → 00-design-log.md across all phases (1-5)
- Update step files to use agent experiences instead of agent dialogs
- 30 files changed, net reduction of ~140 lines of ceremony
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Path fixes across 14 files:
- D-UX-Design/ → C-UX-Scenarios/ (page specs) or D-Design-System/ (tokens)
- 4-scenarios/ → C-UX-Scenarios/ (all step files and page creation flows)
New spacing & typography step in [P] Specify:
- step-08-spacing-typography.md defines section spacing objects and heading tokens
- Old step-08 renumbered to step-09, references updated to steps 1-8
[M] Design System extraction rules:
- Objects extract on 2nd use, spacing extracts immediately on 1st use
- Component extraction check before designing 2nd+ page
[S] Suggest step-15 alignment:
- Old [A]/[S]/[M] menu replaced with two-option transitions
- Matches the pattern used by [C] Conceptualize and workflow-suggest.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Page spec template: rename -gap to -space, use {page}-{v|h}-{type}-{size} naming
- Design system template: objects extract on 2nd use, spacing extracts immediately
- Pattern examples updated with Above/Below/Why table format
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Spacing gets the same treatment as typography — named tokens, a baseline
(space-md), and optical adjustments using token math. But the real shift:
spacing between objects is now a first-class object with its own ID in
page specs, organized in a Patterns section in the design system.
Key additions:
- Spacing Scale: 9 tokens (space-3xs to space-3xl), bring-your-own supported
- Type Scale: 9 tokens (text-3xs to text-3xl), semantic/visual separation
- Optical adjustments: token math (space-lg - space-3xs) with annotations
- Spacing objects in page specs: ↕ `id` — token, including space-zero
- Patterns section: organized by spacing value, context added on violation
- Agent reflection behavior: observe and reflect, don't interrogate
- Design loop: pattern recognition emerges from real design decisions
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Design system template: spacing scale (9 tokens, space-3xs to space-3xl)
and type scale (9 tokens, text-3xs to text-3xl) with bring-your-own option.
Semantic heading level separated from visual text sizing — H1 can look
different on every page. Page spec template: spacing, typography, and
per-section padding/gap using token names. Design loop guide: 9 steps
(added APPROVE — user exports PNG as approval gate), spacing discipline,
export=approval pattern. Wireframe flow: agent draws, user reviews, user
exports PNG to confirm, then spec syncs.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace static activity menu with adaptive dashboard that reads agent dialogs
(session plans) and per-page design log to suggest where to continue. Add
explicit design log reporting points with exact file paths and formats to all
Phase 4 and 5 workflow files. Replace all "Return to activity menu" dead ends
with two-option transitions. Rename Conceptualize → Discuss. Implements
learnings from Källa Fordonservice project.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The VTC (Value Trigger Chain) was a separate concept that extracted
specific nodes from the Trigger Map into a YAML file. This caused
agents to run trigger mapping during Phase 1 (Product Brief), forcing
users to repeat the work in Phase 2. Observed in Monday workshop.
Architectural fix:
- Phase 1 is casual business discovery, NOT trigger mapping
- Phase 2 is where the Trigger Map gets built (unchanged)
- When scenarios/content need strategic context, they reference
the Trigger Map directly — no separate VTC concept needed
Removed (19 files deleted):
- 1-project-brief/vtc-workshop/ (14 step files + workflow)
- step-04-create-vtc.md and step-11a-create-vtc.md from Phase 1
- step-03c-create-vtc.md from Phase 0 alignment
- vtc-template.yaml
Renamed:
- step-03-build-vtcs.md → step-03-build-strategic-context.md
- step-02-vtc-consistency.md → step-02-trigger-map-consistency.md
- step-01-load-vtc-context.md → step-01-load-trigger-map-context.md
- 07-create-vtc.md → 07-reference-trigger-map.md
Rewritten:
- Phase 4 scenario init: "create VTC" → lightweight "pick from Trigger Map"
- Phase 6 content: load context from Trigger Map, not from VTC
- Templates: "Trigger Map" section → "Business Context" (Phase 1 scope)
Zero VTC references remain in src/.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Suggest workflow: Component Extraction Check prompts user to extract
shared elements when starting the 2nd+ page in a scenario
- Dream workflow: Auto-extracts shared components and reports in summary
- Spec audit Level 3: Cross-Page Duplicate Detection compares sections
across all pages, flags exact/near duplicates with severity levels
- Fix Freya role name (Scenario Architect → Facilitator)
- Remove duplicate trigger-map reference in Eira guide
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Remove duplicate `Reads: 2-strategy/trigger-map.md` line in eira-visual-designer.md
- Rename "Scenario Architect" to "Scenario Facilitator" in freya.activation.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Systematic cleanup of Value Trigger Chain (VTC) references in 60 files across
all phases. VTC is replaced with context-appropriate terms:
- "Trigger Map" when referencing the Phase 2 artifact
- "Strategic context" when referencing the extracted business/persona/forces data
- "Value Proposition" for customer-facing value descriptions
Remaining VTC references are only in VTC Workshop definition files (vtc-workshop/,
create-vtc steps) which will be addressed when those workflows are redesigned.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Freya menu: simpler descriptions, logical grouping (SC/UX/SP/SA/GA/DS/DD)
- Freya menu: remove AD and ST, add SC (Scenarios) and SP (Specifications)
- Fix VTC reference in freya agent and workflow-conceptualize
- Conceptualize: save findings to page spec, not separate notes file
- Conceptualize: offer Excalidraw sketching, user sketch first
- Conceptualize: require reading existing specs before drawing
- Conceptualize: no annotations on wireframes rule
- Add Excalidraw tool guide and update tools guide
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
After designing a page, the agent asks what's next: outline and design
the next page in the scenario [N], return to dashboard [R], or validate
[V]. Choosing [N] runs Phase 3's page outline dialog (purpose + exit
action) then designs the page, creating a continuous loop.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
[O] Outline now walks through pages as a conversation: for each page,
ask what the user accomplishes and what interaction moves them forward.
Interactions that leave the page create new steps; interactions that
stay on the page become storyboard items within the page spec.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
[S] → [O] Outline scenario pages. User can cycle through pages
one at a time and stop whenever they want, rather than creating
all at once.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Instead of always creating all page folders, the post-scenario menu
now offers: [N] next scenario, [S] scaffold all page folders,
[D] create first page and design, [C] generate overview. Page folder
structure uses NN.step-slug naming with Sketches/ subfolder.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Phase 4 now checks for existing Phase 3 scenarios before page design.
If no scenario exists, redirects user to Phase 3's 8-question dialog
instead of attempting a lighter inline version.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
After completing a scenario, the user can now choose to:
- [N] Define the next scenario
- [D] Jump to Phase 4 and start designing the first page
- [C] Generate the overview (when all scenarios done)
This lets users design one scenario before defining the rest,
creating a more natural workflow.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Restructure Phase 3 scenario creation around a natural conversation
flow instead of a template checklist:
- 8 strategic questions asked in logical order: transaction → business
goal → user & situation → driving forces → device → starting point
→ best outcome → shortest path
- Two modes: conversation (agent asks, user answers) and suggest
(agent answers from Trigger Map, user reviews)
- Broader transaction definition: includes content browsing and
research, not just purchases/bookings
- Agent creates first page specification after Q8, giving Phase 4
a concrete starting point
- Template reordered to match Q1-Q8 dialog flow
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Implement BMad-style IDE handler architecture for WDS:
- Base class (_base-ide.js) with template method pattern
- Dynamic handler discovery via IdeManager
- Priority handlers: Windsurf, Cursor, Claude Code, Cline, GitHub Copilot
- Installer integration after agent compilation step
- Saga activation now branches on starting_point config (pitch vs brief)
- Remove parenthetical hint from learning material prompt
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Remove mimir-orchestrator.agent.yaml (orchestration layer removed)
- Add activation prompt to Saga for immediate greeting
- Saga now direct entry point (no orchestrator needed)
- Greets user by name and starts Product Brief workflow
Workshop finding: 50% bypassed orchestration, Mimir added complexity.
Direct activation simplifies user journey.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- New option: Full Trigger Map vs Simplified VTC vs Skip
- Synced from bmad-method-wds-expansion
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- New entry point that asks Greenfield vs Brownfield upfront
- Prevents users from going through Phase 1-3 with existing codebases
- Adds project configuration questions
- Updates routing to direct brownfield projects to Phase 8
Synced from bmad-method-wds-expansion.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Step 4 was missing a structured menu at the spec review checkpoint.
This caused agents to skip past the approval step without waiting for
explicit user confirmation.
Added:
- Review menu with [y] Approve, [c] Changes, [q] Questions, [a] Advanced Elicitation, [p] Party Mode
- Explicit HALT instruction
- Menu handling section
This aligns step 4 with the menu-driven pattern used in steps 1-3.
Fixes#1304
Also fixes pre-existing prettier issue in src/modules/cis/module.yaml.
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* docs: expand TEA documentation with cheat sheets, MCP enhancements, and API testing patterns
* docs: update TEA fragment counts and fix playwright-utils code examples
* docs: addressed PR review concerns
* docs: update TEA MCP configuration link to point to documentation site
* feat(docs): add Diataxis folder structure and update sidebar styling
- Create tutorials, how-to, explanation, reference directories with subdirectories
- Add index.md files for each main Diataxis section
- Update homepage with Diataxis card navigation layout
- Implement clean React Native-inspired sidebar styling
- Convert sidebar to autogenerated for both Diataxis and legacy sections
- Update docusaurus config with dark mode default and navbar changes
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(docs): migrate Phase 1 files to Diataxis structure
Move 21 files to new locations:
- Tutorials: quick-start guides, agent creation guide
- How-To: installation, customization, workflows
- Explanation: core concepts, features, game-dev, builder
- Reference: merged glossary from BMM and BMGD
Also:
- Copy images to new locations
- Update internal links via migration script (73 links updated)
- Build verified successfully
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(docs): add category labels for sidebar folders
Add _category_.json files to control display labels and position
for autogenerated sidebar categories.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* style(docs): improve welcome page and visual styling
- Rewrite index.md with React Native-inspired welcoming layout
- Add Diataxis section cards with descriptions
- Remove sidebar separator, add spacing instead
- Increase navbar padding with responsive breakpoints
- Add rounded admonitions without left border bar
- Use system font stack for better readability
- Add lighter chevron styling in sidebar
- Constrain max-width to 1600px for wide viewports
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix: use baseUrl in meta tag paths for correct deployment URLs
* feat(docs): complete Phase 2 - split files and fix broken links
Phase 2 of Diataxis migration:
- Split 16 large legacy files into 42+ focused documents
- Created FAQ section with 7 topic-specific files
- Created brownfield how-to guides (3 files)
- Created workflow how-to guides (15+ files)
- Created architecture explanation files (3 files)
- Created TEA/testing explanation files
- Moved remaining legacy module files to proper Diataxis locations
Link fixes:
- Fixed ~50 broken internal links across documentation
- Updated relative paths for new file locations
- Created missing index files for installation, advanced tutorials
- Simplified TOC anchors to fix Docusaurus warnings
Cleanup:
- Removed legacy sidebar entries for deleted folders
- Deleted duplicate and empty placeholder files
- Moved workflow diagram assets to tutorials/images
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(build): use file glob instead of sidebar parsing for llms-full.txt
Replace brittle sidebar.js regex parsing with recursive file glob.
The old approach captured non-file strings like 'autogenerated' and
category labels, resulting in only 5 files being processed.
Now correctly processes all 86+ markdown files (~95k tokens).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(seo): use absolute URLs in AI meta tags for agent discoverability
AI web-browsing agents couldn't follow relative paths in meta tags due to
URL security restrictions. Changed llms-full.txt and llms.txt meta tag
URLs from relative (baseUrl) to absolute (urlParts.origin + baseUrl).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor(docs): recategorize misplaced files per Diataxis analysis
Phase 2.5 categorization fixes based on post-migration analysis:
Moved to correct Diataxis categories:
- tutorials/installation.md → deleted (duplicate of how-to/install-bmad.md)
- tutorials/brownfield-onboarding.md → how-to/brownfield/index.md
- reference/faq/* (8 files) → explanation/faq/
- reference/agents/barry-quick-flow.md → explanation/agents/
- reference/agents/bmgd-agents.md → explanation/game-dev/agents.md
Created:
- explanation/agents/index.md
Fixed all broken internal links (14 total)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(docs): add Getting Started tutorial and simplify build script
- Add comprehensive Getting Started tutorial with installation as Step 1
- Simplify build-docs.js to read directly from docs/ (no consolidation)
- Remove backup/restore dance that could corrupt docs folder on build failure
- Remove ~150 lines of unused consolidation code
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(css): use fixed width layout to prevent content shifting
Apply React Native docs approach: set both width and max-width at
largest breakpoint (1400px) so content area maintains consistent
size regardless of content length. Switches to fluid 100% below
1416px breakpoint.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor(docs): restructure tutorials with renamed entry point
- Rename index.md to bmad-tutorial.md for clearer navigation
- Remove redundant tutorials/index.md
- Update sidebar and config references
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(docs): add tutorial style guide and AI agent announcement bar
- Add docs/_contributing/ with tutorial style guide
- Reformat quick-start-bmm.md and bmad-tutorial.md per style guide
- Remove horizontal separators, add strategic admonitions
- Add persistent announcement bar for AI agents directing to llms-full.txt
- Fix footer broken link to tutorials
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(docs): add markdown demo page and UI refinements
- Add comprehensive markdown-demo.md for style testing
- Remove doc category links from navbar (use sidebar instead)
- Remove card buttons from welcome page
- Add dark mode styling for announcement bar
- Clean up index.md card layout
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(docs): apply unified tutorial style and update references
- Reformat create-custom-agent.md to follow tutorial style guide
- Update tutorial-style.md with complete unified structure
- Update all internal references to renamed tutorial files
- Remove obsolete advanced/index.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* refactor(docs): migrate from Docusaurus to Astro+Starlight
Replace Docusaurus with Astro and the Starlight documentation theme
for improved performance, better customization, and modern tooling.
Build pipeline changes:
- New build-docs.js orchestrates link checking, artifact generation,
and Astro build in sequence
- Add check-doc-links.js for validating internal links and anchors
- Generate llms.txt and llms-full.txt for LLM-friendly documentation
- Create downloadable source bundles (bmad-sources.zip, bmad-prompts.zip)
- Suppress MODULE_TYPELESS_PACKAGE_JSON warning in Astro build
- Output directly to build/site for cleaner deployment
Website architecture:
- Add rehype-markdown-links.js plugin to transform .md links to routes
- Add site-url.js helper for GitHub Pages URL resolution with strict
validation (throws on invalid GITHUB_REPOSITORY format)
- Custom Astro components: Banner, Header, MobileMenuFooter
- Symlink docs/ into website/src/content/docs for Starlight
Documentation cleanup:
- Remove Docusaurus _category_.json files (Starlight uses frontmatter)
- Convert all docs to use YAML frontmatter with title field
- Move downloads.md from website/src/pages to docs/
- Consolidate style guide and workflow diagram docs
- Add 404.md and tutorials/index.md
---------
Co-authored-by: forcetrainer <bryan@inagaki.us>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* fix(brainstorming): extend ideation phase with 100+ idea goal
Add emphasis on quantity-first approach to unlock better quality ideas.
Introduce energy checkpoints, multiple continuation options, and clearer
success metrics to keep users in generative exploration mode longer.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix(brainstorming): improve exploration menus and fix workflow paths
- Change menu options from numbers [1-4] to letters [K/T/A/B/C] for clearer navigation
- Fix workflow references from .yaml to .md across agents and patterns
- Add universal facilitation rules emphasizing 100+ idea quantity goal
- Update exploration menu with Keep/Try/Advanced/Break/Continue options
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat(brainstorming): implement research-backed procedural rigor
Phase 4 achievements:
- Added Anti-Bias Protocol (Every 10 ideas domain pivot)
- Added Chain-of-Thought requirements (Reasoning before generation)
- Implemented Simulated Temperature prompts for higher divergence
- Standardized Idea Format Template for quality control
- Fixed undefined Advanced Elicitation variables
- Synchronized documentation with new [K, T, A, P, C] pattern
* fix(brainstorming): align ideation goals and fix broken workflow paths
- Standardized quantity goals to 100+ ideas across all brainstorming steps
- Fixed broken .yaml references pointing to renamed .md workflow files
- Aligned documentation summaries with mandatory IDEA FORMAT TEMPLATE
- Cleaned up misplaced mindset/goal sections in core workflow file
- Fixed spelling and inconsistencies in facilitation rules
* Fix ambiguous variable names in brainstorming ideation step
* fix(brainstorming): enforce quality growth alongside quantity
* fix: correct dependency format and add missing frontmatter variable
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Mårten Angner
Alex Verkhovsky
Brian
Murat K Ozcan
Brian Madison
Davor Racic