aidevops 2.52.1

package/.agent/tools/wordpress/wp-preferred.md

@@ -0,0 +1,398 @@
+---
+description: WordPress preferred plugins and theme recommendations
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: false
+  glob: true
+  grep: true
+  webfetch: true
+  task: true
+---
+
+# WordPress Preferred Plugins & Theme
+
+<!-- AI-CONTEXT-START -->
+## Quick Reference
+
+**Theme**: Kadence (https://wordpress.org/themes/kadence/)
+**Total Plugins**: 127+ curated plugins across 19 categories
+
+**Selection Criteria** (applied globally):
+- Speed optimization (minimal frontend impact)
+- WP standards compliance (native UI patterns)
+- Quality documentation
+- Regular updates without breaking changes
+- Tested compatibility with this stack
+
+**Key Ecosystems**:
+- **Kadence**: Theme, Blocks Pro, Conversions, Shop Kit, Starter Templates
+- **Fluent**: Forms, CRM, Support, Booking, Community, Boards, SMTP
+- **Flying**: Analytics, Pages, Scripts (performance suite)
+
+**Quick Install (minimal stack)**:
+
+```bash
+wp plugin install antispam-bee compressx fluent-smtp kadence-blocks simple-cloudflare-turnstile --activate
+wp theme install kadence --activate
+```
+
+**Pro/Premium plugins**: Require license activation via vendor dashboards
+**License keys**: Store in `~/.config/aidevops/mcp-env.sh` (see api-key-setup.md)
+**Updates**: Git Updater available for managing plugin updates from Git repositories
+<!-- AI-CONTEXT-END -->
+
+## Selection Criteria
+
+Plugins are chosen based on:
+
+1. **Speed Optimization** - Minimal frontend impact, efficient code
+2. **WP Standards** - Following WordPress coding standards and UI patterns
+3. **Documentation** - Clear, comprehensive, up-to-date docs
+4. **Update Frequency** - Regular updates without breaking changes
+5. **Conflict-Free** - Tested for compatibility with this stack
+
+## Theme
+
+| Name | Slug | Source |
+|------|------|--------|
+| Kadence | `kadence` | https://wordpress.org/themes/kadence/ |
+| Kadence Pro (plugin) | `kadence-pro` | https://www.kadencewp.com/kadence-theme/pro/ |
+
+## Plugins by Category
+
+### Minimal (Essential Starter Stack)
+
+These 5 plugins form the minimal recommended installation for any new WordPress site.
+
+| Slug | Name | Source |
+|------|------|--------|
+| `antispam-bee` | Antispam Bee | https://wordpress.org/plugins/antispam-bee/ |
+| `compressx` | CompressX | https://wordpress.org/plugins/compressx/ |
+| `fluent-smtp` | FluentSMTP | https://wordpress.org/plugins/fluent-smtp/ |
+| `kadence-blocks` | Kadence Blocks | https://wordpress.org/plugins/kadence-blocks/ |
+| `simple-cloudflare-turnstile` | Simple Cloudflare Turnstile | https://wordpress.org/plugins/simple-cloudflare-turnstile/ |
+
+### Admin
+
+| Slug | Name | Source |
+|------|------|--------|
+| `admin-bar-dashboard-control` | Admin Bar & Dashboard Control | https://wordpress.org/plugins/admin-bar-dashboard-control/ |
+| `admin-columns-pro` | Admin Columns Pro | https://www.admincolumns.com/ |
+| `admin-menu-editor-pro` | Admin Menu Editor Pro | https://adminmenueditor.com/upgrade-to-pro/ |
+| `wp-toolbar-editor` | AME Toolbar Editor | https://adminmenueditor.com/ |
+| `hide-admin-notices` | Hide Admin Notices | https://wordpress.org/plugins/hide-admin-notices/ |
+| `magic-login` | Magic Login | https://wordpress.org/plugins/magic-login/ |
+| `mainwp-child` | MainWP Child | https://wordpress.org/plugins/mainwp-child/ |
+| `mainwp-child-reports` | MainWP Child Reports | https://wordpress.org/plugins/mainwp-child-reports/ |
+| `manage-notification-emails` | Manage Notification E-mails | https://wordpress.org/plugins/manage-notification-emails/ |
+| `network-plugin-auditor` | Network Plugin Auditor | https://wordpress.org/plugins/network-plugin-auditor/ |
+| `plugin-groups` | Plugin Groups | https://wordpress.org/plugins/plugin-groups/ |
+| `plugin-toggle` | Plugin Toggle | https://wordpress.org/plugins/plugin-toggle/ |
+| `user-switching` | User Switching | https://wordpress.org/plugins/user-switching/ |
+
+### AI
+
+| Slug | Name | Source |
+|------|------|--------|
+| `ai-engine` | AI Engine | https://wordpress.org/plugins/ai-engine/ |
+| `ai-engine-pro` | AI Engine (Pro) | https://meowapps.com/plugin/ai-engine/ |
+
+### CMS (Content Management)
+
+| Slug | Name | Source |
+|------|------|--------|
+| `auto-post-scheduler` | Auto Post Scheduler | https://wordpress.org/plugins/auto-post-scheduler/ |
+| `auto-upload-images` | Auto Upload Images | https://wordpress.org/plugins/auto-upload-images/ |
+| `block-options` | EditorsKit | https://wordpress.org/plugins/block-options/ |
+| `bookmark-card` | Bookmark Card | https://wordpress.org/plugins/bookmark-card/ |
+| `browser-shots` | Browser Shots | https://wordpress.org/plugins/browser-shots/ |
+| `bulk-actions-select-all` | Bulk Actions Select All | https://wordpress.org/plugins/bulk-actions-select-all/ |
+| `carbon-copy` | Carbon Copy | https://wordpress.org/plugins/carbon-copy/ |
+| `code-block-pro` | Code Block Pro | https://wordpress.org/plugins/code-block-pro/ |
+| `distributor` | Distributor | https://wordpress.org/plugins/distributor/ |
+| `iframe-block` | iFrame Block | https://wordpress.org/plugins/iframe-block/ |
+| `ics-calendar` | ICS Calendar | https://wordpress.org/plugins/ics-calendar/ |
+| `mammoth-docx-converter` | Mammoth .docx converter | https://wordpress.org/plugins/mammoth-docx-converter/ |
+| `nav-menu-roles` | Nav Menu Roles | https://wordpress.org/plugins/nav-menu-roles/ |
+| `ninja-tables` | Ninja Tables | https://wordpress.org/plugins/ninja-tables/ |
+| `ninja-tables-pro` | Ninja Tables Pro | https://wpmanageninja.com/ninja-tables/ |
+| `post-draft-preview` | Post Draft Preview | https://wordpress.org/plugins/post-draft-preview/ |
+| `post-type-switcher` | Post Type Switcher | https://wordpress.org/plugins/post-type-switcher/ |
+| `simple-custom-post-order` | Simple Custom Post Order | https://wordpress.org/plugins/simple-custom-post-order/ |
+| `simple-icons` | Popular Brand SVG Icons | https://wordpress.org/plugins/simple-icons/ |
+| `sticky-posts-switch` | Sticky Posts - Switch | https://wordpress.org/plugins/sticky-posts-switch/ |
+| `super-speedy-imports` | Super Speedy Imports | https://wordpress.org/plugins/super-speedy-imports/ |
+| `term-management-tools` | Term Management Tools | https://wordpress.org/plugins/term-management-tools/ |
+| `the-paste` | The Paste | https://wordpress.org/plugins/the-paste/ |
+| `wikipedia-preview` | Wikipedia Preview | https://wordpress.org/plugins/wikipedia-preview/ |
+
+### Compliance (Privacy & Legal)
+
+| Slug | Name | Source |
+|------|------|--------|
+| `avatar-privacy` | Avatar Privacy | https://wordpress.org/plugins/avatar-privacy/ |
+| `complianz-gdpr` | Complianz GDPR | https://wordpress.org/plugins/complianz-gdpr/ |
+| `complianz-gdpr-premium` | Complianz Privacy Suite Premium | https://complianz.io/ |
+| `complianz-terms-conditions` | Complianz Terms & Conditions | https://wordpress.org/plugins/complianz-terms-conditions/ |
+| `really-simple-ssl` | Really Simple SSL | https://wordpress.org/plugins/really-simple-ssl/ |
+| `really-simple-ssl-pro` | Really Simple Security Pro | https://really-simple-ssl.com/pro/ |
+
+### CRM & Forms (Fluent Ecosystem)
+
+| Slug | Name | Source |
+|------|------|--------|
+| `fluent-boards` | Fluent Boards | https://wordpress.org/plugins/fluent-boards/ |
+| `fluent-boards-pro` | Fluent Boards Pro | https://fluentboards.com/ |
+| `fluent-booking` | FluentBooking | https://wordpress.org/plugins/fluent-booking/ |
+| `fluent-booking-pro` | FluentBooking Pro | https://fluentbooking.com/ |
+| `fluent-community` | FluentCommunity | https://wordpress.org/plugins/fluent-community/ |
+| `fluent-community-pro` | FluentCommunity Pro | https://fluentcommunity.co/ |
+| `fluent-crm` | FluentCRM | https://wordpress.org/plugins/fluent-crm/ |
+| `fluentcampaign-pro` | FluentCRM Pro | https://fluentcrm.com/ |
+| `fluent-roadmap` | Fluent Roadmap | https://wordpress.org/plugins/fluent-roadmap/ |
+| `fluent-support` | Fluent Support | https://wordpress.org/plugins/fluent-support/ |
+| `fluent-support-pro` | Fluent Support Pro | https://fluentsupport.com/ |
+| `fluentform` | Fluent Forms | https://wordpress.org/plugins/fluentform/ |
+| `fluentformpro` | Fluent Forms Pro | https://fluentforms.com/ |
+| `fluentforms-pdf` | Fluent Forms PDF Generator | https://wordpress.org/plugins/fluentforms-pdf/ |
+| `fluentform-signature` | Fluent Forms Signature Addon | https://fluentforms.com/ |
+
+### eCommerce (WooCommerce)
+
+| Slug | Name | Source |
+|------|------|--------|
+| `woocommerce` | WooCommerce | https://wordpress.org/plugins/woocommerce/ |
+| `kadence-woocommerce-email-designer` | Kadence WooCommerce Email Designer | https://wordpress.org/plugins/kadence-woocommerce-email-designer/ |
+| `kadence-woo-extras` | Kadence Shop Kit | https://www.kadencewp.com/ |
+| `pymntpl-paypal-woocommerce` | Payment Plugins for PayPal | https://wordpress.org/plugins/pymntpl-paypal-woocommerce/ |
+| `woo-stripe-payment` | Payment Plugins for Stripe | https://wordpress.org/plugins/woo-stripe-payment/ |
+
+### LMS (Learning Management)
+
+| Slug | Name | Source |
+|------|------|--------|
+| `tutor` | Tutor LMS | https://wordpress.org/plugins/tutor/ |
+| `tutor-pro` | Tutor LMS Pro | https://www.themeum.com/product/tutor-lms/ |
+| `tutor-lms-certificate-builder` | Tutor LMS Certificate Builder | https://www.themeum.com/product/tutor-lms-certificate-builder/ |
+
+### Media
+
+| Slug | Name | Source |
+|------|------|--------|
+| `easy-watermark` | Easy Watermark | https://wordpress.org/plugins/easy-watermark/ |
+| `enable-media-replace` | Enable Media Replace | https://wordpress.org/plugins/enable-media-replace/ |
+| `image-copytrack` | Image Copytrack | https://wordpress.org/plugins/image-copytrack/ |
+| `imsanity` | Imsanity | https://wordpress.org/plugins/imsanity/ |
+| `media-file-renamer` | Media File Renamer | https://wordpress.org/plugins/media-file-renamer/ |
+| `media-file-renamer-pro` | Media File Renamer Pro | https://meowapps.com/plugin/media-file-renamer/ |
+| `safe-svg` | Safe SVG | https://wordpress.org/plugins/safe-svg/ |
+
+### SEO
+
+| Slug | Name | Source |
+|------|------|--------|
+| `burst-statistics` | Burst Statistics | https://wordpress.org/plugins/burst-statistics/ |
+| `hreflang-manager` | Hreflang Manager | https://wordpress.org/plugins/hreflang-manager/ |
+| `link-insight` | Link Whisper | https://linkwhisper.com/ |
+| `official-facebook-pixel` | Meta Pixel for WordPress | https://wordpress.org/plugins/official-facebook-pixel/ |
+| `post-to-google-my-business` | Post to Google My Business | https://wordpress.org/plugins/post-to-google-my-business/ |
+| `pretty-link` | PrettyLinks | https://wordpress.org/plugins/pretty-link/ |
+| `seo-by-rank-math` | Rank Math SEO | https://wordpress.org/plugins/seo-by-rank-math/ |
+| `rank-optimizer-pro` | Rank Math SEO PRO | https://rankmath.com/ |
+| `readabler` | Readabler | https://wordpress.org/plugins/readabler/ |
+| `remove-cpt-base` | Remove CPT base | https://wordpress.org/plugins/remove-cpt-base/ |
+| `remove-old-slugspermalinks` | Slugs Manager | https://wordpress.org/plugins/remove-old-slugspermalinks/ |
+| `syndication-links` | Syndication Links | https://wordpress.org/plugins/syndication-links/ |
+| `ultimate-410` | Ultimate 410 | https://wordpress.org/plugins/ultimate-410/ |
+| `webmention` | Webmention | https://wordpress.org/plugins/webmention/ |
+
+### Setup & Import
+
+| Slug | Name | Source |
+|------|------|--------|
+| `kadence-starter-templates` | Starter Templates by Kadence WP | https://wordpress.org/plugins/kadence-starter-templates/ |
+| `wordpress-importer` | WordPress Importer | https://wordpress.org/plugins/wordpress-importer/ |
+
+### Social
+
+| Slug | Name | Source |
+|------|------|--------|
+| `social-engine` | Social Engine | https://wordpress.org/plugins/social-engine/ |
+| `social-engine-pro` | Social Engine Pro | https://meowapps.com/plugin/social-engine/ |
+| `wp-social-ninja` | WP Social Ninja | https://wordpress.org/plugins/wp-social-ninja/ |
+| `wp-social-ninja-pro` | WP Social Ninja Pro | https://wpsocialninja.com/ |
+| `wp-social-reviews` | WP Social Reviews | https://wordpress.org/plugins/wp-social-reviews/ |
+
+### Speed & Performance
+
+| Slug | Name | Source |
+|------|------|--------|
+| `compressx` | CompressX | https://wordpress.org/plugins/compressx/ |
+| `disable-wordpress-updates` | Disable All WordPress Updates | https://wordpress.org/plugins/disable-wordpress-updates/ |
+| `disable-dashboard-for-woocommerce-pro` | Disable Bloat PRO | https://disablebloat.com/ |
+| `flying-analytics` | Flying Analytics | https://wordpress.org/plugins/flying-analytics/ |
+| `flying-pages` | Flying Pages | https://wordpress.org/plugins/flying-pages/ |
+| `flying-scripts` | Flying Scripts | https://wordpress.org/plugins/flying-scripts/ |
+| `freesoul-deactivate-plugins` | Freesoul Deactivate Plugins | https://wordpress.org/plugins/freesoul-deactivate-plugins/ |
+| `freesoul-deactivate-plugins-pro` | Freesoul Deactivate Plugins PRO | https://freesoul-deactivate-plugins.com/ |
+| `growthboost` | Scalability Pro | https://scalability.pro/ |
+| `http-requests-manager` | HTTP Requests Manager | https://wordpress.org/plugins/http-requests-manager/ |
+| `index-wp-mysql-for-speed` | Index WP MySQL For Speed | https://wordpress.org/plugins/index-wp-mysql-for-speed/ |
+| `litespeed-cache` | LiteSpeed Cache | https://wordpress.org/plugins/litespeed-cache/ |
+| `performant-translations` | Performant Translations | https://wordpress.org/plugins/performant-translations/ |
+| `wp-widget-disable` | Widget Disable | https://wordpress.org/plugins/wp-widget-disable/ |
+
+### Translation
+
+| Slug | Name | Source |
+|------|------|--------|
+| `hreflang-manager` | Hreflang Manager | https://wordpress.org/plugins/hreflang-manager/ |
+| `performant-translations` | Performant Translations | https://wordpress.org/plugins/performant-translations/ |
+
+### Advanced (Developer Tools)
+
+| Slug | Name | Source |
+|------|------|--------|
+| `acf-better-search` | ACF: Better Search | https://wordpress.org/plugins/acf-better-search/ |
+| `secure-custom-fields` | Secure Custom Fields | https://wordpress.org/plugins/secure-custom-fields/ |
+| `code-snippets` | Code Snippets | https://wordpress.org/plugins/code-snippets/ |
+| `code-snippets-pro` | Code Snippets Pro | https://codesnippets.pro/ |
+| `git-updater` | Git Updater | https://wordpress.org/plugins/git-updater/ |
+| `indieweb` | IndieWeb | https://wordpress.org/plugins/indieweb/ |
+| `waspthemes-yellow-pencil` | YellowPencil Pro | https://yellowpencil.waspthemes.com/ |
+
+### Debug & Troubleshooting
+
+| Slug | Name | Source |
+|------|------|--------|
+| `advanced-database-cleaner` | Advanced Database Cleaner | https://wordpress.org/plugins/advanced-database-cleaner/ |
+| `advanced-database-cleaner-pro` | Advanced Database Cleaner PRO | https://sigmaplugin.com/downloads/wordpress-advanced-database-cleaner |
+| `code-profiler-pro` | Code Profiler Pro | https://codeprofiler.io/ |
+| `debug-log-manager` | Debug Log Manager | https://wordpress.org/plugins/debug-log-manager/ |
+| `gotmls` | Anti-Malware Security | https://wordpress.org/plugins/gotmls/ |
+| `query-monitor` | Query Monitor | https://wordpress.org/plugins/query-monitor/ |
+| `string-locator` | String Locator | https://wordpress.org/plugins/string-locator/ |
+| `user-switching` | User Switching | https://wordpress.org/plugins/user-switching/ |
+| `wp-crontrol` | WP Crontrol | https://wordpress.org/plugins/wp-crontrol/ |
+
+### Security
+
+| Slug | Name | Source |
+|------|------|--------|
+| `antispam-bee` | Antispam Bee | https://wordpress.org/plugins/antispam-bee/ |
+| `comment_goblin` | Comment Goblin | https://commentgoblin.com/ |
+| `gotmls` | Anti-Malware Security | https://wordpress.org/plugins/gotmls/ |
+| `really-simple-ssl` | Really Simple SSL | https://wordpress.org/plugins/really-simple-ssl/ |
+| `really-simple-ssl-pro` | Really Simple Security Pro | https://really-simple-ssl.com/pro/ |
+| `simple-cloudflare-turnstile` | Simple Cloudflare Turnstile | https://wordpress.org/plugins/simple-cloudflare-turnstile/ |
+
+### Kadence Ecosystem
+
+| Slug | Name | Source |
+|------|------|--------|
+| `kadence-blocks` | Kadence Blocks | https://wordpress.org/plugins/kadence-blocks/ |
+| `kadence-blocks-pro` | Kadence Blocks PRO | https://www.kadencewp.com/kadence-blocks/pro/ |
+| `kadence-build-child-defaults` | Kadence Child Theme Builder | https://www.kadencewp.com/ |
+| `kadence-cloud` | Kadence Pattern Hub | https://www.kadencewp.com/ |
+| `kadence-conversions` | Kadence Conversions | https://www.kadencewp.com/ |
+| `kadence-pro` | Kadence Pro | https://www.kadencewp.com/kadence-theme/pro/ |
+| `kadence-simple-share` | Kadence Simple Share | https://wordpress.org/plugins/kadence-simple-share/ |
+| `kadence-starter-templates` | Starter Templates by Kadence WP | https://wordpress.org/plugins/kadence-starter-templates/ |
+| `kadence-woo-extras` | Kadence Shop Kit | https://www.kadencewp.com/ |
+| `kadence-woocommerce-email-designer` | Kadence WooCommerce Email Designer | https://wordpress.org/plugins/kadence-woocommerce-email-designer/ |
+
+### Migration & Backup
+
+| Slug | Name | Source |
+|------|------|--------|
+| `wp-migrate-db-pro` | WP Migrate | https://deliciousbrains.com/wp-migrate-db-pro/ |
+| `wp-migrate-db-pro-compatibility` | WP Migrate Compatibility | https://deliciousbrains.com/wp-migrate-db-pro/ |
+
+### Multisite
+
+| Slug | Name | Source |
+|------|------|--------|
+| `network-plugin-auditor` | Network Plugin Auditor | https://wordpress.org/plugins/network-plugin-auditor/ |
+| `ultimate-multisite` | Ultimate Multisite | https://developer.developer.developer-developer-developer/ |
+
+### Hosting-Specific
+
+| Slug | Name | Source |
+|------|------|--------|
+| `closte-requirements` | Closte.com | Only for Closte.com hosting |
+| `eos-deactivate-plugins` | Freesoul Deactivate Plugins [FDP] | Closte variant |
+
+## WP-CLI Quick Install Commands
+
+### Minimal Stack
+
+```bash
+wp plugin install antispam-bee compressx fluent-smtp kadence-blocks simple-cloudflare-turnstile --activate
+wp theme install kadence --activate
+```
+
+### Admin Stack
+
+```bash
+wp plugin install admin-bar-dashboard-control hide-admin-notices manage-notification-emails plugin-toggle user-switching --activate
+```
+
+### Performance Stack
+
+```bash
+wp plugin install flying-analytics flying-pages flying-scripts freesoul-deactivate-plugins index-wp-mysql-for-speed performant-translations --activate
+```
+
+### SEO Stack
+
+```bash
+wp plugin install seo-by-rank-math burst-statistics syndication-links webmention --activate
+```
+
+### Forms & CRM Stack
+
+```bash
+wp plugin install fluentform fluent-crm fluent-smtp fluent-support --activate
+```
+
+### WooCommerce Stack
+
+```bash
+wp plugin install woocommerce kadence-woocommerce-email-designer pymntpl-paypal-woocommerce woo-stripe-payment --activate
+```
+
+### Debug Stack
+
+```bash
+wp plugin install query-monitor debug-log-manager string-locator wp-crontrol user-switching --activate
+```
+
+## Pro Plugin Vendor URLs
+
+For premium plugins, use these vendor sites for purchase and license management:
+
+| Ecosystem | Vendor URL |
+|-----------|------------|
+| Kadence | https://www.kadencewp.com/ |
+| Fluent/WPManageNinja | https://wpmanageninja.com/ |
+| Rank Math | https://rankmath.com/ |
+| Meow Apps | https://meowapps.com/ |
+| Really Simple | https://really-simple-ssl.com/ |
+| Complianz | https://complianz.io/ |
+| Tutor LMS | https://www.themeum.com/ |
+| Admin Columns | https://www.admincolumns.com/ |
+| Code Snippets | https://codesnippets.pro/ |
+| Delicious Brains | https://deliciousbrains.com/ |
+
+## Related Documentation
+
+| Topic | File |
+|-------|------|
+| WordPress development | `workflows/wp-dev.md` |
+| WordPress admin | `workflows/wp-admin.md` |
+| LocalWP database access | `localwp.md` |
+| MainWP fleet management | `mainwp.md` |
+| API key management | `api-key-setup.md` |

package/.agent/tools/wordpress.md

@@ -0,0 +1,95 @@
+---
+name: wordpress
+description: WordPress ecosystem management - local development, fleet management, plugin curation
+mode: subagent
+---
+
+# WordPress - Orchestrator
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: WordPress ecosystem management
+- **Local Dev**: LocalWP with MCP integration
+- **Fleet Management**: MainWP for multi-site operations
+- **Preferred Plugins**: See `wp-preferred.md` (127+ plugins)
+
+**Subagents**:
+- `wp-dev.md` - Theme/plugin development, debugging
+- `wp-admin.md` - Content management, maintenance
+- `localwp.md` - Local development with MCP
+- `mainwp.md` - Multi-site fleet management
+- `wp-preferred.md` - Curated plugin list by category
+- `scf.md` - Secure Custom Fields / ACF
+
+**MCP Integration**:
+- LocalWP MCP: Direct database access for local sites
+- MainWP REST API: Fleet operations
+
+**Key Commands**:
+
+```bash
+# LocalWP sites
+.agent/scripts/wordpress-mcp-helper.sh list-sites
+
+# MainWP operations
+.agent/scripts/mainwp-helper.sh [command] [site]
+```
+
+<!-- AI-CONTEXT-END -->
+
+## WordPress Ecosystem
+
+### Local Development
+
+Use LocalWP for local WordPress development:
+- Full MCP integration for database access
+- See `localwp.md` for setup
+
+### Fleet Management
+
+MainWP provides centralized WordPress management:
+- Bulk updates, backups, security scans
+- See `mainwp.md` for operations
+
+### Development Workflow
+
+1. **Local**: Develop in LocalWP environment
+2. **Test**: Use `wp-dev.md` patterns
+3. **Deploy**: Push via MainWP or hosting provider
+4. **Manage**: Ongoing via `wp-admin.md`
+
+### Plugin Selection
+
+`wp-preferred.md` contains 127+ curated plugins across 19 categories:
+- Performance, Security, SEO
+- Forms, E-commerce, Membership
+- Backup, Staging, Development tools
+
+Always prefer curated plugins for reliability.
+
+## Oh-My-OpenCode Integration
+
+When oh-my-opencode is installed, leverage these specialized agents for enhanced WordPress development:
+
+| OmO Agent | When to Use | Example |
+|-----------|-------------|---------|
+| `@frontend-ui-ux-engineer` | Theme UI, Gutenberg blocks, custom components | "Ask @frontend-ui-ux-engineer to create a hero section block" |
+| `@oracle` | Architecture decisions, plugin structure, debugging | "Ask @oracle to review this plugin architecture" |
+| `@librarian` | WordPress coding standards, hook examples, API patterns | "Ask @librarian for WooCommerce hook examples" |
+| `@document-writer` | Plugin documentation, readme files, user guides | "Ask @document-writer to create plugin documentation" |
+
+**Theme Development Workflow**:
+
+```text
+1. Design → @frontend-ui-ux-engineer creates UI components
+2. Structure → @oracle reviews theme architecture
+3. Implement → WordPress agent builds with LocalWP
+4. Patterns → @librarian finds WordPress best practices
+5. Document → @document-writer creates theme docs
+6. Deploy → MainWP pushes to production
+```
+
+**Note**: These agents require [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) plugin.
+See `tools/opencode/oh-my-opencode.md` for installation.

package/.agent/workflows/branch/bugfix.md

@@ -0,0 +1,63 @@
+---
+description: Bugfix branch - non-urgent bug fixes
+mode: subagent
+tools:
+  read: true
+  write: true
+  edit: true
+  bash: true
+  glob: true
+  grep: true
+---
+
+# Bugfix Branch
+
+<!-- AI-CONTEXT-START -->
+
+| Aspect | Value |
+|--------|-------|
+| **Prefix** | `bugfix/` |
+| **Commit** | `fix: description` |
+| **Version** | Patch bump (1.0.0 → 1.0.1) |
+| **Create from** | `main` |
+
+```bash
+git checkout main && git pull origin main
+git checkout -b bugfix/{description}
+```
+
+<!-- AI-CONTEXT-END -->
+
+## When to Use
+
+- Non-urgent bug fixes
+- Issues that can wait for normal release cycle
+- Bugs found in development/staging
+
+**For urgent production issues**, use `hotfix/` instead.
+
+## Unique Guidance
+
+**Always add a regression test** to prevent the bug from recurring.
+
+For detailed bug investigation patterns, see `workflows/bug-fixing.md`.
+
+## Examples
+
+```bash
+bugfix/login-timeout
+bugfix/123-null-pointer
+bugfix/api-response-parsing
+```
+
+## Commit Example
+
+```bash
+fix: resolve login timeout on slow connections
+
+- Increase timeout from 5s to 30s
+- Add retry logic with exponential backoff
+- Improve error message for users
+
+Fixes #123
+```

package/.agent/workflows/branch/chore.md

@@ -0,0 +1,95 @@
+---
+description: Chore branch - maintenance, docs, deps, config
+mode: subagent
+tools:
+  read: true
+  write: true
+  edit: true
+  bash: true
+  glob: true
+  grep: true
+---
+
+# Chore Branch
+
+<!-- AI-CONTEXT-START -->
+
+| Aspect | Value |
+|--------|-------|
+| **Prefix** | `chore/` |
+| **Commit** | `chore:`, `docs:`, `ci:`, or `build:` |
+| **Version** | Usually none |
+| **Create from** | `main` |
+
+```bash
+git checkout main && git pull origin main
+git checkout -b chore/{description}
+```
+
+<!-- AI-CONTEXT-END -->
+
+## When to Use
+
+- Dependency updates
+- CI/CD configuration changes
+- Documentation updates
+- Build system changes
+- Tooling configuration
+- Code formatting/linting fixes
+- License updates
+- Gitignore changes
+
+**Not for**: Code changes that affect behavior (use `feature/`, `bugfix/`, or `refactor/`).
+
+## Unique Guidance
+
+### Multiple Commit Prefixes
+
+Use specific prefixes when applicable:
+
+| Prefix | Use For |
+|--------|---------|
+| `chore:` | General maintenance |
+| `docs:` | Documentation |
+| `ci:` | CI/CD changes |
+| `build:` | Build system |
+
+### Common Chore Tasks
+
+**Dependency Updates:**
+
+```bash
+npm outdated          # Check for updates
+npm update            # Update and test
+git commit -m "chore: update dependencies"
+```
+
+**CI/CD Changes:**
+
+```bash
+git commit -m "ci: optimize GitHub Actions workflow
+
+- Add dependency caching
+- Run tests in parallel
+- Reduce build time by 40%"
+```
+
+**Documentation:**
+
+```bash
+git commit -m "docs: improve installation instructions
+
+- Add troubleshooting section
+- Update screenshots
+- Fix broken links"
+```
+
+## Examples
+
+```bash
+chore/update-dependencies
+chore/fix-github-actions
+chore/add-codecov
+chore/update-readme
+chore/configure-eslint
+```