antigravity-ipa-workflow/skills/ipa-validator/SKILL.md

name: ipa-validator description: Core IPA validation engine — checks documentation consistency, ID cross-references, and traceability chain across SRD, UI_SPEC, API_SPEC, and DB_DESIGN. Activated automatically by ipa-validate, ipa-all, and ipa-init. Trigger phrases: "validate ipa documentation", "check id consistency", "ipa traceability check".

Overview

Core validation logic for IPA documentation. Validates ID consistency, cross-reference integrity, status tracking, and traceability chain completeness. Used by ipa-validate, ipa-all, and ipa-init internally.

When to Use

• Invoked automatically by ipa-validate, ipa-all, ipa-init
• When explicitly checking IPA doc validity
• After generating or editing any IPA document

Don't Use When

• IPA docs do not yet exist
• Only a quick command reference is needed (use ipa-help)

Required Docs

• docs/SRD.md — System Requirement Definition
• docs/UI_SPEC.md — UX Specification (Basic Design)
• docs/API_SPEC.md — Interface Specification (Detail Design)
• docs/DB_DESIGN.md — Database Design (Detail Design)

Validation Rules

1. Docs Exist — All four required IPA docs present
2. ID Extraction — Parse FR-xx, S-xx, E-xx from SRD tables
3. Cross-Reference Validation — Every ID referenced in other docs must exist in SRD
4. Status Tracking — API_SPEC Endpoint Matrix must have valid status values
5. Traceability Chain — Each FR-xx must map to Screen + Endpoint + Table
6. Orphan Detection — IDs in detail docs not referenced in SRD indicate scope creep

Workflow

1. Check docs exist — stop and report if any missing
2. Extract IDs — parse all ID types from SRD
3. Validate refs — check cross-references in UI_SPEC, API_SPEC, DB_DESIGN
4. Check status — verify Endpoint Matrix status column
5. Generate report — output validation results with counts, gaps, and recommendations

Output

Validation report with:

• ID consistency check result
• Traceability chain check result
• Cross-reference validation result
• Status tracking validation result
• Recommendations for fixing gaps

Usage

# Run validation via ipa-validate
ipa-validate

# Or invoke directly
"Validate IPA docs"
"Check IPA traceability"