chore: cut v5.0.0 workflows release and maintenance updates

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 <cursoragent@cursor.com>

.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:

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.

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.

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"

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": {

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._