282 lines
8.8 KiB
Markdown
282 lines
8.8 KiB
Markdown
# Antigravity IPA Workflow - Changelog
|
|
|
|
**All notable changes to this project are documented below.**
|
|
|
|
Format: [ISO Date] | Version | Type | Description
|
|
|
|
---
|
|
|
|
## [1.0.0] — 2026-02-16
|
|
|
|
### RELEASE SUMMARY
|
|
Initial production release of Antigravity IPA Workflow. Successfully converted 24 lean skills from IPA-for-CK into standalone Antigravity IDE format, with full validation and zero ClaudeKit dependencies.
|
|
|
|
### FEATURES (New)
|
|
|
|
#### Core Pipeline (4 skills)
|
|
- **ipa-spec**: Software Requirements Definition generation
|
|
- Generates SRD.md and UI_SPEC.md from user input
|
|
- No prerequisites (first stage)
|
|
- Triggers: "spec", "requirements", "srd"
|
|
|
|
- **ipa-design**: UI Mockup & Wireframe generation
|
|
- Generates HTML mockups and interaction flows
|
|
- Prerequisite: Requires SRD.md
|
|
- Triggers: "design", "mockup", "ui design"
|
|
|
|
- **ipa-detail**: API & Database Design generation
|
|
- Generates API_SPEC.md and DB_DESIGN.md
|
|
- Prerequisite: Requires UI_SPEC.md
|
|
- Triggers: "detail", "api", "database design"
|
|
|
|
- **ipa-validate**: Traceability Matrix & Validation
|
|
- Generates traceability matrix and validation report
|
|
- Prerequisites: Requires API_SPEC.md + DB_DESIGN.md
|
|
- Triggers: "validate", "traceability", "matrix"
|
|
|
|
#### Orchestration (2 skills)
|
|
- **ipa-all**: Full Pipeline Orchestration
|
|
- Executes all 4 stages sequentially
|
|
- Enforces hard-gate blocking
|
|
- Triggers: "full pipeline", "run all stages"
|
|
|
|
- **ipa-fast**: Fast Pipeline Variant
|
|
- Streamlined version for quick prototyping
|
|
- Generates minimal docs, skips heavy validation
|
|
- Triggers: "quick pipeline", "fast pipeline"
|
|
|
|
#### Lean Analysis (4 skills)
|
|
- **lean**: Quick MVP scope analysis
|
|
- Analyzes core features, user personas, constraints
|
|
- Output feeds into ipa-spec
|
|
- Triggers: "analyze mvp", "lean startup", "scope"
|
|
|
|
- **lean-analyst**: Deep lean analysis
|
|
- Provides extended lean canvas, competitor analysis
|
|
- Complements lean skill
|
|
- Triggers: "lean analysis", "deep dive"
|
|
|
|
- **lean-user-research**: User research assistant
|
|
- Generates research plans, interview scripts, personas
|
|
- Triggers: "user research", "interview guide", "survey"
|
|
|
|
- **lean-analyze-usage**: Usage pattern analysis
|
|
- Creates user journey maps, feature prioritization
|
|
- Triggers: "usage patterns", "behavior analysis"
|
|
|
|
#### Support & Utilities (10 skills)
|
|
- **ipa-bd**: Business Domain assistant
|
|
- **ipa-dd**: Design Domain assistant
|
|
- **ipa-planner**: Context-aware project planning
|
|
- **ipa-docs**: Documentation generator utility
|
|
- **ipa-docs-split**: Large document splitter
|
|
- **ipa-docs-sync**: Documentation synchronization
|
|
- **ipa-context-aware-planning**: Advanced planning engine
|
|
- **ipa-import**: External document import
|
|
- **ipa-validator**: Documentation validation utility
|
|
- **ipa-mockup-analyze**: Mockup quality analysis
|
|
|
|
#### Setup & Help (4 skills)
|
|
- **ipa-init**: Workspace initialization
|
|
- **ipa-start**: Quick start guide
|
|
- **ipa-help**: Context-aware help system
|
|
- **ipa-import**: Migration assistant
|
|
|
|
### DOCUMENTATION (New)
|
|
|
|
- **README.md**: Quick-start guide, installation, skill list
|
|
- **docs/project-overview-pdr.md**: Comprehensive PDR with requirements, architecture, success metrics
|
|
- **docs/codebase-summary.md**: Complete codebase structure and inventory
|
|
- **docs/project-changelog.md**: This file
|
|
- **docs/migration-guide-from-ipa-for-ck.md**: Guide for upgrading from IPA-for-CK
|
|
- **docs/installation-guide.md**: Detailed installation instructions
|
|
- **templates/docs/SRD.md.template**: Software Requirements Definition template
|
|
- **templates/docs/UI_SPEC.md.template**: UI Specification template
|
|
- **templates/docs/API_SPEC.md.template**: API Specification template
|
|
- **templates/docs/DB_DESIGN.md.template**: Database Design template
|
|
- **templates/SKILL.md**: Template for new skill contributors
|
|
|
|
### INSTALLATION & DISTRIBUTION
|
|
|
|
- **install.sh**: Bash installer for Linux/macOS
|
|
- `--global` flag installs to `~/.gemini/antigravity/skills/`
|
|
- `--workspace` flag installs to `./.agent/skills/` + copies doc templates
|
|
- Proper directory creation and permission handling
|
|
|
|
- **install.ps1**: PowerShell installer for Windows
|
|
- Supports global and workspace installation modes
|
|
- Full script documentation and error handling
|
|
|
|
- **skills_index.json**: Central skill registry with metadata
|
|
- All 24 skills listed with category, triggers, description
|
|
- Version tracking and dependency information
|
|
|
|
### QUALITY ASSURANCE (Validation Results)
|
|
|
|
✓ **Frontmatter Validation**: 24/24 skills (100%)
|
|
✓ **CK Reference Removal**: 0 CK references found
|
|
✓ **Skill Structure**: All skills in correct directory format
|
|
✓ **JSON Parsing**: All frontmatter valid and parseable
|
|
✓ **Documentation**: Complete coverage of all features
|
|
|
|
### BREAKING CHANGES (from IPA-for-CK)
|
|
|
|
1. **Skill Naming**: Colon notation → hyphen notation
|
|
- `ipa:spec` → `ipa-spec`
|
|
- `lean:analyst` → `lean-analyst`
|
|
- Reason: Antigravity IDE naming standard
|
|
|
|
2. **Triggering**: Slash commands → Semantic text triggers
|
|
- Old: `/ipa-spec "my requirements"`
|
|
- New: Say "Generate spec for my requirements"
|
|
- Reason: Antigravity IDE native triggering
|
|
|
|
3. **Hard-gates**: Hooks → Hard-gate blocks
|
|
- Old: @prevent_execution hook
|
|
- New: hardGates JSON property in frontmatter
|
|
- Reason: Antigravity IDE validation standard
|
|
|
|
4. **Dependencies**: ClaudeKit removed entirely
|
|
- Old: Depended on CK orchestration, CK tools, CK skills
|
|
- New: Completely standalone, no CK required
|
|
- Benefit: Universal Antigravity IDE compatibility
|
|
|
|
### MIGRATION NOTES
|
|
|
|
Users upgrading from IPA-for-CK should:
|
|
1. Read `docs/migration-guide-from-ipa-for-ck.md`
|
|
2. Uninstall ClaudeKit skills (if desired)
|
|
3. Run `./install.sh --global` (Antigravity IPA)
|
|
4. Update project scripts that reference old skill names
|
|
5. Test `ipa-all` to verify full pipeline
|
|
|
|
### KNOWN ISSUES
|
|
|
|
- None (v1.0.0 is production-ready)
|
|
|
|
### FUTURE PLANS
|
|
|
|
- [ ] v1.1.0: Add web dashboard for pipeline visualization
|
|
- [ ] v1.2.0: Real-time team collaboration features
|
|
- [ ] v1.3.0: CI/CD integration for automated validation
|
|
- [ ] v2.0.0: Multi-language documentation support
|
|
|
|
---
|
|
|
|
## Pre-Release History
|
|
|
|
### Development Phase: IPA-for-CK → Antigravity IPA (Planning)
|
|
|
|
**Key Milestones:**
|
|
- [ ] Skill conversion and validation
|
|
- [ ] Documentation generation
|
|
- [ ] Installation system setup
|
|
- [ ] Quality assurance testing
|
|
- [ ] GitHub release preparation
|
|
|
|
---
|
|
|
|
## Version Schema
|
|
|
|
This project follows [Semantic Versioning](https://semver.org/):
|
|
- **MAJOR** version when making incompatible API changes
|
|
- **MINOR** version when adding functionality in a backward-compatible manner
|
|
- **PATCH** version when making backward-compatible bug fixes
|
|
|
|
## Commit Message Format
|
|
|
|
This project follows [Conventional Commits](https://www.conventionalcommits.org/):
|
|
|
|
```
|
|
<type>(<scope>): <subject>
|
|
|
|
<body>
|
|
|
|
<footer>
|
|
```
|
|
|
|
**Types:**
|
|
- `feat:` A new feature
|
|
- `fix:` A bug fix
|
|
- `docs:` Documentation only changes
|
|
- `style:` Changes that do not affect code meaning (formatting, missing semicolons)
|
|
- `refactor:` Code changes that neither fix bugs nor add features
|
|
- `perf:` Code changes that improve performance
|
|
- `test:` Adding or updating tests
|
|
- `chore:` Changes to build process or dependencies
|
|
|
|
**Example:**
|
|
```
|
|
feat(ipa-spec): add srd template validation
|
|
|
|
Validate SRD.md structure before proceeding to design stage.
|
|
Checks for required sections: Overview, Features, Constraints.
|
|
|
|
Fixes: #42
|
|
```
|
|
|
|
---
|
|
|
|
## Contributors
|
|
|
|
### v1.0.0 Release
|
|
- **ClaudeKit Team** → Antigravity Community
|
|
- **Validation**: All 24 skills passed frontmatter and dependency checks
|
|
- **Testing**: Installation verified on Linux, macOS, Windows (WSL)
|
|
|
|
---
|
|
|
|
## Release Notes
|
|
|
|
### v1.0.0 (2026-02-16)
|
|
|
|
**What's New:**
|
|
- 24 standalone Antigravity IDE skills
|
|
- Complete IPA documentation pipeline
|
|
- Cross-platform installation (bash, PowerShell)
|
|
- Zero ClaudeKit dependencies
|
|
- Comprehensive documentation and migration guide
|
|
|
|
**Installation:**
|
|
```bash
|
|
# Linux/macOS
|
|
./install.sh --global
|
|
|
|
# Windows
|
|
.\install.ps1
|
|
```
|
|
|
|
**Quick Start:**
|
|
```
|
|
"Generate requirements for a user auth feature" → ipa-spec activates
|
|
"Create UI mockups" → ipa-design activates
|
|
"Generate API spec" → ipa-detail activates
|
|
"Validate documentation" → ipa-validate activates
|
|
```
|
|
|
|
**Documentation:**
|
|
- See `README.md` for quick-start
|
|
- See `docs/migration-guide-from-ipa-for-ck.md` for upgrade path
|
|
- See `docs/installation-guide.md` for detailed setup
|
|
|
|
**Thank You:**
|
|
- Thanks to IPA-for-CK users for feedback and use cases
|
|
- Thanks to ClaudeKit community for the original workflow
|
|
- Thanks to Antigravity IDE for platform support
|
|
|
|
---
|
|
|
|
## Support & Feedback
|
|
|
|
- **GitHub Issues**: Report bugs or request features
|
|
- **Discussions**: Share ideas and ask questions
|
|
- **Pull Requests**: Contribute skills or improvements
|
|
- **Email**: Support contact (if applicable)
|
|
|
|
For detailed contribution guidelines, see CONTRIBUTING.md (if available).
|
|
|
|
---
|
|
|
|
**Last Updated:** 2026-02-16
|
|
**Status:** Production Release (v1.0.0)
|