WordPress WooCommerce Antigravity Kit

Complete WordPress development environment for Antigravity IDE, VS Code Copilot, and Claude

🏗️ Multi-Platform Folder Structure

This kit is a Common Agent Skill Package designed to provide 100% logic parity across different IDEs and AI Assistants. Depending on which command you run, it scaffolds the exact same knowledge base but with platform-specific entry points:

1. Antigravity IDE (ag-agent init)

Entry point for the native Antigravity experience.

.agent/
├── agents/         ✅ WordPress AI Personas
├── workflows/      ✅ Semi-automated procedures
├── rules/          ✅ Core Protocol (GEMINI.md)
├── skills/         ✅ 14 Technical Instruction Modules
└── shared/         ✅ Data maps and Scripts

2. VS Code Copilot (ag-agent init-copilot)

Entry point for GitHub Copilot in VS Code.

.github/
├── copilot-instructions.md  🧠 System Prompt (The Brain)
├── agents/                  ✅ Personas
├── ag-workflows/            ✅ Procedures (Renamed to avoid GA conflict)
├── rules/                   ✅ Protocol
├── skills/                  ✅ Technical Modules
└── shared/                  ✅ Data maps

3. Claude Code / Assistants (ag-agent init-claude)

Entry point for Claude-specific workflows.

.claude/
├── instructions.md  🧠 System Prompt (The Brain)
├── agents/          ✅ Personas
├── workflows/       ✅ Procedures
├── rules/           ✅ Protocol
├── skills/          ✅ Technical Modules
└── shared/          ✅ Data maps

🚀 Quick Install

# Initialize for Antigravity IDE (creates .agent/)
npx @ai-kits/wp-ag-kit init

# Initialize for VS Code Copilot (creates .github/)
npx @ai-kits/wp-ag-kit init-copilot

# Initialize for Claude Code (creates .claude/)
npx @ai-kits/wp-ag-kit init-claude

# Or install globally
npm install -g @ai-kits/wp-ag-kit
# for antigravity
wp-ai init  

# for copilot
wp-ai init-copilot

# for claude
wp-ai init-claude

📦 What You Get

This kit provides a complete WordPress and WooCommerce development environment adapted for modern AI assistants:

• 14 WordPress and WooCommerce Skills - Expert instruction modules for blocks, themes, plugins, performance, and more
• 3 Specialized Agents - WordPress Expert, Frontend Expert, and WooCommerce Expert AI personas
• 2 Workflows - Automated linting and block creation procedures
• Global Rules - GEMINI.md for consistent, high-quality behavior
• Assistant Optimization - Specialized prompt mapping for GPT-4o and Claude 3.5 Sonnet

🤖 Use in VS Code (Copilot & Claude)

Turn your general-purpose AI into a Senior WordPress Architect.

GitHub Copilot (GPT-4o / Claude 3.5 Sonnet)

1. Run ag-agent init-copilot in your project root.
2. It creates a .github/ folder containing the full knowledge base and a copilot-instructions.md.
3. Copilot will automatically read these instructions and follow the Antigravity protocols (Security, Performance, Socratic questioning).

Claude

1. Run ag-agent init-claude in your project root.
2. It creates a .claude/ folder with the full knowledge base.
3. Claude will now be "Antigravity-aware," referencing the local skills for every task.

💡 CLI Usage

Initialize Your Project for Antigavity

cd your-wordpress-project
ag-agent init

Available Commands

ag-agent init              # Initialize .agent folder (Antigravity IDE)
ag-agent init-copilot      # Initialize VS Code Copilot support (.github/)
ag-agent init-claude       # Initialize Claude support (.claude/)
ag-agent list-skills       # Show available skills
ag-agent list-agents       # Show available agents
ag-agent list-installed    # Show what's in your project
ag-agent use-skill <name>  # Add a specific skill
ag-agent help              # Show help

📚 Available Skills

| Skill | Description | |-------|-------------| | wp-project-triage | Automatic project detection and classification | | wp-block-development | Gutenberg block creation and management | | wp-block-themes | Block theme development with theme.json | | wp-plugin-development | Plugin architecture, hooks, and security | | wp-rest-api | REST API endpoints and controllers | | wp-interactivity-api | Frontend interactivity with data-wp-* directives | | wp-abilities-api | Capability-based permissions | | wp-wpcli-and-ops | WP-CLI automation and operations | | wp-performance | Backend performance profiling and optimization | | wp-phpstan | Static analysis with PHPStan | | wp-playground | WordPress Playground workflows | | wpds | WordPress Design System | | wordpress-router | Smart project routing | | woocommerce | Comprehensive WooCommerce development and copy standards |

🤖 Specialized Agents

WordPress Expert

Master WordPress developer that uses all 14 skills for comprehensive WordPress development.

WordPress Frontend Expert

Specialist for Block Themes, Interactivity API, and modern WordPress UI/UX.

WooCommerce Expert

Specialized in e-commerce architecture, checkout flows, and WooCommerce core integration.

🔄 Workflows

• /wp-lint - Run WordPress-specific linting (PHPStan + @wordpress/scripts)
• /create-block - Scaffold a new Gutenberg block

🎯 Requirements

• Node.js 16 or higher
• WordPress 6.9+ (for skills compatibility)
• PHP 7.2.24+ (for WordPress compatibility)

📖 Documentation

• Complete Structure Guide - Detailed breakdown of all components
• Contributing Guide - How to add skills or improve the kit
• Antigravity README - Kit-specific documentation

🛠️ Development

# Install dependencies
npm install

# Run tests
npm test

# Build distribution (VS Code / Claude / Codex)
npm run build

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📄 License

MIT © Anikesh Kumar

🔗 Links

• npm Package

Made with ❤️ for the WordPress, WooCommerce and Antigravity communities