@dzhechkov/keysarium 1.7.14 → 1.7.18

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-qcsd-ideation-swarm/schemas/output.json

@@ -0,0 +1,568 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentic-qe.dev/schemas/qcsd-ideation-swarm-output.json",
+  "title": "QCSD Ideation Swarm Output Schema",
+  "description": "Schema for QCSD ideation swarm output. Includes quality criteria, risks, test ideas, and multi-agent reports.",
+  "type": "object",
+  "required": ["skillName", "version", "timestamp", "status", "trustTier", "output"],
+  "properties": {
+    "skillName": {
+      "type": "string",
+      "const": "qcsd-ideation-swarm",
+      "description": "Must be 'qcsd-ideation-swarm'"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9]+)?$"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["success", "partial", "failed", "skipped"]
+    },
+    "trustTier": {
+      "type": "integer",
+      "const": 3
+    },
+    "output": {
+      "type": "object",
+      "required": ["summary", "qualityCriteria", "risks", "testIdeas"],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "minLength": 100,
+          "maxLength": 3000
+        },
+        "recommendation": {
+          "type": "string",
+          "enum": ["GO", "CONDITIONAL", "NO-GO"],
+          "description": "Overall ideation recommendation"
+        },
+        "qualityCriteria": {
+          "$ref": "#/$defs/qualityCriteriaAnalysis"
+        },
+        "risks": {
+          "$ref": "#/$defs/riskAnalysis"
+        },
+        "testIdeas": {
+          "$ref": "#/$defs/testIdeasCollection"
+        },
+        "agentReports": {
+          "$ref": "#/$defs/agentReports"
+        },
+        "testability": {
+          "$ref": "#/$defs/testabilityAssessment"
+        },
+        "flagDetection": {
+          "$ref": "#/$defs/flagDetection"
+        },
+        "conditionalAnalysis": {
+          "$ref": "#/$defs/conditionalAnalysis"
+        },
+        "executiveSummary": {
+          "$ref": "#/$defs/executiveSummary"
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifact"
+          },
+          "maxItems": 20
+        }
+      }
+    },
+    "metadata": {
+      "$ref": "#/$defs/metadata"
+    },
+    "validation": {
+      "$ref": "#/$defs/validationResult"
+    },
+    "learning": {
+      "$ref": "#/$defs/learningData"
+    }
+  },
+  "$defs": {
+    "qualityCriteriaAnalysis": {
+      "type": "object",
+      "required": ["htsmCategories"],
+      "properties": {
+        "htsmVersion": {
+          "type": "string",
+          "default": "6.3"
+        },
+        "htsmCategories": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/htsmCategory"
+          },
+          "minItems": 5,
+          "maxItems": 10,
+          "description": "HTSM v6.3 categories analyzed"
+        },
+        "prioritySummary": {
+          "type": "object",
+          "properties": {
+            "p0": { "type": "integer", "minimum": 0 },
+            "p1": { "type": "integer", "minimum": 0 },
+            "p2": { "type": "integer", "minimum": 0 },
+            "p3": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "crossCuttingConcerns": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "htsmCategory": {
+      "type": "object",
+      "required": ["name", "priority"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "enum": [
+            "Capability", "Reliability", "Security", "Performance", "Development",
+            "Usability", "Charisma", "Scalability", "Compatibility", "Installability"
+          ]
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["P0", "P1", "P2", "P3"]
+        },
+        "weight": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "testabilityScore": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/evidenceItem"
+          }
+        },
+        "qualityImplication": {
+          "type": "string"
+        },
+        "businessImpact": {
+          "type": "string"
+        }
+      }
+    },
+    "evidenceItem": {
+      "type": "object",
+      "required": ["text", "type"],
+      "properties": {
+        "text": { "type": "string" },
+        "type": {
+          "type": "string",
+          "enum": ["direct", "inferred", "claimed"]
+        },
+        "source": { "type": "string" },
+        "line": { "type": "integer" }
+      }
+    },
+    "riskAnalysis": {
+      "type": "object",
+      "required": ["risks"],
+      "properties": {
+        "methodology": {
+          "type": "string",
+          "enum": ["SFDIPOT", "STRIDE", "custom"]
+        },
+        "totalRisks": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "criticalRisks": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "highestScore": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 25
+        },
+        "risks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/risk"
+          },
+          "minItems": 5,
+          "maxItems": 50
+        },
+        "riskDistribution": {
+          "type": "object",
+          "properties": {
+            "technical": { "type": "integer" },
+            "business": { "type": "integer" },
+            "quality": { "type": "integer" },
+            "integration": { "type": "integer" }
+          }
+        }
+      }
+    },
+    "risk": {
+      "type": "object",
+      "required": ["id", "description", "category", "likelihood", "impact", "score"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^R\\d{3}$"
+        },
+        "description": { "type": "string", "minLength": 10 },
+        "category": {
+          "type": "string",
+          "enum": ["technical", "business", "quality", "integration"]
+        },
+        "likelihood": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5
+        },
+        "impact": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5
+        },
+        "score": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 25
+        },
+        "mitigation": { "type": "string" },
+        "owner": {
+          "type": "string",
+          "enum": ["Dev", "QE", "Product", "Ops", "Security"]
+        }
+      }
+    },
+    "testIdeasCollection": {
+      "type": "object",
+      "required": ["ideas"],
+      "properties": {
+        "total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "ideas": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/testIdea"
+          },
+          "minItems": 5,
+          "maxItems": 100
+        },
+        "byCategory": {
+          "type": "object",
+          "properties": {
+            "functional": { "type": "integer" },
+            "nonfunctional": { "type": "integer" },
+            "exploratory": { "type": "integer" },
+            "regression": { "type": "integer" }
+          }
+        }
+      }
+    },
+    "testIdea": {
+      "type": "object",
+      "required": ["id", "title", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^TI-\\d{3}$"
+        },
+        "title": { "type": "string", "minLength": 10 },
+        "description": { "type": "string" },
+        "type": {
+          "type": "string",
+          "enum": ["functional", "nonfunctional", "exploratory", "regression", "security", "accessibility", "performance"]
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low"]
+        },
+        "linkedRisks": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "linkedCriteria": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "automation": {
+          "type": "string",
+          "enum": ["automated", "manual", "hybrid"]
+        }
+      }
+    },
+    "agentReports": {
+      "type": "object",
+      "required": ["coreAgents"],
+      "properties": {
+        "coreAgents": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/agentReport"
+          },
+          "minItems": 3,
+          "maxItems": 3,
+          "description": "Must have exactly 3 core agents"
+        },
+        "conditionalAgents": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/agentReport"
+          },
+          "maxItems": 3
+        },
+        "totalAgents": {
+          "type": "integer",
+          "minimum": 3,
+          "maximum": 6
+        }
+      }
+    },
+    "agentReport": {
+      "type": "object",
+      "required": ["agentId", "domain", "status"],
+      "properties": {
+        "agentId": {
+          "type": "string",
+          "pattern": "^qe-[a-z][a-z0-9-]*$"
+        },
+        "domain": {
+          "type": "string",
+          "enum": [
+            "requirements-validation", "coverage-analysis", "security-compliance",
+            "visual-accessibility", "cross-domain"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "enum": ["completed", "partial", "failed", "skipped"]
+        },
+        "reportPath": { "type": "string" },
+        "executionTimeMs": { "type": "integer", "minimum": 0 },
+        "findingsCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "testabilityAssessment": {
+      "type": "object",
+      "required": ["score"],
+      "properties": {
+        "score": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "grade": {
+          "type": "string",
+          "pattern": "^[A-F][+-]?$"
+        },
+        "principles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "score": { "type": "integer", "minimum": 0, "maximum": 10 },
+              "evidence": { "type": "string" }
+            }
+          },
+          "minItems": 10,
+          "maxItems": 10
+        },
+        "blockers": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "flagDetection": {
+      "type": "object",
+      "required": ["HAS_UI", "HAS_SECURITY", "HAS_UX"],
+      "properties": {
+        "HAS_UI": {
+          "type": "boolean"
+        },
+        "HAS_SECURITY": {
+          "type": "boolean"
+        },
+        "HAS_UX": {
+          "type": "boolean"
+        },
+        "HAS_VIDEO": {
+          "type": "boolean"
+        },
+        "evidence": {
+          "type": "object",
+          "properties": {
+            "ui": { "type": "array", "items": { "type": "string" } },
+            "security": { "type": "array", "items": { "type": "string" } },
+            "ux": { "type": "array", "items": { "type": "string" } },
+            "video": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    },
+    "conditionalAnalysis": {
+      "type": "object",
+      "properties": {
+        "accessibility": {
+          "$ref": "#/$defs/accessibilityAnalysis"
+        },
+        "security": {
+          "$ref": "#/$defs/securityAnalysis"
+        },
+        "qualityExperience": {
+          "$ref": "#/$defs/qxAnalysis"
+        }
+      }
+    },
+    "accessibilityAnalysis": {
+      "type": "object",
+      "properties": {
+        "wcagLevel": { "type": "string", "enum": ["A", "AA", "AAA"] },
+        "uiComponents": { "type": "array", "items": { "type": "string" } },
+        "findings": { "type": "array", "items": { "type": "object" } }
+      }
+    },
+    "securityAnalysis": {
+      "type": "object",
+      "properties": {
+        "strideCategories": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "authRequirements": { "type": "string" },
+        "dataProtection": { "type": "array", "items": { "type": "object" } },
+        "compliance": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "qxAnalysis": {
+      "type": "object",
+      "properties": {
+        "pact": {
+          "type": "object",
+          "properties": {
+            "people": { "type": "string" },
+            "activities": { "type": "string" },
+            "contexts": { "type": "string" },
+            "technologies": { "type": "string" }
+          }
+        },
+        "personas": { "type": "array", "items": { "type": "object" } },
+        "userJourneys": { "type": "array", "items": { "type": "string" } },
+        "qxRisks": { "type": "array", "items": { "type": "object" } }
+      }
+    },
+    "executiveSummary": {
+      "type": "object",
+      "required": ["recommendation"],
+      "properties": {
+        "recommendation": {
+          "type": "string",
+          "enum": ["GO", "CONDITIONAL", "NO-GO"]
+        },
+        "rationale": { "type": "string", "minLength": 50 },
+        "metrics": {
+          "type": "object",
+          "properties": {
+            "htsmCoverage": { "type": "integer", "minimum": 0, "maximum": 10 },
+            "testabilityScore": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "acCompleteness": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "criticalRisks": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "immediateActions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "developmentActions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "preReleaseActions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "followUpRecommendations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "action": { "type": "string" },
+              "skill": { "type": "string" },
+              "reason": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "required": ["type", "path"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["report", "htsm-analysis", "risk-matrix", "test-ideas", "executive-summary"]
+        },
+        "path": { "type": "string", "maxLength": 500 },
+        "format": {
+          "type": "string",
+          "enum": ["html", "md", "json"]
+        },
+        "description": { "type": "string" }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "executionTimeMs": { "type": "integer", "minimum": 0 },
+        "agentId": { "type": "string", "pattern": "^qe-[a-z][a-z0-9-]*$" },
+        "targetUrl": { "type": "string" },
+        "epicId": { "type": "string" },
+        "fetchMethod": {
+          "type": "string",
+          "enum": ["playwright", "webfetch", "websearch-fallback"]
+        }
+      }
+    },
+    "validationResult": {
+      "type": "object",
+      "properties": {
+        "schemaValid": { "type": "boolean" },
+        "contentValid": { "type": "boolean" },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "warnings": { "type": "array", "items": { "type": "string" } },
+        "errors": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "learningData": {
+      "type": "object",
+      "properties": {
+        "patternsDetected": { "type": "array", "items": { "type": "string" } },
+        "reward": { "type": "number", "minimum": 0, "maximum": 1 },
+        "ideationPatterns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "pattern": { "type": "string" },
+              "recommendation": { "type": "string" },
+              "outcome": { "type": "string" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-qcsd-ideation-swarm/scripts/validate-config.json

@@ -0,0 +1,25 @@
+{
+  "skillName": "qcsd-ideation-swarm",
+  "skillVersion": "1.0.0",
+  "requiredTools": [
+    "jq"
+  ],
+  "optionalTools": [],
+  "schemaPath": "schemas/output.json",
+  "requiredFields": [
+    "skillName",
+    "status",
+    "output"
+  ],
+  "requiredNonEmptyFields": [],
+  "mustContainTerms": [],
+  "mustNotContainTerms": [],
+  "enumValidations": {
+    ".status": [
+      "success",
+      "partial",
+      "failed",
+      "skipped"
+    ]
+  }
+}

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-qcsd-ideation-swarm/steps/01-flag-detection.md

@@ -0,0 +1,57 @@
+# Step 1: Analyze Epic Content (Flag Detection)
+
+## Prerequisites
+- Ideation swarm skill invoked
+- Epic / feature description provided (or URL for URL mode)
+- OUTPUT_FOLDER determined
+
+## Instructions
+
+### URL Mode Check
+
+If a URL was provided, this step also includes the URL-based content fetch cascade.
+Use the Read tool to read `steps/01a-url-fetch.md` for the URL fetch protocol if applicable.
+
+### Flag Detection (Check ALL flags)
+
+```
+HAS_UI = FALSE
+  Set TRUE if epic contains ANY of: UI, frontend, visual, design,
+  component, screen, page, form, button, modal, dialog, dashboard,
+  widget, interface, display, view, layout, CSS, styling
+
+HAS_SECURITY = FALSE
+  Set TRUE if epic contains ANY of: authentication, authorization,
+  encryption, security, OWASP, token, OAuth, credentials, privacy,
+  compliance, vulnerability, access control
+
+HAS_UX = FALSE
+  Set TRUE if epic contains ANY of: user experience, usability,
+  interaction design, user flow, journey, persona, accessibility,
+  responsive, mobile-first, navigation, onboarding
+
+HAS_MIDDLEWARE = FALSE
+  Set TRUE if epic mentions middleware, ESB, message broker, MQ,
+  Kafka, RabbitMQ, integration bus, API gateway, pub/sub
+
+HAS_SAP_INTEGRATION = FALSE
+  Set TRUE if epic mentions SAP, RFC, BAPI, IDoc, OData,
+  S/4HANA, EWM, ECC, ABAP, CDS view, Fiori
+
+HAS_AUTHORIZATION = FALSE
+  Set TRUE if epic mentions SoD, segregation of duties,
+  role conflict, authorization object, RBAC, permission matrix
+
+HAS_VIDEO = FALSE
+  Set TRUE if epic mentions video content, media playback,
+  streaming, video player, captions, subtitles
+```
+
+Output flag detection results.
+
+## Success Criteria
+- [ ] All flags evaluated with evidence
+- [ ] Expected agent count calculated
+
+## Navigation
+- On success: proceed to Step 2 by reading `steps/02-core-agents.md`

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-qcsd-ideation-swarm/steps/02-core-agents.md

@@ -0,0 +1,29 @@
+# Step 2: Spawn Core Agents (Parallel Batch 1)
+
+## Prerequisites
+- Step 1 completed with flags
+
+## Instructions
+
+### Spawn ALL THREE core agents in ONE message
+
+| Agent | Domain | Role |
+|-------|--------|------|
+| qe-quality-criteria-recommender | requirements-validation | HTSM v6.3 quality criteria analysis |
+| qe-risk-assessor | coverage-analysis | Risk storming and risk-based testing |
+| qe-requirements-validator | requirements-validation | Requirements completeness validation |
+
+### Agent 1: Quality Criteria Recommender
+Apply HTSM v6.3 (10 quality categories) to the epic. Generate quality criteria with priorities. Save to: `${OUTPUT_FOLDER}/02-quality-criteria.md`
+
+### Agent 2: Risk Assessor
+Perform risk storming: identify risks, assess likelihood and impact, recommend risk-based test strategies. Save to: `${OUTPUT_FOLDER}/03-risk-assessment.md`
+
+### Agent 3: Requirements Validator
+Validate epic completeness, identify gaps, assess testability. Save to: `${OUTPUT_FOLDER}/04-requirements-validation.md`
+
+## Success Criteria
+- [ ] All THREE agents spawned
+
+## Navigation
+- On success: proceed to Step 3 by reading `steps/03-batch1-results.md`

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-qcsd-ideation-swarm/steps/03-batch1-results.md

@@ -0,0 +1,15 @@
+# Step 3: Wait for Batch 1 & Extract Results
+
+## Prerequisites
+- Step 2: All 3 core agents spawned
+
+## Instructions
+
+WAIT for all three. Extract: quality criteria count, risk count, testability score,
+requirements completeness, critical gaps identified.
+
+## Success Criteria
+- [ ] All metrics extracted
+
+## Navigation
+- On success: proceed to Step 4 by reading `steps/04-conditional-agents.md`