@delorenj/pjangler 1.2.25 → 1.2.33

package/templates/commonproject/_bmad/bmb/workflows/module/steps-c/step-06-workflows.md

@@ -1,183 +0,0 @@
----
-name: 'step-06-workflows'
-description: 'Create workflow placeholder/spec files'
-
-nextStepFile: './step-07-docs.md'
-workflowSpecTemplate: '../../templates/workflow-spec-template.md'
-buildTrackingFile: '{bmad_creations_output_folder}/modules/module-build-{module_code}.md'
-targetLocation: '{build_tracking_targetLocation}'
----
-
-# Step 6: Workflow Specs
-
-## STEP GOAL:
-
-Create workflow placeholder/spec files based on the brief.
-
-## MANDATORY EXECUTION RULES:
-
-### Universal Rules:
-
-- 🛑 NEVER generate content without user input
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: When loading next with 'C', ensure entire file is read
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ Speak in `{communication_language}`
-
-### Role Reinforcement:
-
-- ✅ You are the **Module Builder** — creating workflow specs
-- ✅ These are specs, not full workflows (workflow-builder does that)
-- ✅ Keep it high-level
-
----
-
-## MANDATORY SEQUENCE
-
-### 1. Get Workflow List from Brief
-
-Extract from the brief:
-- Core workflows
-- Feature workflows
-- Utility workflows
-
-For each workflow:
-- Name
-- Purpose/goal
-- Primary agent
-- Input/output requirements
-
-### 2. For Each Workflow, Create Spec
-
-Load `{workflowSpecTemplate}` and create:
-
-`{targetLocation}/workflows/{workflow_name}/{workflow_name}.spec.md`
-
-With content:
-```markdown
-# Workflow Specification: {workflow_name}
-
-**Module:** {module_code}
-**Status:** Placeholder — To be created via create-workflow workflow
-**Created:** {date}
-
----
-
-## Workflow Overview
-
-**Goal:** {workflow_goal}
-
-**Description:** {workflow_description}
-
-**Workflow Type:** {workflow_type}
-
----
-
-## Workflow Structure
-
-### Entry Point
-
-```yaml
----
-name: {workflow_name}
-description: {workflow_description}
-web_bundle: true
-installed_path: '{project-root}/_bmad/{module_code}/workflows/{workflow_folder_name}'
----
-```
-
-### Mode
-
-- [ ] Create-only (steps-c/)
-- [ ] Tri-modal (steps-c/, steps-e/, steps-v/)
-
----
-
-## Planned Steps
-
-| Step | Name | Goal |
-|------|------|------|
-{workflow_steps_table}
-
----
-
-## Workflow Inputs
-
-### Required Inputs
-
-{required_inputs}
-
-### Optional Inputs
-
-{optional_inputs}
-
----
-
-## Workflow Outputs
-
-### Output Format
-
-- [ ] Document-producing
-- [ ] Non-document
-
-### Output Files
-
-{output_files}
-
----
-
-## Agent Integration
-
-### Primary Agent
-
-{primary_agent}
-
-### Other Agents
-
-{other_agents}
-
----
-
-## Implementation Notes
-
-**Use the create-workflow workflow to build this workflow.**
-
----
-
-_Spec created on {date} via BMAD Module workflow_
-```
-
-### 3. Create All Workflow Specs
-
-Iterate through each workflow from the brief and create their spec file.
-
-### 4. Update Build Tracking
-
-Update `{buildTrackingFile}`:
-- Add 'step-06-workflows' to stepsCompleted
-- List all workflow specs created
-
-### 5. Report Success
-
-"**✓ Workflow specs created:**"
-
-- {count} workflow spec files
-- {list workflow names}
-
-"**These are specs/blueprints. Use the create-workflow workflow to build each workflow.**"
-
-### 6. MENU OPTIONS
-
-**Select an Option:** [C] Continue
-
-- IF C: Update tracking, load `{nextStepFile}`
-- IF Any other: Help, then redisplay menu
-
----
-
-## Success Metrics
-
-✅ Workflow spec files created for all workflows
-✅ Each spec has goal, steps, inputs/outputs
-✅ Agent associations documented
-✅ Build tracking updated

package/templates/commonproject/_bmad/bmb/workflows/module/steps-c/step-07-docs.md

@@ -1,402 +0,0 @@
----
-name: 'step-07-docs'
-description: 'Generate README.md, TODO.md, and docs/ folder'
-
-nextStepFile: './step-08-complete.md'
-buildTrackingFile: '{bmb_creations_output_folder}/modules/module-build-{module_code}.md'
-targetLocation: '{build_tracking_targetLocation}'
----
-
-# Step 7: Documentation
-
-## STEP GOAL:
-
-Generate README.md, TODO.md, and user documentation in docs/ folder for the module.
-
-## MANDATORY EXECUTION RULES:
-
-### Universal Rules:
-
-- 🛑 NEVER generate content without user input
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: When loading next with 'C', ensure entire file is read
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ Speak in `{communication_language}`
-
-### Role Reinforcement:
-
-- ✅ You are the **Module Builder** — documentation creator
-- ✅ README is the user's first impression
-- ✅ TODO tracks remaining work
-- ✅ docs/ provides user-facing documentation
-
----
-
-## MANDATORY SEQUENCE
-
-### 1. Generate README.md
-
-Create `{targetLocation}/README.md`:
-
-```markdown
-# {module_display_name}
-
-{brief_header}
-
-{subheader}
-
----
-
-## Overview
-
-{module_overview_from_brief}
-
----
-
-## Installation
-
-```bash
-bmad install {module_code}
-```
-
----
-
-## Quick Start
-
-{quick_start_from_brief}
-
-**For detailed documentation, see [docs/](docs/).**
-
----
-
-## Components
-
-### Agents
-
-{agent_list_from_brief}
-
-### Workflows
-
-{workflow_list_from_brief}
-
----
-
-## Configuration
-
-The module supports these configuration options (set during installation):
-
-{config_variables_from_module_yaml}
-
----
-
-## Module Structure
-
-```
-{module_code}/
-├── module.yaml
-├── README.md
-├── TODO.md
-├── docs/
-│   ├── getting-started.md
-│   ├── agents.md
-│   ├── workflows.md
-│   └── examples.md
-├── agents/
-├── workflows/
-└── _module-installer/
-```
-
----
-
-## Documentation
-
-For detailed user guides and documentation, see the **[docs/](docs/)** folder:
-- [Getting Started](docs/getting-started.md)
-- [Agents Reference](docs/agents.md)
-- [Workflows Reference](docs/workflows.md)
-- [Examples](docs/examples.md)
-
----
-
-## Development Status
-
-This module is currently in development. The following components are planned:
-
-- [ ] Agents: {agent_count} agents
-- [ ] Workflows: {workflow_count} workflows
-
-See TODO.md for detailed status.
-
----
-
-## Author
-
-Created via BMAD Module workflow
-
----
-
-## License
-
-Part of the BMAD framework.
-```
-
-### 2. Generate TODO.md
-
-Create `{targetLocation}/TODO.md`:
-
-```markdown
-# TODO: {module_display_name}
-
-Development roadmap for {module_code} module.
-
----
-
-## Agents to Build
-
-{for each agent}
-- [ ] {agent_name} ({agent_title})
-  - Use: `bmad:bmb:agents:agent-builder`
-  - Spec: `agents/{agent_name}.spec.md`
-
----
-
-## Workflows to Build
-
-{for each workflow}
-- [ ] {workflow_name}
-  - Use: `bmad:bmb:workflows:workflow` or `/workflow`
-  - Spec: `workflows/{workflow_name}/{workflow_name}.spec.md`
-
----
-
-## Installation Testing
-
-- [ ] Test installation with `bmad install`
-- [ ] Verify module.yaml prompts work correctly
-- [ ] Test installer.js (if present)
-- [ ] Test IDE-specific handlers (if present)
-
----
-
-## Documentation
-
-- [ ] Complete README.md with usage examples
-- [ ] Enhance docs/ folder with more guides
-- [ ] Add troubleshooting section
-- [ ] Document configuration options
-
----
-
-## Next Steps
-
-1. Build agents using create-agent workflow
-2. Build workflows using create-workflow workflow
-3. Test installation and functionality
-4. Iterate based on testing
-
----
-
-_Last updated: {date}_
-```
-
-### 3. Create docs/ Folder
-
-Create `{targetLocation}/docs/` folder with user documentation:
-
-### 3.1. getting-started.md
-
-```markdown
-# Getting Started with {module_display_name}
-
-Welcome to {module_code}! This guide will help you get up and running.
-
----
-
-## What This Module Does
-
-{module_purpose_from_brief}
-
----
-
-## Installation
-
-If you haven't installed the module yet:
-
-```bash
-bmad install {module_code}
-```
-
-Follow the prompts to configure the module for your needs.
-
----
-
-## First Steps
-
-{first_steps_from_brief}
-
----
-
-## Common Use Cases
-
-{common_use_cases_from_brief}
-
----
-
-## What's Next?
-
-- Check out the [Agents Reference](agents.md) to meet your team
-- Browse the [Workflows Reference](workflows.md) to see what you can do
-- See [Examples](examples.md) for real-world usage
-
----
-
-## Need Help?
-
-If you run into issues:
-1. Check the troubleshooting section in examples.md
-2. Review your module configuration
-3. Consult the broader BMAD documentation
-```
-
-### 3.2. agents.md
-
-```markdown
-# Agents Reference
-
-{module_code} includes {agent_count} specialized agents:
-
----
-
-{for each agent}
-## {agent_title}
-
-**ID:** `{agent_id}`
-**Icon:** {agent_icon}
-
-**Role:**
-{agent_role_from_spec}
-
-**When to Use:**
-{when_to_use_from_spec}
-
-**Key Capabilities:**
-{agent_capabilities_from_spec}
-
-**Menu Trigger(s):**
-{menu_triggers_from_spec}
-
----
-```
-
-### 3.3. workflows.md
-
-```markdown
-# Workflows Reference
-
-{module_code} includes {workflow_count} workflows:
-
----
-
-{for each workflow}
-## {workflow_title}
-
-**ID:** `{workflow_id}`
-**Workflow:** `{workflow_name}`
-
-**Purpose:**
-{workflow_purpose_from_spec}
-
-**When to Use:**
-{when_to_use_from_spec}
-
-**Key Steps:**
-{workflow_steps_outline_from_spec}
-
-**Agent(s):**
-{associated_agents_from_spec}
-
----
-```
-
-### 3.4. examples.md
-
-```markdown
-# Examples & Use Cases
-
-This section provides practical examples for using {module_display_name}.
-
----
-
-## Example Workflows
-
-{example_workflows_from_brief}
-
----
-
-## Common Scenarios
-
-{common_scenarios_from_brief}
-
----
-
-## Tips & Tricks
-
-{tips_from_brief}
-
----
-
-## Troubleshooting
-
-### Common Issues
-
-{troubleshooting_from_brief}
-
----
-
-## Getting More Help
-
-- Review the main BMAD documentation
-- Check module configuration in module.yaml
-- Verify all agents and workflows are properly installed
-```
-
-### 4. Update Build Tracking
-
-Update `{buildTrackingFile}`:
-- Add 'step-07-docs' to stepsCompleted
-- Note: README.md, TODO.md, and docs/ folder created
-
-### 5. Report Success
-
-"**✓ Documentation created:**"
-
-- README.md — module overview and navigation
-- TODO.md — development roadmap
-- docs/ — user documentation folder
-  - getting-started.md — quick start guide
-  - agents.md — agent reference
-  - workflows.md — workflow reference
-  - examples.md — practical examples
-
-"**User documentation is valuable even with placeholder agent/workflow specs — users will understand what each component does and how to use them.**"
-
-"**TODO.md tracks the remaining work:**"
-- Build {agent_count} agents
-- Build {workflow_count} workflows
-- Test installation
-
-### 6. MENU OPTIONS
-
-**Select an Option:** [C] Continue
-
-- IF C: Update tracking, load `{nextStepFile}`
-- IF Any other: Help, then redisplay menu
-
----
-
-## Success Metrics
-
-✅ README.md created with all sections
-✅ TODO.md created with agent/workflow checklist
-✅ docs/ folder created with user documentation
-✅ Build tracking updated

package/templates/commonproject/_bmad/bmb/workflows/module/steps-c/step-08-complete.md

@@ -1,123 +0,0 @@
----
-name: 'step-08-complete'
-description: 'Finalize, offer to run validation'
-
-buildTrackingFile: '{bmb_creations_output_folder}/modules/module-build-{module_code}.md'
-targetLocation: '{build_tracking_targetLocation}'
-validationWorkflow: '../steps-v/step-01-validate.md'
----
-
-# Step 8: Complete
-
-## STEP GOAL:
-
-Finalize the module build, update tracking, and offer to run validation.
-
-## MANDATORY EXECUTION RULES:
-
-### Universal Rules:
-
-- 📖 CRITICAL: Read the complete step file before taking any action
-- ✅ Speak in `{communication_language}`
-
-### Role Reinforcement:
-
-- ✅ You are the **Module Builder** — completing the build
-- ✅ Celebrate what was created
-- ✅ Guide next steps
-
----
-
-## MANDATORY SEQUENCE
-
-### 1. Final Build Summary
-
-"**🎉 Module structure build complete!**"
-
-**Module:** {moduleName} ({moduleCode})
-**Type:** {moduleType}
-**Location:** {targetLocation}
-
-**What was created:**
-
-| Component | Count | Location |
-|-----------|-------|----------|
-| Agent specs | {count} | agents/ |
-| Workflow specs | {count} | workflows/ |
-| Configuration | 1 | module.yaml |
-| Documentation | 2 | README.md, TODO.md |
-| Installer | {yes/no} | _module-installer/ |
-
-### 2. Update Build Tracking
-
-Update `{buildTrackingFile}`:
-```yaml
----
-moduleCode: {module_code}
-moduleName: {name}
-moduleType: {type}
-targetLocation: {location}
-stepsCompleted: ['step-01-load-brief', 'step-02-structure', 'step-03-config', 'step-04-installer', 'step-05-agents', 'step-06-workflows', 'step-07-docs', 'step-08-complete']
-created: {created_date}
-completed: {date}
-status: COMPLETE
----
-```
-
-### 3. Next Steps
-
-"**Your module structure is ready! Here's what to do next:**"
-
-1. **Review the build** — Check {targetLocation}
-2. **Build agents** — Use `bmad:bmb:agents:agent-builder` for each agent spec
-3. **Build workflows** — Use `bmad:bmb:workflows:workflow` for each workflow spec
-4. **Test installation** — Run `bmad install {module_code}`
-5. **Iterate** — Refine based on testing
-
-### 4. Offer Validation
-
-"**Would you like to run validation on the module structure?**"
-
-Validation checks:
-- File structure compliance
-- module.yaml correctness
-- Spec completeness
-- Installation readiness
-
-### 5. MENU OPTIONS
-
-**Select an Option:** [V] Validate Module [D] Done
-
-#### EXECUTION RULES:
-
-- ALWAYS halt and wait for user input
-
-#### Menu Handling Logic:
-
-- IF V: Load `{validationWorkflow}` to run validation
-- IF D: Celebration message, workflow complete
-- IF Any other: Help user, then redisplay menu
-
-### 6. Completion Message (if Done selected)
-
-"**🚀 You've built a module structure for BMAD!**"
-
-"**Module:** {moduleName} ({moduleCode})"
-"**Location:** {targetLocation}"
-"**Status:** Ready for agent and workflow implementation"
-
-"**The journey from idea to installable module continues:**
-- Agent specs → create-agent workflow
-- Workflow specs → create-workflow workflow
-- Full module → `bmad install`
-
-"**Great work! Let's build something amazing.** ✨"
-
----
-
-## Success Metrics
-
-✅ Build tracking marked COMPLETE
-✅ Summary presented to user
-✅ Next steps clearly explained
-✅ Validation offered (optional)