--- title: Quality Check dimension: things category: agents tags: agent, ai related_dimensions: connections, events, knowledge scope: global created: 2025-11-03 updated: 2025-11-03 version: 1.0.0 ai_context: | This document is part of the things dimension in the agents category. Location: one/things/claude/commands/quality-check.md Purpose: Documents automated quality validation command Related dimensions: connections, events, knowledge For AI agents: Read this to understand quality check. --- # Automated Quality Validation Command **Command:** `quality-check` **Purpose:** AI-powered automated quality validation for cascade system **Target:** 80% automation rate, 30-second validation vs 5+ minute manual process ## Command Usage ```bash # Quick validation (most common) /quality-check --level=story --id=story-3.1 # Batch validation /quality-check --level=mission --id=mission-3 --cascade # Full validation with detailed report /quality-check --level=task --id=task-1.2.3 --verbose # Auto-approve high confidence results /quality-check --level=agent --id=agent-validation-123 --auto-approve ``` ## Automated Validation Engine ### 1. Smart Content Analysis **Text Quality Scoring:** - **Clarity Score**: Readability analysis, jargon detection, structure validation - **Completeness Score**: Requirement coverage, deliverable matching, gap detection - **Consistency Score**: Brand alignment, terminology validation, style compliance - **Impact Score**: Objective advancement, measurable outcomes, value creation **Automated Checks:** ```yaml text_analysis: readability_threshold: 8.0 # Flesch Reading Ease completeness_threshold: 95 # Requirement coverage % consistency_threshold: 90 # Brand alignment % clarity_keywords: ["specific", "measurable", "actionable", "realistic", "timely"] red_flags: ["vague", "unclear", "maybe", "possibly", "eventually"] ``` ### 2. Structural Validation **Cascade Compliance:** - **Mission → Story**: Story objectives clearly derive from mission goals - **Story → Task**: Tasks directly advance story narrative arc - **Task → Agent**: Agent assignments match required expertise - **Quality Gates**: Each level meets 4.0+ star threshold before progression **Automated Structure Checks:** ```yaml structure_validation: mission_requirements: ["objective", "success_metrics", "timeline", "resources"] story_requirements: [ "mission_connection", "narrative_arc", "acceptance_criteria", "value_proposition", ] task_requirements: ["story_context", "deliverables", "agent_assignment", "completion_criteria"] agent_requirements: [ "task_fulfillment", "quality_standards", "deliverable_validation", "outcome_measurement", ] ``` ### 3. Smart Auto-Approval **High-Confidence Auto-Approval Criteria:** - **Content Quality Score**: ≥ 4.5 stars across all dimensions - **Structural Compliance**: 100% requirement coverage - **Brand Consistency**: ≥ 95% alignment score - **Template Matching**: Perfect adherence to proven templates - **Historical Success**: Similar content with proven quality track record **Auto-Approval Thresholds:** ```yaml auto_approval: confidence_threshold: 0.95 # 95% confidence required quality_threshold: 4.5 # 4.5+ stars required consistency_threshold: 95 # 95% brand alignment completeness_threshold: 100 # 100% requirement coverage bypass_conditions: - template_perfect_match: true - proven_pattern_reuse: true - historical_success_rate: ">90%" ``` ## 4. Quality Feedback System **Intelligent Improvement Suggestions:** **For Low Scores (< 4.0):** - **Specific Gaps**: "Missing measurable success metrics in objective statement" - **Template Suggestions**: "Consider using Mission Template #3 for technical objectives" - **Content Improvements**: "Add quantifiable outcomes: target 50% increase in X metric" - **Structure Fixes**: "Story connection to mission objective needs explicit statement" **For Medium Scores (4.0-4.4):** - **Enhancement Opportunities**: "Good foundation, consider adding competitive analysis" - **Quality Boosters**: "Strong narrative, add specific timeline milestones for 4.5+ stars" - **Alignment Improvements**: "Excellent content, strengthen brand voice consistency" **Sample Feedback Output:** ```yaml validation_result: overall_score: 4.2 confidence: 0.87 auto_approved: false dimension_scores: clarity: 4.5 completeness: 3.8 # NEEDS IMPROVEMENT consistency: 4.3 impact: 4.2 feedback: critical_issues: - "Missing specific success metrics for Story Objective #2" - "Task deliverables need concrete acceptance criteria" improvement_suggestions: - "Add quantifiable KPIs to strengthen completeness score" - "Reference mission objectives explicitly in story narrative" - "Consider using Story Template #7 for technical implementation stories" quick_fixes: - template_suggestion: "story-technical-implementation.yaml" - auto_enhancement: "Add standard KPI framework" - reference_examples: ["story-2.1", "story-1.4", "story-1.8"] ``` ## 5. Batch Processing & Cascade Validation **Cascade Flow Validation:** ```bash # Validate entire mission cascade /quality-check --cascade mission-3 └── Mission-3: Turbo Monorepo → 4.3 stars ✓ ├── Story-3.1: External Repository → 4.1 stars ✓ ├── Story-3.2: Architecture Integration → PENDING ├── Story-3.3: Multi-Platform Development → PENDING ├── Story-3.4: Shared Package System → PENDING └── Story-3.5: Backend Integration → PENDING ``` **Performance Metrics:** - **Validation Speed**: 30 seconds vs 5+ minutes manual - **Automation Rate**: Target 80% auto-approval for high-quality content - **Accuracy Rate**: 95%+ alignment with manual validation results - **Quality Improvement**: 15% average score increase through feedback ## 6. Integration with Quality Gates **Automated Gate Enforcement:** ```yaml quality_gates: mission_to_story: threshold: 4.0 auto_block: true feedback_required: true story_to_task: threshold: 4.0 auto_block: true enhancement_suggestions: true task_to_agent: threshold: 4.0 auto_block: true template_recommendations: true agent_completion: threshold: 4.0 auto_block: true deliverable_validation: true ``` **Command Integration:** ```bash # Before story creation (auto-triggered) /quality-check --gate=mission-to-story --id=mission-3 # Before task breakdown (auto-triggered) /quality-check --gate=story-to-task --id=story-3.2 # Before agent assignment (auto-triggered) /quality-check --gate=task-to-agent --id=task-3.2.1 # After agent completion (auto-triggered) /quality-check --gate=agent-completion --id=agent-task-456 ``` ## Expected Outcomes **Performance Improvements:** - ⚡ **30-second validation** (vs 5+ minute manual process) - 🤖 **80% automation rate** for standard content patterns - 📈 **15% quality score improvement** through intelligent feedback - 🛡️ **100% gate compliance** with automated enforcement - 🔄 **Real-time feedback** during content creation **Quality Excellence:** - 🎯 **4.0+ star guarantee** across all cascade levels - 📊 **Consistent scoring** eliminates subjective variation - 🚀 **Faster iteration** through immediate feedback - 🔍 **Proactive quality** prevents low-quality progression - 📋 **Comprehensive coverage** across all validation dimensions This automated system transforms manual quality gates into an intelligent, fast, and reliable validation engine that maintains the high standards of the CASCADE system while dramatically improving efficiency.