112 lines
3.2 KiB
Markdown
112 lines
3.2 KiB
Markdown
# Antigravity IPA Workflow
|
|
|
|
Intelligent Project Automation (IPA) — a stage-gated documentation workflow for AI-assisted software development, now as Antigravity IDE skills.
|
|
|
|
## IPA Workflow
|
|
|
|
```mermaid
|
|
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)
|
|
|
|
```bash
|
|
./install.sh --global
|
|
# Skills install to ~/.gemini/antigravity/skills/
|
|
```
|
|
|
|
### Workspace (current project — also copies doc templates)
|
|
|
|
```bash
|
|
./install.sh --workspace
|
|
# Skills install to .agent/skills/
|
|
# Doc templates copied to ./docs/ (SRD.md, UI_SPEC.md, etc.)
|
|
```
|
|
|
|
### Windows
|
|
|
|
```powershell
|
|
.\install.ps1
|
|
# or: .\install.ps1 -Workspace
|
|
```
|
|
|
|
## Prerequisites
|
|
|
|
- Antigravity IDE (Gemini CLI)
|
|
- No dependency on antigravity-claudekit (fully standalone)
|
|
- Optional: install [antigravity-claudekit](https://github.com/user/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
|
|
|
|
1. Fork this repo
|
|
2. Create a skill in `skills/<name>/SKILL.md` following `template/SKILL.md`
|
|
3. Add entry to `skills_index.json`
|
|
4. Submit PR
|
|
|
|
## Migration from IPA-for-CK
|
|
|
|
See [docs/migration-guide-from-ipa-for-ck.md](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
|