diff --git a/.github/MAINTENANCE.md b/.github/MAINTENANCE.md index 825a7a9a..90ce7bbf 100644 --- a/.github/MAINTENANCE.md +++ b/.github/MAINTENANCE.md @@ -1,4 +1,4 @@ -# 🛠️ Repository Maintenance Guide (V4) +# 🛠️ Repository Maintenance Guide (V5) > **"If it's not documented, it's broken."** @@ -145,6 +145,24 @@ Locations to check: - **Antigravity Badge**: Must point to `https://github.com/sickn33/antigravity-awesome-skills`, NOT `anthropics/antigravity`. - **License**: Ensure the link points to `LICENSE` file. +### F. Workflows Consistency (NEW in V5) + +If you touch any Workflows-related artifact, keep all workflow surfaces in sync: + +1. `docs/WORKFLOWS.md` (human-readable playbooks) +2. `data/workflows.json` (machine-readable schema) +3. `skills/antigravity-workflows/SKILL.md` (orchestration entrypoint) + +Rules: + +- Every workflow id referenced in docs must exist in `data/workflows.json`. +- If you add/remove a workflow step category, update prompt examples accordingly. +- If a workflow references optional skills not yet merged (example: `go-playwright`), mark them explicitly as **optional** in docs. +- If workflow onboarding text is changed, update the docs trinity: + - `README.md` + - `docs/GETTING_STARTED.md` + - `docs/FAQ.md` + --- ## 3. 🛡️ Governance & Quality Bar @@ -198,6 +216,10 @@ When cutting a new version (e.g., V4): You cannot republish the same version; always bump `package.json` before publishing. - **Option B (CI):** On GitHub, create a **Release** (tag e.g. `v4.6.1`). The workflow [Publish to npm](.github/workflows/publish-npm.yml) runs on **Release published** and runs `npm publish` if the repo secret `NPM_TOKEN` is set (npm → Access Tokens → Granular token with Publish, then add as repo secret `NPM_TOKEN`). +6. **Close linked issue(s)**: + - If the release completes an issue scope (feature/fix), close it with `gh issue close --comment "..."` + - Include release tag reference in the closing note when applicable. + ### 📋 Changelog Entry Template Each new release section in `CHANGELOG.md` should follow [Keep a Changelog](https://keepachangelog.com/) and this structure: diff --git a/CHANGELOG.md b/CHANGELOG.md index d23533c9..2f133cb5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 --- +## [5.0.0] - 2026-02-10 - "Antigravity Workflows Foundation" + +> Workflows are now first-class: users can run guided, multi-skill playbooks instead of manually composing skills one by one. + +### Added + +- **New orchestration skill**: `antigravity-workflows` + - `skills/antigravity-workflows/SKILL.md` + - `skills/antigravity-workflows/resources/implementation-playbook.md` +- **New workflow documentation**: `docs/WORKFLOWS.md` + - Introduces the Workflows model and differentiates it from Bundles. + - Provides execution playbooks with prerequisites, ordered steps, and prompt examples. +- **New machine-readable workflow registry**: `data/workflows.json` + - `ship-saas-mvp` + - `security-audit-web-app` + - `build-ai-agent-system` + - `qa-browser-automation` + +### Changed + +- **README / Onboarding docs** updated to include Workflows discovery and usage: + - `README.md` (TOC + "Antigravity Workflows" section) + - `docs/GETTING_STARTED.md` (Bundles vs Workflows guidance) + - `docs/FAQ.md` (new Q&A: Bundles vs Workflows) +- **Go browser automation alignment**: + - Workflow playbooks now include optional `@go-playwright` hooks for Go-based QA/E2E flows. +- **Registry sync** after workflow skill addition: + - `CATALOG.md` + - `skills_index.json` + - `data/catalog.json` + - `data/bundles.json` + +### Contributors + +- [@sickn33](https://github.com/sickn33) - Workflows architecture, docs, and release integration + +--- + ## [4.11.0] - 2026-02-08 - "Clean Code & Registry Stability" > Quality improvements: Clean Code principles and deterministic builds. diff --git a/README.md b/README.md index ff9c7248..4b60f6ed 100644 --- a/README.md +++ b/README.md @@ -52,11 +52,11 @@ This repository provides essential skills to transform your AI assistant into a ## New Here? Start Here! -**Welcome to the V4.0.0 Enterprise Edition.** This isn't just a list of scripts; it's a complete operating system for your AI Agent. +**Welcome to the V5.0.0 Workflows Edition.** This isn't just a list of scripts; it's a complete operating system for your AI Agent. ### 1. 🐣 Context: What is this? -**Antigravity Awesome Skills** (Release 4.0.0) is a massive upgrade to your AI's capabilities. +**Antigravity Awesome Skills** (Release 5.0.0) is a massive upgrade to your AI's capabilities. AI Agents (like Claude Code, Cursor, or Gemini) are smart, but they lack **specific tools**. They don't know your company's "Deployment Protocol" or the specific syntax for "AWS CloudFormation". **Skills** are small markdown files that teach them how to do these specific tasks perfectly, every time. diff --git a/package-lock.json b/package-lock.json index 332964d2..7b5e65ef 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "antigravity-awesome-skills", - "version": "4.10.0", + "version": "5.0.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "antigravity-awesome-skills", - "version": "4.10.0", + "version": "5.0.0", "license": "MIT", "bin": { "antigravity-awesome-skills": "bin/install.js" diff --git a/package.json b/package.json index 0512439a..75e98731 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "antigravity-awesome-skills", - "version": "4.11.0", + "version": "5.0.0", "description": "626+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.", "license": "MIT", "scripts": { diff --git a/release_notes.md b/release_notes.md index 851a31ea..9497bc07 100644 --- a/release_notes.md +++ b/release_notes.md @@ -1,36 +1,36 @@ -## [4.10.0] - 2026-02-06 - "Composio Automation + .NET Backend" +## [5.0.0] - 2026-02-10 - "Antigravity Workflows Foundation" -> This release significantly expands hands-on automation coverage while adding a production-oriented .NET backend skill. +> First-class Workflows are now available to orchestrate multiple skills through guided execution playbooks. -### Added +### 🚀 New Skills -- **79 new skills total**. -- **78 Composio/Rube automation skills** (PR #64), covering practical workflows across: -- CRM/sales (`HubSpot`, `Salesforce`, `Pipedrive`, `Zoho CRM`, `Close`) -- Collaboration/project ops (`Notion`, `ClickUp`, `Asana`, `Jira`, `Confluence`, `Trello`, `Monday`) -- Messaging/support (`Slack`, `Discord`, `Teams`, `Intercom`, `Freshdesk`, `Zendesk`) -- Analytics/marketing (`Google Analytics`, `Mixpanel`, `PostHog`, `Segment`, `Mailchimp`, `Klaviyo`) -- Dev/infra operations (`GitHub`, `GitLab`, `CircleCI`, `Datadog`, `PagerDuty`, `Vercel`, `Render`) -- **1 new `dotnet-backend` skill** (PR #65) with detailed ASP.NET Core 8+ guidance: -- Minimal API and controller patterns -- EF Core data-access patterns -- JWT authentication implementation -- Background service templates -- Explicit "When to Use" and "Limitations" sections -- **Registry growth**: 634 -> 713 indexed skills. +### 🧭 [antigravity-workflows](skills/antigravity-workflows/) -### Changed +**Orchestrates multi-step outcomes using curated workflow playbooks.** +This new skill routes users from high-level goals to concrete execution steps across related skills and bundles. -- Regenerated and synchronized discovery artifacts: -- `README.md` -- `skills_index.json` -- `CATALOG.md` -- `data/catalog.json` -- `data/bundles.json` -- `data/aliases.json` -- Updated release metadata and published tag/release `v4.10.0`. +- **Key Feature 1**: Workflow routing for SaaS MVP, Security Audit, AI Agent Systems, and Browser QA. +- **Key Feature 2**: Explicit step-by-step outputs with prerequisites, recommended skills, and validation checkpoints. -### Contributors +> **Try it:** `Use @antigravity-workflows to run ship-saas-mvp for my project.` -- [@sohamganatra](https://github.com/sohamganatra) -- [@Nguyen-Van-Chan](https://github.com/Nguyen-Van-Chan) +--- + +## 📦 Improvements + +- **Workflow Registry**: Added `data/workflows.json` for machine-readable workflow metadata. +- **Workflow Docs**: Added `docs/WORKFLOWS.md` to distinguish Bundles vs Workflows and provide practical execution playbooks. +- **Trinity Sync**: Updated `README.md`, `docs/GETTING_STARTED.md`, and `docs/FAQ.md` for workflow onboarding. +- **Go QA Path**: Added optional `@go-playwright` wiring in QA/E2E workflow steps. +- **Registry Update**: Catalog regenerated; repository now tracks 714 skills. + +## 👥 Credits + +A huge shoutout to our community and maintainers: + +- **@Walapalam** for the Workflows concept request ([Issue #72](https://github.com/sickn33/antigravity-awesome-skills/issues/72)) +- **@sickn33** for workflow integration, release preparation, and maintenance updates + +--- + +_Upgrade now: `git pull origin main` to fetch the latest skills._