aidevops 2.52.1 → 2.53.2

package/.agent/tools/ui/shadcn.md

@@ -1,196 +0,0 @@
----
-description: shadcn/ui component library MCP for browsing, searching, and installing components
-mode: subagent
-tools:
-  read: true
-  write: true
-  edit: true
-  bash: true
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# shadcn/ui MCP Server
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Purpose**: Browse, search, and install shadcn/ui components via MCP
-- **MCP Config**: `configs/mcp-templates/shadcn.json`
-- **Docs**: https://ui.shadcn.com/docs/mcp
-- **Registry Docs**: https://ui.shadcn.com/docs/registry/mcp
-
-**When to use this MCP**:
-- User asks to add UI components (buttons, dialogs, forms, cards, etc.)
-- Building landing pages, dashboards, or forms
-- User mentions "shadcn", "radix", or component names like "dialog", "sheet", "toast"
-- Project has `components.json` in root (shadcn-initialized project)
-
-**Available Tools** (via MCP):
-- Browse all components in registries
-- Search for specific components by name/functionality
-- Install components directly into project
-- Work with multiple registries (public, private, third-party)
-
-**Components Available**: accordion, alert, alert-dialog, aspect-ratio, avatar, badge, breadcrumb, button, button-group, calendar, card, carousel, chart, checkbox, collapsible, combobox, command, context-menu, data-table, date-picker, dialog, drawer, dropdown-menu, empty, field, form, hover-card, input, input-group, input-otp, item, kbd, label, menubar, native-select, navigation-menu, pagination, popover, progress, radio-group, resizable, scroll-area, select, separator, sheet, sidebar, skeleton, slider, sonner, spinner, switch, table, tabs, textarea, toast, toggle, toggle-group, tooltip, typography
-
-<!-- AI-CONTEXT-END -->
-
-## Setup
-
-### Prerequisites
-
-1. Project must be initialized with shadcn:
-
-   ```bash
-   npx shadcn@latest init
-   ```
-
-2. This creates `components.json` in project root
-
-### MCP Configuration
-
-Add to your MCP client config:
-
-**Claude Code** (`.mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "shadcn": {
-      "command": "npx",
-      "args": ["shadcn@latest", "mcp"]
-    }
-  }
-}
-```
-
-**Cursor** (`.cursor/mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "shadcn": {
-      "command": "npx",
-      "args": ["shadcn@latest", "mcp"]
-    }
-  }
-}
-```
-
-**VS Code** (`.vscode/mcp.json`):
-
-```json
-{
-  "servers": {
-    "shadcn": {
-      "command": "npx",
-      "args": ["shadcn@latest", "mcp"]
-    }
-  }
-}
-```
-
-**OpenCode** (`~/.config/opencode/opencode.json`):
-
-```json
-{
-  "mcp": {
-    "shadcn": {
-      "command": "npx",
-      "args": ["shadcn@latest", "mcp"]
-    }
-  }
-}
-```
-
-## Usage Examples
-
-### Browse & Search
-
-- "Show me all available components in the shadcn registry"
-- "Find me a login form from the shadcn registry"
-- "What dialog components are available?"
-
-### Install Components
-
-- "Add the button, dialog and card components to my project"
-- "Install the form component with all its dependencies"
-- "Add a date picker to my project"
-
-### Build with Components
-
-- "Create a contact form using components from the shadcn registry"
-- "Build a landing page using hero, features and testimonials sections"
-- "Create a dashboard layout with sidebar navigation"
-
-## Multiple Registries
-
-Configure additional registries in `components.json`:
-
-```json
-{
-  "registries": {
-    "@acme": "https://registry.acme.com/{name}.json",
-    "@internal": {
-      "url": "https://internal.company.com/{name}.json",
-      "headers": {
-        "Authorization": "Bearer ${REGISTRY_TOKEN}"
-      }
-    }
-  }
-}
-```
-
-Then use namespace syntax:
-- "Show me components from acme registry"
-- "Install @internal/auth-form"
-
-## Private Registry Authentication
-
-Set environment variables in `.env.local`:
-
-```bash
-REGISTRY_TOKEN=your_token_here
-API_KEY=your_api_key_here
-```
-
-## Troubleshooting
-
-### MCP Not Responding
-
-1. Check configuration is correct
-2. Restart your MCP client
-3. Verify `shadcn` is accessible: `npx shadcn@latest --version`
-4. Use `/mcp` command in Claude Code to debug
-
-### No Tools Available
-
-1. Clear npx cache: `npx clear-npx-cache`
-2. Re-enable the MCP server
-3. Check logs (Cursor: View -> Output -> MCP: project-*)
-
-### Registry Access Issues
-
-1. Verify registry URLs in `components.json`
-2. Check authentication environment variables
-3. Test registry accessibility directly
-
-## Integration with aidevops
-
-When working on React/Next.js projects:
-
-1. **Detection**: Check for `components.json` to identify shadcn projects
-2. **Component Installation**: Use shadcn MCP for component management
-3. **Styling**: Components use Tailwind CSS - ensure it's configured
-4. **Forms**: Use with React Hook Form or TanStack Form (see `tools/browser/` for form testing)
-
-## Related Resources
-
-- [shadcn/ui Documentation](https://ui.shadcn.com/docs)
-- [Component Registry](https://ui.shadcn.com/docs/components)
-- [Blocks & Templates](https://ui.shadcn.com/blocks)
-- [Theming Guide](https://ui.shadcn.com/docs/theming)

package/.agent/tools/ui/ui-skills.md

@@ -1,115 +0,0 @@
----
-description: Opinionated constraints for building better interfaces with agents
-mode: subagent
-tools:
-  read: true
-  write: true
-  edit: true
-  bash: true
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# UI Skills
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Purpose**: Opinionated constraints for building better interfaces with agents
-- **Source**: https://www.ui-skills.com/llms.txt
-- **Stack**: Tailwind CSS, motion/react, tw-animate-css, clsx + tailwind-merge
-
-**When to apply these constraints**:
-- Building React/Next.js interfaces
-- Working with Tailwind CSS
-- Adding animations or transitions
-- Creating accessible components
-- Optimizing UI performance
-
-**Key Principles**:
-- Use Tailwind defaults before custom values
-- Use accessible component primitives (Base UI, React Aria, Radix)
-- Never add animation unless explicitly requested
-- Respect `prefers-reduced-motion`
-- Never block paste in inputs
-
-<!-- AI-CONTEXT-END -->
-
-## Stack
-
-- MUST use Tailwind CSS defaults (spacing, radius, shadows) before custom values
-- MUST use `motion/react` (formerly `framer-motion`) when JavaScript animation is required
-- SHOULD use `tw-animate-css` for entrance and micro-animations in Tailwind CSS
-- MUST use `cn` utility (`clsx` + `tailwind-merge`) for class logic
-
-## Components
-
-- MUST use accessible component primitives for anything with keyboard or focus behavior (`Base UI`, `React Aria`, `Radix`)
-- MUST use the project's existing component primitives first
-- NEVER mix primitive systems within the same interaction surface
-- SHOULD prefer [`Base UI`](https://base-ui.com/react/components) for new primitives if compatible with the stack
-- MUST add an `aria-label` to icon-only buttons
-- NEVER rebuild keyboard or focus behavior by hand unless explicitly requested
-
-## Interaction
-
-- MUST use an `AlertDialog` for destructive or irreversible actions
-- SHOULD use structural skeletons for loading states
-- NEVER use `h-screen`, use `h-dvh`
-- MUST respect `safe-area-inset` for fixed elements
-- MUST show errors next to where the action happens
-- NEVER block paste in `input` or `textarea` elements
-
-## Animation
-
-- NEVER add animation unless it is explicitly requested
-- MUST animate only compositor props (`transform`, `opacity`)
-- NEVER animate layout properties (`width`, `height`, `top`, `left`, `margin`, `padding`)
-- SHOULD avoid animating paint properties (`background`, `color`) except for small, local UI (text, icons)
-- SHOULD use `ease-out` on entrance
-- NEVER exceed `200ms` for interaction feedback
-- MUST pause looping animations when off-screen
-- MUST respect `prefers-reduced-motion`
-- NEVER introduce custom easing curves unless explicitly requested
-- SHOULD avoid animating large images or full-screen surfaces
-
-## Typography
-
-- MUST use `text-balance` for headings and `text-pretty` for body/paragraphs
-- MUST use `tabular-nums` for data
-- SHOULD use `truncate` or `line-clamp` for dense UI
-- NEVER modify `letter-spacing` (`tracking-`) unless explicitly requested
-
-## Layout
-
-- MUST use a fixed `z-index` scale (no arbitrary `z-x`)
-- SHOULD use `size-x` for square elements instead of `w-x` + `h-x`
-
-## Performance
-
-- NEVER animate large `blur()` or `backdrop-filter` surfaces
-- NEVER apply `will-change` outside an active animation
-- NEVER use `useEffect` for anything that can be expressed as render logic
-
-## Design
-
-- NEVER use gradients unless explicitly requested
-- NEVER use purple or multicolor gradients
-- NEVER use glow effects as primary affordances
-- SHOULD use Tailwind CSS default shadow scale unless explicitly requested
-- MUST give empty states one clear next action
-- SHOULD limit accent color usage to one per view
-- SHOULD use existing theme or Tailwind CSS color tokens before introducing new ones
-
-## Related Resources
-
-- [UI Skills](https://www.ui-skills.com/)
-- [Base UI](https://base-ui.com/react/components)
-- [React Aria](https://react-spectrum.adobe.com/react-aria/)
-- [Radix Primitives](https://www.radix-ui.com/primitives)
-- [motion/react](https://motion.dev/)
-- [tw-animate-css](https://github.com/Wombosvideo/tw-animate-css)
-- [shadcn/ui](https://ui.shadcn.com/) - See `tools/ui/shadcn.md`

package/.agent/tools/wordpress/localwp.md

@@ -1,311 +0,0 @@
----
-description: LocalWP database access - read-only SQL queries, schema inspection via MCP. Requires LocalWP running
-mode: subagent
-temperature: 0.1
-tools:
-  bash: true
-  read: true
-  localwp_*: true
-  task: true
----
-
-# LocalWP Database Access Subagent
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Purpose**: AI read-only access to Local by Flywheel WordPress databases
-- **Install**: `npm install -g @verygoodplugins/mcp-local-wp`
-- **Start**: `./.agent/scripts/localhost-helper.sh start-mcp`
-- **Port**: 8085 (default)
-
-**MCP Tools**:
-- `mysql_query` - Execute SELECT/SHOW/DESCRIBE/EXPLAIN queries
-- `mysql_schema` - List tables or inspect specific table structure
-
-**Example Queries**:
-
-```sql
-SELECT ID, post_title FROM wp_posts WHERE post_status='publish' LIMIT 5;
-DESCRIBE wp_postmeta;
-```
-
-**Benefits**: AI sees actual table structure, no more schema guessing, accurate JOINs
-
-**Requires**: Local by Flywheel running with active site
-**Security**: Read-only only, local development environments only
-
-**Typically invoked from**: `@wp-dev` for database inspection during debugging
-<!-- AI-CONTEXT-END -->
-
-This subagent provides AI assistants with direct, read-only access to Local by Flywheel WordPress databases.
-
-## What is LocalWP MCP?
-
-LocalWP MCP is a Model Context Protocol server that gives AI assistants like Claude and Cursor direct, read-only access to your Local by Flywheel WordPress databases. Instead of guessing table structures or writing SQL queries blind, your AI can now see and understand your actual WordPress data.
-
-## Why This Changes Everything
-
-### Before MCP (AI Flying Blind)
-
-```sql
--- AI guesses at table structure
-SELECT post_id, activity_meta FROM wp_user_activity
-WHERE user_id=123 AND activity_type='quiz';
--- Error: activity_meta column doesn't exist!
-```
-
-### After MCP (AI With X-Ray Vision)
-
-```sql
--- AI sees actual table structure and relationships
-SELECT ua.post_id, ua.activity_id, uam.activity_meta_key, uam.activity_meta_value
-FROM wp_user_activity ua
-LEFT JOIN wp_user_activity_meta uam ON ua.activity_id = uam.activity_id
-WHERE ua.user_id=123 AND ua.activity_type='quiz';
--- Perfect query on first try!
-```
-
-## Installation
-
-### Prerequisites
-
-- Local by Flywheel installed and running
-- Node.js 18+ installed
-- At least one active Local site
-
-### Install LocalWP MCP Server
-
-```bash
-# Global installation (recommended)
-npm install -g @verygoodplugins/mcp-local-wp
-
-# Verify installation
-mcp-local-wp --help
-```
-
-## Configuration
-
-### Add to MCP Configuration
-
-**For Claude Desktop:**
-
-```json
-{
-  "mcpServers": {
-    "localwp": {
-      "command": "mcp-local-wp",
-      "args": ["--transport", "sse", "--port", "8085"],
-      "env": {
-        "DEBUG": "false"
-      }
-    }
-  }
-}
-```
-
-**For Cursor IDE:**
-
-```json
-{
-  "mcpServers": {
-    "localwp": {
-      "command": "mcp-local-wp",
-      "args": ["--transport", "sse", "--port", "8085"]
-    }
-  }
-}
-```
-
-### Using the Framework Helper
-
-```bash
-# Start LocalWP MCP server
-./.agent/scripts/localhost-helper.sh start-mcp
-
-# Stop LocalWP MCP server
-./.agent/scripts/localhost-helper.sh stop-mcp
-
-# Check LocalWP sites
-./.agent/scripts/localhost-helper.sh list-localwp
-```
-
-## Available Tools
-
-### mysql_query
-
-Execute read-only SQL queries against your WordPress database.
-
-**Supported Operations:**
-
-- `SELECT` - Query data
-- `SHOW` - Show tables, columns, etc.
-- `DESCRIBE` - Describe table structure
-- `EXPLAIN` - Explain query execution
-
-**Examples:**
-
-```sql
--- Get recent posts
-SELECT ID, post_title, post_date, post_status
-FROM wp_posts
-WHERE post_type = 'post' AND post_status = 'publish'
-ORDER BY post_date DESC LIMIT 5;
-
--- Parameterized queries
-SELECT * FROM wp_posts WHERE post_status = ? ORDER BY post_date DESC LIMIT ?;
--- params: ["publish", "5"]
-```
-
-### mysql_schema
-
-Inspect database schema and structure.
-
-**Usage:**
-
-```bash
-# List all tables
-mysql_schema()
-
-# Inspect specific table
-mysql_schema("wp_posts")
-```
-
-## Real-World Use Cases
-
-### Plugin Development
-
-```sql
--- Understand LearnDash table structure
-DESCRIBE wp_learndash_user_activity;
-
--- Find quiz completion data
-SELECT ua.*, uam.activity_meta_key, uam.activity_meta_value
-FROM wp_learndash_user_activity ua
-LEFT JOIN wp_learndash_user_activity_meta uam ON ua.activity_id = uam.activity_id
-WHERE ua.activity_type = 'quiz' AND ua.user_id = 123;
-```
-
-### WooCommerce Analysis
-
-```sql
--- Get order data with meta
-SELECT p.ID, p.post_date, pm.meta_key, pm.meta_value
-FROM wp_posts p
-JOIN wp_postmeta pm ON p.ID = pm.post_id
-WHERE p.post_type = 'shop_order'
-AND pm.meta_key IN ('_order_total', '_billing_email')
-ORDER BY p.post_date DESC LIMIT 10;
-```
-
-### User Management
-
-```sql
--- Find users with specific capabilities
-SELECT u.user_login, u.user_email, um.meta_value as capabilities
-FROM wp_users u
-JOIN wp_usermeta um ON u.ID = um.user_id
-WHERE um.meta_key = 'wp_capabilities'
-AND um.meta_value LIKE '%administrator%';
-```
-
-### Content Analysis
-
-```sql
--- Find posts with specific custom fields
-SELECT p.post_title, pm.meta_key, pm.meta_value
-FROM wp_posts p
-JOIN wp_postmeta pm ON p.ID = pm.post_id
-WHERE p.post_status = 'publish'
-AND pm.meta_key = '_featured_image'
-ORDER BY p.post_date DESC;
-```
-
-## How It Works
-
-### Automatic Detection
-
-The MCP server automatically detects your active Local by Flywheel MySQL instance by:
-
-1. **Process Detection**: Scans running processes for active mysqld instances
-2. **Config Parsing**: Extracts MySQL configuration from the active Local site
-3. **Dynamic Connection**: Connects using the correct socket path automatically
-4. **Fallback Support**: Falls back to environment variables for custom setups
-
-### Local Directory Structure
-
-```text
-~/Library/Application Support/Local/run/
-├── lx97vbzE7/                    # Dynamic site ID (changes on restart)
-│   ├── conf/mysql/my.cnf        # MySQL configuration
-│   └── mysql/mysqld.sock        # Socket connection
-└── WP7lolWDi/                   # Another site
-    ├── conf/mysql/my.cnf
-    └── mysql/mysqld.sock
-```
-
-## Security Features
-
-- **Read-only operations**: Only SELECT/SHOW/DESCRIBE/EXPLAIN allowed
-- **Single statement**: Multiple statements blocked
-- **Local development**: Designed for local environments only
-- **No external connections**: Prioritizes Unix socket connections
-- **Process isolation**: Runs in separate process from your applications
-
-## Troubleshooting
-
-### Common Issues
-
-**"No active MySQL process found"**
-
-- Ensure Local by Flywheel is running
-- Make sure at least one site is started in Local
-- Check that the site's database is running
-
-**"MySQL socket not found"**
-
-- Verify the Local site is fully started
-- Try stopping and restarting the site in Local
-- Check Local's logs for MySQL startup issues
-
-**"Connection refused"**
-
-- Ensure the Local site's MySQL service is running
-- Check if another process is using the MySQL port
-- Try restarting Local by Flywheel
-
-### Debug Mode
-
-```bash
-# Enable debug logging
-DEBUG=mcp-local-wp ./.agent/scripts/localhost-helper.sh start-mcp
-```
-
-## Benefits for AI Development
-
-- **No more schema guessing** - AI sees actual tables and columns
-- **Accurate JOIN operations** - AI understands table relationships
-- **Real data validation** - AI verifies data exists before suggesting queries
-- **Plugin-aware development** - AI adapts to any plugin's custom tables
-- **Instant debugging** - Complex queries become 5-second tasks
-- **Zero configuration** - Works automatically with Local by Flywheel
-
-## Related Subagents
-
-| Task | Subagent | Reason |
-|------|----------|--------|
-| Development & debugging | `@wp-dev` | This subagent is typically called from @wp-dev |
-| Content management | `@wp-admin` | Admin tasks, not database-level |
-| Fleet management | `@mainwp` | Multi-site operations |
-
-## Related Documentation
-
-| Topic | File |
-|-------|------|
-| WordPress development | `workflows/wp-dev.md` |
-| WordPress admin | `workflows/wp-admin.md` |
-| Local development | `localhost.md` |
-| MCP setup | `context7-mcp-setup.md` |
-
-**Transform your WordPress development workflow with AI that actually understands your database!**