graph LR
    L[Lean Analysis] --> S1[Stage 1: Spec]
    S1 --> S2[Stage 2: Design]
    S2 --> S3[Stage 3: Detail]
    S3 --> S4[Stage 4: Validate]
    S4 --> I[Implementation]

Stage	Skill	Output
Pre-spec	lean, lean-analyst	MVP scope, user research
Stage 1	ipa-spec	SRD.md + UI_SPEC.md
Stage 2	ipa-design	HTML mockups
Stage 3	ipa-detail	API_SPEC.md + DB_DESIGN.md
Stage 4	ipa-validate	Traceability matrix
Full pipeline	ipa-all, ipa-fast	All stages sequentially

Installation

Global (all projects)

./install.sh --global
# Skills install to ~/.gemini/antigravity/skills/

Workspace (current project — also copies doc templates)

./install.sh --workspace
# Skills install to .agent/skills/
# Doc templates copied to ./docs/ (SRD.md, UI_SPEC.md, etc.)

Windows

.\install.ps1
# or: .\install.ps1 -Workspace

Prerequisites

Antigravity IDE (Gemini CLI)
No dependency on antigravity-claudekit (fully standalone)
Optional: install antigravity-claudekit for full CK workflow

Usage

"Generate requirements for a user auth feature"  → ipa-spec activates
"Create UI mockups"                               → ipa-design activates
"Generate API spec and database design"           → ipa-detail activates
"Validate documentation traceability"             → ipa-validate activates
"Run full IPA pipeline"                           → ipa-all activates

Stage Gates

Each stage enforces prerequisites:

ipa-design requires SRD.md to exist (run ipa-spec first)
ipa-detail requires UI_SPEC.md to exist (run ipa-design first)
ipa-validate requires API_SPEC.md + DB_DESIGN.md (run ipa-detail first)

Skill List

IPA Core

ipa-spec, ipa-srd, ipa-design, ipa-detail, ipa-validate, ipa-all, ipa-fast, ipa-start, ipa-help

IPA Support

ipa-bd, ipa-dd, ipa-context-aware-planning, ipa-docs, ipa-docs-split, ipa-docs-sync, ipa-import, ipa-init, ipa-mockup-analyze, ipa-planner, ipa-validator

Lean Analysis

lean, lean-analyst, lean-analyze-usage, lean-user-research

Project Template

The templates/ directory provides a bootstrappable project structure:

templates/docs/SRD.md.template — Requirements spec skeleton
templates/docs/UI_SPEC.md.template — UI specification skeleton
templates/docs/API_SPEC.md.template — API specification skeleton
templates/docs/DB_DESIGN.md.template — Database design skeleton

Use ./install.sh --workspace to auto-copy these into your project.

Contributing

Fork this repo
Create a skill in skills/<name>/SKILL.md following template/SKILL.md
Add entry to skills_index.json
Submit PR

Migration from IPA-for-CK

See docs/migration-guide-from-ipa-for-ck.md.

Key differences:

Colon names → hyphens (ipa:spec → ipa-spec)
No slash commands → semantic triggering
Stage gates use HARD-GATE blocks instead of hooks

License

MIT