agentic-qe 3.7.16 → 3.7.17

package/.claude/skills/qcsd-production-swarm/steps/03-batch1-results.md

@@ -0,0 +1,101 @@
+# Step 3: Wait for Batch 1 & Extract Results
+
+## Prerequisites
+- Step 2 (Core Agents) completed: all 3 core agents spawned
+- qe-metrics-optimizer, qe-defect-predictor, qe-root-cause-analyzer running in background
+
+## Instructions
+
+### ENFORCEMENT: NO EARLY PROCEEDING
+
+```
++-------------------------------------------------------------+
+|  YOU MUST WAIT FOR ALL THREE BACKGROUND TASKS TO COMPLETE    |
+|                                                              |
+|  DO NOT summarize what agents "would" find                   |
+|  DO NOT proceed to Step 4 early                              |
+|  DO NOT provide your own analysis as substitute              |
+|                                                              |
+|  WAIT for actual agent results                               |
+|  ONLY proceed when all three have returned                   |
++-------------------------------------------------------------+
+```
+
+### Results Extraction Checklist
+
+When results return, extract and record:
+
+```
+From qe-metrics-optimizer:
+[ ] doraScore = __.__ composite score (0-1)
+[ ] doraClassification = Elite/High/Medium/Low
+[ ] slaCompliance = __% compliance percentage
+[ ] deploymentFrequency = __/day or __/week
+[ ] leadTime = __ hours/days
+[ ] mttr = __ hours
+[ ] changeFailureRate = __%
+
+From qe-defect-predictor:
+[ ] defectTrend = declining/stable/increasing
+[ ] defectDensity = __.__ per KLOC
+[ ] hotspotCount = __ hotspots identified
+[ ] escapeCount = __ defects escaped from earlier phases
+[ ] predictedDensity = __.__ per KLOC (next period)
+
+From qe-root-cause-analyzer:
+[ ] incidentCount = __ total incidents
+[ ] maxOpenSeverity = P0/P1/P2/P3/P4/NONE
+[ ] rcaCompleteness = __% (completed RCAs / total incidents)
+[ ] averageTTD = __ hours (time to detect)
+[ ] averageTTR = __ hours (time to resolve)
+[ ] openP0P1 = __ count of open P0/P1 incidents
+```
+
+### Metrics Summary Box
+
+Output extracted metrics:
+
+```
++-------------------------------------------------------------+
+|                    BATCH 1 RESULTS SUMMARY                   |
++-------------------------------------------------------------+
+|                                                              |
+|  DORA Score:                 __.__ (Elite/High/Med/Low)       |
+|  Deployment Frequency:       __/day or __/week               |
+|  Lead Time:                  __ hours/days                   |
+|  MTTR:                       __ hours                        |
+|  Change Failure Rate:        __%                             |
+|  SLA Compliance:             __%                             |
+|                                                              |
+|  Defect Trend:               declining/stable/increasing     |
+|  Defect Density:             __.__ per KLOC                  |
+|  Predicted Density:          __.__ per KLOC                  |
+|  Hotspots:                   __                              |
+|  Defects Escaped:            __                              |
+|                                                              |
+|  Incidents (total):          __                              |
+|  Max Open Severity:          P_/NONE                         |
+|  RCA Completeness:           __%                             |
+|  Avg Time to Detect:         __ hours                        |
+|  Avg Time to Resolve:        __ hours                        |
+|  Open P0/P1:                 __                              |
+|                                                              |
++-------------------------------------------------------------+
+```
+
+**DO NOT proceed to Step 4 until ALL fields are filled.**
+
+## Success Criteria
+- [ ] All three core agents returned results
+- [ ] All metrics extracted and recorded in summary box
+- [ ] No placeholder values remain in the summary
+- [ ] Results saved for use in subsequent steps
+
+## Output
+Provide to the next step:
+- Complete Batch 1 Results Summary with all metrics filled
+- Flag values from Step 1 (needed to determine which conditional agents to spawn)
+
+## Navigation
+- On success: proceed to Step 4 (Conditional Agents) by reading `steps/04-conditional-agents.md`
+- On failure: if any agent failed, retry the failed agent before proceeding

package/.claude/skills/qcsd-production-swarm/steps/04-conditional-agents.md

@@ -0,0 +1,125 @@
+# Step 4: Spawn Conditional Agents (Parallel Batch 2)
+
+## Prerequisites
+- Step 3 (Batch 1 Results) completed with all metrics extracted
+- Flag detection results from Step 1 available
+- Core agent reports saved to OUTPUT_FOLDER
+
+## Instructions
+
+### ENFORCEMENT: NO SKIPPING CONDITIONAL AGENTS
+
+```
++-------------------------------------------------------------+
+|  IF A FLAG IS TRUE, YOU MUST SPAWN THAT AGENT                |
+|                                                              |
+|  HAS_INFRASTRUCTURE_CHANGE = TRUE -> MUST spawn qe-chaos-engineer       |
+|  HAS_PERFORMANCE_SLA = TRUE       -> MUST spawn qe-performance-tester   |
+|  HAS_REGRESSION_RISK = TRUE       -> MUST spawn qe-regression-analyzer  |
+|  HAS_RECURRING_INCIDENTS = TRUE   -> MUST spawn qe-pattern-learner      |
+|  HAS_MIDDLEWARE = TRUE             -> MUST spawn qe-middleware-validator  |
+|  HAS_SAP_INTEGRATION = TRUE       -> MUST spawn qe-sap-rfc-tester       |
+|  HAS_AUTHORIZATION = TRUE         -> MUST spawn qe-sod-analyzer         |
+|                                                              |
+|  Skipping a flagged agent is a FAILURE of this skill.        |
++-------------------------------------------------------------+
+```
+
+### Conditional Domain Mapping
+
+| Flag | Agent | Domain | MCP Tool |
+|------|-------|--------|----------|
+| HAS_INFRASTRUCTURE_CHANGE | qe-chaos-engineer | chaos-resilience | `performance_benchmark` |
+| HAS_PERFORMANCE_SLA | qe-performance-tester | chaos-resilience | `performance_benchmark` |
+| HAS_REGRESSION_RISK | qe-regression-analyzer | defect-intelligence | `defect_predict` |
+| HAS_RECURRING_INCIDENTS | qe-pattern-learner | defect-intelligence | `root_cause_analyze` |
+| HAS_MIDDLEWARE | qe-middleware-validator | enterprise-integration | `task_orchestrate` |
+| HAS_SAP_INTEGRATION | qe-sap-rfc-tester | enterprise-integration | `task_orchestrate` |
+| HAS_AUTHORIZATION | qe-sod-analyzer | enterprise-integration | `task_orchestrate` |
+
+### Decision Tree
+
+```
+IF ALL flags are FALSE:
+    -> Skip to Step 5 (no conditional agents needed)
+    -> State: "No conditional agents needed based on production context"
+
+ELSE:
+    -> Spawn ALL applicable agents in ONE message
+    -> Count how many you're spawning: __
+```
+
+### IF HAS_INFRASTRUCTURE_CHANGE: Chaos Engineer
+
+Spawn qe-chaos-engineer to assess resilience of production systems after recent infrastructure changes. Agent must analyze infrastructure change impact, run resilience tests, assess auto-recovery, evaluate resource utilization, and produce a Chaos Resilience Score (0-100). Save to: `${OUTPUT_FOLDER}/05-chaos-resilience.md`
+
+### IF HAS_PERFORMANCE_SLA: Performance Tester
+
+Spawn qe-performance-tester to validate production performance against SLA/SLO targets. Agent must assess SLA/SLO compliance, detect performance regressions, analyze error budgets, evaluate latency distributions, and produce a Performance SLA Score (0-100). Save to: `${OUTPUT_FOLDER}/06-performance-sla.md`
+
+### IF HAS_REGRESSION_RISK: Regression Analyzer
+
+Spawn qe-regression-analyzer to analyze production regressions from user-reported issues and monitoring data. Agent must inventory regressions, analyze error rates, map root causes, assess user impact, and produce a Regression Analysis Score (0-100). Save to: `${OUTPUT_FOLDER}/07-regression-analysis.md`
+
+### IF HAS_RECURRING_INCIDENTS: Pattern Learner
+
+Spawn qe-pattern-learner to detect recurring incident patterns in production. Agent must identify recurring patterns, analyze flapping services, find repeat offender modules, cluster same-root-cause incidents, and provide recommendations. Save to: `${OUTPUT_FOLDER}/08-pattern-analysis.md`
+
+### IF HAS_MIDDLEWARE: Middleware Validator
+
+Spawn qe-middleware-validator to validate middleware and message broker health. Agent must inventory middleware components, assess message flow health, evaluate broker health, analyze message loss, and produce a Middleware Health Score (0-100). Save to: `${OUTPUT_FOLDER}/10-middleware-health.md`
+
+### IF HAS_SAP_INTEGRATION: SAP RFC Tester
+
+Spawn qe-sap-rfc-tester to validate SAP RFC/BAPI integration health. Agent must inventory SAP services, assess RFC/BAPI health, validate data integrity, evaluate connector performance, and produce a SAP Health Score (0-100). Save to: `${OUTPUT_FOLDER}/11-sap-health.md`
+
+### IF HAS_AUTHORIZATION: SoD Analyzer
+
+Spawn qe-sod-analyzer to validate segregation of duties and authorization controls. Agent must assess compliance status, inventory SoD violations, analyze role assignments, evaluate access control effectiveness, and produce a SoD Compliance Score (0-100). Save to: `${OUTPUT_FOLDER}/12-sod-compliance.md`
+
+### Agent Count Validation
+
+```
++-------------------------------------------------------------+
+|                   AGENT COUNT VALIDATION                     |
++-------------------------------------------------------------+
+|  CORE AGENTS (ALWAYS 3):                                     |
+|    [ ] qe-metrics-optimizer - SPAWNED                        |
+|    [ ] qe-defect-predictor - SPAWNED                         |
+|    [ ] qe-root-cause-analyzer - SPAWNED                      |
+|  CONDITIONAL AGENTS (based on flags):                        |
+|    [ ] qe-chaos-engineer - [Y/N] (HAS_INFRA)                |
+|    [ ] qe-performance-tester - [Y/N] (HAS_PERF_SLA)         |
+|    [ ] qe-regression-analyzer - [Y/N] (HAS_REGRESS)         |
+|    [ ] qe-pattern-learner - [Y/N] (HAS_RECURRING)           |
+|    [ ] qe-middleware-validator - [Y/N] (HAS_MIDDLEWARE)       |
+|    [ ] qe-sap-rfc-tester - [Y/N] (HAS_SAP_INTEG)            |
+|    [ ] qe-sod-analyzer - [Y/N] (HAS_AUTHORIZATION)          |
+|  FEEDBACK AGENTS (ALWAYS 2): PENDING (Step 7)               |
+|  VALIDATION:                                                 |
+|    Expected so far: [3 + count of TRUE flags]                |
+|    Actual spawned:  [count]                                  |
+|    Status:          [PASS/FAIL]                              |
++-------------------------------------------------------------+
+```
+
+**DO NOT proceed if validation FAILS. Wait for all conditional agents to complete.**
+
+## Success Criteria
+- [ ] All flagged conditional agents spawned in ONE message (or skipped to Step 5 if no flags)
+- [ ] Agent count validation PASSED
+- [ ] All conditional agents completed and returned results
+- [ ] Conditional scores extracted
+
+## Output
+Provide to the next step:
+- regressionCount (from qe-regression-analyzer, or NULL)
+- chaosResilience (from qe-chaos-engineer, or NULL, 0-100)
+- middlewareHealth (from qe-middleware-validator, or NULL, 0-100)
+- sapHealth (from qe-sap-rfc-tester, or NULL, 0-100)
+- sodCompliance (from qe-sod-analyzer, or NULL, 0-100)
+- Agent count validation result
+
+## Navigation
+- On success: proceed to Step 5 (Decision Logic) by reading `steps/05-decision-synthesis.md`
+- On failure: spawn missing agents before proceeding

package/.claude/skills/qcsd-production-swarm/steps/05-decision-synthesis.md

@@ -0,0 +1,136 @@
+# Step 5: Synthesize Results & Determine Recommendation
+
+## Prerequisites
+- Step 3 (Batch 1 Results) completed with core metrics
+- Step 4 (Conditional Agents) completed with all conditional scores
+- All agent reports saved to OUTPUT_FOLDER
+
+## Instructions
+
+### ENFORCEMENT: EXACT DECISION LOGIC
+
+**You MUST apply this logic EXACTLY. No interpretation.**
+
+```
+STEP 1: Derive composite metrics from agent outputs
+-----------------------------------------------------------
+doraScore         = doraMetrics.compositeScore from qe-metrics-optimizer
+slaCompliance     = slaReport.compliancePercent from qe-metrics-optimizer
+incidentSeverity  = maxOpenSeverity from qe-root-cause-analyzer
+rcaCompleteness   = completedRcas / totalIncidents from qe-root-cause-analyzer
+defectTrend       = trendDirection from qe-defect-predictor
+defectDensity     = predictedDensity from qe-defect-predictor
+regressionCount   = regressionCount from qe-regression-analyzer (NULL if not ran)
+chaosResilience   = resilienceScore from qe-chaos-engineer (NULL if not ran, 0-100)
+middlewareHealth   = healthScore from qe-middleware-validator (NULL if not ran, 0-100)
+sapHealth          = healthScore from qe-sap-rfc-tester (NULL if not ran, 0-100)
+sodCompliance      = complianceScore from qe-sod-analyzer (NULL if not ran, 0-100)
+
+STEP 2: Check CRITICAL conditions (ANY triggers CRITICAL)
+-----------------------------------------------------------
+IF incidentSeverity in [P0, P1]        -> CRITICAL ("Active P0/P1 incidents")
+IF doraScore < 0.4                     -> CRITICAL ("DORA metrics critically low")
+IF slaCompliance < 95.0                -> CRITICAL ("SLA compliance below minimum")
+IF defectTrend == "increasing"
+   AND defectDensity > 5.0             -> CRITICAL ("Accelerating defect trend")
+IF middlewareHealth != NULL
+   AND middlewareHealth < 20           -> CRITICAL ("Middleware critically unhealthy")
+IF sapHealth != NULL
+   AND sapHealth < 20                  -> CRITICAL ("SAP integration critically unhealthy")
+IF sodCompliance != NULL
+   AND sodCompliance < 20             -> CRITICAL ("Critical SoD violations in production")
+
+STEP 3: Check HEALTHY conditions (ALL required for HEALTHY)
+-----------------------------------------------------------
+IF doraScore >= 0.7
+   AND slaCompliance >= 99.0
+   AND incidentSeverity in [P3, P4, NONE]
+   AND rcaCompleteness >= 80
+   AND defectTrend in ["declining", "stable"]
+   AND defectDensity <= 2.0
+   AND (regressionCount == NULL OR regressionCount <= 2)
+   AND (chaosResilience == NULL OR chaosResilience >= 80)
+   AND (middlewareHealth == NULL OR middlewareHealth >= 70)
+   AND (sapHealth == NULL OR sapHealth >= 70)
+   AND (sodCompliance == NULL OR sodCompliance >= 70)
+                                       -> HEALTHY
+
+STEP 4: Default
+-----------------------------------------------------------
+ELSE                                   -> DEGRADED
+```
+
+### Decision Recording
+
+```
+METRICS:
+- doraScore = __.__ (0-1)
+- slaCompliance = __%
+- incidentSeverity = P_/NONE (max open)
+- rcaCompleteness = __%
+- defectTrend = declining/stable/increasing
+- defectDensity = __.__ per KLOC
+- regressionCount = __ (if applicable, else NULL)
+- chaosResilience = __ (if applicable, else NULL, 0-100)
+- middlewareHealth = __ (if applicable, else NULL, 0-100)
+- sapHealth = __ (if applicable, else NULL, 0-100)
+- sodCompliance = __ (if applicable, else NULL, 0-100)
+
+CRITICAL CHECK:
+- incidentSeverity in [P0, P1]? __ (YES/NO)
+- doraScore < 0.4? __ (YES/NO)
+- slaCompliance < 95.0? __ (YES/NO)
+- defectTrend == "increasing" AND defectDensity > 5.0? __ (YES/NO)
+- middlewareHealth != NULL AND < 20? __ (YES/NO)
+- sapHealth != NULL AND < 20? __ (YES/NO)
+- sodCompliance != NULL AND < 20? __ (YES/NO)
+
+HEALTHY CHECK (only if no CRITICAL triggered):
+- doraScore >= 0.7? __ (YES/NO)
+- slaCompliance >= 99.0? __ (YES/NO)
+- incidentSeverity in [P3, P4, NONE]? __ (YES/NO)
+- rcaCompleteness >= 80? __ (YES/NO)
+- defectTrend in ["declining", "stable"]? __ (YES/NO)
+- defectDensity <= 2.0? __ (YES/NO)
+- regressionCount == NULL OR <= 2? __ (YES/NO)
+- chaosResilience == NULL OR >= 80? __ (YES/NO)
+- middlewareHealth == NULL OR >= 70? __ (YES/NO)
+- sapHealth == NULL OR >= 70? __ (YES/NO)
+- sodCompliance == NULL OR >= 70? __ (YES/NO)
+
+FINAL RECOMMENDATION: [HEALTHY / DEGRADED / CRITICAL]
+REASON: ___
+```
+
+### Degraded Recommendations
+
+If recommendation is DEGRADED, provide specific improvement actions:
+
+| Issue | Current Value | Required Value | Owner | Action |
+|-------|--------------|----------------|-------|--------|
+| ... | ... | ... | [who] | [what to do] |
+
+If recommendation is CRITICAL, provide mandatory remediation steps:
+
+| Fix | Priority | Effort | Must Complete Before |
+|-----|----------|--------|---------------------|
+| ... | P0 | [scope] | [production can stabilize] |
+
+## Success Criteria
+- [ ] All metrics derived from actual agent outputs
+- [ ] CRITICAL conditions checked exhaustively
+- [ ] HEALTHY conditions checked only if no CRITICAL triggered
+- [ ] Decision recording completed with all fields filled
+- [ ] FINAL RECOMMENDATION determined: HEALTHY, DEGRADED, or CRITICAL
+- [ ] Rationale documented
+
+## Output
+Provide to the next step:
+- FINAL RECOMMENDATION (HEALTHY / DEGRADED / CRITICAL)
+- Complete metrics summary
+- Decision rationale
+- Improvement/remediation actions (if DEGRADED or CRITICAL)
+
+## Navigation
+- On success: proceed to Step 6 (Report Generation) by reading `steps/06-report-generation.md`
+- On failure: if metrics are missing, return to the appropriate step to retrieve them

package/.claude/skills/qcsd-production-swarm/steps/06-report-generation.md

@@ -0,0 +1,181 @@
+# Step 6: Generate Production Health Report
+
+## Prerequisites
+- Step 5 (Decision Synthesis) completed with FINAL RECOMMENDATION
+- All agent reports saved to OUTPUT_FOLDER
+- Complete metrics available
+
+## Instructions
+
+### ENFORCEMENT: COMPLETE REPORT STRUCTURE
+
+**ALL sections below are MANDATORY. No abbreviations.**
+
+Generate the following report and save it to `${OUTPUT_FOLDER}/01-executive-summary.md`:
+
+```markdown
+# QCSD Production Health Report: [Release Name/ID]
+
+**Generated**: [Date/Time]
+**Recommendation**: [HEALTHY / DEGRADED / CRITICAL]
+**Agents Executed**: [List all agents that ran]
+**Parallel Batches**: [3]
+**Release ID**: [RELEASE_ID value]
+**Telemetry Source**: [TELEMETRY_DATA path]
+
+---
+
+## Executive Summary
+
+| Metric | Value | Threshold | Status |
+|--------|-------|-----------|--------|
+| DORA Score | X.XX | >= 0.7 (HEALTHY) | PASS/WARN/FAIL |
+| SLA Compliance | X% | >= 99% (HEALTHY) | PASS/WARN/FAIL |
+| Incident Severity | P_/NONE | P3/P4/NONE (HEALTHY) | PASS/WARN/FAIL |
+| Defect Trend | declining/stable/increasing | declining/stable (HEALTHY) | PASS/WARN/FAIL |
+| RCA Completeness | X% | >= 80% (HEALTHY) | PASS/WARN/FAIL |
+
+**Recommendation Rationale**: [1-2 sentences explaining why HEALTHY/DEGRADED/CRITICAL]
+
+---
+
+## DORA Metrics Analysis
+
+[EMBED or LINK the full report from qe-metrics-optimizer]
+
+### DORA Dashboard
+
+| Metric | Value | Classification |
+|--------|-------|----------------|
+[All 4 DORA metrics from qe-metrics-optimizer]
+
+### SLA Compliance Matrix
+[Key findings from agent output]
+
+---
+
+## Defect Prediction Analysis
+
+[EMBED or LINK the full report from qe-defect-predictor]
+
+### Trend Summary
+
+| Dimension | Value | Risk |
+|-----------|-------|------|
+[Key metrics from agent output]
+
+### Escape Analysis
+[Which phases should have caught production defects]
+
+---
+
+## Root Cause Analysis
+
+[EMBED or LINK the full report from qe-root-cause-analyzer]
+
+### Incident Summary
+
+| Metric | Value | Status |
+|--------|-------|--------|
+[Key metrics from agent output]
+
+### Top Incidents
+[Summary of highest-severity incidents]
+
+---
+
+## Conditional Analysis
+
+[INCLUDE ONLY IF APPLICABLE - based on which conditional agents ran]
+
+### Chaos Resilience (IF HAS_INFRASTRUCTURE_CHANGE)
+[Full output from qe-chaos-engineer]
+
+### Performance SLA (IF HAS_PERFORMANCE_SLA)
+[Full output from qe-performance-tester]
+
+### Regression Analysis (IF HAS_REGRESSION_RISK)
+[Full output from qe-regression-analyzer]
+
+### Pattern Analysis (IF HAS_RECURRING_INCIDENTS)
+[Full output from qe-pattern-learner]
+
+### Middleware Health (IF HAS_MIDDLEWARE)
+[Full output from qe-middleware-validator]
+
+### SAP Health (IF HAS_SAP_INTEGRATION)
+[Full output from qe-sap-rfc-tester]
+
+### SoD Compliance (IF HAS_AUTHORIZATION)
+[Full output from qe-sod-analyzer]
+
+---
+
+## Feedback Loop Synthesis
+
+[Full output from qe-learning-coordinator and qe-transfer-specialist - Step 8]
+
+### Strategic Feedback (to Ideation)
+[DORA trends + defect patterns for risk calibration]
+
+### Tactical Feedback (to Refinement)
+[RCA patterns + escape analysis for test strategy improvement]
+
+---
+
+## Recommended Actions
+
+### Immediate Actions (P0 - Blockers)
+- [ ] [Action based on findings]
+
+### Short-Term Actions (P1 - Important)
+- [ ] [Action based on findings]
+
+### Long-Term Improvements (P2 - Improvement)
+- [ ] [Action based on findings]
+
+---
+
+## Appendix: Agent Outputs
+
+[Link to or embed full outputs from each agent]
+
+---
+
+*Generated by QCSD Production Swarm v1.0*
+*Execution Model: Task Tool Parallel Swarm*
+```
+
+### Report Validation Checklist
+
+Before presenting report:
+
+```
++-- Executive Summary table is complete with all 5 metrics
++-- Recommendation matches decision logic output
++-- DORA section includes all 4 metrics with classifications
++-- Defect section includes trend direction and escape analysis
++-- RCA section includes incident severity and completeness
++-- Conditional sections included for all spawned agents
++-- Feedback loop section present (will be filled in Step 8)
++-- Recommended actions are specific (not generic)
++-- Report saved to output folder
+```
+
+**DO NOT present an incomplete report.**
+
+## Success Criteria
+- [ ] Executive summary with all 5 core metrics
+- [ ] DORA, Defect, and RCA sections complete
+- [ ] Conditional sections for all spawned agents
+- [ ] Recommended actions are specific and actionable
+- [ ] Report saved to `${OUTPUT_FOLDER}/01-executive-summary.md`
+
+## Output
+Provide to the next step:
+- Confirmation that report is saved
+- Complete metrics for learning persistence
+
+## Navigation
+- On success: proceed to Step 7 (Learning Persistence) by reading `steps/07-learning-persistence.md`
+- On failure: complete missing report sections before proceeding