Build-Only: Validate Capability Flow

Build-Only: Validate Capability Flow

Validate a capability flow specification against the framework's schema constraints.

Note: This skill is prefixed build-only- because it is used during framework development, not as part of the framework itself.

When to Use

Use this skill after designing a capability flow specification to verify:

• Schema constraint compliance (C1-C4)
• Structural completeness
• Consistency between patterns and roles

Schema Constraints

The capability flow schema defines four core constraints:

Additional Validation Rules

Beyond C1-C4, check:

How to Validate

Manual Validation Checklist

For each capability instance in the specification:

□ Capability is one of the eight valid capabilities
□ Pattern is one of the five valid patterns
□ C1: If Human-Only, AI Role = "None"
□ C2: If AI-Only, Human Role = "None"
□ C3: If AI Role ≠ "None", Pattern ≠ Human-Only
□ C4: If Human Role ≠ "None", Pattern ≠ AI-Only
□ Escalation triggers defined (if AI participates)
□ Completion criteria are testable

Validation Script

Execute the validation script:

.claude/​skills/​build-only-validate-capability-flow/​scripts/​validate-capability-flow.sh <spec-file>

The script reads a YAML capability flow specification and reports:

• Constraint violations
• Missing required fields
• Recommendations for fixes

Validation Output

The validator returns:

• PASS if all constraints satisfied
• FAIL with list of violations if any constraint broken

Example output:

Validating: process-spec.yaml
Step PA-3: FAIL - C1 violated: Pattern is Human-Only but AI Role is "Proposes decomposition"
Step PA-7: PASS
Step PA-8: PASS
Overall: FAIL (1 violation)

Handling Failures

When validation fails:

1. Identify the specific constraint violated
2. Determine which field is incorrect (Pattern or Role)
3. Either change the pattern to match the roles, or change the roles to match the pattern
4. Re-validate after correction

Part of the AI-Augmented SDLC Framework build tooling