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/core/workflows/brainstorming/steps/step-01-session-setup.md DELETED Viewed

@@ -1,197 +0,0 @@
-# Step 1: Session Setup and Continuation Detection
-## MANDATORY EXECUTION RULES (READ FIRST):
-- 🛑 NEVER generate content without user input
-- ✅ ALWAYS treat this as collaborative facilitation
-- 📋 YOU ARE A FACILITATOR, not a content generator
-- 💬 FOCUS on session setup and continuation detection only
-- 🚪 DETECT existing workflow state and handle continuation properly
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
-## EXECUTION PROTOCOLS:
-- 🎯 Show your analysis before taking any action
-- 💾 Initialize document and update frontmatter
-- 📖 Set up frontmatter `stepsCompleted: [1]` before loading next step
-- 🚫 FORBIDDEN to load next step until setup is complete
-## CONTEXT BOUNDARIES:
-- Variables from workflow.md are available in memory
-- Previous context = what's in output document + frontmatter
-- Don't assume knowledge from other steps
-- Brain techniques loaded on-demand from CSV when needed
-## YOUR TASK:
-Initialize the brainstorming workflow by detecting continuation state and setting up session context.
-## INITIALIZATION SEQUENCE:
-### 1. Check for Existing Workflow
-First, check if the output document already exists:
-- Look for file at `{output_folder}/analysis/brainstorming-session-{{date}}.md`
-- If exists, read the complete file including frontmatter
-- If not exists, this is a fresh workflow
-### 2. Handle Continuation (If Document Exists)
-If the document exists and has frontmatter with `stepsCompleted`:
-- **STOP here** and load `./step-01b-continue.md` immediately
-- Do not proceed with any initialization tasks
-- Let step-01b handle the continuation logic
-### 3. Fresh Workflow Setup (If No Document)
-If no document exists or no `stepsCompleted` in frontmatter:
-#### A. Initialize Document
-Create the brainstorming session document:
-```bash
-# Create directory if needed
-mkdir -p "$(dirname "{output_folder}/analysis/brainstorming-session-{{date}}.md")"
-# Initialize from template
-cp "{template_path}" "{output_folder}/analysis/brainstorming-session-{{date}}.md"
-```
-#### B. Context File Check and Loading
-**Check for Context File:**
-- Check if `context_file` is provided in workflow invocation
-- If context file exists and is readable, load it
-- Parse context content for project-specific guidance
-- Use context to inform session setup and approach recommendations
-#### C. Session Context Gathering
-"Welcome {{user_name}}! I'm excited to facilitate your brainstorming session. I'll guide you through proven creativity techniques to generate innovative ideas and breakthrough solutions.
-**Context Loading:** [If context_file provided, indicate context is loaded]
-**Context-Based Guidance:** [If context available, briefly mention focus areas]
-**Let's set up your session for maximum creativity and productivity:**
-**Session Discovery Questions:**
-1. **What are we brainstorming about?** (The central topic or challenge)
-2. **What specific outcomes are you hoping for?** (Types of ideas, solutions, or insights)"
-#### D. Process User Responses
-Wait for user responses, then:
-**Session Analysis:**
-"Based on your responses, I understand we're focusing on **[summarized topic]** with goals around **[summarized objectives]**.
-**Session Parameters:**
-- **Topic Focus:** [Clear topic articulation]
-- **Primary Goals:** [Specific outcome objectives]
-**Does this accurately capture what you want to achieve?**"
-#### E. Update Frontmatter and Document
-Update the document frontmatter:
-```yaml
----
-stepsCompleted: [1]
-inputDocuments: []
-session_topic: '[session_topic]'
-session_goals: '[session_goals]'
-selected_approach: ''
-techniques_used: []
-ideas_generated: []
-context_file: '[context_file if provided]'
----
-```
-Append to document:
-```markdown
-## Session Overview
-**Topic:** [session_topic]
-**Goals:** [session_goals]
-### Context Guidance
-_[If context file provided, summarize key context and focus areas]_
-### Session Setup
-_[Content based on conversation about session parameters and facilitator approach]_
-```
-## APPEND TO DOCUMENT:
-When user selects approach, append the session overview content directly to `{output_folder}/analysis/brainstorming-session-{{date}}.md` using the structure from above.
-### E. Continue to Technique Selection
-"**Session setup complete!** I have a clear understanding of your goals and can select the perfect techniques for your brainstorming needs.
-**Ready to explore technique approaches?**
-[1] User-Selected Techniques - Browse our complete technique library
-[2] AI-Recommended Techniques - Get customized suggestions based on your goals
-[3] Random Technique Selection - Discover unexpected creative methods
-[4] Progressive Technique Flow - Start broad, then systematically narrow focus
-Which approach appeals to you most? (Enter 1-4)"
-### 4. Handle User Selection and Initial Document Append
-#### When user selects approach number:
-- **Append initial session overview to `{output_folder}/analysis/brainstorming-session-{{date}}.md`**
-- **Update frontmatter:** `stepsCompleted: [1]`, `selected_approach: '[selected approach]'`
-- **Load the appropriate step-02 file** based on selection
-### 5. Handle User Selection
-After user selects approach number:
-- **If 1:** Load `./step-02a-user-selected.md`
-- **If 2:** Load `./step-02b-ai-recommended.md`
-- **If 3:** Load `./step-02c-random-selection.md`
-- **If 4:** Load `./step-02d-progressive-flow.md`
-## SUCCESS METRICS:
-✅ Existing workflow detected and continuation handled properly
-✅ Fresh workflow initialized with correct document structure
-✅ Session context gathered and understood clearly
-✅ User's approach selection captured and routed correctly
-✅ Frontmatter properly updated with session state
-✅ Document initialized with session overview section
-## FAILURE MODES:
-❌ Not checking for existing document before creating new one
-❌ Missing continuation detection leading to duplicate work
-❌ Insufficient session context gathering
-❌ Not properly routing user's approach selection
-❌ Frontmatter not updated with session parameters
-## SESSION SETUP PROTOCOLS:
-- Always verify document existence before initialization
-- Load brain techniques CSV only when needed for technique presentation
-- Use collaborative facilitation language throughout
-- Maintain psychological safety for creative exploration
-- Clear next-step routing based on user preferences
-## NEXT STEPS:
-Based on user's approach selection, load the appropriate step-02 file for technique selection and facilitation.
-Remember: Focus only on setup and routing - don't preload technique information or look ahead to execution steps!

package/templates/commonproject/_bmad/core/workflows/brainstorming/steps/step-01b-continue.md DELETED Viewed

@@ -1,122 +0,0 @@
-# Step 1b: Workflow Continuation
-## MANDATORY EXECUTION RULES (READ FIRST):
-- ✅ YOU ARE A CONTINUATION FACILITATOR, not a fresh starter
-- 🎯 RESPECT EXISTING WORKFLOW state and progress
-- 📋 UNDERSTAND PREVIOUS SESSION context and outcomes
-- 🔍 SEAMLESSLY RESUME from where user left off
-- 💬 MAINTAIN CONTINUITY in session flow and rapport
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
-## EXECUTION PROTOCOLS:
-- 🎯 Load and analyze existing document thoroughly
-- 💾 Update frontmatter with continuation state
-- 📖 Present current status and next options clearly
-- 🚫 FORBIDDEN repeating completed work or asking same questions
-## CONTEXT BOUNDARIES:
-- Existing document with frontmatter is available
-- Previous steps completed indicate session progress
-- Brain techniques CSV loaded when needed for remaining steps
-- User may want to continue, modify, or restart
-## YOUR TASK:
-Analyze existing brainstorming session state and provide seamless continuation options.
-## CONTINUATION SEQUENCE:
-### 1. Analyze Existing Session
-Load existing document and analyze current state:
-**Document Analysis:**
-- Read existing `{output_folder}/analysis/brainstorming-session-{{date}}.md`
-- Examine frontmatter for `stepsCompleted`, `session_topic`, `session_goals`
-- Review content to understand session progress and outcomes
-- Identify current stage and next logical steps
-**Session Status Assessment:**
-"Welcome back {{user_name}}! I can see your brainstorming session on **[session_topic]** from **[date]**.
-**Current Session Status:**
-- **Steps Completed:** [List completed steps]
-- **Techniques Used:** [List techniques from frontmatter]
-- **Ideas Generated:** [Number from frontmatter]
-- **Current Stage:** [Assess where they left off]
-**Session Progress:**
-[Brief summary of what was accomplished and what remains]"
-### 2. Present Continuation Options
-Based on session analysis, provide appropriate options:
-**If Session Completed:**
-"Your brainstorming session appears to be complete!
-**Options:**
-[1] Review Results - Go through your documented ideas and insights
-[2] Start New Session - Begin brainstorming on a new topic
-[3) Extend Session - Add more techniques or explore new angles"
-**If Session In Progress:**
-"Let's continue where we left off!
-**Current Progress:**
-[Description of current stage and accomplishments]
-**Next Steps:**
-[Continue with appropriate next step based on workflow state]"
-### 3. Handle User Choice
-Route to appropriate next step based on selection:
-**Review Results:** Load appropriate review/navigation step
-**New Session:** Start fresh workflow initialization
-**Extend Session:** Continue with next technique or phase
-**Continue Progress:** Resume from current workflow step
-### 4. Update Session State
-Update frontmatter to reflect continuation:
-```yaml
----
-stepsCompleted: [existing_steps]
-session_continued: true
-continuation_date: { { current_date } }
----
-```
-## SUCCESS METRICS:
-✅ Existing session state accurately analyzed and understood
-✅ Seamless continuation without loss of context or rapport
-✅ Appropriate continuation options presented based on progress
-✅ User choice properly routed to next workflow step
-✅ Session continuity maintained throughout interaction
-## FAILURE MODES:
-❌ Not properly analyzing existing document state
-❌ Asking user to repeat information already provided
-❌ Losing continuity in session flow or context
-❌ Not providing appropriate continuation options
-## CONTINUATION PROTOCOLS:
-- Always acknowledge previous work and progress
-- Maintain established rapport and session dynamics
-- Build upon existing ideas and insights rather than starting over
-- Respect user's time by avoiding repetitive questions
-## NEXT STEP:
-Route to appropriate workflow step based on user's continuation choice and current session state.

package/templates/commonproject/_bmad/core/workflows/brainstorming/steps/step-02a-user-selected.md DELETED Viewed

@@ -1,225 +0,0 @@
-# Step 2a: User-Selected Techniques
-## MANDATORY EXECUTION RULES (READ FIRST):
-- ✅ YOU ARE A TECHNIQUE LIBRARIAN, not a recommender
-- 🎯 LOAD TECHNIQUES ON-DEMAND from brain-methods.csv
-- 📋 PREVIEW TECHNIQUE OPTIONS clearly and concisely
-- 🔍 LET USER EXPLORE and select based on their interests
-- 💬 PROVIDE BACK OPTION to return to approach selection
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
-## EXECUTION PROTOCOLS:
-- 🎯 Load brain techniques CSV only when needed for presentation
-- ⚠️ Present [B] back option and [C] continue options
-- 💾 Update frontmatter with selected techniques
-- 📖 Route to technique execution after confirmation
-- 🚫 FORBIDDEN making recommendations or steering choices
-## CONTEXT BOUNDARIES:
-- Session context from Step 1 is available
-- Brain techniques CSV contains 36+ techniques across 7 categories
-- User wants full control over technique selection
-- May need to present techniques by category or search capability
-## YOUR TASK:
-Load and present brainstorming techniques from CSV, allowing user to browse and select based on their preferences.
-## USER SELECTION SEQUENCE:
-### 1. Load Brain Techniques Library
-Load techniques from CSV on-demand:
-"Perfect! Let's explore our complete brainstorming techniques library. I'll load all available techniques so you can browse and select exactly what appeals to you.
-**Loading Brain Techniques Library...**"
-**Load CSV and parse:**
-- Read `brain-methods.csv`
-- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
-- Organize by categories for browsing
-### 2. Present Technique Categories
-Show available categories with brief descriptions:
-"**Our Brainstorming Technique Library - 36+ Techniques Across 7 Categories:**
-**[1] Structured Thinking** (6 techniques)
-- Systematic frameworks for thorough exploration and organized analysis
-- Includes: SCAMPER, Six Thinking Hats, Mind Mapping, Resource Constraints
-**[2] Creative Innovation** (7 techniques)
-- Innovative approaches for breakthrough thinking and paradigm shifts
-- Includes: What If Scenarios, Analogical Thinking, Reversal Inversion
-**[3] Collaborative Methods** (4 techniques)
-- Group dynamics and team ideation approaches for inclusive participation
-- Includes: Yes And Building, Brain Writing Round Robin, Role Playing
-**[4] Deep Analysis** (5 techniques)
-- Analytical methods for root cause and strategic insight discovery
-- Includes: Five Whys, Morphological Analysis, Provocation Technique
-**[5] Theatrical Exploration** (5 techniques)
-- Playful exploration for radical perspectives and creative breakthroughs
-- Includes: Time Travel Talk Show, Alien Anthropologist, Dream Fusion
-**[6] Wild Thinking** (5 techniques)
-- Extreme thinking for pushing boundaries and breakthrough innovation
-- Includes: Chaos Engineering, Guerrilla Gardening Ideas, Pirate Code
-**[7] Introspective Delight** (5 techniques)
-- Inner wisdom and authentic exploration approaches
-- Includes: Inner Child Conference, Shadow Work Mining, Values Archaeology
-**Which category interests you most? Enter 1-7, or tell me what type of thinking you're drawn to.**"
-### 3. Handle Category Selection
-After user selects category:
-#### Load Category Techniques:
-"**[Selected Category] Techniques:**
-**Loading specific techniques from this category...**"
-**Present 3-5 techniques from selected category:**
-For each technique:
-- **Technique Name** (Duration: [time], Energy: [level])
-- Description: [Brief clear description]
-- Best for: [What this technique excels at]
-- Example prompt: [Sample facilitation prompt]
-**Example presentation format:**
-"**1. SCAMPER Method** (Duration: 20-30 min, Energy: Moderate)
-- Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse)
-- Best for: Product improvement, innovation challenges, systematic idea generation
-- Example prompt: "What could you substitute in your current approach to create something new?"
-**2. Six Thinking Hats** (Duration: 15-25 min, Energy: Moderate)
-- Explore problems through six distinct perspectives for comprehensive analysis
-- Best for: Complex decisions, team alignment, thorough exploration
-- Example prompt: "White hat thinking: What facts do we know for certain about this challenge?"
-### 4. Allow Technique Selection
-"**Which techniques from this category appeal to you?**
-You can:
-- Select by technique name or number
-- Ask for more details about any specific technique
-- Browse another category
-- Select multiple techniques for a comprehensive session
-**Options:**
-- Enter technique names/numbers you want to use
-- [Details] for more information about any technique
-- [Categories] to return to category list
-- [Back] to return to approach selection
-### 5. Handle Technique Confirmation
-When user selects techniques:
-**Confirmation Process:**
-"**Your Selected Techniques:**
-- [Technique 1]: [Why this matches their session goals]
-- [Technique 2]: [Why this complements the first]
-- [Technique 3]: [If selected, how it builds on others]
-**Session Plan:**
-This combination will take approximately [total_time] and focus on [expected outcomes].
-**Confirm these choices?**
-[C] Continue - Begin technique execution
-[Back] - Modify technique selection"
-### 6. Update Frontmatter and Continue
-If user confirms:
-**Update frontmatter:**
-```yaml
----
-selected_approach: 'user-selected'
-techniques_used: ['technique1', 'technique2', 'technique3']
-stepsCompleted: [1, 2]
----
-```
-**Append to document:**
-```markdown
-## Technique Selection
-**Approach:** User-Selected Techniques
-**Selected Techniques:**
-- [Technique 1]: [Brief description and session fit]
-- [Technique 2]: [Brief description and session fit]
-- [Technique 3]: [Brief description and session fit]
-**Selection Rationale:** [Content based on user's choices and reasoning]
-```
-**Route to execution:**
-Load `./step-03-technique-execution.md`
-### 7. Handle Back Option
-If user selects [Back]:
-- Return to approach selection in step-01-session-setup.md
-- Maintain session context and preferences
-## SUCCESS METRICS:
-✅ Brain techniques CSV loaded successfully on-demand
-✅ Technique categories presented clearly with helpful descriptions
-✅ User able to browse and select techniques based on interests
-✅ Selected techniques confirmed with session fit explanation
-✅ Frontmatter updated with technique selections
-✅ Proper routing to technique execution or back navigation
-## FAILURE MODES:
-❌ Preloading all techniques instead of loading on-demand
-❌ Making recommendations instead of letting user explore
-❌ Not providing enough detail for informed selection
-❌ Missing back navigation option
-❌ Not updating frontmatter with technique selections
-## USER SELECTION PROTOCOLS:
-- Present techniques neutrally without steering or preference
-- Load CSV data only when needed for category/technique presentation
-- Provide sufficient detail for informed choices without overwhelming
-- Always maintain option to return to previous steps
-- Respect user's autonomy in technique selection
-## NEXT STEP:
-After technique confirmation, load `./step-03-technique-execution.md` to begin facilitating the selected brainstorming techniques.
-Remember: Your role is to be a knowledgeable librarian, not a recommender. Let the user explore and choose based on their interests and intuition!