Initial commit

commands/validation-orchestrator/run-comprehensive.md

@@ -0,0 +1,191 @@
+## 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:**
+```bash
+/validation-orchestrator comprehensive path:. report:true
+```
+
+**Comprehensive validation, results only:**
+```bash
+/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