Initial commit: antigravity-ipa-workflow

skills/ipa-validator/SKILL.md

@@ -0,0 +1,63 @@
+---
+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"
+```