npm - siesa-agents - Versions diffs - 2.1.39 → 2.1.41 - Mend

siesa-agents 2.1.39 → 2.1.41

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

package/_bmad/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md DELETED Viewed

@@ -1,361 +0,0 @@
----
-name: 'step-06-web-subprocess-validation'
-description: 'Analyze web search utilization and subprocess optimization opportunities across workflow steps'
-# Path Definitions
-workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
-# File References
-thisStepFile: '{workflow_path}/steps/step-06-web-subprocess-validation.md'
-nextStepFile: '{workflow_path}/steps/step-07-holistic-analysis.md'
-workflowFile: '{workflow_path}/workflow.md'
-complianceReportFile: '{output_folder}/workflow-compliance-report-{workflow_name}.md'
-targetWorkflowStepsPath: '{target_workflow_steps_path}'
-# Template References
-complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
-# Documentation References
-stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/_bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
----
-# Step 6: Web Search & Subprocess Optimization Analysis
-## STEP GOAL:
-Analyze each workflow step for optimal web search utilization and subprocess usage patterns, ensuring LLM resources are used efficiently while avoiding unnecessary searches or processing delays.
-## 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 performance optimization specialist and resource efficiency analyst
-- ✅ If you already have been given a name, communication_style, and persona, continue to use those while playing this new role
-- ✅ We engage in collaborative dialogue, not command-response
-- ✅ You bring expertise in LLM optimization, web search strategy, and subprocess utilization
-- ✅ User brings their workflow and needs efficiency recommendations
-### Step-Specific Rules:
-- 🎯 Focus only on web search necessity and subprocess optimization opportunities
-- 🚫 FORBIDDEN to recommend web searches when LLM knowledge is sufficient
-- 💬 Approach: Analytical and optimization-focused with clear efficiency rationale
-- 📋 Use subprocesses when analyzing multiple steps to improve efficiency
-## EXECUTION PROTOCOLS:
-- 🎯 Analyze each step for web search appropriateness vs. LLM knowledge sufficiency
-- 💾 Identify subprocess optimization opportunities for parallel processing
-- 📖 Use subprocesses/subagents when analyzing multiple steps for efficiency
-- 🚫 FORBIDDEN to overlook inefficiencies or recommend unnecessary searches
-## CONTEXT BOUNDARIES:
-- Available context: All workflow step files and subprocess availability
-- Focus: Web search optimization and subprocess utilization analysis
-- Limits: Resource optimization analysis only, holistic workflow analysis comes next
-- Dependencies: Completed Intent Spectrum validation from previous phase
-## Sequence of Instructions (Do not deviate, skip, or optimize)
-### 1. Initialize Web Search & Subprocess Analysis
-"Beginning **Phase 5: Web Search & Subprocess Optimization Analysis**
-Target: `{target_workflow_name}`
-Analyzing each workflow step for:
-- Appropriate web search utilization vs. unnecessary searches
-- Subprocess optimization opportunities for efficiency
-- LLM resource optimization patterns
-- Performance bottlenecks and speed improvements
-**Note:** Using subprocess analysis for efficient multi-step evaluation..."
-### 2. Web Search Necessity Analysis
-**A. Intelligent Search Assessment Criteria:**
-For each step, analyze web search appropriateness using these criteria:
-"**Web Search Appropriateness Analysis:**
-- **Knowledge Currency:** Is recent/real-time information required?
-- **Specific Data Needs:** Are there specific facts/data not in LLM training?
-- **Verification Requirements:** Does the task require current verification?
-- **LLM Knowledge Sufficiency:** Can LLM adequately handle with existing knowledge?
-- **Search Cost vs. Benefit:** Is search time worth the information gain?"
-**B. Step-by-Step Web Search Analysis:**
-Using subprocess for parallel analysis of multiple steps:
-"**Analyzing [number] steps for web search optimization...**"
-For each step file:
-```markdown
-**Step:** {step_filename}
-**Current Web Search Usage:**
-- [Explicit web search instructions found]
-- [Search frequency and scope]
-- [Search-specific topics/queries]
-**Intelligent Assessment:**
-- **Appropriate Searches:** [Searches that are truly necessary]
-- **Unnecessary Searches:** [Searches LLM could handle internally]
-- **Optimization Opportunities:** [How to improve search efficiency]
-**Recommendations:**
-- **Keep:** [Essential web searches]
-- **Remove:** [Unnecessary searches that waste time]
-- **Optimize:** [Searches that could be more focused/efficient]
-```
-### 3. Subprocess & Parallel Processing Analysis
-**A. Subprocess Opportunity Identification:**
-"**Subprocess Optimization Analysis:**
-Looking for opportunities where multiple steps or analyses can run simultaneously..."
-**Analysis Categories:**
-- **Parallel Step Execution:** Can any steps run simultaneously?
-- **Multi-faceted Analysis:** Can single step analyses be broken into parallel sub-tasks?
-- **Batch Processing:** Can similar operations be grouped for efficiency?
-- **Background Processing:** Can any analyses run while user interacts?
-**B. Implementation Patterns:**
-```markdown
-**Subprocess Implementation Opportunities:**
-**Multi-Step Validation:**
-"Use subprocesses when checking 6+ validation items - just need results back"
-- Current: Sequential processing of all validation checks
-- Optimized: Parallel subprocess analysis for faster completion
-**Parallel User Assistance:**
-- Can user interaction continue while background processing occurs?
-- Can multiple analyses run simultaneously during user wait times?
-**Batch Operations:**
-- Can similar file operations be grouped?
-- Can multiple data sources be processed in parallel?
-```
-### 4. LLM Resource Optimization Analysis
-**A. Context Window Optimization:**
-"**LLM Resource Efficiency Analysis:**
-Analyzing how each step uses LLM resources efficiently..."
-**Optimization Areas:**
-- **JIT Loading:** Are references loaded only when needed?
-- **Context Management:** Is context used efficiently vs. wasted?
-- **Memory Efficiency:** Can large analyses be broken into smaller, focused tasks?
-- **Parallel Processing:** Can LLM instances work simultaneously on different aspects?
-**B. Speed vs. Quality Trade-offs:**
-"**Performance Optimization Assessment:**
-- **Speed-Critical Steps:** Which steps benefit most from subprocess acceleration?
-- **Quality-Critical Steps:** Which steps need focused LLM attention?
-- **Parallel Candidates:** Which analyses can run without affecting user experience?
-- **Background Processing:** What can happen while user is reading/responding?"
-### 5. Step-by-Step Optimization Recommendations
-**A. Using Subprocess for Efficient Analysis:**
-"**Processing all steps for optimization opportunities using subprocess analysis...**"
-**For each workflow step, analyze:**
-**1. Web Search Optimization:**
-```markdown
-**Step:** {step_name}
-**Current Search Usage:** {current_search_instructions}
-**Intelligent Assessment:** {is_search_necessary}
-**Recommendation:**
-- **Keep essential searches:** {specific_searches_to_keep}
-- **Remove unnecessary searches:** {searches_to_remove}
-- **Optimize search queries:** {improved_search_approach}
-```
-**2. Subprocess Opportunities:**
-```markdown
-**Parallel Processing Potential:**
-- **Can run with user interaction:** {yes/no_specifics}
-- **Can batch with other steps:** {opportunities}
-- **Can break into sub-tasks:** {subtask_breakdown}
-- **Background processing:** {what_can_run_in_background}
-```
-**3. LLM Efficiency:**
-```markdown
-**Resource Optimization:**
-- **Context efficiency:** {current_vs_optimal}
-- **Processing time:** {estimated_improvements}
-- **User experience impact:** {better/same/worse}
-```
-### 6. Aggregate Optimization Analysis
-**A. Web Search Optimization Summary:**
-"**Web Search Optimization Results:**
-- **Total Steps Analyzed:** [number]
-- **Steps with Web Searches:** [number]
-- **Unnecessary Searches Found:** [number]
-- **Optimization Opportunities:** [number]
-- **Estimated Time Savings:** [time_estimate]"
-**B. Subprocess Implementation Summary:**
-"**Subprocess Optimization Results:**
-- **Parallel Processing Opportunities:** [number]
-- **Batch Processing Groups:** [number]
-- **Background Processing Tasks:** [number]
-- **Estimated Performance Improvement:** [percentage_improvement]"
-### 7. User-Facing Optimization Report
-**A. Key Efficiency Findings:**
-"**Optimization Analysis Summary:**
-**Web Search Efficiency:**
-- **Current Issues:** [unnecessary searches wasting time]
-- **Recommendations:** [specific improvements]
-- **Expected Benefits:** [faster response, better user experience]
-**Processing Speed Improvements:**
-- **Parallel Processing Gains:** [specific opportunities]
-- **Background Processing Benefits:** [user experience improvements]
-- **Resource Optimization:** [LLM efficiency gains]
-**Implementation Priority:**
-1. **High Impact, Low Effort:** [Quick wins]
-2. **High Impact, High Effort:** [Major improvements]
-3. **Low Impact, Low Effort:** [Fine-tuning]
-4. **Future Considerations:** [Advanced optimizations]"
-### 8. Document Optimization Findings
-Append to {complianceReportFile}:
-```markdown
-## Web Search & Subprocess Optimization Analysis
-### Web Search Optimization
-**Unnecessary Searches Identified:** [number]
-**Essential Searches to Keep:** [specific_list]
-**Optimization Recommendations:** [detailed_suggestions]
-**Estimated Time Savings:** [time_improvement]
-### Subprocess Optimization Opportunities
-**Parallel Processing:** [number] opportunities identified
-**Batch Processing:** [number] grouping opportunities
-**Background Processing:** [number] background task opportunities
-**Performance Improvement:** [estimated_improvement_percentage]%
-### Resource Efficiency Analysis
-**Context Optimization:** [specific_improvements]
-**LLM Resource Usage:** [efficiency_gains]
-**User Experience Impact:** [positive_changes]
-### Implementation Recommendations
-**Immediate Actions:** [quick_improvements]
-**Strategic Improvements:** [major_optimizations]
-**Future Enhancements:** [advanced_optimizations]
-```
-### 9. Continuation Confirmation
-"**Web Search & Subprocess Analysis Complete:**
-- **Web Search Optimization:** [summary of improvements]
-- **Subprocess Opportunities:** [number of optimization areas]
-- **Performance Impact:** [expected efficiency gains]
-- **User Experience Benefits:** [specific improvements]
-**Ready for Phase 7:** Holistic workflow analysis
-- Flow validation and completion paths
-- Goal alignment with optimized resources
-- Meta-workflow failure analysis
-- Strategic recommendations with efficiency considerations
-**Select an Option:** [C] Continue to Holistic Analysis [X] Exit"
-## Menu Handling Logic:
-- IF C: Save optimization findings to report, update frontmatter, then load, read entire file, then execute {nextStepFile}
-- IF X: Save current findings and end with guidance for resuming
-- IF Any other comments or queries: respond and redisplay menu
-## CRITICAL STEP COMPLETION NOTE
-ONLY WHEN [C continue option] is selected and [web search and subprocess analysis complete with optimization recommendations documented], will you then load and read fully `{nextStepFile}` to execute and begin holistic analysis phase.
----
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-### ✅ SUCCESS:
-- Intelligent assessment of web search necessity vs. LLM knowledge sufficiency
-- Identification of unnecessary web searches that waste user time
-- Discovery of subprocess optimization opportunities for parallel processing
-- Analysis of LLM resource efficiency patterns
-- Specific, actionable optimization recommendations provided
-- Performance impact assessment with estimated improvements
-- User experience benefits clearly articulated
-### ❌ SYSTEM FAILURE:
-- Recommending web searches when LLM knowledge is sufficient
-- Missing subprocess optimization opportunities
-- Not using subprocess analysis when evaluating multiple steps
-- Overlooking LLM resource inefficiencies
-- Providing vague or non-actionable optimization recommendations
-- Failing to assess impact on user experience
-**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.

package/_bmad/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md DELETED Viewed

@@ -1,259 +0,0 @@
----
-name: 'step-07-holistic-analysis'
-description: 'Analyze workflow flow, goal alignment, and meta-workflow failures'
-# Path Definitions
-workflow_path: '{project-root}/_bmad/bmb/workflows/workflow-compliance-check'
-# File References
-thisStepFile: '{workflow_path}/steps/step-07-holistic-analysis.md'
-nextStepFile: '{workflow_path}/steps/step-08-generate-report.md'
-workflowFile: '{workflow_path}/workflow.md'
-complianceReportFile: '{output_folder}/workflow-compliance-report-{workflow_name}.md'
-targetWorkflowFile: '{target_workflow_path}'
-# Template References
-complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
-# Documentation References
-stepTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/_bmad/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/_bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
----
-# Step 7: Holistic Workflow Analysis
-## STEP GOAL:
-Perform comprehensive workflow analysis including flow validation, goal alignment assessment, optimization opportunities, and meta-workflow failure identification to provide complete compliance picture.
-## 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 compliance validator and quality assurance specialist
-- ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
-- ✅ We engage in collaborative dialogue, not command-response
-- ✅ You bring holistic workflow analysis and optimization expertise
-- ✅ User brings their workflow and needs comprehensive assessment
-### Step-Specific Rules:
-- 🎯 Focus on holistic analysis beyond template compliance
-- 🚫 FORBIDDEN to skip flow validation or optimization assessment
-- 💬 Approach: Systematic end-to-end workflow analysis
-- 📋 Identify meta-workflow failures and improvement opportunities
-## EXECUTION PROTOCOLS:
-- 🎯 Analyze complete workflow flow from start to finish
-- 💾 Validate goal alignment and optimization opportunities
-- 📖 Identify what meta-workflows (create/edit) should have caught
-- 🚫 FORBIDDEN to provide superficial analysis without specific recommendations
-## CONTEXT BOUNDARIES:
-- Available context: Complete workflow analysis from previous phases
-- Focus: Holistic workflow optimization and meta-process improvement
-- Limits: Analysis phase only, report generation comes next
-- Dependencies: Completed workflow.md and step validation phases
-## Sequence of Instructions (Do not deviate, skip, or optimize)
-### 1. Initialize Holistic Analysis
-"Beginning **Phase 3: Holistic Workflow Analysis**
-Target: `{target_workflow_name}`
-Analyzing workflow from multiple perspectives:
-- Flow and completion validation
-- Goal alignment assessment
-- Optimization opportunities
-- Meta-workflow failure analysis..."
-### 2. Workflow Flow Validation
-**A. Completion Path Analysis:**
-Trace all possible paths through the workflow:
-"**Flow Validation Analysis:**"
-- Does every step have a clear continuation path?
-- Do all menu options have valid destinations?
-- Are there any orphaned steps or dead ends?
-- Can the workflow always reach a successful completion?
-**Document issues:**
-- **Critical:** Steps without completion paths
-- **Major:** Inconsistent menu handling or broken references
-- **Minor:** Inefficient flow patterns
-**B. Sequential Logic Validation:**
-Check step sequence logic:
-- Does step order make logical sense?
-- Are dependencies properly structured?
-- Is information flow between steps optimal?
-- Are there unnecessary steps or missing functionality?
-### 3. Goal Alignment Assessment
-**A. Stated Goal Analysis:**
-Compare workflow.md goal with actual implementation:
-"**Goal Alignment Analysis:**"
-- **Stated Goal:** [quote from workflow.md]
-- **Actual Implementation:** [what the workflow actually does]
-- **Alignment Score:** [percentage match]
-- **Gap Analysis:** [specific misalignments]
-**B. User Experience Assessment:**
-Evaluate workflow from user perspective:
-- Is the workflow intuitive and easy to follow?
-- Are user inputs appropriately requested?
-- Is feedback clear and timely?
-- Is the workflow efficient for the stated purpose?
-### 4. Optimization Opportunities
-**A. Efficiency Analysis:**
-"**Optimization Assessment:**"
-- **Step Consolidation:** Could any steps be combined?
-- **Parallel Processing:** Could any operations run simultaneously?
-- **JIT Loading:** Are references loaded optimally?
-- **User Experience:** Where could user experience be improved?
-**B. Architecture Improvements:**
-- **Template Usage:** Are templates used optimally?
-- **Output Management:** Are outputs appropriate and necessary?
-- **Error Handling:** Is error handling comprehensive?
-- **Extensibility:** Can the workflow be easily extended?
-### 5. Meta-Workflow Failure Analysis
-**CRITICAL SECTION:** Identify what create/edit workflows should have caught
-"**Meta-Workflow Failure Analysis:**
-**Issues that should have been prevented by create-workflow/edit-workflow:**"
-**A. Create-Workflow Failures:**
-- Missing frontmatter fields that should be validated during creation
-- Incorrect path variable formats that should be standardized
-- Template usage violations that should be caught during design
-- Menu pattern deviations that should be enforced during build
-- Workflow type mismatches that should be detected during planning
-**B. Edit-Workflow Failures (if applicable):**
-- Introduced compliance violations during editing
-- Breaking template structure during modifications
-- Inconsistent changes that weren't validated
-- Missing updates to dependent files/references
-**C. Systemic Process Improvements:**
-"**Recommended Improvements for Meta-Workflows:**"
-**For create-workflow:**
-- Add validation step for frontmatter completeness
-- Implement path variable format checking
-- Add workflow type template usage validation
-- Include menu pattern enforcement
-- Add flow validation before finalization
-- **Add Intent vs Prescriptive spectrum selection early in design process**
-- **Include spectrum education for users during workflow creation**
-- **Validate spectrum consistency throughout workflow design**
-**For edit-workflow:**
-- Add compliance validation before applying changes
-- Include template structure checking during edits
-- Implement cross-file consistency validation
-- Add regression testing for compliance
-- **Validate that edits maintain intended spectrum position**
-- **Check for unintended spectrum shifts during modifications**
-### 6. Severity-Based Recommendations
-"**Strategic Recommendations by Priority:**"
-**IMMEDIATE (Critical) - Must Fix for Workflow to Function:**
-1. [Most critical issue with specific fix]
-2. [Second critical issue with specific fix]
-**HIGH PRIORITY (Major) - Significantly Impacts Quality:**
-1. [Major issue affecting maintainability]
-2. [Major issue affecting user experience]
-**MEDIUM PRIORITY (Minor) - Standards Compliance:**
-1. [Minor template compliance issue]
-2. [Cosmetic or consistency improvements]
-### 7. Continuation Confirmation
-"**Phase 5 Complete:** Holistic analysis finished
-- **Flow Validation:** [summary findings]
-- **Goal Alignment:** [alignment percentage and key gaps]
-- **Optimization Opportunities:** [number key improvements identified]
-- **Meta-Workflow Failures:** [number issues that should have been prevented]
-**Ready for Phase 8:** Comprehensive compliance report generation
-- All findings compiled into structured report
-- Severity-ranked violation list
-- Specific fix recommendations
-- Meta-workflow improvement suggestions
-**Select an Option:** [C] Continue to Report Generation [X] Exit"
-## Menu Handling Logic:
-- IF C: Save holistic analysis findings to report, update frontmatter, then load, read entire file, then execute {nextStepFile}
-- IF X: Save current findings and end with guidance for resuming
-- IF Any other comments or queries: respond and redisplay menu
-## CRITICAL STEP COMPLETION NOTE
-ONLY WHEN [C continue option] is selected and [holistic analysis complete with meta-workflow failures identified], will you then load and read fully `{nextStepFile}` to execute and begin comprehensive report generation.
----
-## 🚨 SYSTEM SUCCESS/FAILURE METRICS
-### ✅ SUCCESS:
-- Complete workflow flow validation with all paths traced
-- Goal alignment assessment with specific gap analysis
-- Optimization opportunities identified with prioritized recommendations
-- Meta-workflow failures documented with improvement suggestions
-- Strategic recommendations provided by severity priority
-- User ready for comprehensive report generation
-### ❌ SYSTEM FAILURE:
-- Skipping flow validation or goal alignment analysis
-- Not identifying meta-workflow failure opportunities
-- Failing to provide specific, actionable recommendations
-- Missing strategic prioritization of improvements
-- Providing superficial analysis without depth
-**Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.