DevFlow: Quality Validation Flow

Execute all project validations in parallel using specialized subagents, providing structured reporting of results.

When to Use

Use this flow when you need to:

• Validate code quality before PR
• Check project health
• Run all tests and validations
• Verify build integrity
• Ensure no regressions

Flow Diagram

flowchart TD
    A([BEGIN]) --> B[Parse arguments: --fast, --verbose]
    B --> C[Load project validation config]
    C --> D[Identify enabled validations]
    D --> E{Fast mode?}
    E -->|Yes| F[Skip build validation]
    E -->|No| G[Include all validations]
    F --> H[Launch parallel subagents]
    G --> H
    H --> I[test-runner: Execute tests]
    H --> J[lint-runner: Execute linting]
    H --> K[typecheck-runner: Type check]
    H --> L{Fast mode?}
    L -->|No| M[build-runner: Execute build]
    L -->|Yes| N[Skip build]
    I --> O[Collect JSON responses]
    J --> O
    K --> O
    M --> O
    N --> O
    O --> P[Aggregate results]
    P --> Q{All passed?}
    Q -->|No| R{Verbose mode?}
    R -->|Yes| S[Show full error details]
    R -->|No| T[Show summary with fix recommendations]
    Q -->|Yes| U[Generate success report]
    S --> V([END])
    T --> V
    U --> V

Node Details

1. Load Configuration

Read .claude/details/commands/check.md for project-specific validation commands.

2. Parallel Execution

Launch all validation subagents simultaneously:

• Tests: Run complete test suite
• Linting: Code quality checks
• Type Checking: Language-specific type validation
• Build: Compile project (unless --fast)

3. Result Aggregation

Each subagent returns structured JSON:

{
  "validation": "tests",
  "status": "success|warning|error",
  "duration": 12.3,
  "summary": "145 tests passed",
  "details": "...",
  "errors": [],
  "warnings": []
}

4. Executive Report

Generate consolidated summary with:

• Status per validation
• Execution time
• Error/warning count
• Recommended actions

Parameters

• --fast: Skip build validation (quicker)
• --verbose: Show full output from all validations

Example Usage

/flow:devflow-check
/flow:devflow-check --fast
/flow:devflow-check --verbose

Output

Executive summary table:

┌─────────────────┬─────────┬─────────┬──────────────────────┐
│ Validation      │ Status  │ Time    │ Result               │
├─────────────────┼─────────┼─────────┼──────────────────────┤
│ 🧪 Tests        │ ✅ OK   │ 12.3s   │ 145 passed           │
│ 🔍 Linting      │ ⚠️ WARN │ 3.4s    │ 3 warnings           │
│ 📝 Type Check   │ ✅ OK   │ 8.5s    │ No type errors       │
│ 🏗️ Build        │ ✅ OK   │ 45.2s   │ Success              │
└─────────────────┴─────────┴─────────┴──────────────────────┘