oneie/one/things/claude/commands/quality-check.md

Build apps, websites, and AI agents in English. Zero-interaction setup for AI agents (Claude Code, Cursor, Windsurf). Download to your computer, run in the cloud, deploy to the edge. Open source and free forever.

---
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.