chore: cut v5.0.0 workflows release and maintenance updates

sck000 · cursoragent · sck000 · commit cc2946b6d5ff · 2026-02-10T10:43:41.000+01:00
Prepare release 5.0.0 by documenting the new Workflows foundation, bumping package metadata, refreshing release notes, and extending MAINTENANCE guidance for workflows consistency and issue-closing protocol.

Co-authored-by: Cursor &lt;cursoragent@cursor.com&gt;
diff --git 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 <id> --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
@@ -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
@@ -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
diff --git 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
@@ -1,36 +1,36 @@
-## [4.10.0] - 2026-02-06 - "Composio Automation + .NET Backend"
-
-> This release significantly expands hands-on automation coverage while adding a production-oriented .NET backend skill.
-
-### Added
-
-- **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.
-
-### Changed
-
-- 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`.
-
-### Contributors
-
-- [@sohamganatra](https://github.com/sohamganatra)
-- [@Nguyen-Van-Chan](https://github.com/Nguyen-Van-Chan)
+## [5.0.0] - 2026-02-10 - "Antigravity Workflows Foundation"
+
+> First-class Workflows are now available to orchestrate multiple skills through guided execution playbooks.
+
+### 🚀 New Skills
+
+### 🧭 [antigravity-workflows](skills/antigravity-workflows/)
+
+**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.
+
+- **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.
+
+> **Try it:** `Use @antigravity-workflows to run ship-saas-mvp for my project.`
+
+---
+
+## 📦 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._

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "antigravity-awesome-skills",`
`3`		`- "version": "4.11.0",`
	`3`	`+ "version": "5.0.0",`
`4`	`4`	`"description": "626+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"scripts": {`