npm - @delorenj/pjangler - Versions diffs - 1.2.25 → 1.3.0 - Mend

@delorenj/pjangler 1.2.25 → 1.3.0

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 (849) hide show

package/templates/commonproject/_bmad/bmb/workflows/workflow/steps-c/step-05-plan-review.md DELETED Viewed

@@ -1,242 +0,0 @@
----
-name: 'step-05-plan-review'
-description: 'Review the complete workflow plan and approve before design'
-nextStepFile: './step-06-design.md'
-workflowPlanFile: '{bmb_creations_output_folder}/workflows/{new_workflow_name}/workflow-plan-{new_workflow_name}.md'
-advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
-partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
----
-# Step 5: Plan Review and Approval
-## STEP GOAL:
-To present the complete workflow plan (discovery, classification, requirements, tools) for review and approval before proceeding to the design phase.
-## MANDATORY EXECUTION RULES (READ FIRST):
-### Universal Rules:
-- 🛑 NEVER generate content without user input
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-### Role Reinforcement:
-- ✅ You are a workflow architect conducting a design review
-- ✅ Present the complete plan clearly
-- ✅ Solicit feedback and make refinements
-- ✅ Get explicit approval before proceeding to design
-### Step-Specific Rules:
-- 🎯 Focus ONLY on review and refinement
-- 🚫 FORBIDDEN to start designing workflow steps in this step
-- 💬 Present plan clearly, ask targeted questions
-- 🚫 DO NOT proceed to design without user approval
-## EXECUTION PROTOCOLS:
-- 🎯 Present complete plan from {workflowPlanFile}
-- 💾 Capture any modifications or refinements
-- 📖 Update frontmatter stepsCompleted when complete
-- 🚫 FORBIDDEN to load next step until user approves
-## CONTEXT BOUNDARIES:
-- Discovery (Step 1) → Classification (Step 2) → Requirements (Step 3) → Tools (Step 4)
-- ALL the information needed for design is now captured
-- This is the final checkpoint before designing the workflow structure
-- Once we proceed to Step 6, we'll be designing actual step files
-## MANDATORY SEQUENCE
-**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
-### 1. Initialize Review
-"**Let's review the complete plan before we start designing.**
-We've covered a lot of ground. Let me walk you through everything we've decided, and you can tell me what looks right and what needs adjustment."
-### 2. Present Complete Plan
-Load and present from `{workflowPlanFile}`:
-"**Complete Workflow Plan: {workflow-name}**
----
-**1. DISCOVERY** (from Step 1)
-**Your Vision:**
-[Present user's vision]
-**Who It's For:**
-[Present users/audience]
-**Key Insights:**
-[Present important context]
----
-**2. CLASSIFICATION** (from Step 2)
-**The 4 Key Decisions:**
-1. **Document Output:** {true/false} - [what it produces]
-2. **Module Affiliation:** {standalone/module} - {target path}
-3. **Session Type:** {single-session/continuable} - [implications]
-4. **Lifecycle Support:** {create-only/tri-modal} - [implications]
-**Workflow Name:** {name}
-**Target Location:** {path}
----
-**3. REQUIREMENTS** (from Step 3)
-**Flow Structure:**
-- Pattern: {linear/looping/branching/repeating}
-- Phases: {list major phases}
-- Estimated steps: {count}
-**User Interaction:**
-- Style: {collaborative/autonomous/guided/mixed}
-- Decision points: {where user must choose}
-**Inputs:** {required and optional}
-**Output:** {type and format}
-**Success Criteria:** {what success looks like}
-**Instruction Style:** {intent/prescriptive/mixed}
----
-**4. TOOLS CONFIGURATION** (from Step 4)
-**Core Tools:**
-- Party Mode: {included/excluded} - {integration point}
-- Advanced Elicitation: {included/excluded} - {integration point}
-- Brainstorming: {included/excluded} - {integration point}
-**LLM Features:**
-- Web-Browsing: {included/excluded}
-- File I/O: {included/excluded}
-- Sub-Agents: {included/excluded}
-- Sub-Processes: {included/excluded}
-**Memory:** {continuable/single-session}
----
-### 3. Detailed Review by Section
-"**Let's go through this systematically. I want your feedback on each area:**"
-**A. Vision and Scope (Discovery)**
-- "Does the 'Your Vision' section capture what you're trying to build?"
-- "Anything we missed in the key insights?"
-**B. Structural Decisions (Classification)**
-- "Do the 4 key decisions still feel right?"
-- "Any second thoughts on continuable vs single-session?"
-- "Create-only or tri-modal - still the right call?"
-**C. Requirements (Details)**
-- "Does the flow structure match what you envisioned?"
-- "Are the interaction style and decision points accurate?"
-- "Input/output specifications complete?"
-- "Success criteria clear?"
-**D. Tools (Integrations)**
-- "Do the selected tools make sense?"
-- "Integration points feel right?"
-- "Any tools we should add or remove?"
-### 4. Collect Feedback
-"**Your feedback:**
-For each section above, tell me:
-1. What looks good and should stay as-is
-2. What needs modification or refinement
-3. What's missing that should be added
-4. Anything unclear or confusing
-**Take your time - this is our last chance to make changes before we start designing the actual workflow.**"
-### 5. Process Feedback and Refine
-For each feedback item:
-- Document the requested change
-- Discuss implications on workflow design
-- Make the refinement
-- Confirm with user
-Update `{workflowPlanFile}` with all approved changes.
-### 6. Final Confirmation
-"**One last check before we proceed to design:**
-Based on everything we've discussed:
-- [Re-state the workflow's purpose in one sentence]
-- [Re-state the key structural decision: continuable/tri-modal]
-- [Re-state the flow pattern]
-You're approving this plan to move into the actual workflow design phase.
-Ready to proceed?"
-### 7. Update Plan Status
-Update `{workflowPlanFile}` frontmatter:
-```yaml
-status: APPROVED_FOR_DESIGN
-approvedDate: [current date]
-```
-### 8. Present MENU OPTIONS
-Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Design
-#### EXECUTION RULES:
-- ALWAYS halt and wait for user input
-- ONLY proceed to next step when user selects 'C'
-- User can chat or ask questions - always respond and redisplay menu
-#### Menu Handling Logic:
-- IF A: Execute {advancedElicitationTask}
-- IF P: Execute {partyModeWorkflow}
-- IF C: Update plan frontmatter with approval, then load `{nextStepFile}`
-- IF Any other: Help user, then redisplay menu
----
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-### ✅ SUCCESS:
-- Complete plan presented clearly from the plan document
-- All 4 sections reviewed systematically
-- User feedback collected and incorporated
-- User explicitly approves the plan
-- Plan status updated to APPROVED_FOR_DESIGN
-- Ready to proceed to design phase
-### ❌ SYSTEM FAILURE:
-- Not loading plan from {workflowPlanFile}
-- Skipping review sections
-- Not documenting refinements
-- Proceeding without explicit approval
-- Not updating plan status
-**Master Rule:** The plan must be complete and approved before design. This is the gatekeeper step.

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

@@ -1,329 +0,0 @@
----
-name: 'step-06-design'
-description: 'Design the workflow structure and step sequence based on gathered requirements, tools configuration, and output format'
-nextStepFile: './step-07-foundation.md'
-targetWorkflowPath: '{bmb_creations_output_folder}/workflows/{new_workflow_name}'
-workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
-advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
-partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
-stepTemplate: '../templates/step-template.md'
-stepTypePatterns: '../data/step-type-patterns.md'
-menuHandlingStandards: '../data/menu-handling-standards.md'
-frontmatterStandards: '../data/frontmatter-standards.md'
-outputFormatStandards: '../data/output-format-standards.md'
-inputDiscoveryStandards: '../data/input-discovery-standards.md'
-workflowChainingStandards: '../data/workflow-chaining-standards.md'
-trimodalWorkflowStructure: '../data/trimodal-workflow-structure.md'
-subprocessPatterns: '../data/subprocess-optimization-patterns.md'
----
-# Step 6: Workflow Structure Design
-## STEP GOAL:
-To collaboratively design the workflow structure, step sequence, and interaction patterns based on the approved plan and output format requirements.
-## MANDATORY EXECUTION RULES (READ FIRST):
-### Universal Rules:
-- 🛑 NEVER generate content without user input
-- 📖 CRITICAL: Read the complete step file before taking any action
-- 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-### Role Reinforcement:
-- ✅ You are a workflow architect and systems designer
-- ✅ If you already have been given communication or persona patterns, continue to use those while playing this new role
-- ✅ We engage in collaborative dialogue, not command-response
-- ✅ You bring workflow design patterns and architectural expertise
-- ✅ User brings their domain requirements and workflow preferences
-### Step-Specific Rules:
-- 🎯 Focus ONLY on designing structure, not implementation details
-- 🚫 FORBIDDEN to write actual step content or code in this step
-- 💬 Collaboratively design the flow and sequence
-- 🚫 DO NOT finalize design without user agreement
-## EXECUTION PROTOCOLS:
-- 🎯 Guide collaborative design process
-- 💾 After completing design, append to {workflowPlanFile}
-- 📖 Update frontmatter stepsCompleted to add this step when completed.
-- 🚫 FORBIDDEN to load next step until user selects 'C' and design is saved
-## CONTEXT BOUNDARIES:
-- Approved plan from step 4 is available and should inform design
-- Output format design from step 5 (if completed) guides structure
-- Load architecture documentation when needed for guidance
-- Focus ONLY on structure and flow design
-- Don't implement actual files in this step
-- This is about designing the blueprint, not building
-## DESIGN REFERENCE MATERIALS:
-When designing, you will load these data standards as needed (ideally within subprocesses that can return the relevant insights during the design step):
-- {stepTemplate} - Step file structure template
-- {stepTypePatterns} - Templates for different step types (init, middle, branch, validation, final)
-- {menuHandlingStandards} - Menu patterns and handler rules
-- {frontmatterStandards} - Variable definitions and path rules
-- {outputFormatStandards} - Output document patterns
-- {inputDiscoveryStandards} - How to discover documents from prior workflows
-- {workflowChainingStandards} - How workflows connect in sequences
-- {trimodalWorkflowStructure} - Tri-modal workflow patterns (if applicable)
-Example [Workflow.md](../workflow.md) for reference of a perfect workflow.md with some complex options (not all workflows will offer multiple next step options like this one - most will just auto route right to a step 1 file)
-## MANDATORY SEQUENCE
-**CRITICAL:** Follow this sequence exactly. Do not skip, reorder, or improvise unless user explicitly requests a change.
-### 1. Step Structure Design
-Load {stepTypePatterns} for available step type templates:
-This shows the standard structure for all step types:
-- Init Step (Continuable)
-- Continuation Step (01b)
-- Middle Step (Standard/Simple)
-- Branch Step
-- Validation Sequence Step
-- Init Step (With Input Discovery)
-- Final Polish Step
-- Final Step
-Based on the approved plan, collaboratively design the info to answer the following for the build plan:
-- How many major steps does this workflow need?
-- What is the goal of each step?
-- Which steps are optional vs required?
-- Should any steps repeat or loop?
-- What are the decision points within steps?
-### 1a. Continuation Support Assessment
-**Ask the user:**
-"Will this workflow potentially take multiple sessions to complete? Consider:
-- Does this workflow generate a document/output file?
-- Might users need to pause and resume the workflow?
-- Does the workflow involve extensive data collection or analysis?
-- Are there complex decisions that might require multiple sessions?
-If **YES** to any of these, we should include continuation support using step-01b-continue.md."
-**If continuation support is needed:**
-- Include step-01-init.md (with continuation detection logic)
-- Include step-01b-continue.md (for resuming workflows)
-- Ensure every step updates `stepsCompleted` in output frontmatter
-- Design the workflow to persist state between sessions
-### 2. Interaction Pattern Design
-Load {menuHandlingStandards} for menu pattern options:
-Design how users will interact with the workflow:
-- Where should users provide input vs where the AI works autonomously?
-- What menu pattern does each step need? (Standard A/P/C, Auto-proceed, Custom, Conditional)
-- Should there be Advanced Elicitation or Party Mode options?
-- How will users know their progress?
-- What confirmation points are needed?
-### 3. Data Flow Design
-Map how information flows through the workflow:
-- What data is needed at each step?
-- What outputs does each step produce?
-- How is state tracked between steps?
-- Where are checkpoints and saves needed?
-- How are errors or exceptions handled?
-### 4. File Structure Design
-Plan the workflow's file organization:
-- Will this workflow need templates?
-- Are there data files required?
-- Is a validation checklist needed?
-- What supporting files will be useful?
-- How will variables be managed?
-### 5. Role and Persona Definition
-Define the AI's role for this workflow:
-- What expertise should the AI embody?
-- How should the AI communicate with users?
-- What tone and style is appropriate?
-- How collaborative vs prescriptive should the AI be?
-### 6. Validation and Error Handling
-Design quality assurance:
-- How will the workflow validate its outputs?
-- What happens if a user provides invalid input?
-- Are there checkpoints for review?
-- How can users recover from errors?
-- What constitutes successful completion?
-### 6a. Subprocess Optimization Design
-Load {subprocessPatterns} to understand subprocess optimization patterns that can save context and improve performance during workflow execution.
-Ask the user:
-"**Should we design this workflow to leverage subprocess optimization patterns?** Consider:
-- **Pattern 1 (Grep/Regex):** Will any step search across many files or documents for patterns?
-- **Pattern 2 (Deep Analysis):** Will any step analyze multiple files for prose, logic, quality, or flow?
-- **Pattern 3 (Data Operations):** Will any step load large reference data, knowledge bases, or datasets?
-- **Pattern 4 (Parallel Execution):** Can any validation or analysis checks run in parallel instead of sequentially?
-If **YES** to any of these, we should design those steps with subprocess optimization in mind."
-**If subprocess optimization is applicable:**
-For each step that could benefit from subprocesses:
-- Identify which pattern(s) apply (Pattern 1, 2, 3, or 4)
-- Design what the subprocess should return (findings only, not full content)
-- Plan graceful fallback for LLMs without subprocess capability
-- Document optimization strategy in the build plan
-**Example subprocess integration:**
-```markdown
-### Step-Specific Rules:
-- 🎯 Analyze X files for Y - use subprocess per file (Pattern 2)
-- 💬 Subprocess returns structured findings, not full content
-- ⚙️ If subprocess unavailable: Perform analysis in main thread
-```
-**Document in the plan:**
-For each step identified for subprocess optimization, record:
-- Step number and name
-- Pattern type(s) to apply
-- What the subprocess will analyze
-- Expected return structure
-- Fallback approach
-### 7. Special Features Design
-Identify unique requirements:
-- Does this workflow need conditional logic?
-- Are there branch points based on user choices?
-- Should it integrate with other workflows?
-- Does it need to handle multiple scenarios?
-**Input Discovery:**
-If this workflow depends on documents from prior workflows, load {inputDiscoveryStandards}:
-- What prior workflow outputs does this workflow need?
-- Are these required or optional inputs?
-- How will the workflow discover these documents?
-**Workflow Chaining:**
-If this workflow is part of a sequence, load {workflowChainingStandards}:
-- What workflow comes before this one?
-- What workflow comes after this one?
-- What outputs does this workflow produce for the next?
-### 8. Design Review and Refinement
-Present the design for review:
-- Walk through the complete flow
-- Identify potential issues or improvements
-- Ensure all requirements are addressed
-- Get user agreement on the design
-## DESIGN PRINCIPLES TO APPLY:
-### Micro-File Architecture
-- Keep each step focused and self-contained
-- Ensure steps can be loaded independently
-- Design for Just-In-Time loading
-### Sequential Flow with Clear Progression
-- Each step should build on previous work
-- Include clear decision points
-- Maintain logical progression toward goal
-### Menu-Based Interactions
-- Include consistent menu patterns
-- Provide clear options at decision points
-- Allow for conversation within steps
-### State Management
-- Track progress using `stepsCompleted` array
-- Persist state in output file frontmatter
-- Support continuation where appropriate
-### 9. Document Design in Plan
-Append to {workflowPlanFile}:
-- Complete step outline with names and purposes
-- Flow diagram or sequence description
-- Interaction patterns
-- File structure requirements
-- Special features and handling
-### 10. Present MENU OPTIONS
-Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
-#### EXECUTION RULES:
-- ALWAYS halt and wait for user input after presenting menu
-- ONLY proceed to next step when user selects 'C'
-- After other menu items execution, return to this menu
-- User can chat or ask questions - always respond and then end with display again of the menu options
-- Use menu handling logic section below
-#### Menu Handling Logic:
-- IF A: Execute {advancedElicitationTask}
-- IF P: Execute {partyModeWorkflow}
-- IF C: Save design to {workflowPlanFile}, update frontmatter, then load, read entire file, then execute {nextStepFile}
-- IF Any other comments or queries: help user respond then [Redisplay Menu Options](#10-present-menu-options)
-## CRITICAL STEP COMPLETION NOTE
-ONLY WHEN C is selected and design is saved will you load {nextStepFile} to begin implementation.
----
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-### ✅ SUCCESS:
-- Workflow structure designed collaboratively
-- All steps clearly defined and sequenced
-- Interaction patterns established
-- File structure planned
-- User agreement on design
-### ❌ SYSTEM FAILURE:
-- Designing without user collaboration
-- Skipping design principles
-- Not documenting design in plan
-- Proceeding without user agreement
-**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.