@dzhechkov/keysarium 1.7.14 → 1.7.18

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-shift-left-testing/evals/shift-left-testing.yaml

@@ -0,0 +1,145 @@
+skill: shift-left-testing
+version: 1.0.0
+description: >
+  Evaluation suite for shift-left testing strategy.
+  Tests early defect detection, pre-commit checks, and development-phase validation.
+
+models_to_test:
+  - claude-sonnet-4-6    # Primary (high accuracy expected)
+  - claude-haiku-4-5     # Fast model (minimum quality floor)
+
+mcp_integration:
+  enabled: true
+  namespace: skill-validation
+  query_patterns: true
+  track_outcomes: true
+  store_patterns: true
+  target_agents:
+    - qe-learning-coordinator
+
+learning:
+  store_success_patterns: true
+  pattern_ttl_days: 90
+
+result_format:
+  json_output: true
+  include_timing: true
+  include_token_usage: true
+
+setup:
+  required_tools:
+    - jq
+
+test_cases:
+
+  - id: tc001_pre_commit_validation
+    description: "Identify issues before commit"
+    category: pre_commit
+    priority: critical
+
+    input:
+      code_changes:
+        - "function processPayment() { db.query(userInput); }"
+      checks:
+        - "sql_injection"
+        - "xss"
+        - "hardcoded_secrets"
+
+    expected_output:
+      must_contain:
+        - "SQL injection"
+        - "vulnerable"
+        - "pre-commit"
+
+    validation:
+      schema_check: true
+      keyword_match_threshold: 0.8
+
+  - id: tc002_unit_test_generation_early
+    description: "Generate unit tests during development"
+    category: development
+    priority: high
+
+    input:
+      code: |
+        function calculateDiscount(amount, percentage) {
+          return amount * (1 - percentage / 100);
+        }
+      generate_tests: true
+
+    expected_output:
+      must_contain:
+        - "test"
+        - "unit"
+        - "edge case"
+
+    validation:
+      schema_check: true
+
+  - id: tc003_code_quality_gates
+    description: "Apply quality gates during development"
+    category: quality
+    priority: high
+
+    input:
+      metrics:
+        complexity: 12
+        duplication_percent: 5
+        test_coverage: 75
+
+    expected_output:
+      must_contain:
+        - "quality"
+        - "gate"
+
+    validation:
+      schema_check: true
+
+  - id: tc004_early_architecture_review
+    description: "Validate architecture early in development"
+    category: architecture
+    priority: medium
+
+    input:
+      design:
+        layers: ["presentation", "business", "data"]
+        patterns: ["MVC", "dependency_injection"]
+
+    expected_output:
+      must_contain:
+        - "architecture"
+        - "design"
+
+    validation:
+      schema_check: true
+
+  - id: tc005_developer_feedback
+    description: "Provide immediate developer feedback"
+    category: feedback
+    priority: medium
+
+    input:
+      code_snippet: "const x = 1; const y = 1; const z = x + y;"
+      focus_areas: ["readability", "performance"]
+
+    expected_output:
+      must_contain:
+        - "feedback"
+        - "improve"
+
+    validation:
+      schema_check: true
+      allow_partial: true
+
+success_criteria:
+  pass_rate: 0.9
+  critical_pass_rate: 1.0
+  avg_reasoning_quality: 0.75
+  max_execution_time_ms: 300000
+
+metadata:
+  author: "qe-shift-left-coordinator"
+  created: "2026-02-02"
+  coverage_target: >
+    Shift-left testing with 5 test cases covering pre-commit validation,
+    early test generation, quality gates, architecture review, and developer feedback.

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-shift-left-testing/schemas/output.json

@@ -0,0 +1,459 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentic-qe.dev/schemas/shift-left-testing-output.json",
+  "title": "AQE Shift-Left Testing Skill Output Schema",
+  "description": "Schema for shift-left-testing skill output validation. Extends the base skill-output template with test pyramid analysis, TDD assessment, and CI/CD integration.",
+  "type": "object",
+  "required": ["skillName", "version", "timestamp", "status", "trustTier", "output"],
+  "properties": {
+    "skillName": {
+      "type": "string",
+      "const": "shift-left-testing",
+      "description": "Must be 'shift-left-testing'"
+    },
+    "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", "testPyramid", "shiftLeftLevel", "findings", "recommendations"],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "minLength": 50,
+          "maxLength": 2000,
+          "description": "Human-readable summary of shift-left assessment"
+        },
+        "score": {
+          "$ref": "#/$defs/shiftLeftScore"
+        },
+        "testPyramid": {
+          "$ref": "#/$defs/testPyramid",
+          "description": "Test pyramid analysis"
+        },
+        "shiftLeftLevel": {
+          "$ref": "#/$defs/shiftLeftLevel",
+          "description": "Current shift-left maturity level"
+        },
+        "cicdIntegration": {
+          "$ref": "#/$defs/cicdIntegration",
+          "description": "CI/CD pipeline testing integration"
+        },
+        "tddPractices": {
+          "$ref": "#/$defs/tddPractices",
+          "description": "TDD/BDD practices assessment"
+        },
+        "requirementsValidation": {
+          "$ref": "#/$defs/requirementsValidation",
+          "description": "Early requirements testing"
+        },
+        "defectCostAnalysis": {
+          "$ref": "#/$defs/defectCostAnalysis",
+          "description": "Cost of defects by phase"
+        },
+        "findings": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/shiftLeftFinding"
+          },
+          "maxItems": 100
+        },
+        "recommendations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/shiftLeftRecommendation"
+          },
+          "maxItems": 50
+        },
+        "metrics": {
+          "$ref": "#/$defs/shiftLeftMetrics"
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/artifact"
+          },
+          "maxItems": 50
+        }
+      }
+    },
+    "metadata": {
+      "$ref": "#/$defs/metadata"
+    },
+    "validation": {
+      "$ref": "#/$defs/validationResult"
+    },
+    "learning": {
+      "$ref": "#/$defs/learningData"
+    }
+  },
+  "$defs": {
+    "shiftLeftScore": {
+      "type": "object",
+      "required": ["value", "max"],
+      "properties": {
+        "value": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "max": {
+          "type": "number",
+          "const": 100
+        },
+        "grade": {
+          "type": "string",
+          "pattern": "^[A-F][+-]?$"
+        },
+        "maturityLevel": {
+          "type": "string",
+          "enum": ["level-1", "level-2", "level-3", "level-4"],
+          "description": "Shift-left maturity level"
+        }
+      }
+    },
+    "testPyramid": {
+      "type": "object",
+      "required": ["unit", "integration", "e2e"],
+      "properties": {
+        "unit": {
+          "type": "object",
+          "properties": {
+            "count": { "type": "integer", "minimum": 0 },
+            "percentage": { "type": "number", "minimum": 0, "maximum": 100 },
+            "target": { "type": "number", "default": 70 },
+            "coverage": { "type": "number", "minimum": 0, "maximum": 100 },
+            "averageExecutionMs": { "type": "number" },
+            "status": { "type": "string", "enum": ["healthy", "needs-attention", "critical"] }
+          },
+          "description": "Unit tests layer"
+        },
+        "integration": {
+          "type": "object",
+          "properties": {
+            "count": { "type": "integer", "minimum": 0 },
+            "percentage": { "type": "number", "minimum": 0, "maximum": 100 },
+            "target": { "type": "number", "default": 20 },
+            "coverage": { "type": "number", "minimum": 0, "maximum": 100 },
+            "averageExecutionMs": { "type": "number" },
+            "status": { "type": "string", "enum": ["healthy", "needs-attention", "critical"] }
+          },
+          "description": "Integration tests layer"
+        },
+        "e2e": {
+          "type": "object",
+          "properties": {
+            "count": { "type": "integer", "minimum": 0 },
+            "percentage": { "type": "number", "minimum": 0, "maximum": 100 },
+            "target": { "type": "number", "default": 10 },
+            "coverage": { "type": "number", "minimum": 0, "maximum": 100 },
+            "averageExecutionMs": { "type": "number" },
+            "status": { "type": "string", "enum": ["healthy", "needs-attention", "critical"] }
+          },
+          "description": "End-to-end tests layer"
+        },
+        "pyramidShape": {
+          "type": "string",
+          "enum": ["healthy-pyramid", "ice-cream-cone", "hourglass", "inverted", "unbalanced"],
+          "description": "Current pyramid shape"
+        },
+        "pyramidScore": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "How close to ideal pyramid (100 = perfect)"
+        }
+      }
+    },
+    "shiftLeftLevel": {
+      "type": "object",
+      "required": ["current", "practices"],
+      "properties": {
+        "current": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 4,
+          "description": "Current shift-left level (0-4)"
+        },
+        "target": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 4,
+          "description": "Target shift-left level"
+        },
+        "practices": {
+          "type": "object",
+          "properties": {
+            "level1": {
+              "type": "object",
+              "properties": {
+                "testsInPR": { "type": "boolean" },
+                "ciPipeline": { "type": "boolean" },
+                "codeReview": { "type": "boolean" }
+              },
+              "description": "Level 1: Tests in every PR"
+            },
+            "level2": {
+              "type": "object",
+              "properties": {
+                "tddPractice": { "type": "boolean" },
+                "testFirst": { "type": "boolean" },
+                "redGreenRefactor": { "type": "boolean" }
+              },
+              "description": "Level 2: TDD practice"
+            },
+            "level3": {
+              "type": "object",
+              "properties": {
+                "bddInRefinement": { "type": "boolean" },
+                "exampleMapping": { "type": "boolean" },
+                "threeAmigos": { "type": "boolean" }
+              },
+              "description": "Level 3: BDD in refinement"
+            },
+            "level4": {
+              "type": "object",
+              "properties": {
+                "riskAnalysisInDesign": { "type": "boolean" },
+                "testabilityReview": { "type": "boolean" },
+                "architectureValidation": { "type": "boolean" }
+              },
+              "description": "Level 4: Risk analysis in design"
+            }
+          }
+        }
+      }
+    },
+    "cicdIntegration": {
+      "type": "object",
+      "properties": {
+        "hasCI": { "type": "boolean" },
+        "testsOnEveryCommit": { "type": "boolean" },
+        "pipelineDuration": {
+          "type": "object",
+          "properties": {
+            "total": { "type": "integer", "description": "Total duration in seconds" },
+            "unitTests": { "type": "integer" },
+            "integrationTests": { "type": "integer" },
+            "e2eTests": { "type": "integer" },
+            "linting": { "type": "integer" }
+          }
+        },
+        "qualityGates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "stage": { "type": "string" },
+              "blocking": { "type": "boolean" },
+              "currentStatus": { "type": "string", "enum": ["passing", "failing", "warning"] }
+            }
+          }
+        },
+        "fastFeedback": {
+          "type": "boolean",
+          "description": "Does pipeline provide feedback in < 10 minutes"
+        }
+      }
+    },
+    "tddPractices": {
+      "type": "object",
+      "properties": {
+        "tddAdoption": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Percentage of code developed with TDD"
+        },
+        "testFirstRatio": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Percentage of tests written before code"
+        },
+        "bddAdoption": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Percentage of features with BDD specs"
+        },
+        "practicesAssessment": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "practice": { "type": "string" },
+              "implemented": { "type": "boolean" },
+              "effectiveness": { "type": "string", "enum": ["poor", "fair", "good", "excellent"] }
+            }
+          }
+        }
+      }
+    },
+    "requirementsValidation": {
+      "type": "object",
+      "properties": {
+        "investCriteria": { "type": "boolean" },
+        "testabilityReviewed": { "type": "boolean" },
+        "acceptanceCriteria": { "type": "boolean" },
+        "examplesProvided": { "type": "boolean" },
+        "ambiguityScore": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "How ambiguous are requirements (0=clear, 100=very ambiguous)"
+        }
+      }
+    },
+    "defectCostAnalysis": {
+      "type": "object",
+      "properties": {
+        "byPhase": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "phase": {
+                "type": "string",
+                "enum": ["requirements", "design", "development", "testing", "production"]
+              },
+              "relativeCost": {
+                "type": "number",
+                "description": "Relative cost (requirements = 1x)"
+              },
+              "defectsFound": {
+                "type": "integer",
+                "description": "Number of defects found in this phase"
+              },
+              "percentageFound": {
+                "type": "number",
+                "description": "Percentage of total defects found in this phase"
+              }
+            }
+          }
+        },
+        "potentialSavings": {
+          "type": "string",
+          "description": "Estimated savings from better shift-left"
+        }
+      }
+    },
+    "shiftLeftFinding": {
+      "type": "object",
+      "required": ["id", "title", "type", "severity"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^SLT-\\d{3,6}$"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 10,
+          "maxLength": 200
+        },
+        "description": { "type": "string" },
+        "type": {
+          "type": "string",
+          "enum": ["pyramid-imbalance", "ci-gap", "tdd-gap", "late-testing", "missing-gate", "slow-feedback", "opportunity"]
+        },
+        "severity": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low", "info"]
+        },
+        "phase": {
+          "type": "string",
+          "enum": ["requirements", "design", "development", "testing", "deployment"],
+          "description": "Which phase this finding affects"
+        }
+      }
+    },
+    "shiftLeftRecommendation": {
+      "type": "object",
+      "required": ["id", "title", "priority", "levelImpact"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^REC-\\d{3,6}$"
+        },
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "priority": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low"]
+        },
+        "levelImpact": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 4,
+          "description": "Which shift-left level this improves"
+        },
+        "costReduction": {
+          "type": "string",
+          "description": "Expected defect cost reduction"
+        },
+        "effort": {
+          "type": "string",
+          "enum": ["trivial", "low", "medium", "high", "major"]
+        }
+      }
+    },
+    "shiftLeftMetrics": {
+      "type": "object",
+      "properties": {
+        "defectEscapeRate": { "type": "number", "minimum": 0, "maximum": 100 },
+        "testCoverage": { "type": "number", "minimum": 0, "maximum": 100 },
+        "ciPassRate": { "type": "number", "minimum": 0, "maximum": 100 },
+        "averageFeedbackTime": { "type": "integer", "description": "Average CI feedback time in minutes" },
+        "tddAdoptionRate": { "type": "number", "minimum": 0, "maximum": 100 }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "required": ["type", "path"],
+      "properties": {
+        "type": { "type": "string" },
+        "path": { "type": "string" },
+        "format": { "type": "string" },
+        "description": { "type": "string" }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "executionTimeMs": { "type": "integer" },
+        "agentId": { "type": "string" },
+        "modelUsed": { "type": "string" },
+        "environment": { "type": "string" }
+      }
+    },
+    "validationResult": {
+      "type": "object",
+      "properties": {
+        "schemaValid": { "type": "boolean" },
+        "contentValid": { "type": "boolean" },
+        "confidence": { "type": "number" }
+      }
+    },
+    "learningData": {
+      "type": "object",
+      "properties": {
+        "patternsDetected": { "type": "array", "items": { "type": "string" } },
+        "reward": { "type": "number" }
+      }
+    }
+  }
+}

package/templates/.claude/skills/feature-adr/references/agentic-qe/qe-ref-shift-left-testing/scripts/validate-config.json

@@ -0,0 +1,25 @@
+{
+  "skillName": "shift-left-testing",
+  "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.md

@@ -153,7 +153,9 @@ DISCOVERY → EXPLORE  → RESEARCH → CJM PROTO    → SOLVE    → ARCHITECTU
 1. **Файлы создаются в момент фазы**, не в Phase 6
 2. **Phase 2.5 (CJM Prototype) — НИКОГДА НЕ ПРОПУСКАТЬ**
 3. **08_executive_summary.md — ОБЯЗАТЕЛЕН**
-4. **Research в PARANOID mode** — ноль непроверенных утверждений
+4. **Research по `.claude/rules/research-quality.md`** — `moderate` для обычных источников;
+   `strict`/`paranoid` только при подтверждённых ключах издателей и подписанной выдаче.
+   Неподтверждённые сведения помечаются и не становятся основанием решения.
 5. **{CHOSEN_CJM} передаётся** из Phase 2.5 в Phase 3-5
 6. **Checkpoint после каждой фазы** — ждём "ок" от пользователя + `<promise>` тег
 7. **Всё в researches/<slug>/** — не засоряем корень

package/templates/docs/feature-adr/04-admin-guide.md

@@ -252,7 +252,7 @@ rm -rf features/<slug>
 
 **Step 1 (Requirements):** Для M+ tiers каждое функциональное требование должно иметь формулировку acceptance criteria, пригодную для верификации на Step 8.
 
-**Step 2 (Research):** Для L/XL tiers все ссылки на аналоги и паттерны должны быть верифицируемы. Применяется принцип PARANOID mode.
+**Step 2 (Research):** Для L/XL tiers ссылки на аналоги и паттерны должны быть проверяемы. Это требование к качеству цитирования, а не автоматическое включение GOAP `paranoid` без ключей издателей и подписанной выдачи.
 
 **Step 3 (ADR):** Минимум 2 альтернативы на каждый ADR. Каждая альтернатива содержит pros/cons и trade-off анализ. Выбранный вариант обоснован.
 

package/templates/docs/improvement-directions.md

@@ -60,7 +60,7 @@
 .claude/shards/
 ├── phase-0-discovery.shard.md      ← Правила для Phase 0
 ├── phase-1-explore.shard.md        ← Правила для Phase 1
-├── phase-2-research.shard.md       ← Правила для Phase 2 (PARANOID mode)
+├── phase-2-research.shard.md       ← Правила выбора режима и проверки источников Phase 2
 ├── phase-25-cjm.shard.md           ← Правила для Phase 2.5 (MANDATORY)
 ├── phase-3-solve.shard.md          ← Правила для Phase 3
 ├── phase-4-architecture.shard.md   ← Правила для Phase 4
@@ -93,7 +93,7 @@ AQE определяет 7 неизменяемых инвариантов:
 |-----------|-------------|
 | CJM Phase 2.5 НИКОГДА не пропускается | Gate check перед Phase 3 |
 | Executive Summary (08) ОБЯЗАТЕЛЕН | Gate check перед packaging |
-| PARANOID mode: ноль unverified claims | Automated scan артефактов Phase 2 |
+| Подтверждённые источники и явные пробелы, без выдуманных цитат | Проверка артефактов Phase 2 |
 | BTO: judge и generator — разные модели | Model check в BTO pipeline |
 | Layer 0 rejection = NO escalation без 3 retries | Retry counter в BTO test |
 | Файлы создаются в момент фазы, не в Phase 6 | File existence check на checkpoint |
@@ -275,7 +275,7 @@ AQE использует semantic promises:
 |---------|------|----------|
 | `DISCOVERY_COMPLETE` | Phase 0 | JTBD + конкуренты + ROI проанализированы |
 | `CASE_EXPLORED` | Phase 1 | Кейс полностью понят, brief создан |
-| `RESEARCH_PARANOID_PASSED` | Phase 2 | Все claims верифицированы, zero unverified |
+| `RESEARCH_PARANOID_PASSED` | Phase 2 | Унаследованное имя: evidence gate пройден в выбранном GOAP режиме; подпись издателя не подразумевается |
 | `CJM_VALIDATED` | Phase 2.5 | CJM прототип создан и выбран |
 | `SOLUTION_DESIGNED` | Phase 3 | Стратегия решения сформирована |
 | `ARCHITECTURE_DEFINED` | Phase 4 | C4 диаграммы + sequence flows готовы |