wordpress-claude-stack CLAUDE.md

WordPress Project — Claude Code Instructions

Stack

• WordPress 6.x
• PHP 8.2+ (strict types)
• MySQL 8.0 / MariaDB 10.6+
• Gutenberg (Block Editor)
• WooCommerce (if e-commerce)
• Advanced Custom Fields PRO (if applicable)
• Tailwind CSS or classic enqueued styles
• Vite for asset bundling (modern themes)
• Composer for PHP dependencies
• npm/pnpm for frontend dependencies

Code Style

PHP

• Always declare declare(strict_types=1); at top of files
• Follow WordPress Coding Standards (WPCS)
• Use type hints for all function parameters and return types
• Prefix all functions, classes, and hooks with project namespace
• Use snake_case for functions, UPPER_SNAKE_CASE for constants
• Escape all output: esc_html(), esc_attr(), esc_url(), wp_kses_post()
• Sanitize all input: sanitize_text_field(), absint(), wp_unslash()
• Use $wpdb->prepare() for ALL database queries — never raw SQL

Theme Development

theme/
├── functions.php          # Theme setup, hooks, enqueues
├── inc/
│   ├── setup.php          # add_theme_support, menus, sidebars
│   ├── enqueue.php        # wp_enqueue_script/style
│   ├── custom-post-types.php
│   ├── taxonomies.php
│   ├── customizer.php
│   ├── acf-fields.php     # ACF field group registrations
│   └── template-tags.php  # Reusable template functions
├── template-parts/
│   ├── header/
│   ├── footer/
│   ├── content/
│   └── components/
├── templates/             # Full page templates
├── assets/
│   ├── src/               # Source JS/CSS (Vite input)
│   └── dist/              # Built assets
├── blocks/                # Custom Gutenberg blocks
└── woocommerce/           # WooCommerce template overrides

Plugin Development

plugin/
├── plugin-name.php        # Main plugin file with header
├── includes/
│   ├── class-plugin-name.php       # Main plugin class
│   ├── class-activator.php         # Activation hook
│   ├── class-deactivator.php       # Deactivation hook
│   ├── class-admin.php             # Admin functionality
│   ├── class-public.php            # Public functionality
│   └── class-rest-api.php          # REST API endpoints
├── admin/
│   ├── views/             # Admin page templates
│   ├── css/
│   └── js/
├── public/
│   ├── views/
│   ├── css/
│   └── js/
├── languages/             # i18n .pot/.po/.mo files
├── tests/
│   └── phpunit/
├── uninstall.php          # Cleanup on uninstall
└── composer.json