agentic-qe 3.3.2 → 3.3.4

package/v3/assets/agents/v3/qe-gap-detector.md

@@ -238,6 +238,45 @@ Use via CLI: `aqe skills show risk-based-testing`
 Use via Claude Code: `Skill("test-design-techniques")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Quality-Criteria Loop (Development → Ideation)
+**Role**: PRODUCER - Stores coverage gap patterns for AC improvement
+
+### On Gap Detection, Store Quality-Criteria Signal:
+```typescript
+mcp__agentic_qe__cross_phase_store({
+  loop: "quality-criteria",
+  data: {
+    untestablePatterns: [
+      {
+        acPattern: "<vague-ac-pattern>",
+        problem: "Not testable - missing specific assertions",
+        frequency: <0.0-1.0>,
+        betterPattern: "Given/When/Then with specific values"
+      }
+    ],
+    coverageGaps: [
+      {
+        codeArea: "<path/to/file>",
+        coveragePercentage: <percentage>,
+        rootCause: "No acceptance criteria for this path",
+        acImprovement: "Add explicit AC for edge cases"
+      }
+    ],
+    recommendations: {
+      forRequirementsValidator: ["<recommendations for AC validation>"],
+      acTemplates: {}
+    }
+  }
+})
+```
+
+### Signal Flow:
+- **Produces**: Coverage gaps mapped to AC problems → consumed by qe-requirements-validator, qe-bdd-generator
+- **Namespace**: `aqe/cross-phase/quality-criteria/ac-quality`
+- **TTL**: 60 days
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the coverage-analysis bounded context (ADR-003).
 

package/v3/assets/agents/v3/qe-pattern-learner.md

@@ -250,6 +250,37 @@ Use via CLI: `aqe skills show agentdb-learning`
 Use via Claude Code: `Skill("reasoningbank-intelligence")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Tactical Loop (Grooming → Ideation)
+**Role**: PRODUCER - Stores SFDIPOT factor weights from pattern analysis
+
+### On Pattern Discovery, Store Tactical Signal:
+```typescript
+mcp__agentic_qe__cross_phase_store({
+  loop: "tactical",
+  data: {
+    factorWeights: [
+      {
+        factor: "<Structure|Function|Data|Interfaces|Platform|Operations|Time>",
+        weight: <0.0-1.0>,
+        defectPercentage: <percentage>,
+        commonPatterns: ["<pattern-1>", "<pattern-2>"]
+      }
+    ],
+    featureContext: "<feature-being-analyzed>",
+    recommendations: {
+      forProductFactorsAssessor: ["<factor-based recommendations>"]
+    }
+  }
+})
+```
+
+### Signal Flow:
+- **Produces**: SFDIPOT factor weights → consumed by qe-product-factors-assessor
+- **Namespace**: `aqe/cross-phase/tactical/sfdipot-weights`
+- **TTL**: 90 days (tactical insights inform future feature grooming)
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the learning-optimization bounded context (ADR-012).
 

package/v3/assets/agents/v3/qe-product-factors-assessor.md

@@ -306,6 +306,40 @@ Use via CLI: `aqe skills show brutal-honesty-review`
 Use via Claude Code: `Skill("context-driven-testing")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Tactical Loop (Grooming → Ideation)
+**Role**: CONSUMER - Receives SFDIPOT factor weights from production analysis
+
+### On Startup, Query Tactical Signals:
+```typescript
+const result = await mcp__agentic_qe__cross_phase_query({
+  loop: "tactical",
+  maxAge: "90d",
+  featureContext: "<current-feature>"  // Optional: filter by feature
+});
+
+// Apply learned factor weights to SFDIPOT analysis
+for (const signal of result.signals) {
+  if (signal.factorWeights) {
+    for (const factor of signal.factorWeights) {
+      // Prioritize factors with higher production defect correlation
+      adjustFactorWeight(factor.factor, factor.weight);
+    }
+  }
+}
+```
+
+### How to Use Injected Signals:
+1. **Factor Prioritization**: Use `signal.factorWeights` to prioritize SFDIPOT factors
+2. **Common Patterns**: Reference `factor.commonPatterns` when documenting risks
+3. **Recommendations**: Apply `signal.recommendations.forProductFactorsAssessor`
+
+### Signal Flow:
+- **Consumes**: SFDIPOT factor weights from qe-pattern-learner
+- **Namespace**: `aqe/cross-phase/tactical/sfdipot-weights`
+- **Expected Signals**: Factor weights with defect percentages and patterns
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the requirements-validation bounded context (ADR-004).
 

package/v3/assets/agents/v3/qe-quality-criteria-recommender.md

@@ -300,6 +300,38 @@ Use via CLI: `aqe skills show brutal-honesty-review`
 Use via Claude Code: `Skill("brutal-honesty-review")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Strategic Loop (Production → Ideation)
+**Role**: CONSUMER - Receives production insights to recommend better quality criteria
+
+### On Startup, Query Strategic Signals:
+```typescript
+const result = await mcp__agentic_qe__cross_phase_query({
+  loop: "strategic",
+  maxAge: "90d"
+});
+
+// Apply production learnings to quality criteria recommendations
+for (const signal of result.signals) {
+  if (signal.recommendations?.forQualityCriteria) {
+    for (const rec of signal.recommendations.forQualityCriteria) {
+      addQualityCriteriaRecommendation(rec);
+    }
+  }
+}
+```
+
+### How to Use Injected Signals:
+1. **Defect-Prone Areas**: Prioritize quality criteria for areas with high defect weights
+2. **Recommendations**: Apply `signal.recommendations.forQualityCriteria` directly
+3. **Evidence**: Reference defect evidence when explaining recommendations
+
+### Signal Flow:
+- **Consumes**: Production risk weights from qe-defect-predictor
+- **Namespace**: `aqe/cross-phase/strategic/production-risk`
+- **Expected Signals**: Recommendations for quality criteria improvements
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the requirements-validation bounded context (ADR-004).
 

package/v3/assets/agents/v3/qe-quality-gate.md

@@ -197,6 +197,45 @@ Use via CLI: `aqe skills show quality-metrics`
 Use via Claude Code: `Skill("compliance-testing")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Operational Loop (CI/CD → Development)
+**Role**: PRODUCER - Stores flaky test patterns and gate failures
+
+### On Gate Failure or Flaky Detection, Store Operational Signal:
+```typescript
+mcp__agentic_qe__cross_phase_store({
+  loop: "operational",
+  data: {
+    flakyPatterns: [
+      {
+        pattern: "<flaky test pattern>",
+        frequency: <0.0-1.0>,
+        affectedTests: ["<test-file-1>", "<test-file-2>"],
+        rootCause: "<identified root cause>",
+        fix: "<recommended fix>"
+      }
+    ],
+    gateFailures: [
+      {
+        reason: "<failure reason>",
+        percentage: <metric-value>,
+        trend: "<increasing|stable|decreasing>"
+      }
+    ],
+    recommendations: {
+      forTestArchitect: ["<test architecture recommendations>"],
+      antiPatterns: ["<anti-patterns to avoid>"]
+    }
+  }
+})
+```
+
+### Signal Flow:
+- **Produces**: Flaky patterns, gate failures → consumed by qe-test-architect, qe-tdd-specialist
+- **Namespace**: `aqe/cross-phase/operational/test-health`
+- **TTL**: 30 days (operational insights are time-sensitive)
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the quality-assessment bounded context (ADR-004).
 

package/v3/assets/agents/v3/qe-requirements-validator.md

@@ -381,6 +381,43 @@ Use via CLI: `aqe skills show context-driven-testing`
 Use via Claude Code: `Skill("bdd-scenario-tester")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Quality-Criteria Loop (Development → Ideation)
+**Role**: CONSUMER - Receives untestable patterns to flag during validation
+
+### On Startup, Query Quality-Criteria Signals:
+```typescript
+const result = await mcp__agentic_qe__cross_phase_query({
+  loop: "quality-criteria",
+  maxAge: "60d"
+});
+
+// Learn from historical untestable patterns
+for (const signal of result.signals) {
+  if (signal.untestablePatterns) {
+    for (const pattern of signal.untestablePatterns) {
+      // Flag these patterns during AC validation
+      addKnownUntestablePattern(pattern.acPattern, pattern.betterPattern);
+    }
+  }
+  if (signal.recommendations?.forRequirementsValidator) {
+    applyValidationRecommendations(signal.recommendations.forRequirementsValidator);
+  }
+}
+```
+
+### How to Use Injected Signals:
+1. **Pattern Detection**: Flag AC matching `untestablePatterns[].acPattern`
+2. **Improvement Suggestions**: Suggest `untestablePatterns[].betterPattern`
+3. **AC Templates**: Use `signal.recommendations.acTemplates` for guidance
+4. **Root Causes**: Reference `coverageGaps[].rootCause` in validation feedback
+
+### Signal Flow:
+- **Consumes**: Untestable patterns from qe-coverage-specialist, qe-gap-detector
+- **Namespace**: `aqe/cross-phase/quality-criteria/ac-quality`
+- **Expected Signals**: AC patterns with testability problems and improvements
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the requirements-validation bounded context (ADR-006).
 

package/v3/assets/agents/v3/qe-risk-assessor.md

@@ -251,6 +251,39 @@ Use via CLI: `aqe skills show risk-based-testing`
 Use via Claude Code: `Skill("quality-metrics")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Strategic Loop (Production → Ideation)
+**Role**: CONSUMER - Receives production risk weights to inform risk assessment
+
+### On Startup, Query Strategic Signals:
+```typescript
+const result = await mcp__agentic_qe__cross_phase_query({
+  loop: "strategic",
+  maxAge: "90d"
+});
+
+// Apply risk weights to current assessment
+for (const signal of result.signals) {
+  if (signal.riskWeights) {
+    for (const weight of signal.riskWeights) {
+      // Boost risk scores for categories with production defects
+      applyHistoricalRiskWeight(weight.category, weight.weight, weight.confidence);
+    }
+  }
+}
+```
+
+### How to Use Injected Signals:
+1. **Risk Category Weights**: Use `signal.riskWeights` to prioritize assessment categories
+2. **Confidence Levels**: Trust weights with high confidence (>0.8) more heavily
+3. **Recommendations**: Apply `signal.recommendations.forRiskAssessor` directly
+
+### Signal Flow:
+- **Consumes**: Production risk weights from qe-defect-predictor
+- **Namespace**: `aqe/cross-phase/strategic/production-risk`
+- **Expected Signals**: Risk weights by category with evidence
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the quality-assessment bounded context (ADR-004).
 

package/v3/assets/agents/v3/qe-tdd-specialist.md

@@ -211,6 +211,39 @@ Use via CLI: `aqe skills show tdd-london-chicago`
 Use via Claude Code: `Skill("tdd-london-chicago")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Operational Loop (CI/CD → Development)
+**Role**: CONSUMER - Receives flaky patterns to avoid in TDD cycles
+
+### On Startup, Query Operational Signals:
+```typescript
+const result = await mcp__agentic_qe__cross_phase_query({
+  loop: "operational",
+  maxAge: "30d"
+});
+
+// Apply test health learnings to TDD patterns
+for (const signal of result.signals) {
+  if (signal.recommendations?.antiPatterns) {
+    for (const antiPattern of signal.recommendations.antiPatterns) {
+      // Never use these patterns when writing tests
+      avoidPattern(antiPattern);
+    }
+  }
+}
+```
+
+### How to Use Injected Signals:
+1. **Anti-Patterns in RED phase**: Don't write tests using patterns in `antiPatterns`
+2. **Flaky Prevention**: Check `flakyPatterns[].pattern` before writing async tests
+3. **Stability Guidance**: Use `flakyPatterns[].fix` for similar test scenarios
+
+### Signal Flow:
+- **Consumes**: Flaky patterns and anti-patterns from qe-quality-gate
+- **Namespace**: `aqe/cross-phase/operational/test-health`
+- **Expected Signals**: Anti-patterns and flaky test fixes
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the test-generation bounded context (ADR-002).
 

package/v3/assets/agents/v3/qe-test-architect.md

@@ -219,6 +219,42 @@ Use via CLI: `aqe skills show shift-left-testing`
 Use via Claude Code: `Skill("shift-left-testing")`
 </skills_available>
 
+<cross_phase_memory>
+**QCSD Feedback Loop**: Operational Loop (CI/CD → Development)
+**Role**: CONSUMER - Receives flaky patterns and test health data
+
+### On Startup, Query Operational Signals:
+```typescript
+const result = await mcp__agentic_qe__cross_phase_query({
+  loop: "operational",
+  maxAge: "30d"
+});
+
+// Apply test health learnings to test architecture
+for (const signal of result.signals) {
+  if (signal.flakyPatterns) {
+    for (const flaky of signal.flakyPatterns) {
+      // Avoid patterns that cause flakiness
+      addAntiPattern(flaky.pattern, flaky.fix);
+    }
+  }
+  if (signal.recommendations?.antiPatterns) {
+    applyAntiPatterns(signal.recommendations.antiPatterns);
+  }
+}
+```
+
+### How to Use Injected Signals:
+1. **Anti-Patterns**: Avoid patterns listed in `signal.recommendations.antiPatterns`
+2. **Flaky Fixes**: Apply `flakyPattern.fix` recommendations to similar test structures
+3. **Architecture Guidance**: Use `signal.recommendations.forTestArchitect`
+
+### Signal Flow:
+- **Consumes**: Flaky patterns and gate failures from qe-quality-gate
+- **Namespace**: `aqe/cross-phase/operational/test-health`
+- **Expected Signals**: Flaky test patterns with root causes and fixes
+</cross_phase_memory>
+
 <coordination_notes>
 **V3 Architecture**: This agent operates within the test-generation bounded context (ADR-002).
 

package/v3/assets/hooks/cross-phase-memory.yaml

@@ -0,0 +1,253 @@
+# Cross-Phase Memory Hooks Configuration
+#
+# Defines automatic triggers for storing and querying cross-phase signals.
+# These hooks enable the 4 QCSD feedback loops to operate automatically.
+#
+# Version: 1.0.0
+# Last Updated: 2026-01-25
+
+version: "1.0"
+enabled: true
+
+# =============================================================================
+# Hook Definitions
+# =============================================================================
+
+hooks:
+  # ---------------------------------------------------------------------------
+  # Loop 1: Production → Ideation (Strategic)
+  # ---------------------------------------------------------------------------
+
+  post-defect-analysis:
+    description: "Store risk weights after production defect analysis"
+    trigger:
+      event: "agent-complete"
+      agent: "qe-defect-predictor"
+      conditions:
+        - "result.defects.length > 0"
+    actions:
+      - type: "store-signal"
+        loop: "strategic"
+        namespace: "qcsd-memory/production-patterns/defect-weights"
+        extract:
+          riskWeights: "result.riskWeights"
+          recommendations: "result.recommendations"
+      - type: "notify-agent"
+        target: "qe-learning-coordinator"
+        message: "New risk weights available from production"
+
+  pre-ideation:
+    description: "Query production signals before ideation phase"
+    trigger:
+      event: "phase-start"
+      phase: "ideation"
+    actions:
+      - type: "query-signals"
+        namespace: "qcsd-memory/production-patterns/defect-weights"
+        maxAge: "90d"
+        injectInto:
+          - "qe-risk-assessor"
+          - "qe-quality-criteria-recommender"
+
+  # ---------------------------------------------------------------------------
+  # Loop 2: Production → Grooming (Tactical)
+  # ---------------------------------------------------------------------------
+
+  post-pattern-analysis:
+    description: "Store SFDIPOT weights after pattern learning"
+    trigger:
+      event: "agent-complete"
+      agent: "qe-pattern-learner"
+      conditions:
+        - "result.patterns.length > 0"
+    actions:
+      - type: "store-signal"
+        loop: "tactical"
+        namespace: "qcsd-memory/production-patterns/failure-modes"
+        extract:
+          factorWeights: "result.factorWeights"
+          featureContext: "result.featureContext"
+          recommendations: "result.recommendations"
+
+  pre-grooming-tactical:
+    description: "Query SFDIPOT weights before grooming"
+    trigger:
+      event: "phase-start"
+      phase: "grooming"
+    actions:
+      - type: "query-signals"
+        namespace: "qcsd-memory/production-patterns/failure-modes"
+        maxAge: "90d"
+        filterBy: "featureContext"
+        injectInto:
+          - "qe-product-factors-assessor"
+
+  # ---------------------------------------------------------------------------
+  # Loop 3: CI/CD → Development (Operational)
+  # ---------------------------------------------------------------------------
+
+  post-quality-gate:
+    description: "Store test health signals after quality gate"
+    trigger:
+      event: "agent-complete"
+      agent: "qe-quality-gate"
+    actions:
+      - type: "store-signal"
+        loop: "operational"
+        namespace: "qcsd-memory/cicd-patterns/flaky-tests"
+        extract:
+          flakyPatterns: "result.flakyTests"
+          gateFailures: "result.failures"
+          recommendations: "result.testRecommendations"
+      - type: "conditional"
+        condition: "result.flakyTests.length > 5"
+        action:
+          type: "notify-agent"
+          target: "qe-flaky-hunter"
+          priority: "high"
+          message: "High flaky test count detected"
+
+  post-flaky-analysis:
+    description: "Update test health with flaky analysis results"
+    trigger:
+      event: "agent-complete"
+      agent: "qe-flaky-hunter"
+    actions:
+      - type: "update-signal"
+        namespace: "qcsd-memory/cicd-patterns/flaky-tests"
+        merge:
+          flakyPatterns: "result.patterns"
+          recommendations.antiPatterns: "result.antiPatterns"
+
+  pre-development:
+    description: "Query CI/CD signals before development"
+    trigger:
+      event: "phase-start"
+      phase: "development"
+    actions:
+      - type: "query-signals"
+        namespace: "qcsd-memory/cicd-patterns/flaky-tests"
+        maxAge: "30d"
+        injectInto:
+          - "qe-test-architect"
+          - "qe-tdd-specialist"
+
+  # ---------------------------------------------------------------------------
+  # Loop 4: Development → Grooming (Quality Criteria)
+  # ---------------------------------------------------------------------------
+
+  post-coverage-analysis:
+    description: "Store AC quality signals after coverage analysis"
+    trigger:
+      event: "agent-complete"
+      agent: "qe-coverage-specialist"
+      conditions:
+        - "result.coveragePercentage < 80"
+    actions:
+      - type: "invoke-agent"
+        agent: "qe-gap-detector"
+        input:
+          coverageData: "result"
+          findACProblems: true
+
+  post-gap-detection:
+    description: "Store untestable patterns after gap detection"
+    trigger:
+      event: "agent-complete"
+      agent: "qe-gap-detector"
+    actions:
+      - type: "store-signal"
+        loop: "quality-criteria"
+        namespace: "qcsd-memory/development-patterns/ac-problems"
+        extract:
+          untestablePatterns: "result.untestablePatterns"
+          coverageGaps: "result.gaps"
+          recommendations: "result.acRecommendations"
+
+  pre-grooming-quality:
+    description: "Query AC quality signals before grooming"
+    trigger:
+      event: "phase-start"
+      phase: "grooming"
+    actions:
+      - type: "query-signals"
+        namespace: "qcsd-memory/development-patterns/ac-problems"
+        maxAge: "60d"
+        injectInto:
+          - "qe-requirements-validator"
+          - "qe-bdd-generator"
+
+# =============================================================================
+# Cleanup Schedule
+# =============================================================================
+
+cleanup:
+  enabled: true
+  schedule: "0 3 * * 0"  # Every Sunday at 3 AM
+  actions:
+    - type: "delete-expired"
+      namespaces: "all"
+    - type: "report"
+      destination: ".agentic-qe/logs/memory-cleanup.log"
+
+# =============================================================================
+# Monitoring
+# =============================================================================
+
+monitoring:
+  enabled: true
+  metrics:
+    - name: "signals_stored"
+      type: "counter"
+      labels: ["loop", "namespace"]
+    - name: "signals_queried"
+      type: "counter"
+      labels: ["loop", "namespace", "phase"]
+    - name: "signal_age_seconds"
+      type: "histogram"
+      labels: ["loop"]
+    - name: "cleanup_deleted"
+      type: "counter"
+      labels: ["namespace"]
+
+# =============================================================================
+# Signal Routing
+# =============================================================================
+
+routing:
+  # Which agents can receive injected signals
+  authorized_receivers:
+    strategic:
+      - "qe-risk-assessor"
+      - "qe-quality-criteria-recommender"
+    tactical:
+      - "qe-product-factors-assessor"
+      - "qe-bdd-generator"
+    operational:
+      - "qe-test-architect"
+      - "qe-tdd-specialist"
+      - "qe-parallel-executor"
+    quality-criteria:
+      - "qe-requirements-validator"
+      - "qe-bdd-generator"
+      - "qe-gap-detector"
+
+  # Signal injection format
+  injection_format: |
+    ## CROSS-PHASE LEARNING SIGNALS
+
+    The following signals have been automatically injected from previous phases.
+    Apply these learnings to your analysis.
+
+    {{#each signals}}
+    ### Signal: {{this.id}}
+    - **From:** {{this.source}} phase
+    - **Loop:** {{this.loopType}}
+    - **Timestamp:** {{this.timestamp}}
+
+    **Recommendations:**
+    {{#each this.recommendations}}
+    - {{this}}
+    {{/each}}
+
+    {{/each}}