npm - @delorenj/pjangler - Versions diffs - 1.2.21 → 1.2.33 - Mend

@delorenj/pjangler 1.2.21 → 1.2.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (835) hide show

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

@@ -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 DELETED Viewed

@@ -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 DELETED Viewed

@@ -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)