Merge pull request #32 from giuseppe-trisciuoglio/feat/php-agents

New PHP agents and WordPress skills

Author: giuseppe-trisciuoglio

.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Developer Kit for building applications with Claude Code using best practices and patterns.",
-    "version": "1.23.0"
+    "version": "1.24.0"
   },
   "plugins": [
     {
@@ -81,9 +81,9 @@
         "./skills/aws-java/aws-sdk-java-v2-s3",
         "./skills/aws-java/aws-sdk-java-v2-secrets-manager",
         "./skills/nestjs",
-        "./skills/react",
+        "./skills/react-patterns",
         "./skills/shadcn-ui",
-        "./skills/tailwind-css",
+        "./skills/tailwind-css-patterns",
         "./skills/typescript-docs"
       ]
     }

CHANGELOG.md

@@ -7,6 +7,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.24.0] - 2026-02-01
+
+### Added
+- **New PHP Agents** (5 new specialized agents):
+  - `php-code-review-expert`: Expert PHP code reviewer specializing in code quality, security, performance, and modern PHP best practices. Reviews PHP codebases (Laravel, Symfony) for bugs, logic errors, security vulnerabilities, and quality issues using confidence-based filtering
+  - `php-refactor-expert`: Expert PHP code refactoring specialist. Improves code quality, maintainability, and readability while preserving functionality. Applies clean code principles, SOLID patterns, and modern PHP 8.3+ best practices for Laravel and Symfony
+  - `php-security-expert`: Expert security auditor specializing in PHP application security, DevSecOps, and compliance frameworks. Masters vulnerability assessment, threat modeling, secure authentication (OAuth2/JWT), OWASP standards, and security automation for Laravel and Symfony
+  - `php-software-architect-expert`: Expert PHP software architect specializing in Clean Architecture, Domain-Driven Design (DDD), and modern PHP patterns. Reviews PHP codebases (Laravel, Symfony) for architectural integrity, proper module organization, and SOLID principles
+  - `wordpress-development-expert`: Expert WordPress developer specializing in custom plugin and theme development. Masters WordPress coding standards, hooks/filters architecture, Gutenberg blocks, REST API, WooCommerce integration, and site/portal development
+- **New WordPress Sage Theme Skill**:
+  - `wordpress-sage-theme`: Comprehensive WordPress Sage theme development skill
+  - Sage 10+ theme architecture with modern Blade templates
+  - ACF (Advanced Custom Fields) integration patterns
+  - Bud (Vite-based) build system configuration
+  - Blade templating engine patterns for WordPress themes
+  - Starter layouts and page templates
+  - Reference documentation for Sage, Blade, ACF, and Bud
+  - Asset compilation and optimization strategies
+- **Enhanced Spring Boot Code Review** (contributed by @zmlgit):
+  - Added transaction management checks (JTA, @Transactional, isolation levels)
+  - Added event handling patterns verification (Spring Events, @EventListener)
+  - Added AOP (Aspect-Oriented Programming) patterns review
+  - Added JPA pitfalls detection (N+1 queries, lazy loading, entity lifecycle)
+  - Added MyBatis integration patterns and best practices
+- **Enhanced PHP/Laravel Support**:
+  - PHP 8.3+ specific patterns (readonly classes, enums, constructor property promotion)
+  - Modern PHP patterns (match expressions, named arguments, attributes, first-class callables)
+  - Laravel-specific patterns (Eloquent ORM, query scopes, service container, middleware)
+  - Symfony-specific patterns (autowiring, security voters, doctrine ORM, messenger)
+  - Clean Architecture and DDD patterns for PHP applications
+- **WordPress Development Expertise**:
+  - Custom plugin architecture and WordPress Plugin API
+  - Theme development (child themes, block themes, Full Site Editing)
+  - Gutenberg block development with React
+  - WordPress REST API integration
+  - WooCommerce customization and extensions
+  - WordPress coding standards and security best practices
+
+### Changed
+- Updated `.claude-plugin/marketplace.json` with new PHP and WordPress agents metadata
+- Enhanced README.md with PHP development capabilities documentation
+- Total agents count increased with new PHP and WordPress specialists
+- Updated agents documentation to include PHP/Laravel/Symfony and WordPress development capabilities
+- Organized skills directory structure with `react-patterns` and `tailwind-css-patterns` renames
+- Updated marketplace.json metadata for new skills
+- Enhanced general agents documentation with PHP/WordPress capabilities
+
+### Documentation
+- Added comprehensive PHP agent definitions with specialized expertise in:
+  - Code review with confidence-based filtering (≥80 threshold)
+  - Refactoring with SOLID principles and clean code patterns
+  - Security auditing with OWASP Top 10 compliance
+  - Software architecture with Clean Architecture and DDD patterns
+  - WordPress plugin and theme development best practices
+- Enhanced agent descriptions with PHP framework expertise (Laravel, Symfony)
+- Added WordPress-specific patterns and coding standards
+- Added comprehensive Sage theme development guide with 281 lines of SKILL.md content
+- Added reference documentation for ACF (465 lines), Blade (304 lines), Bud (327 lines), and Sage (130 lines)
+- Included starter Blade templates for layouts and pages
+
 ## [1.23.0] - 2025-01-24
 
 ### Added
@@ -443,7 +503,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Core functionality
 - Foundation documentation
 
-[Unreleased]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.23.0...HEAD
+[Unreleased]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.24.0...HEAD
+[1.24.0]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.23.0...v1.24.0
 [1.23.0]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.22.0...v1.23.0
 [1.22.0]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.20.0...v1.22.0
 [1.21.0]: https://github.com/giuseppe.trisciuoglio/developer-kit/compare/v1.20.0...v1.21.0

README.md

@@ -61,6 +61,7 @@ Specialized AI assistants for specific development domains.
 | TypeScript/NestJS | `nestjs-backend-development-expert`, `typescript-refactor-expert`, `nestjs-security-expert`                         |
 | React/Frontend    | `react-frontend-development-expert`, `react-software-architect-review`, `expo-react-native-development-expert`      |
 | Python            | `python-code-review-expert`, `python-refactor-expert`, `python-security-expert`, `python-software-architect-expert` |
+| PHP/WordPress     | `php-code-review-expert`, `php-refactor-expert`, `php-security-expert`, `php-software-architect-expert`, `wordpress-development-expert` |
 | AWS               | `aws-solution-architect-expert`, `aws-cloudformation-devops-expert`, `aws-architecture-review-expert`               |
 | AI/LangChain4J    | `langchain4j-ai-development-expert`, `prompt-engineering-expert`                                                    |
 | General Purpose   | `general-debugger`, `general-code-reviewer`, `general-refactor-expert`, `document-generator-expert`                 |
@@ -101,7 +102,7 @@ Workflow automation commands for development tasks.
 | Java/Spring Boot   | ✅ Comprehensive (skills, agents, commands)       |
 | TypeScript/Node.js | ✅ React, NestJS, Expo (skills, agents, commands) |
 | Python             | 🚧 In Progress (agents available)                |
-| PHP                | 📋 Planned (Laravel, Symfony)                    |
+| PHP/WordPress      | ✅ Agents available (code review, refactor, security, architecture, WordPress) |
 
 ---
 

agents/general-code-explorer.md

@@ -1,5 +1,5 @@
 ---
-name: code-explorer
+name: general-code-explorer
 description: Deeply analyzes existing codebase features by tracing execution paths, mapping architecture layers, understanding patterns and abstractions, and documenting dependencies
 tools: [Read, Write, Edit, Glob, Grep, Bash]
 model: inherit

agents/general-code-reviewer.md

@@ -1,5 +1,5 @@
 ---
-name: code-reviewer
+name: general-code-reviewer
 description: Reviews code for bugs, logic errors, security vulnerabilities, and quality issues using confidence-based filtering to report only high-priority issues that truly matter
 tools: [Read, Write, Edit, Glob, Grep, Bash]
 model: inherit

agents/general-debugger.md

@@ -1,5 +1,5 @@
 ---
-name: debugger
+name: general-debugger
 description: Expert debugger for root cause analysis. Traces execution paths, analyzes stack traces, identifies failure points, and proposes targeted fixes with minimal changes. Use proactively for errors, test failures, or unexpected behavior.
 tools: [Read, Write, Edit, Glob, Grep, Bash]
 model: inherit

agents/general-refactor-expert.md

@@ -1,5 +1,5 @@
 ---
-name: refactor-expert
+name: general-refactor-expert
 description: Expert code refactoring specialist. Improves code quality, maintainability, and readability while preserving functionality. Applies clean code principles, SOLID patterns, and language-specific best practices. Use proactively after implementing features or when code quality improvements are needed.
 tools: [Read, Write, Edit, Glob, Grep, Bash]
 model: inherit

agents/general-software-architect.md

@@ -1,5 +1,5 @@
 ---
-name: software-architect
+name: general-software-architect
 description: Designs comprehensive feature architectures by analyzing existing codebase patterns and providing detailed implementation blueprints with specific files, components, data flows, and build sequences
 tools: [Read, Write, Edit, Glob, Grep, Bash]
 model: inherit