gh-dhofheinz-open-plugins-plugins-marketplace-validator-plugin/commands/validation-orchestrator/run-comprehensive.md

Operation: Run Comprehensive Validation

Execute complete quality audit with detailed analysis, scoring, and recommendations.

Parameters from $ARGUMENTS

• path: Path to validation target (required)
  • Format: path:/path/to/target
  • Default: . (current directory)
• report: Generate detailed report (optional)
  • Format: report:true|false
  • Default: true

Comprehensive Validation Scope

Execute all validation layers:

1. Schema Validation (via /schema-validation full-schema)

   • JSON syntax and structure
   • Required and recommended fields
   • Format compliance
   • Type validation

2. Security Scanning (via /security-scan full-security-audit)

   • Secret detection
   • URL safety checks
   • File permission validation
   • Vulnerability scanning

3. Quality Analysis (via /quality-analysis full-analysis)

   • Quality score calculation (0-100)
   • Star rating generation
   • Issue prioritization
   • Improvement recommendations

4. Documentation Validation (via /documentation-validation full-docs)

   • README completeness
   • CHANGELOG format
   • LICENSE presence
   • Example quality

5. Best Practices Enforcement (via /best-practices full-standards)

   • Naming conventions
   • Versioning compliance
   • Category validation
   • Keyword quality

Workflow

1. Initialize Validation

   Detect target type using .scripts/target-detector.sh
   Create validation context
   Set up result aggregation
   

2. Execute Validation Layers (parallel where possible)

   PARALLEL:
     Layer 1: /schema-validation full-schema path:"$path"
     Layer 2: /security-scan full-security-audit path:"$path"
     Layer 3: /documentation-validation full-docs path:"$path"
     Layer 4: /best-practices full-standards path:"$path"
   
   AFTER all complete:
     Layer 5: /quality-analysis full-analysis path:"$path" context:"$all_results"
   

3. Aggregate Results

   Execute .scripts/validation-dispatcher.py --mode=aggregate
   Compile all layer results
   Calculate overall quality score
   Prioritize issues (Critical → Important → Recommended)
   Generate actionable recommendations
   

4. Generate Report (if requested)

   IF report parameter is true:
     Generate comprehensive markdown report
     Include all findings with details
     Add remediation guidance
     Provide next steps
   

Integration with Other Skills

This operation orchestrates multiple skills:

• schema-validation: Structure and format checks
• security-scan: Security vulnerability detection
• documentation-validation: Documentation quality
• best-practices: Standards compliance
• quality-analysis: Scoring and recommendations

Examples

Comprehensive validation with report:

/validation-orchestrator comprehensive path:. report:true

Comprehensive validation, results only:

/validation-orchestrator comprehensive path:/my-plugin report:false

Performance Expectations

Comprehensive validation typically takes 5-10 seconds depending on:

• Target size and complexity
• Number of files to scan
• Documentation completeness
• Script execution time

Error Handling

• Validation layer failure: Continue with other layers, report partial results
• Aggregation failure: Return individual layer results
• Report generation failure: Return console output
• Timeout: Cancel and report completed layers only

Output Format

Comprehensive Validation Results
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Target: <path>
Type: <marketplace|plugin>
Quality Score: <0-100>/100 <⭐⭐⭐⭐⭐>
Rating: <Excellent|Good|Fair|Needs Improvement|Poor>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Validation Layers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Schema Validation: <✅ PASS | ❌ FAIL>
  - Required fields: <status>
  - Format compliance: <status>
  - <additional details>

Security Scan: <✅ PASS | ❌ FAIL>
  - Secret detection: <status>
  - URL safety: <status>
  - <additional details>

Documentation: <✅ PASS | ⚠️  WARNINGS>
  - README: <status>
  - CHANGELOG: <status>
  - <additional details>

Best Practices: <✅ PASS | ⚠️  WARNINGS>
  - Naming: <status>
  - Versioning: <status>
  - <additional details>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Issues Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Critical Issues (must fix): <count>
❌ <issue 1>
❌ <issue 2>

Important Warnings (should fix): <count>
⚠️  <warning 1>
⚠️  <warning 2>

Recommendations (improve quality): <count>
💡 <recommendation 1>
💡 <recommendation 2>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Next Steps
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. <prioritized action 1>
2. <prioritized action 2>
3. <prioritized action 3>

Publication Readiness: <Ready | Needs Work | Not Ready>

Report File Location

If report generation is enabled, save to:

<target-path>/validation-report-<timestamp>.md

Request: $ARGUMENTS