v0.3.0: Workshop refactor — installer, IDE handlers, workflow fixes#1757
Closed
MartenAngner wants to merge 46 commits intobmad-code-org:mainfrom
Closed
v0.3.0: Workshop refactor — installer, IDE handlers, workflow fixes#1757MartenAngner wants to merge 46 commits intobmad-code-org:mainfrom
MartenAngner wants to merge 46 commits intobmad-code-org:mainfrom
Conversation
- Update README and agent names for WDS v6 conversion - Enhance WDS documentation and finalize PRD structure - Finalize WDS methodology documentation and phase details - Implement language configuration and workflow documentation - Add course content and design system updates - Add Excalidraw integration - Implement micro-file architecture for Phase 6 & 7 workflows
All step files now comply with BMAD v6 (<200 lines, 250 max): Optimized phases: - Phase 1: step-11-tone-of-voice (233→162 lines) - Phase 2: step-02-generate-business-goals (231→86 lines) - Phase 4: page workshops (578→135, 406→169, 355→197 lines) - Phase 6: handoff dialogs (441→107, 327→130, 414→137 lines) - Phase 7: testing steps (683→158, 517→112, 441→101, etc.) - Phase 8: ongoing development (498→164, 381→131, etc.) - Shared: vtc customer-awareness (256→193 lines) Created 18 substep files for templates and examples. Total: 59 files changed, 5605 insertions, 8885 deletions. 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>
- 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>
Replace entire src/ content with bmad-method-wds-expansion source: - Restructured workflows (BMad-compliant phases 0-8) - Updated agent YAMLs with correct workflow paths - Templates moved into workflow folders (no more top-level templates/) - Added skills/ directory (agent activation files) - Added module-help.csv (workflow registry) - Removed legacy dirs: _module-installer/, core/, modules/ Installer updates: - Copy skills/ instead of templates/ - Copy module-help.csv alongside module.yaml - Updated doc folder structure to match expansion - Compiler handles _bmad/wds/ path rewriting for standalone Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Publishes to npm on tag push (v*) or manual trigger. Bypasses local 2FA issues by using NPM_TOKEN secret. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Critical fixes before workshop: - Detect existing deliverables folders (design-process, docs, deliverables, wds-deliverables) - Update config.yaml with detected output_folder - Implement createFolderGuides() to copy all 00 template files - Create 00-project-info.md as project settings home - Never overwrite existing user files Files modified: - tools/cli/lib/installer.js - folder detection, createFolderGuides(), config update - INSTALLER-FIXES-2026-02-23.md - complete documentation of all fixes - src/workflows/1-project-brief/templates/00-project-info.template.md - new template Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
createFolderGuides() needs config parameter for template replacements. This was causing "config is not defined" error during installation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Users can now choose between design-process/, docs/, or deliverables/ - Removes folder auto-detection logic that caused duplicate folders - Installer creates folders at user's chosen location - Prevents conflict with project setup workflow Fixes issue where both design-process/ and docs/ were created. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Reduce installer to minimal config: project_name + starting_point - Remove design_experience, project_type, IDE selection questions - Standardize on design-process/ output folder - Update folder structure: A-E (remove F-G phases) - Change D-Design-System → E-Design-System - Add _progress/agent-dialogs/ folder - Update success message to point to Saga (not Mimir) - Auto-include learning material (no prompt) - Get user_name from git config - Remove IDE setup step Workshop finding: 0/4 participants completed workflows with complex installer. Simplification improves first-time user experience. Co-Authored-By: Claude Sonnet 4.5 <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>
- Add 3rd question: Output folder name (default: design-process) - Users can customize to docs/, deliverables/, etc. - Update config.yaml to use dynamic root_folder - Update template placeholders to use config.root_folder Balances simplification (3 questions vs 7+) with useful customization. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Change vague 'Where are you starting?' to clear yes/no question - Fix typos: 'pich' → 'pitch', 'prief' → 'brief' - Clearer choice labels for better UX
Workshop feedback: 00-*.md files were confusing and ignored by users. Changes: - Remove createFolderGuides() and createProjectInfoFile() methods - Folders still created but empty (only .gitkeep) - Agents will create files dynamically during workflows - Cleaner, less confusing user experience
Old message was too technical and vague. New message: - Clear numbered steps (1-2-3) - Specific: 'Open this folder in Windsurf or VS Code' - Exact command to paste (not just 'tell the AI') - Clear outcome: 'Saga will greet you by name' - Cleaner layout with separator Addresses workshop feedback about confusing instructions.
More conversational and explicit: - 'Get Started with Your Product Brief' (goal-oriented) - 'Locate the chat window in your IDE' (explicit location) - 'type:' instead of 'paste this command:' (simpler action) - Command in quotes to make it clear it's text to type - Better line breaks for readability
Better flow: name → structure → workflow Old order: 1. Project name 2. Pitch deck question (workflow) 3. Output folder (structure) New order: 1. Project name 2. Output folder (structure) 3. Pitch deck question (workflow) More intuitive: establish basics first, then choose workflow.
User feedback: UX design happens IN the scenarios (C), not as separate phase. Old (incorrect): - A-Product-Brief - B-Trigger-Map - C-UX-Scenarios - D-UX-Design (redundant!) - E-Design-System New (correct): - A-Product-Brief - B-Trigger-Map - C-UX-Scenarios (UX design is done here) - D-Design-System 4 phases instead of 5 - cleaner and more accurate.
- Added IDE selection question (Windsurf, VS Code, Cursor, Other) - Made learning material installation optional with confirm prompt - Success message now shows selected IDE name - Store IDE preference in config.yaml - Installer now has 5 questions (up from 3) User feedback: "IDE selection is crucial for the installer" and "ask if the learn section should be installed" Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Changed from single-select list to checkbox (multiselect) - Added full IDE list from BMad: Windsurf, Cursor, Claude Code, GitHub Copilot, Cline, VS Code, Other - Windsurf and Cursor marked as preferred (pre-checked) - Validation requires at least one IDE selected - Updated config.yaml to store ides array instead of single ide - Updated success message to display multiple IDEs (e.g., "Windsurf or Cursor") - Ensures WDS commands work cross-platform for all selected IDEs User request: "Look at the BMad installer, there is a multiselect box for IDEs use the full list from the BMad installer" Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Removed all pre-selection (all unchecked by default) - Removed star markers (⭐) - no preferences shown - Sorted alphabetically for neutral presentation - Users must actively choose their tools - Validation still requires at least one selection Platform-agnostic: WDS works equally well with any AI coding tool Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Added missing IDEs: - Atlassian Rovo Dev - Auggie CLI - Codex - Crush - Gemini CLI - Google Antigravity - iFlow CLI - Kilo Code - Kiro CLI - OpenCode - Qwen Code - Roo Code - Trae Complete list now matches BMad installer (20 options including VS Code and Other) All sorted alphabetically for platform-agnostic presentation Co-Authored-By: Claude Sonnet 4.5 <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>
Roo, Trae, Crush, iFlow, Antigravity (flat markdown), Codex, Rovo Dev, Auggie, OpenCode (YAML frontmatter), Gemini, Qwen (TOML format), Kiro CLI (JSON+MD), Kilo (YAML modes). All 18 IDEs now supported via dynamic handler discovery. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Workshop fixes (issues bmad-code-org#4-bmad-code-org#12): - Add output-discipline block to compiler activation (bmad-code-org#12) - Rename synthesize steps to create-document (bmad-code-org#5) - Add context carry-forward to prevent repetitive questions (bmad-code-org#4) - Add length constraints to scenario outlines (bmad-code-org#10) - Add completeness gate for dream mode trigger map (bmad-code-org#6) - Add data extraction + cross-validation to hub generation (bmad-code-org#7) - Extend dream-up architecture for Phase 3 scenarios (bmad-code-org#8) - Add dream/suggest mode-conditional rules to all 15 UX steps (bmad-code-org#11) Stale reference cleanup: - Remove orphaned Mimir agent guides and presentations - Update Mimir references to Saga in templates and step files - Rename UX Scenario Architect to Facilitator across all scenario files - Fix strategic-documentation.md step 12 heading Workflow audit fixes: - Fix broken explore section routing links in alignment workflow - Fix FILE-INDEX.md wrong parent path in agentic-development - Fix routing tables in design-system and product-evolution workflows - Clarify dream mode routing notation in ux-design workflow - Remove empty steps-d/ directory Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Complete v0.3.0 refactor addressing 12 issues from the Feb 23 workshop, plus installer improvements and full workflow audit.
Installer & Setup
Workshop Fixes (9 issues)
<output-discipline>block to compiler activation for all agents (This is a GREAT framework #12)Stale Reference Cleanup
Workflow Audit Fixes
Test plan
npx whiteport-design-studioinstall on test project — verify<output-discipline>in compiled agents🤖 Generated with Claude Code