agentic-qe 1.1.0 → 1.3.0

package/.claude/agents/reasoning/goal-planner.md

@@ -0,0 +1,73 @@
+---
+name: goal-planner
+description: "Goal-Oriented Action Planning (GOAP) specialist that dynamically creates intelligent plans to achieve complex objectives. Uses gaming AI techniques to discover novel solutions by combining actions in creative ways. Excels at adaptive replanning, multi-step reasoning, and finding optimal paths through complex state spaces."
+color: purple
+---
+
+You are a Goal-Oriented Action Planning (GOAP) specialist, an advanced AI planner that uses intelligent algorithms to dynamically create optimal action sequences for achieving complex objectives. Your expertise combines gaming AI techniques with practical software engineering to discover novel solutions through creative action composition.
+
+Your core capabilities:
+- **Dynamic Planning**: Use A* search algorithms to find optimal paths through state spaces
+- **Precondition Analysis**: Evaluate action requirements and dependencies
+- **Effect Prediction**: Model how actions change world state
+- **Adaptive Replanning**: Adjust plans based on execution results and changing conditions
+- **Goal Decomposition**: Break complex objectives into achievable sub-goals
+- **Cost Optimization**: Find the most efficient path considering action costs
+- **Novel Solution Discovery**: Combine known actions in creative ways
+- **Mixed Execution**: Blend LLM-based reasoning with deterministic code actions
+- **Tool Group Management**: Match actions to available tools and capabilities
+- **Domain Modeling**: Work with strongly-typed state representations
+- **Continuous Learning**: Update planning strategies based on execution feedback
+
+Your planning methodology follows the GOAP algorithm:
+
+1. **State Assessment**:
+   - Analyze current world state (what is true now)
+   - Define goal state (what should be true)
+   - Identify the gap between current and goal states
+
+2. **Action Analysis**:
+   - Inventory available actions with their preconditions and effects
+   - Determine which actions are currently applicable
+   - Calculate action costs and priorities
+
+3. **Plan Generation**:
+   - Use A* pathfinding to search through possible action sequences
+   - Evaluate paths based on cost and heuristic distance to goal
+   - Generate optimal plan that transforms current state to goal state
+
+4. **Execution Monitoring** (OODA Loop):
+   - **Observe**: Monitor current state and execution progress
+   - **Orient**: Analyze changes and deviations from expected state
+   - **Decide**: Determine if replanning is needed
+   - **Act**: Execute next action or trigger replanning
+
+5. **Dynamic Replanning**:
+   - Detect when actions fail or produce unexpected results
+   - Recalculate optimal path from new current state
+   - Adapt to changing conditions and new information
+
+## MCP Integration Examples
+
+```javascript
+// Orchestrate complex goal achievement
+mcp__claude-flow__task_orchestrate {
+  task: "achieve_production_deployment",
+  strategy: "adaptive",
+  priority: "high"
+}
+
+// Coordinate with swarm for parallel planning
+mcp__claude-flow__swarm_init {
+  topology: "hierarchical",
+  maxAgents: 5
+}
+
+// Store successful plans for reuse
+mcp__claude-flow__memory_usage {
+  action: "store",
+  namespace: "goap-plans",
+  key: "deployment_plan_v1",
+  value: JSON.stringify(successful_plan)
+}
+```

package/.claude/settings.json

@@ -1,3 +1,4 @@
+
 {
   "env": {
     "CLAUDE_FLOW_AUTO_COMMIT": "false",
@@ -5,36 +6,37 @@
     "CLAUDE_FLOW_HOOKS_ENABLED": "true",
     "CLAUDE_FLOW_TELEMETRY_ENABLED": "true",
     "CLAUDE_FLOW_REMOTE_EXECUTION": "true",
-    "CLAUDE_FLOW_CHECKPOINTS_ENABLED": "true"
+    "CLAUDE_FLOW_CHECKPOINTS_ENABLED": "true",
+    "AGENTDB_LEARNING_ENABLED": "true",
+    "AGENTDB_REASONING_ENABLED": "true",
+    "AGENTDB_AUTO_TRAIN": "true"
   },
   "permissions": {
     "allow": [
-      "Bash(npx claude-flow *)",
+      "Bash(npx claude-flow:*)",
+      "Bash(npx agentdb:*)",
       "Bash(npm run lint)",
       "Bash(npm run test:*)",
-      "Bash(npm test *)",
+      "Bash(npm test:*)",
       "Bash(git status)",
-      "Bash(git diff *)",
-      "Bash(git log *)",
-      "Bash(git add *)",
-      "Bash(git commit *)",
+      "Bash(git diff:*)",
+      "Bash(git log:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
       "Bash(git push)",
-      "Bash(git config *)",
-      "Bash(git tag *)",
-      "Bash(git branch *)",
-      "Bash(git checkout *)",
-      "Bash(git stash *)",
-      "Bash(jq *)",
-      "Bash(node *)",
-      "Bash(which *)",
+      "Bash(git config:*)",
+      "Bash(git tag:*)",
+      "Bash(git branch:*)",
+      "Bash(git checkout:*)",
+      "Bash(git stash:*)",
+      "Bash(jq:*)",
+      "Bash(node:*)",
+      "Bash(which:*)",
       "Bash(pwd)",
-      "Bash(ls *)"
+      "Bash(ls:*)"
     ],
     "deny": [
-      "Bash(rm -rf /)",
-      "Bash(curl * | bash)",
-      "Bash(wget * | sh)",
-      "Bash(eval *)"
+      "Bash(rm -rf /)"
     ]
   },
   "hooks": {
@@ -53,7 +55,23 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks pre-edit --file '{}' --auto-assign-agents true --load-context true"
+            "description": "3. Semantic Search Memory - Query similar successful past edits",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} bash -c 'FILE=\"{}\"; echo \"🔍 Semantic Search: Querying similar successful edits for $FILE...\"; npx agentdb@latest query --domain \"successful-edits\" --query \"file:$FILE\" --k 5 --min-confidence 0.8 --format json 2>/dev/null || echo \"{}\" | jq -r \".memories[]? | \\\"💡 Past Success: \\(.pattern.summary // \\\"No similar patterns found\\\")\\\" \" 2>/dev/null; npx claude-flow@alpha hooks pre-edit --file \"$FILE\" --auto-assign-agents true --load-context true'"
+          },
+          {
+            "type": "command",
+            "description": "5. Failure Pattern Recognition - Warn about known failure patterns",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} bash -c 'FILE=\"{}\"; echo \"⚠️ Failure Detection: Checking for known failure patterns...\"; npx agentdb@latest query --domain \"failed-edits\" --query \"file:$FILE\" --k 3 --min-confidence 0.7 --format json 2>/dev/null | jq -r \".memories[]? | \\\"🚨 Warning: Similar edit failed - \\(.pattern.reason // \\\"unknown\\\")\\\" \" 2>/dev/null || true'"
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "description": "4. Trajectory Prediction - Predict optimal task sequence",
+            "command": "cat | jq -r '.tool_input.prompt // .tool_input.task // empty' | tr '\\n' '\\0' | xargs -0 -I {} bash -c 'TASK=\"{}\"; echo \"🎯 Trajectory Prediction: Analyzing optimal workflow for task...\"; npx agentdb@latest query --domain \"task-trajectories\" --query \"task:$TASK\" --k 3 --min-confidence 0.75 --format json 2>/dev/null | jq -r \".memories[]? | \\\"📋 Predicted Steps: \\(.pattern.trajectory // \\\"No trajectory data\\\") (Success Rate: \\(.confidence // 0))\\\" \" 2>/dev/null || echo \"📋 No historical trajectory data - learning from this task...\"; npx claude-flow@alpha hooks pre-task --description \"$TASK\" --auto-spawn-agents true --load-memory true'"
           }
         ]
       }
@@ -73,7 +91,23 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-edit --file '{}' --format true --update-memory true"
+            "description": "1. Experience Replay Developer - Capture edit as RL experience",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} bash -c 'FILE=\"{}\"; echo \"💾 Experience Replay: Storing edit experience for $FILE...\"; TIMESTAMP=$(date +%s); npx agentdb@latest store-pattern --type \"experience\" --domain \"code-edits\" --pattern \"{\\\"file\\\":\\\"$FILE\\\",\\\"timestamp\\\":$TIMESTAMP,\\\"action\\\":\\\"edit\\\",\\\"state\\\":\\\"pre-test\\\"}\" --confidence 0.5 2>/dev/null || true; npx claude-flow@alpha hooks post-edit --file \"$FILE\" --format true --update-memory true --train-patterns true'"
+          },
+          {
+            "type": "command",
+            "description": "2. Verdict-Based Quality - Async verdict assignment after tests",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} bash -c 'FILE=\"{}\"; (sleep 2; TEST_RESULT=$(npm test --silent 2>&1 | grep -q \"pass\" && echo \"ACCEPT\" || echo \"REJECT\"); REWARD=$([ \"$TEST_RESULT\" = \"ACCEPT\" ] && echo \"1.0\" || echo \"-1.0\"); echo \"⚖️ Verdict: $TEST_RESULT (reward: $REWARD) for $FILE\"; npx agentdb@latest store-pattern --type \"verdict\" --domain \"code-quality\" --pattern \"{\\\"file\\\":\\\"$FILE\\\",\\\"verdict\\\":\\\"$TEST_RESULT\\\",\\\"reward\\\":$REWARD}\" --confidence $([ \"$TEST_RESULT\" = \"ACCEPT\" ] && echo \"0.95\" || echo \"0.3\") 2>/dev/null; if [ \"$TEST_RESULT\" = \"ACCEPT\" ]; then npx agentdb@latest store-pattern --type \"success\" --domain \"successful-edits\" --pattern \"{\\\"file\\\":\\\"$FILE\\\",\\\"summary\\\":\\\"Edit passed tests\\\"}\" --confidence 0.9 2>/dev/null; else npx agentdb@latest store-pattern --type \"failure\" --domain \"failed-edits\" --pattern \"{\\\"file\\\":\\\"$FILE\\\",\\\"reason\\\":\\\"Tests failed\\\"}\" --confidence 0.8 2>/dev/null; fi) &'"
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "description": "4. Trajectory Storage - Record task trajectory for learning",
+            "command": "cat | jq -r '.tool_input.prompt // .tool_input.task // empty, .result.success // \"unknown\"' | tr '\\n' '\\0' | xargs -0 bash -c 'TASK=\"$1\"; SUCCESS=\"$2\"; echo \"📊 Trajectory Storage: Recording task workflow...\"; CONFIDENCE=$([ \"$SUCCESS\" = \"true\" ] && echo \"0.95\" || echo \"0.5\"); npx agentdb@latest store-pattern --type \"trajectory\" --domain \"task-trajectories\" --pattern \"{\\\"task\\\":\\\"$TASK\\\",\\\"success\\\":$SUCCESS,\\\"trajectory\\\":\\\"search→scaffold→test→refine\\\"}\" --confidence \"$CONFIDENCE\" 2>/dev/null || true; npx claude-flow@alpha hooks post-task --analyze-performance true --store-decisions true --export-learnings true' _"
           }
         ]
       }
@@ -103,12 +137,17 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx claude-flow@alpha hooks session-end --generate-summary true --persist-state true --export-metrics true"
+            "description": "Session end - Train models and compress learnings",
+            "command": "bash -c 'echo \"🎓 Session End: Training models on accumulated experiences...\"; npx agentdb@latest train --domain \"code-edits\" --epochs 10 --batch-size 32 2>/dev/null || echo \"⚠️ Training skipped (insufficient data)\"; echo \"🧠 Memory Distillation: Compressing session learnings...\"; npx agentdb@latest optimize-memory --compress true --consolidate-patterns true 2>/dev/null || true; npx claude-flow@alpha hooks session-end --generate-summary true --persist-state true --export-metrics true'"
           }
         ]
       }
     ]
   },
   "includeCoAuthoredBy": true,
-  "enabledMcpjsonServers": ["claude-flow", "ruv-swarm"]
-}
+  "enabledMcpjsonServers": ["claude-flow", "ruv-swarm"],
+  "statusLine": {
+    "type": "command",
+    "command": ".claude/statusline-agentdb.sh"
+  }
+}

package/.claude/skills/README.md

@@ -0,0 +1,124 @@
+# Claude Skills Collection
+
+Personal skill library for Dragan Spiridonov - Agentic Quality Engineer & Founder of Quantum Quality Engineering.
+
+## Available Skills
+
+### Core Quality Skills
+- **[holistic-testing-pact](./holistic-testing-pact/)** - Evolved Holistic Testing Model with PACT principles (Proactive, Autonomous, Collaborative, Targeted)
+- **[context-driven-testing](./context-driven-testing/)** - Context-driven philosophy and Rapid Software Testing techniques
+- **[agentic-quality-engineering](./agentic-quality-engineering/)** - AI agents as quality work force multipliers
+- **[exploratory-testing-advanced](./exploratory-testing-advanced/)** - Deep dive into RST heuristics and session-based testing
+- **[risk-based-testing](./risk-based-testing/)** - Risk assessment frameworks and prioritization
+
+### Development Practices
+- **[tdd-london-chicago](./tdd-london-chicago/)** - Both schools of TDD with examples and guidance
+- **[xp-practices](./xp-practices/)** - Pair/ensemble programming patterns and XP methodologies
+- **[refactoring-patterns](./refactoring-patterns/)** - Safe refactoring techniques and code improvement patterns
+
+### Testing Patterns
+- **[api-testing-patterns](./api-testing-patterns/)** - REST, GraphQL, contract testing, and integration approaches
+- **[performance-testing](./performance-testing/)** - Load, stress, soak testing strategies and optimization
+- **[security-testing](./security-testing/)** - OWASP Top 10, vulnerability scanning, and secure coding
+- **[test-automation-strategy](./test-automation-strategy/)** - When/how to automate, avoiding anti-patterns
+
+### Communication & Process
+- **[technical-writing](./technical-writing/)** - Clear, engaging technical content for practitioners
+- **[bug-reporting-excellence](./bug-reporting-excellence/)** - Writing actionable, clear bug reports
+- **[code-review-quality](./code-review-quality/)** - Effective code reviews that teach and improve
+
+### Professional Skills
+- **[consultancy-practices](./consultancy-practices/)** - Assessment, transformation, and advisory work
+- **[quality-metrics](./quality-metrics/)** - Meaningful metrics vs. vanity metrics
+
+## How to Use
+
+Each skill contains a `SKILL.md` file with:
+- Core principles and philosophy
+- Practical techniques and examples
+- Common pitfalls and anti-patterns
+- Context-appropriate guidance
+- Real-world examples from production
+
+## Philosophy
+
+All skills reflect these values:
+- **Context over dogma** - Best practices are contextual, not universal
+- **Practice over theory** - Based on 12+ years in production, not just study
+- **Value over compliance** - Focus on customer value, not process adherence
+- **Pragmatism over purity** - Blend approaches as needed for your context
+- **Quality built-in** - Prevention over detection, shift-left thinking
+
+## Skill Categories
+
+### For Quality Engineers
+Start with: holistic-testing-pact, context-driven-testing, exploratory-testing-advanced, risk-based-testing
+
+### For Developers
+Start with: tdd-london-chicago, refactoring-patterns, code-review-quality
+
+### For Team Leads
+Start with: quality-metrics, consultancy-practices, xp-practices
+
+### For Everyone
+Start with: technical-writing, bug-reporting-excellence
+
+## Integration with Tools
+
+These skills work well with:
+- **Claude Code** - Copy to project `.claude/` directory
+- **IDE Plugins** - Reference during development
+- **CI/CD Pipelines** - Embed principles in automation
+- **Team Wikis** - Share as team knowledge base
+
+## About
+
+Created by Dragan Spiridonov (profa):
+- Founder, Quantum Quality Engineering
+- Member, Global Agentics Foundation
+- Establishing Serbian Agentic Foundation Chapter
+- 25+ years IT experience
+- 8 years leading QA/QE at Alchemy
+- 12+ years implementing quality practices in production
+
+## Current Work
+
+Building the Serbian Agentic Foundation community in partnership with StartIt centers across Serbia, starting with Novi Sad in October 2025.
+
+## Skill Development
+
+### Recently Added
+- api-testing-patterns
+- quality-metrics
+- consultancy-practices
+- performance-testing
+- security-testing
+- bug-reporting-excellence
+- refactoring-patterns
+- code-review-quality
+
+### Future Considerations
+- chaos-engineering
+- observability-practices
+- incident-management
+- technical-leadership
+- team-building
+- public-speaking
+
+## Contributing
+
+These skills evolve based on:
+- Real production experience
+- Community feedback
+- New techniques and tools
+- Lessons learned from failures
+
+Feedback welcome through discussions and community channels.
+
+## License
+
+These skills document proven practices and methodologies. Use freely with attribution.
+
+---
+
+*These skills are living documents that evolve with practice and community input. Last updated: October 2025*