npm - @mytechtoday/augment-extensions - Versions diffs - 0.7.0 → 1.2.0 - Mend

@mytechtoday/augment-extensions 0.7.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (483) hide show

package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md CHANGED Viewed

@@ -1,854 +1,854 @@
-# Bead Decomposition Patterns for WordPress Plugin Development
-This document provides reusable patterns for breaking down WordPress plugin development tasks into Beads tasks with proper dependencies.
-## Table of Contents
-1. [Plugin Creation Pattern](#plugin-creation-pattern)
-2. [Feature Addition Pattern](#feature-addition-pattern)
-3. [Custom Post Type Pattern](#custom-post-type-pattern)
-4. [Settings Page Pattern](#settings-page-pattern)
-5. [AJAX Feature Pattern](#ajax-feature-pattern)
-6. [REST API Endpoint Pattern](#rest-api-endpoint-pattern)
-7. [Custom Database Table Pattern](#custom-database-table-pattern)
-8. [Security Audit Pattern](#security-audit-pattern)
-9. [WordPress.org Submission Pattern](#wordpress-org-submission-pattern)
-10. [Bug Fix Pattern](#bug-fix-pattern)
----
-## Plugin Creation Pattern
-**Use Case**: Creating a new WordPress plugin from scratch
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Create [Plugin Name] plugin" -p 0 --type epic --label plugin-creation
-# Subtasks
-bd create "Create plugin scaffolding" -p 1 --parent [epic-id] --label scaffolding
-bd create "Create main plugin file with header" -p 1 --parent [epic-id] --label scaffolding
-bd create "Create directory structure" -p 1 --parent [epic-id] --label scaffolding
-bd create "Create activation/deactivation hooks" -p 1 --parent [epic-id] --label scaffolding
-bd create "Create uninstall.php" -p 1 --parent [epic-id] --label scaffolding
-bd create "Implement core functionality" -p 2 --parent [epic-id] --label core
-bd create "Create core classes" -p 2 --parent [epic-id] --label core
-bd create "Implement admin interface" -p 2 --parent [epic-id] --label admin
-bd create "Implement frontend display" -p 2 --parent [epic-id] --label frontend
-bd create "Add security measures" -p 3 --parent [epic-id] --label security
-bd create "Add nonce verification" -p 3 --parent [epic-id] --label security
-bd create "Add capability checks" -p 3 --parent [epic-id] --label security
-bd create "Add input sanitization" -p 3 --parent [epic-id] --label security
-bd create "Add output escaping" -p 3 --parent [epic-id] --label security
-bd create "Create tests" -p 4 --parent [epic-id] --label testing
-bd create "Set up PHPUnit" -p 4 --parent [epic-id] --label testing
-bd create "Write unit tests" -p 4 --parent [epic-id] --label testing
-bd create "Write integration tests" -p 4 --parent [epic-id] --label testing
-bd create "Create documentation" -p 5 --parent [epic-id] --label documentation
-bd create "Create readme.txt" -p 5 --parent [epic-id] --label documentation
-bd create "Add inline documentation" -p 5 --parent [epic-id] --label documentation
-```
-**Dependencies**:
-```bash
-# Scaffolding tasks are sequential
-bd dep add [main-file-id] [epic-id]
-bd dep add [directory-id] [main-file-id]
-bd dep add [hooks-id] [directory-id]
-bd dep add [uninstall-id] [hooks-id]
-# Core depends on scaffolding
-bd dep add [core-classes-id] [uninstall-id]
-bd dep add [admin-id] [core-classes-id]
-bd dep add [frontend-id] [core-classes-id]
-# Security depends on core
-bd dep add [nonce-id] [admin-id]
-bd dep add [nonce-id] [frontend-id]
-bd dep add [capability-id] [admin-id]
-bd dep add [sanitization-id] [admin-id]
-bd dep add [sanitization-id] [frontend-id]
-bd dep add [escaping-id] [admin-id]
-bd dep add [escaping-id] [frontend-id]
-# Testing depends on security
-bd dep add [phpunit-id] [escaping-id]
-bd dep add [unit-tests-id] [phpunit-id]
-bd dep add [integration-tests-id] [phpunit-id]
-# Documentation can run in parallel with testing
-bd dep add [readme-id] [escaping-id]
-bd dep add [inline-docs-id] [escaping-id]
-```
-**Task Count**: 17 tasks
-**Estimated Time**: 2-4 weeks
----
-## Feature Addition Pattern
-**Use Case**: Adding a new feature to an existing plugin
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Add [Feature Name] to [Plugin Name]" -p 0 --type epic --label feature-addition
-# Planning
-bd create "Create OpenSpec spec for feature" -p 1 --parent [epic-id] --label planning
-bd create "Design database schema (if needed)" -p 1 --parent [epic-id] --label planning
-# Implementation
-bd create "Create feature class" -p 2 --parent [epic-id] --label implementation
-bd create "Add database migration (if needed)" -p 2 --parent [epic-id] --label implementation
-bd create "Implement core logic" -p 2 --parent [epic-id] --label implementation
-bd create "Add admin interface" -p 2 --parent [epic-id] --label implementation
-bd create "Add frontend display" -p 2 --parent [epic-id] --label implementation
-bd create "Add AJAX handlers (if needed)" -p 2 --parent [epic-id] --label implementation
-# Integration
-bd create "Integrate with existing code" -p 3 --parent [epic-id] --label integration
-bd create "Add hooks and filters" -p 3 --parent [epic-id] --label integration
-bd create "Update settings page" -p 3 --parent [epic-id] --label integration
-# Security
-bd create "Add security measures" -p 4 --parent [epic-id] --label security
-bd create "Run security audit" -p 4 --parent [epic-id] --label security
-# Testing
-bd create "Write unit tests" -p 5 --parent [epic-id] --label testing
-bd create "Write integration tests" -p 5 --parent [epic-id] --label testing
-bd create "Manual testing" -p 5 --parent [epic-id] --label testing
-# Documentation
-bd create "Update readme.txt" -p 6 --parent [epic-id] --label documentation
-bd create "Add inline documentation" -p 6 --parent [epic-id] --label documentation
-```
-**Dependencies**:
-```bash
-# Implementation depends on planning
-bd dep add [feature-class-id] [openspec-id]
-bd dep add [migration-id] [schema-id]
-bd dep add [core-logic-id] [feature-class-id]
-bd dep add [admin-id] [core-logic-id]
-bd dep add [frontend-id] [core-logic-id]
-bd dep add [ajax-id] [core-logic-id]
-# Integration depends on implementation
-bd dep add [integrate-id] [admin-id]
-bd dep add [integrate-id] [frontend-id]
-bd dep add [hooks-id] [integrate-id]
-bd dep add [settings-id] [integrate-id]
-# Security depends on integration
-bd dep add [security-measures-id] [settings-id]
-bd dep add [security-audit-id] [security-measures-id]
-# Testing depends on security
-bd dep add [unit-tests-id] [security-audit-id]
-bd dep add [integration-tests-id] [security-audit-id]
-bd dep add [manual-testing-id] [integration-tests-id]
-# Documentation depends on testing
-bd dep add [readme-id] [manual-testing-id]
-bd dep add [inline-docs-id] [manual-testing-id]
-```
-**Task Count**: 18 tasks
-**Estimated Time**: 1-2 weeks
----
-## Custom Post Type Pattern
-**Use Case**: Adding a custom post type with taxonomy and meta boxes
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Add [Post Type Name] custom post type" -p 0 --type epic --label custom-post-type
-# Registration
-bd create "Register custom post type" -p 1 --parent [epic-id] --label registration
-bd create "Register custom taxonomy" -p 1 --parent [epic-id] --label registration
-bd create "Add rewrite rules" -p 1 --parent [epic-id] --label registration
-# Admin Interface
-bd create "Add custom meta boxes" -p 2 --parent [epic-id] --label admin
-bd create "Add custom columns to list view" -p 2 --parent [epic-id] --label admin
-bd create "Add quick edit support" -p 2 --parent [epic-id] --label admin
-bd create "Add bulk actions" -p 2 --parent [epic-id] --label admin
-# Frontend Display
-bd create "Create archive template" -p 3 --parent [epic-id] --label frontend
-bd create "Create single template" -p 3 --parent [epic-id] --label frontend
-bd create "Add shortcode for display" -p 3 --parent [epic-id] --label frontend
-bd create "Add widget (optional)" -p 3 --parent [epic-id] --label frontend
-# Security
-bd create "Add capability checks for meta boxes" -p 4 --parent [epic-id] --label security
-bd create "Add nonce verification for meta saves" -p 4 --parent [epic-id] --label security
-bd create "Sanitize meta box inputs" -p 4 --parent [epic-id] --label security
-# Testing
-bd create "Test post type registration" -p 5 --parent [epic-id] --label testing
-bd create "Test meta box functionality" -p 5 --parent [epic-id] --label testing
-bd create "Test frontend display" -p 5 --parent [epic-id] --label testing
-```
-**Dependencies**:
-```bash
-# Taxonomy and rewrite depend on post type
-bd dep add [taxonomy-id] [post-type-id]
-bd dep add [rewrite-id] [post-type-id]
-# Admin features depend on registration
-bd dep add [meta-boxes-id] [rewrite-id]
-bd dep add [columns-id] [rewrite-id]
-bd dep add [quick-edit-id] [columns-id]
-bd dep add [bulk-actions-id] [columns-id]
-# Frontend depends on registration
-bd dep add [archive-id] [rewrite-id]
-bd dep add [single-id] [rewrite-id]
-bd dep add [shortcode-id] [single-id]
-bd dep add [widget-id] [shortcode-id]
-# Security depends on admin features
-bd dep add [capability-id] [meta-boxes-id]
-bd dep add [nonce-id] [meta-boxes-id]
-bd dep add [sanitize-id] [meta-boxes-id]
-# Testing depends on security
-bd dep add [test-registration-id] [sanitize-id]
-bd dep add [test-meta-id] [sanitize-id]
-bd dep add [test-frontend-id] [widget-id]
-```
-**Task Count**: 17 tasks
-**Estimated Time**: 1 week
----
-## Settings Page Pattern
-**Use Case**: Adding a settings page with WordPress Settings API
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Add [Settings Page Name] settings page" -p 0 --type epic --label settings-page
-# Page Setup
-bd create "Register settings page" -p 1 --parent [epic-id] --label setup
-bd create "Create page template" -p 1 --parent [epic-id] --label setup
-bd create "Add menu item" -p 1 --parent [epic-id] --label setup
-# Settings API
-bd create "Register settings" -p 2 --parent [epic-id] --label settings-api
-bd create "Add settings sections" -p 2 --parent [epic-id] --label settings-api
-bd create "Add settings fields" -p 2 --parent [epic-id] --label settings-api
-bd create "Add sanitization callbacks" -p 2 --parent [epic-id] --label settings-api
-# UI Components
-bd create "Create field renderers" -p 3 --parent [epic-id] --label ui
-bd create "Add tabs (if multiple sections)" -p 3 --parent [epic-id] --label ui
-bd create "Add reset to defaults button" -p 3 --parent [epic-id] --label ui
-bd create "Add import/export (optional)" -p 3 --parent [epic-id] --label ui
-# Security
-bd create "Add nonce verification" -p 4 --parent [epic-id] --label security
-bd create "Add capability checks" -p 4 --parent [epic-id] --label security
-bd create "Sanitize all inputs" -p 4 --parent [epic-id] --label security
-# Testing
-bd create "Test settings save/load" -p 5 --parent [epic-id] --label testing
-bd create "Test sanitization" -p 5 --parent [epic-id] --label testing
-bd create "Test reset functionality" -p 5 --parent [epic-id] --label testing
-```
-**Dependencies**:
-```bash
-# Page template and menu depend on registration
-bd dep add [template-id] [register-id]
-bd dep add [menu-id] [register-id]
-# Settings API depends on page setup
-bd dep add [register-settings-id] [menu-id]
-bd dep add [sections-id] [register-settings-id]
-bd dep add [fields-id] [sections-id]
-bd dep add [sanitization-id] [fields-id]
-# UI depends on Settings API
-bd dep add [renderers-id] [sanitization-id]
-bd dep add [tabs-id] [renderers-id]
-bd dep add [reset-id] [renderers-id]
-bd dep add [import-export-id] [reset-id]
-# Security depends on UI
-bd dep add [nonce-id] [import-export-id]
-bd dep add [capability-id] [import-export-id]
-bd dep add [sanitize-inputs-id] [import-export-id]
-# Testing depends on security
-bd dep add [test-save-id] [sanitize-inputs-id]
-bd dep add [test-sanitization-id] [sanitize-inputs-id]
-bd dep add [test-reset-id] [sanitize-inputs-id]
-```
-**Task Count**: 17 tasks
-**Estimated Time**: 3-5 days
----
-## AJAX Feature Pattern
-**Use Case**: Adding AJAX functionality to a plugin
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Add AJAX [Feature Name]" -p 0 --type epic --label ajax-feature
-# Backend Setup
-bd create "Create AJAX handler function" -p 1 --parent [epic-id] --label backend
-bd create "Register AJAX actions" -p 1 --parent [epic-id] --label backend
-bd create "Add response formatting" -p 1 --parent [epic-id] --label backend
-# Frontend Setup
-bd create "Create JavaScript file" -p 2 --parent [epic-id] --label frontend
-bd create "Enqueue script with dependencies" -p 2 --parent [epic-id] --label frontend
-bd create "Localize script with ajax_url and nonce" -p 2 --parent [epic-id] --label frontend
-# Implementation
-bd create "Implement AJAX request logic" -p 3 --parent [epic-id] --label implementation
-bd create "Add loading state UI" -p 3 --parent [epic-id] --label implementation
-bd create "Add success handler" -p 3 --parent [epic-id] --label implementation
-bd create "Add error handler" -p 3 --parent [epic-id] --label implementation
-# Security
-bd create "Add nonce verification in handler" -p 4 --parent [epic-id] --label security
-bd create "Add capability checks" -p 4 --parent [epic-id] --label security
-bd create "Sanitize inputs" -p 4 --parent [epic-id] --label security
-bd create "Escape outputs" -p 4 --parent [epic-id] --label security
-# Testing
-bd create "Test AJAX request/response" -p 5 --parent [epic-id] --label testing
-bd create "Test error handling" -p 5 --parent [epic-id] --label testing
-bd create "Test security measures" -p 5 --parent [epic-id] --label testing
-```
-**Dependencies**:
-```bash
-# Backend tasks are sequential
-bd dep add [register-actions-id] [handler-id]
-bd dep add [response-id] [register-actions-id]
-# Frontend depends on backend
-bd dep add [js-file-id] [response-id]
-bd dep add [enqueue-id] [js-file-id]
-bd dep add [localize-id] [enqueue-id]
-# Implementation depends on frontend setup
-bd dep add [request-logic-id] [localize-id]
-bd dep add [loading-ui-id] [request-logic-id]
-bd dep add [success-handler-id] [request-logic-id]
-bd dep add [error-handler-id] [request-logic-id]
-# Security depends on implementation
-bd dep add [nonce-verify-id] [error-handler-id]
-bd dep add [capability-id] [error-handler-id]
-bd dep add [sanitize-id] [error-handler-id]
-bd dep add [escape-id] [error-handler-id]
-# Testing depends on security
-bd dep add [test-ajax-id] [escape-id]
-bd dep add [test-errors-id] [escape-id]
-bd dep add [test-security-id] [escape-id]
-```
-**Task Count**: 17 tasks
-**Estimated Time**: 2-3 days
----
-## REST API Endpoint Pattern
-**Use Case**: Adding a REST API endpoint to a plugin
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Add REST API endpoint for [Resource]" -p 0 --type epic --label rest-api
-# Endpoint Setup
-bd create "Register REST route" -p 1 --parent [epic-id] --label setup
-bd create "Create callback function" -p 1 --parent [epic-id] --label setup
-bd create "Add permission callback" -p 1 --parent [epic-id] --label setup
-# Request Handling
-bd create "Define request parameters" -p 2 --parent [epic-id] --label request
-bd create "Add parameter validation" -p 2 --parent [epic-id] --label request
-bd create "Add parameter sanitization" -p 2 --parent [epic-id] --label request
-# Response Handling
-bd create "Implement GET handler" -p 3 --parent [epic-id] --label response
-bd create "Implement POST handler" -p 3 --parent [epic-id] --label response
-bd create "Implement PUT handler (optional)" -p 3 --parent [epic-id] --label response
-bd create "Implement DELETE handler (optional)" -p 3 --parent [epic-id] --label response
-bd create "Format response data" -p 3 --parent [epic-id] --label response
-# Security
-bd create "Add authentication check" -p 4 --parent [epic-id] --label security
-bd create "Add authorization check" -p 4 --parent [epic-id] --label security
-bd create "Add rate limiting (optional)" -p 4 --parent [epic-id] --label security
-# Testing
-bd create "Test GET requests" -p 5 --parent [epic-id] --label testing
-bd create "Test POST requests" -p 5 --parent [epic-id] --label testing
-bd create "Test authentication/authorization" -p 5 --parent [epic-id] --label testing
-bd create "Test error responses" -p 5 --parent [epic-id] --label testing
-# Documentation
-bd create "Document API endpoint" -p 6 --parent [epic-id] --label documentation
-bd create "Add usage examples" -p 6 --parent [epic-id] --label documentation
-```
-**Dependencies**:
-```bash
-# Setup tasks are sequential
-bd dep add [callback-id] [route-id]
-bd dep add [permission-id] [callback-id]
-# Request handling depends on setup
-bd dep add [parameters-id] [permission-id]
-bd dep add [validation-id] [parameters-id]
-bd dep add [sanitization-id] [validation-id]
-# Response handlers depend on request handling
-bd dep add [get-handler-id] [sanitization-id]
-bd dep add [post-handler-id] [sanitization-id]
-bd dep add [put-handler-id] [sanitization-id]
-bd dep add [delete-handler-id] [sanitization-id]
-bd dep add [format-response-id] [delete-handler-id]
-# Security depends on response handling
-bd dep add [authentication-id] [format-response-id]
-bd dep add [authorization-id] [authentication-id]
-bd dep add [rate-limiting-id] [authorization-id]
-# Testing depends on security
-bd dep add [test-get-id] [rate-limiting-id]
-bd dep add [test-post-id] [rate-limiting-id]
-bd dep add [test-auth-id] [rate-limiting-id]
-bd dep add [test-errors-id] [rate-limiting-id]
-# Documentation depends on testing
-bd dep add [document-id] [test-errors-id]
-bd dep add [examples-id] [document-id]
-```
-**Task Count**: 20 tasks
-**Estimated Time**: 3-5 days
----
-## Custom Database Table Pattern
-**Use Case**: Adding a custom database table with CRUD operations
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Add custom database table for [Data Type]" -p 0 --type epic --label database-table
-# Schema Design
-bd create "Design table schema" -p 1 --parent [epic-id] --label schema
-bd create "Create migration script" -p 1 --parent [epic-id] --label schema
-bd create "Add version checking" -p 1 --parent [epic-id] --label schema
-# Model Class
-bd create "Create model class" -p 2 --parent [epic-id] --label model
-bd create "Implement create() method" -p 2 --parent [epic-id] --label model
-bd create "Implement get_by_id() method" -p 2 --parent [epic-id] --label model
-bd create "Implement get_all() method" -p 2 --parent [epic-id] --label model
-bd create "Implement update() method" -p 2 --parent [epic-id] --label model
-bd create "Implement delete() method" -p 2 --parent [epic-id] --label model
-# Query Optimization
-bd create "Add database indexes" -p 3 --parent [epic-id] --label optimization
-bd create "Implement pagination" -p 3 --parent [epic-id] --label optimization
-bd create "Add caching layer" -p 3 --parent [epic-id] --label optimization
-# Security
-bd create "Use prepared statements for all queries" -p 4 --parent [epic-id] --label security
-bd create "Validate data before insertion" -p 4 --parent [epic-id] --label security
-bd create "Sanitize all inputs" -p 4 --parent [epic-id] --label security
-# Testing
-bd create "Test CRUD operations" -p 5 --parent [epic-id] --label testing
-bd create "Test pagination" -p 5 --parent [epic-id] --label testing
-bd create "Test data validation" -p 5 --parent [epic-id] --label testing
-# Cleanup
-bd create "Add uninstall cleanup (optional)" -p 6 --parent [epic-id] --label cleanup
-```
-**Dependencies**:
-```bash
-# Schema tasks are sequential
-bd dep add [migration-id] [schema-id]
-bd dep add [version-id] [migration-id]
-# Model class depends on schema
-bd dep add [model-class-id] [version-id]
-bd dep add [create-method-id] [model-class-id]
-bd dep add [get-by-id-id] [model-class-id]
-bd dep add [get-all-id] [model-class-id]
-bd dep add [update-method-id] [model-class-id]
-bd dep add [delete-method-id] [model-class-id]
-# Optimization depends on model
-bd dep add [indexes-id] [delete-method-id]
-bd dep add [pagination-id] [delete-method-id]
-bd dep add [caching-id] [pagination-id]
-# Security depends on optimization
-bd dep add [prepared-statements-id] [caching-id]
-bd dep add [validation-id] [prepared-statements-id]
-bd dep add [sanitization-id] [validation-id]
-# Testing depends on security
-bd dep add [test-crud-id] [sanitization-id]
-bd dep add [test-pagination-id] [sanitization-id]
-bd dep add [test-validation-id] [sanitization-id]
-# Cleanup depends on testing
-bd dep add [uninstall-id] [test-validation-id]
-```
-**Task Count**: 19 tasks
-**Estimated Time**: 4-6 days
----
-## Security Audit Pattern
-**Use Case**: Performing a comprehensive security audit
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Security audit for [Plugin Name]" -p 0 --type epic --label security-audit
-# Automated Scanning
-bd create "Run PHPCS with WordPress-VIP-Go" -p 1 --parent [epic-id] --label automated
-bd create "Run WPScan (if applicable)" -p 1 --parent [epic-id] --label automated
-# Manual Review - CSRF
-bd create "Audit forms for nonce verification" -p 2 --parent [epic-id] --label csrf
-bd create "Audit AJAX handlers for nonce verification" -p 2 --parent [epic-id] --label csrf
-# Manual Review - XSS
-bd create "Audit output for escaping" -p 2 --parent [epic-id] --label xss
-bd create "Audit admin pages for escaping" -p 2 --parent [epic-id] --label xss
-# Manual Review - SQL Injection
-bd create "Audit database queries" -p 2 --parent [epic-id] --label sql-injection
-bd create "Verify prepared statements usage" -p 2 --parent [epic-id] --label sql-injection
-# Manual Review - Authorization
-bd create "Audit capability checks" -p 2 --parent [epic-id] --label authorization
-bd create "Audit user role handling" -p 2 --parent [epic-id] --label authorization
-# Remediation
-bd create "Fix critical issues" -p 3 --parent [epic-id] --label remediation
-bd create "Fix high-priority issues" -p 3 --parent [epic-id] --label remediation
-bd create "Verify fixes" -p 3 --parent [epic-id] --label remediation
-# Documentation
-bd create "Document security findings" -p 4 --parent [epic-id] --label documentation
-bd create "Create security audit report" -p 4 --parent [epic-id] --label documentation
-```
-**Dependencies**:
-```bash
-# Manual reviews depend on automated scanning
-bd dep add [audit-forms-id] [phpcs-id]
-bd dep add [audit-ajax-id] [phpcs-id]
-bd dep add [audit-output-id] [phpcs-id]
-bd dep add [audit-admin-id] [phpcs-id]
-bd dep add [audit-queries-id] [phpcs-id]
-bd dep add [verify-prepared-id] [phpcs-id]
-bd dep add [audit-capability-id] [phpcs-id]
-bd dep add [audit-roles-id] [phpcs-id]
-# Remediation depends on all manual reviews
-bd dep add [fix-critical-id] [audit-roles-id]
-bd dep add [fix-high-id] [fix-critical-id]
-bd dep add [verify-fixes-id] [fix-high-id]
-# Documentation depends on remediation
-bd dep add [document-findings-id] [verify-fixes-id]
-bd dep add [audit-report-id] [document-findings-id]
-```
-**Task Count**: 15 tasks
-**Estimated Time**: 2-3 days
----
-## WordPress.org Submission Pattern
-**Use Case**: Submitting a plugin to WordPress.org
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Submit [Plugin Name] to WordPress.org" -p 0 --type epic --label wordpress-org
-# Pre-submission
-bd create "Run final WPCS check" -p 1 --parent [epic-id] --label pre-submission
-bd create "Validate readme.txt format" -p 1 --parent [epic-id] --label pre-submission
-bd create "Create plugin banner images" -p 1 --parent [epic-id] --label assets
-bd create "Create plugin icon images" -p 1 --parent [epic-id] --label assets
-bd create "Take plugin screenshots" -p 1 --parent [epic-id] --label assets
-bd create "Optimize all images" -p 1 --parent [epic-id] --label assets
-bd create "Create plugin ZIP file" -p 1 --parent [epic-id] --label pre-submission
-# Submission
-bd create "Create WordPress.org account" -p 2 --parent [epic-id] --label submission
-bd create "Submit plugin via form" -p 2 --parent [epic-id] --label submission
-bd create "Wait for initial review" -p 2 --parent [epic-id] --label submission
-bd create "Respond to review feedback" -p 2 --parent [epic-id] --label submission
-# Post-approval
-bd create "Set up SVN repository" -p 3 --parent [epic-id] --label post-approval
-bd create "Commit files to trunk" -p 3 --parent [epic-id] --label post-approval
-bd create "Tag release version" -p 3 --parent [epic-id] --label post-approval
-bd create "Upload assets to SVN" -p 3 --parent [epic-id] --label post-approval
-bd create "Verify plugin on WordPress.org" -p 3 --parent [epic-id] --label post-approval
-# Documentation
-bd create "Create submission documentation" -p 4 --parent [epic-id] --label documentation
-```
-**Dependencies**:
-```bash
-# Assets can be created in parallel
-bd dep add [optimize-images-id] [banner-id]
-bd dep add [optimize-images-id] [icon-id]
-bd dep add [optimize-images-id] [screenshots-id]
-# ZIP depends on WPCS and readme
-bd dep add [zip-id] [wpcs-id]
-bd dep add [zip-id] [readme-id]
-# Submission depends on ZIP and account
-bd dep add [submit-id] [zip-id]
-bd dep add [submit-id] [account-id]
-bd dep add [wait-review-id] [submit-id]
-bd dep add [respond-feedback-id] [wait-review-id]
-# SVN setup depends on approval
-bd dep add [svn-setup-id] [respond-feedback-id]
-bd dep add [commit-trunk-id] [svn-setup-id]
-bd dep add [tag-release-id] [commit-trunk-id]
-bd dep add [upload-assets-id] [tag-release-id]
-bd dep add [verify-id] [upload-assets-id]
-# Documentation depends on verification
-bd dep add [documentation-id] [verify-id]
-```
-**Task Count**: 17 tasks
-**Estimated Time**: 1-2 weeks (including review wait time)
----
-## Bug Fix Pattern
-**Use Case**: Fixing a bug in an existing plugin
-**Epic Structure**:
-```bash
-# Create epic
-bd create "Fix: [Bug Description]" -p 0 --type epic --label bug-fix
-# Investigation
-bd create "Reproduce bug" -p 1 --parent [epic-id] --label investigation
-bd create "Identify root cause" -p 1 --parent [epic-id] --label investigation
-bd create "Document expected behavior" -p 1 --parent [epic-id] --label investigation
-# Fix Implementation
-bd create "Implement fix" -p 2 --parent [epic-id] --label implementation
-bd create "Add error handling" -p 2 --parent [epic-id] --label implementation
-bd create "Update related code" -p 2 --parent [epic-id] --label implementation
-# Testing
-bd create "Write regression test" -p 3 --parent [epic-id] --label testing
-bd create "Test fix in isolation" -p 3 --parent [epic-id] --label testing
-bd create "Test with related features" -p 3 --parent [epic-id] --label testing
-bd create "Test edge cases" -p 3 --parent [epic-id] --label testing
-# Documentation
-bd create "Update changelog" -p 4 --parent [epic-id] --label documentation
-bd create "Add inline comments" -p 4 --parent [epic-id] --label documentation
-bd create "Update readme if needed" -p 4 --parent [epic-id] --label documentation
-```
-**Dependencies**:
-```bash
-# Investigation tasks are sequential
-bd dep add [root-cause-id] [reproduce-id]
-bd dep add [expected-behavior-id] [root-cause-id]
-# Implementation depends on investigation
-bd dep add [implement-fix-id] [expected-behavior-id]
-bd dep add [error-handling-id] [implement-fix-id]
-bd dep add [update-related-id] [implement-fix-id]
-# Testing depends on implementation
-bd dep add [regression-test-id] [update-related-id]
-bd dep add [test-isolation-id] [regression-test-id]
-bd dep add [test-related-id] [test-isolation-id]
-bd dep add [test-edge-cases-id] [test-related-id]
-# Documentation depends on testing
-bd dep add [changelog-id] [test-edge-cases-id]
-bd dep add [comments-id] [test-edge-cases-id]
-bd dep add [readme-id] [test-edge-cases-id]
-```
-**Task Count**: 13 tasks
-**Estimated Time**: 1-3 days
----
-## Best Practices for Task Decomposition
-### 1. Granularity
-- **Too large**: Tasks that take more than 1 day
-- **Too small**: Tasks that take less than 30 minutes
-- **Just right**: Tasks that take 1-4 hours
-### 2. Dependencies
-- Use dependencies to enforce order
-- Identify tasks that can run in parallel
-- Don't over-constrain (allow parallelism where possible)
-### 3. Labeling
-Use consistent labels:
-- `scaffolding` - Initial setup
-- `core` - Core functionality
-- `admin` - Admin interface
-- `frontend` - Frontend display
-- `security` - Security measures
-- `testing` - Tests
-- `documentation` - Documentation
-- `implementation` - Feature implementation
-- `integration` - Integration with existing code
-- `optimization` - Performance optimization
-### 4. Priorities
-- P0: Blocking/Critical
-- P1: High priority
-- P2: Medium priority
-- P3: Low priority
-### 5. Estimation
-Include time estimates in task descriptions:
-```bash
-bd create "Task name (est: 2h)" -p 1 --parent [epic-id]
-```
-### 6. Progress Tracking
-Update task status regularly:
-```bash
-bd update [task-id] --status in_progress
-bd comment [task-id] "Progress update"
-bd close [task-id]
-```
----
-## Usage Examples
-### Example 1: Create Contact Form Plugin
-```bash
-# Use Plugin Creation Pattern
-bd create "Create Simple Contact Form plugin" -p 0 --type epic --label plugin-creation
-# Follow the pattern, customizing task names
-bd create "Create plugin scaffolding for Simple Contact Form" -p 1 --parent bd-xyz
-bd create "Create main plugin file simple-contact-form.php" -p 1 --parent bd-xyz
-# ... continue with pattern
-```
-### Example 2: Add Custom Fields Feature
-```bash
-# Use Feature Addition Pattern
-bd create "Add Custom Fields to Simple Contact Form" -p 0 --type epic --label feature-addition
-# Follow the pattern
-bd create "Create OpenSpec spec for custom fields feature" -p 1 --parent bd-abc
-bd create "Design custom fields database schema" -p 1 --parent bd-abc
-# ... continue with pattern
-```
-### Example 3: Fix Email Notification Bug
-```bash
-# Use Bug Fix Pattern
-bd create "Fix: Email notifications not sending" -p 0 --type epic --label bug-fix
-# Follow the pattern
-bd create "Reproduce email notification bug" -p 1 --parent bd-def
-bd create "Identify root cause of email failure" -p 1 --parent bd-def
-# ... continue with pattern
-```
----
-## Related Resources
-- [Beads Workflow Documentation](../../beads/README.md)
-- [OpenSpec Workflow Documentation](../../openspec/README.md)
-- [WordPress Plugin Development Workflow](../rules/development-workflow.md)
-- [WordPress Plugin Best Practices](../rules/best-practices.md)
+# Bead Decomposition Patterns for WordPress Plugin Development
+This document provides reusable patterns for breaking down WordPress plugin development tasks into Beads tasks with proper dependencies.
+## Table of Contents
+1. [Plugin Creation Pattern](#plugin-creation-pattern)
+2. [Feature Addition Pattern](#feature-addition-pattern)
+3. [Custom Post Type Pattern](#custom-post-type-pattern)
+4. [Settings Page Pattern](#settings-page-pattern)
+5. [AJAX Feature Pattern](#ajax-feature-pattern)
+6. [REST API Endpoint Pattern](#rest-api-endpoint-pattern)
+7. [Custom Database Table Pattern](#custom-database-table-pattern)
+8. [Security Audit Pattern](#security-audit-pattern)
+9. [WordPress.org Submission Pattern](#wordpress-org-submission-pattern)
+10. [Bug Fix Pattern](#bug-fix-pattern)
+---
+## Plugin Creation Pattern
+**Use Case**: Creating a new WordPress plugin from scratch
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Create [Plugin Name] plugin" -p 0 --type epic --label plugin-creation
+# Subtasks
+bd create "Create plugin scaffolding" -p 1 --parent [epic-id] --label scaffolding
+bd create "Create main plugin file with header" -p 1 --parent [epic-id] --label scaffolding
+bd create "Create directory structure" -p 1 --parent [epic-id] --label scaffolding
+bd create "Create activation/deactivation hooks" -p 1 --parent [epic-id] --label scaffolding
+bd create "Create uninstall.php" -p 1 --parent [epic-id] --label scaffolding
+bd create "Implement core functionality" -p 2 --parent [epic-id] --label core
+bd create "Create core classes" -p 2 --parent [epic-id] --label core
+bd create "Implement admin interface" -p 2 --parent [epic-id] --label admin
+bd create "Implement frontend display" -p 2 --parent [epic-id] --label frontend
+bd create "Add security measures" -p 3 --parent [epic-id] --label security
+bd create "Add nonce verification" -p 3 --parent [epic-id] --label security
+bd create "Add capability checks" -p 3 --parent [epic-id] --label security
+bd create "Add input sanitization" -p 3 --parent [epic-id] --label security
+bd create "Add output escaping" -p 3 --parent [epic-id] --label security
+bd create "Create tests" -p 4 --parent [epic-id] --label testing
+bd create "Set up PHPUnit" -p 4 --parent [epic-id] --label testing
+bd create "Write unit tests" -p 4 --parent [epic-id] --label testing
+bd create "Write integration tests" -p 4 --parent [epic-id] --label testing
+bd create "Create documentation" -p 5 --parent [epic-id] --label documentation
+bd create "Create readme.txt" -p 5 --parent [epic-id] --label documentation
+bd create "Add inline documentation" -p 5 --parent [epic-id] --label documentation
+```
+**Dependencies**:
+```bash
+# Scaffolding tasks are sequential
+bd dep add [main-file-id] [epic-id]
+bd dep add [directory-id] [main-file-id]
+bd dep add [hooks-id] [directory-id]
+bd dep add [uninstall-id] [hooks-id]
+# Core depends on scaffolding
+bd dep add [core-classes-id] [uninstall-id]
+bd dep add [admin-id] [core-classes-id]
+bd dep add [frontend-id] [core-classes-id]
+# Security depends on core
+bd dep add [nonce-id] [admin-id]
+bd dep add [nonce-id] [frontend-id]
+bd dep add [capability-id] [admin-id]
+bd dep add [sanitization-id] [admin-id]
+bd dep add [sanitization-id] [frontend-id]
+bd dep add [escaping-id] [admin-id]
+bd dep add [escaping-id] [frontend-id]
+# Testing depends on security
+bd dep add [phpunit-id] [escaping-id]
+bd dep add [unit-tests-id] [phpunit-id]
+bd dep add [integration-tests-id] [phpunit-id]
+# Documentation can run in parallel with testing
+bd dep add [readme-id] [escaping-id]
+bd dep add [inline-docs-id] [escaping-id]
+```
+**Task Count**: 17 tasks
+**Estimated Time**: 2-4 weeks
+---
+## Feature Addition Pattern
+**Use Case**: Adding a new feature to an existing plugin
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Add [Feature Name] to [Plugin Name]" -p 0 --type epic --label feature-addition
+# Planning
+bd create "Create OpenSpec spec for feature" -p 1 --parent [epic-id] --label planning
+bd create "Design database schema (if needed)" -p 1 --parent [epic-id] --label planning
+# Implementation
+bd create "Create feature class" -p 2 --parent [epic-id] --label implementation
+bd create "Add database migration (if needed)" -p 2 --parent [epic-id] --label implementation
+bd create "Implement core logic" -p 2 --parent [epic-id] --label implementation
+bd create "Add admin interface" -p 2 --parent [epic-id] --label implementation
+bd create "Add frontend display" -p 2 --parent [epic-id] --label implementation
+bd create "Add AJAX handlers (if needed)" -p 2 --parent [epic-id] --label implementation
+# Integration
+bd create "Integrate with existing code" -p 3 --parent [epic-id] --label integration
+bd create "Add hooks and filters" -p 3 --parent [epic-id] --label integration
+bd create "Update settings page" -p 3 --parent [epic-id] --label integration
+# Security
+bd create "Add security measures" -p 4 --parent [epic-id] --label security
+bd create "Run security audit" -p 4 --parent [epic-id] --label security
+# Testing
+bd create "Write unit tests" -p 5 --parent [epic-id] --label testing
+bd create "Write integration tests" -p 5 --parent [epic-id] --label testing
+bd create "Manual testing" -p 5 --parent [epic-id] --label testing
+# Documentation
+bd create "Update readme.txt" -p 6 --parent [epic-id] --label documentation
+bd create "Add inline documentation" -p 6 --parent [epic-id] --label documentation
+```
+**Dependencies**:
+```bash
+# Implementation depends on planning
+bd dep add [feature-class-id] [openspec-id]
+bd dep add [migration-id] [schema-id]
+bd dep add [core-logic-id] [feature-class-id]
+bd dep add [admin-id] [core-logic-id]
+bd dep add [frontend-id] [core-logic-id]
+bd dep add [ajax-id] [core-logic-id]
+# Integration depends on implementation
+bd dep add [integrate-id] [admin-id]
+bd dep add [integrate-id] [frontend-id]
+bd dep add [hooks-id] [integrate-id]
+bd dep add [settings-id] [integrate-id]
+# Security depends on integration
+bd dep add [security-measures-id] [settings-id]
+bd dep add [security-audit-id] [security-measures-id]
+# Testing depends on security
+bd dep add [unit-tests-id] [security-audit-id]
+bd dep add [integration-tests-id] [security-audit-id]
+bd dep add [manual-testing-id] [integration-tests-id]
+# Documentation depends on testing
+bd dep add [readme-id] [manual-testing-id]
+bd dep add [inline-docs-id] [manual-testing-id]
+```
+**Task Count**: 18 tasks
+**Estimated Time**: 1-2 weeks
+---
+## Custom Post Type Pattern
+**Use Case**: Adding a custom post type with taxonomy and meta boxes
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Add [Post Type Name] custom post type" -p 0 --type epic --label custom-post-type
+# Registration
+bd create "Register custom post type" -p 1 --parent [epic-id] --label registration
+bd create "Register custom taxonomy" -p 1 --parent [epic-id] --label registration
+bd create "Add rewrite rules" -p 1 --parent [epic-id] --label registration
+# Admin Interface
+bd create "Add custom meta boxes" -p 2 --parent [epic-id] --label admin
+bd create "Add custom columns to list view" -p 2 --parent [epic-id] --label admin
+bd create "Add quick edit support" -p 2 --parent [epic-id] --label admin
+bd create "Add bulk actions" -p 2 --parent [epic-id] --label admin
+# Frontend Display
+bd create "Create archive template" -p 3 --parent [epic-id] --label frontend
+bd create "Create single template" -p 3 --parent [epic-id] --label frontend
+bd create "Add shortcode for display" -p 3 --parent [epic-id] --label frontend
+bd create "Add widget (optional)" -p 3 --parent [epic-id] --label frontend
+# Security
+bd create "Add capability checks for meta boxes" -p 4 --parent [epic-id] --label security
+bd create "Add nonce verification for meta saves" -p 4 --parent [epic-id] --label security
+bd create "Sanitize meta box inputs" -p 4 --parent [epic-id] --label security
+# Testing
+bd create "Test post type registration" -p 5 --parent [epic-id] --label testing
+bd create "Test meta box functionality" -p 5 --parent [epic-id] --label testing
+bd create "Test frontend display" -p 5 --parent [epic-id] --label testing
+```
+**Dependencies**:
+```bash
+# Taxonomy and rewrite depend on post type
+bd dep add [taxonomy-id] [post-type-id]
+bd dep add [rewrite-id] [post-type-id]
+# Admin features depend on registration
+bd dep add [meta-boxes-id] [rewrite-id]
+bd dep add [columns-id] [rewrite-id]
+bd dep add [quick-edit-id] [columns-id]
+bd dep add [bulk-actions-id] [columns-id]
+# Frontend depends on registration
+bd dep add [archive-id] [rewrite-id]
+bd dep add [single-id] [rewrite-id]
+bd dep add [shortcode-id] [single-id]
+bd dep add [widget-id] [shortcode-id]
+# Security depends on admin features
+bd dep add [capability-id] [meta-boxes-id]
+bd dep add [nonce-id] [meta-boxes-id]
+bd dep add [sanitize-id] [meta-boxes-id]
+# Testing depends on security
+bd dep add [test-registration-id] [sanitize-id]
+bd dep add [test-meta-id] [sanitize-id]
+bd dep add [test-frontend-id] [widget-id]
+```
+**Task Count**: 17 tasks
+**Estimated Time**: 1 week
+---
+## Settings Page Pattern
+**Use Case**: Adding a settings page with WordPress Settings API
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Add [Settings Page Name] settings page" -p 0 --type epic --label settings-page
+# Page Setup
+bd create "Register settings page" -p 1 --parent [epic-id] --label setup
+bd create "Create page template" -p 1 --parent [epic-id] --label setup
+bd create "Add menu item" -p 1 --parent [epic-id] --label setup
+# Settings API
+bd create "Register settings" -p 2 --parent [epic-id] --label settings-api
+bd create "Add settings sections" -p 2 --parent [epic-id] --label settings-api
+bd create "Add settings fields" -p 2 --parent [epic-id] --label settings-api
+bd create "Add sanitization callbacks" -p 2 --parent [epic-id] --label settings-api
+# UI Components
+bd create "Create field renderers" -p 3 --parent [epic-id] --label ui
+bd create "Add tabs (if multiple sections)" -p 3 --parent [epic-id] --label ui
+bd create "Add reset to defaults button" -p 3 --parent [epic-id] --label ui
+bd create "Add import/export (optional)" -p 3 --parent [epic-id] --label ui
+# Security
+bd create "Add nonce verification" -p 4 --parent [epic-id] --label security
+bd create "Add capability checks" -p 4 --parent [epic-id] --label security
+bd create "Sanitize all inputs" -p 4 --parent [epic-id] --label security
+# Testing
+bd create "Test settings save/load" -p 5 --parent [epic-id] --label testing
+bd create "Test sanitization" -p 5 --parent [epic-id] --label testing
+bd create "Test reset functionality" -p 5 --parent [epic-id] --label testing
+```
+**Dependencies**:
+```bash
+# Page template and menu depend on registration
+bd dep add [template-id] [register-id]
+bd dep add [menu-id] [register-id]
+# Settings API depends on page setup
+bd dep add [register-settings-id] [menu-id]
+bd dep add [sections-id] [register-settings-id]
+bd dep add [fields-id] [sections-id]
+bd dep add [sanitization-id] [fields-id]
+# UI depends on Settings API
+bd dep add [renderers-id] [sanitization-id]
+bd dep add [tabs-id] [renderers-id]
+bd dep add [reset-id] [renderers-id]
+bd dep add [import-export-id] [reset-id]
+# Security depends on UI
+bd dep add [nonce-id] [import-export-id]
+bd dep add [capability-id] [import-export-id]
+bd dep add [sanitize-inputs-id] [import-export-id]
+# Testing depends on security
+bd dep add [test-save-id] [sanitize-inputs-id]
+bd dep add [test-sanitization-id] [sanitize-inputs-id]
+bd dep add [test-reset-id] [sanitize-inputs-id]
+```
+**Task Count**: 17 tasks
+**Estimated Time**: 3-5 days
+---
+## AJAX Feature Pattern
+**Use Case**: Adding AJAX functionality to a plugin
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Add AJAX [Feature Name]" -p 0 --type epic --label ajax-feature
+# Backend Setup
+bd create "Create AJAX handler function" -p 1 --parent [epic-id] --label backend
+bd create "Register AJAX actions" -p 1 --parent [epic-id] --label backend
+bd create "Add response formatting" -p 1 --parent [epic-id] --label backend
+# Frontend Setup
+bd create "Create JavaScript file" -p 2 --parent [epic-id] --label frontend
+bd create "Enqueue script with dependencies" -p 2 --parent [epic-id] --label frontend
+bd create "Localize script with ajax_url and nonce" -p 2 --parent [epic-id] --label frontend
+# Implementation
+bd create "Implement AJAX request logic" -p 3 --parent [epic-id] --label implementation
+bd create "Add loading state UI" -p 3 --parent [epic-id] --label implementation
+bd create "Add success handler" -p 3 --parent [epic-id] --label implementation
+bd create "Add error handler" -p 3 --parent [epic-id] --label implementation
+# Security
+bd create "Add nonce verification in handler" -p 4 --parent [epic-id] --label security
+bd create "Add capability checks" -p 4 --parent [epic-id] --label security
+bd create "Sanitize inputs" -p 4 --parent [epic-id] --label security
+bd create "Escape outputs" -p 4 --parent [epic-id] --label security
+# Testing
+bd create "Test AJAX request/response" -p 5 --parent [epic-id] --label testing
+bd create "Test error handling" -p 5 --parent [epic-id] --label testing
+bd create "Test security measures" -p 5 --parent [epic-id] --label testing
+```
+**Dependencies**:
+```bash
+# Backend tasks are sequential
+bd dep add [register-actions-id] [handler-id]
+bd dep add [response-id] [register-actions-id]
+# Frontend depends on backend
+bd dep add [js-file-id] [response-id]
+bd dep add [enqueue-id] [js-file-id]
+bd dep add [localize-id] [enqueue-id]
+# Implementation depends on frontend setup
+bd dep add [request-logic-id] [localize-id]
+bd dep add [loading-ui-id] [request-logic-id]
+bd dep add [success-handler-id] [request-logic-id]
+bd dep add [error-handler-id] [request-logic-id]
+# Security depends on implementation
+bd dep add [nonce-verify-id] [error-handler-id]
+bd dep add [capability-id] [error-handler-id]
+bd dep add [sanitize-id] [error-handler-id]
+bd dep add [escape-id] [error-handler-id]
+# Testing depends on security
+bd dep add [test-ajax-id] [escape-id]
+bd dep add [test-errors-id] [escape-id]
+bd dep add [test-security-id] [escape-id]
+```
+**Task Count**: 17 tasks
+**Estimated Time**: 2-3 days
+---
+## REST API Endpoint Pattern
+**Use Case**: Adding a REST API endpoint to a plugin
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Add REST API endpoint for [Resource]" -p 0 --type epic --label rest-api
+# Endpoint Setup
+bd create "Register REST route" -p 1 --parent [epic-id] --label setup
+bd create "Create callback function" -p 1 --parent [epic-id] --label setup
+bd create "Add permission callback" -p 1 --parent [epic-id] --label setup
+# Request Handling
+bd create "Define request parameters" -p 2 --parent [epic-id] --label request
+bd create "Add parameter validation" -p 2 --parent [epic-id] --label request
+bd create "Add parameter sanitization" -p 2 --parent [epic-id] --label request
+# Response Handling
+bd create "Implement GET handler" -p 3 --parent [epic-id] --label response
+bd create "Implement POST handler" -p 3 --parent [epic-id] --label response
+bd create "Implement PUT handler (optional)" -p 3 --parent [epic-id] --label response
+bd create "Implement DELETE handler (optional)" -p 3 --parent [epic-id] --label response
+bd create "Format response data" -p 3 --parent [epic-id] --label response
+# Security
+bd create "Add authentication check" -p 4 --parent [epic-id] --label security
+bd create "Add authorization check" -p 4 --parent [epic-id] --label security
+bd create "Add rate limiting (optional)" -p 4 --parent [epic-id] --label security
+# Testing
+bd create "Test GET requests" -p 5 --parent [epic-id] --label testing
+bd create "Test POST requests" -p 5 --parent [epic-id] --label testing
+bd create "Test authentication/authorization" -p 5 --parent [epic-id] --label testing
+bd create "Test error responses" -p 5 --parent [epic-id] --label testing
+# Documentation
+bd create "Document API endpoint" -p 6 --parent [epic-id] --label documentation
+bd create "Add usage examples" -p 6 --parent [epic-id] --label documentation
+```
+**Dependencies**:
+```bash
+# Setup tasks are sequential
+bd dep add [callback-id] [route-id]
+bd dep add [permission-id] [callback-id]
+# Request handling depends on setup
+bd dep add [parameters-id] [permission-id]
+bd dep add [validation-id] [parameters-id]
+bd dep add [sanitization-id] [validation-id]
+# Response handlers depend on request handling
+bd dep add [get-handler-id] [sanitization-id]
+bd dep add [post-handler-id] [sanitization-id]
+bd dep add [put-handler-id] [sanitization-id]
+bd dep add [delete-handler-id] [sanitization-id]
+bd dep add [format-response-id] [delete-handler-id]
+# Security depends on response handling
+bd dep add [authentication-id] [format-response-id]
+bd dep add [authorization-id] [authentication-id]
+bd dep add [rate-limiting-id] [authorization-id]
+# Testing depends on security
+bd dep add [test-get-id] [rate-limiting-id]
+bd dep add [test-post-id] [rate-limiting-id]
+bd dep add [test-auth-id] [rate-limiting-id]
+bd dep add [test-errors-id] [rate-limiting-id]
+# Documentation depends on testing
+bd dep add [document-id] [test-errors-id]
+bd dep add [examples-id] [document-id]
+```
+**Task Count**: 20 tasks
+**Estimated Time**: 3-5 days
+---
+## Custom Database Table Pattern
+**Use Case**: Adding a custom database table with CRUD operations
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Add custom database table for [Data Type]" -p 0 --type epic --label database-table
+# Schema Design
+bd create "Design table schema" -p 1 --parent [epic-id] --label schema
+bd create "Create migration script" -p 1 --parent [epic-id] --label schema
+bd create "Add version checking" -p 1 --parent [epic-id] --label schema
+# Model Class
+bd create "Create model class" -p 2 --parent [epic-id] --label model
+bd create "Implement create() method" -p 2 --parent [epic-id] --label model
+bd create "Implement get_by_id() method" -p 2 --parent [epic-id] --label model
+bd create "Implement get_all() method" -p 2 --parent [epic-id] --label model
+bd create "Implement update() method" -p 2 --parent [epic-id] --label model
+bd create "Implement delete() method" -p 2 --parent [epic-id] --label model
+# Query Optimization
+bd create "Add database indexes" -p 3 --parent [epic-id] --label optimization
+bd create "Implement pagination" -p 3 --parent [epic-id] --label optimization
+bd create "Add caching layer" -p 3 --parent [epic-id] --label optimization
+# Security
+bd create "Use prepared statements for all queries" -p 4 --parent [epic-id] --label security
+bd create "Validate data before insertion" -p 4 --parent [epic-id] --label security
+bd create "Sanitize all inputs" -p 4 --parent [epic-id] --label security
+# Testing
+bd create "Test CRUD operations" -p 5 --parent [epic-id] --label testing
+bd create "Test pagination" -p 5 --parent [epic-id] --label testing
+bd create "Test data validation" -p 5 --parent [epic-id] --label testing
+# Cleanup
+bd create "Add uninstall cleanup (optional)" -p 6 --parent [epic-id] --label cleanup
+```
+**Dependencies**:
+```bash
+# Schema tasks are sequential
+bd dep add [migration-id] [schema-id]
+bd dep add [version-id] [migration-id]
+# Model class depends on schema
+bd dep add [model-class-id] [version-id]
+bd dep add [create-method-id] [model-class-id]
+bd dep add [get-by-id-id] [model-class-id]
+bd dep add [get-all-id] [model-class-id]
+bd dep add [update-method-id] [model-class-id]
+bd dep add [delete-method-id] [model-class-id]
+# Optimization depends on model
+bd dep add [indexes-id] [delete-method-id]
+bd dep add [pagination-id] [delete-method-id]
+bd dep add [caching-id] [pagination-id]
+# Security depends on optimization
+bd dep add [prepared-statements-id] [caching-id]
+bd dep add [validation-id] [prepared-statements-id]
+bd dep add [sanitization-id] [validation-id]
+# Testing depends on security
+bd dep add [test-crud-id] [sanitization-id]
+bd dep add [test-pagination-id] [sanitization-id]
+bd dep add [test-validation-id] [sanitization-id]
+# Cleanup depends on testing
+bd dep add [uninstall-id] [test-validation-id]
+```
+**Task Count**: 19 tasks
+**Estimated Time**: 4-6 days
+---
+## Security Audit Pattern
+**Use Case**: Performing a comprehensive security audit
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Security audit for [Plugin Name]" -p 0 --type epic --label security-audit
+# Automated Scanning
+bd create "Run PHPCS with WordPress-VIP-Go" -p 1 --parent [epic-id] --label automated
+bd create "Run WPScan (if applicable)" -p 1 --parent [epic-id] --label automated
+# Manual Review - CSRF
+bd create "Audit forms for nonce verification" -p 2 --parent [epic-id] --label csrf
+bd create "Audit AJAX handlers for nonce verification" -p 2 --parent [epic-id] --label csrf
+# Manual Review - XSS
+bd create "Audit output for escaping" -p 2 --parent [epic-id] --label xss
+bd create "Audit admin pages for escaping" -p 2 --parent [epic-id] --label xss
+# Manual Review - SQL Injection
+bd create "Audit database queries" -p 2 --parent [epic-id] --label sql-injection
+bd create "Verify prepared statements usage" -p 2 --parent [epic-id] --label sql-injection
+# Manual Review - Authorization
+bd create "Audit capability checks" -p 2 --parent [epic-id] --label authorization
+bd create "Audit user role handling" -p 2 --parent [epic-id] --label authorization
+# Remediation
+bd create "Fix critical issues" -p 3 --parent [epic-id] --label remediation
+bd create "Fix high-priority issues" -p 3 --parent [epic-id] --label remediation
+bd create "Verify fixes" -p 3 --parent [epic-id] --label remediation
+# Documentation
+bd create "Document security findings" -p 4 --parent [epic-id] --label documentation
+bd create "Create security audit report" -p 4 --parent [epic-id] --label documentation
+```
+**Dependencies**:
+```bash
+# Manual reviews depend on automated scanning
+bd dep add [audit-forms-id] [phpcs-id]
+bd dep add [audit-ajax-id] [phpcs-id]
+bd dep add [audit-output-id] [phpcs-id]
+bd dep add [audit-admin-id] [phpcs-id]
+bd dep add [audit-queries-id] [phpcs-id]
+bd dep add [verify-prepared-id] [phpcs-id]
+bd dep add [audit-capability-id] [phpcs-id]
+bd dep add [audit-roles-id] [phpcs-id]
+# Remediation depends on all manual reviews
+bd dep add [fix-critical-id] [audit-roles-id]
+bd dep add [fix-high-id] [fix-critical-id]
+bd dep add [verify-fixes-id] [fix-high-id]
+# Documentation depends on remediation
+bd dep add [document-findings-id] [verify-fixes-id]
+bd dep add [audit-report-id] [document-findings-id]
+```
+**Task Count**: 15 tasks
+**Estimated Time**: 2-3 days
+---
+## WordPress.org Submission Pattern
+**Use Case**: Submitting a plugin to WordPress.org
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Submit [Plugin Name] to WordPress.org" -p 0 --type epic --label wordpress-org
+# Pre-submission
+bd create "Run final WPCS check" -p 1 --parent [epic-id] --label pre-submission
+bd create "Validate readme.txt format" -p 1 --parent [epic-id] --label pre-submission
+bd create "Create plugin banner images" -p 1 --parent [epic-id] --label assets
+bd create "Create plugin icon images" -p 1 --parent [epic-id] --label assets
+bd create "Take plugin screenshots" -p 1 --parent [epic-id] --label assets
+bd create "Optimize all images" -p 1 --parent [epic-id] --label assets
+bd create "Create plugin ZIP file" -p 1 --parent [epic-id] --label pre-submission
+# Submission
+bd create "Create WordPress.org account" -p 2 --parent [epic-id] --label submission
+bd create "Submit plugin via form" -p 2 --parent [epic-id] --label submission
+bd create "Wait for initial review" -p 2 --parent [epic-id] --label submission
+bd create "Respond to review feedback" -p 2 --parent [epic-id] --label submission
+# Post-approval
+bd create "Set up SVN repository" -p 3 --parent [epic-id] --label post-approval
+bd create "Commit files to trunk" -p 3 --parent [epic-id] --label post-approval
+bd create "Tag release version" -p 3 --parent [epic-id] --label post-approval
+bd create "Upload assets to SVN" -p 3 --parent [epic-id] --label post-approval
+bd create "Verify plugin on WordPress.org" -p 3 --parent [epic-id] --label post-approval
+# Documentation
+bd create "Create submission documentation" -p 4 --parent [epic-id] --label documentation
+```
+**Dependencies**:
+```bash
+# Assets can be created in parallel
+bd dep add [optimize-images-id] [banner-id]
+bd dep add [optimize-images-id] [icon-id]
+bd dep add [optimize-images-id] [screenshots-id]
+# ZIP depends on WPCS and readme
+bd dep add [zip-id] [wpcs-id]
+bd dep add [zip-id] [readme-id]
+# Submission depends on ZIP and account
+bd dep add [submit-id] [zip-id]
+bd dep add [submit-id] [account-id]
+bd dep add [wait-review-id] [submit-id]
+bd dep add [respond-feedback-id] [wait-review-id]
+# SVN setup depends on approval
+bd dep add [svn-setup-id] [respond-feedback-id]
+bd dep add [commit-trunk-id] [svn-setup-id]
+bd dep add [tag-release-id] [commit-trunk-id]
+bd dep add [upload-assets-id] [tag-release-id]
+bd dep add [verify-id] [upload-assets-id]
+# Documentation depends on verification
+bd dep add [documentation-id] [verify-id]
+```
+**Task Count**: 17 tasks
+**Estimated Time**: 1-2 weeks (including review wait time)
+---
+## Bug Fix Pattern
+**Use Case**: Fixing a bug in an existing plugin
+**Epic Structure**:
+```bash
+# Create epic
+bd create "Fix: [Bug Description]" -p 0 --type epic --label bug-fix
+# Investigation
+bd create "Reproduce bug" -p 1 --parent [epic-id] --label investigation
+bd create "Identify root cause" -p 1 --parent [epic-id] --label investigation
+bd create "Document expected behavior" -p 1 --parent [epic-id] --label investigation
+# Fix Implementation
+bd create "Implement fix" -p 2 --parent [epic-id] --label implementation
+bd create "Add error handling" -p 2 --parent [epic-id] --label implementation
+bd create "Update related code" -p 2 --parent [epic-id] --label implementation
+# Testing
+bd create "Write regression test" -p 3 --parent [epic-id] --label testing
+bd create "Test fix in isolation" -p 3 --parent [epic-id] --label testing
+bd create "Test with related features" -p 3 --parent [epic-id] --label testing
+bd create "Test edge cases" -p 3 --parent [epic-id] --label testing
+# Documentation
+bd create "Update changelog" -p 4 --parent [epic-id] --label documentation
+bd create "Add inline comments" -p 4 --parent [epic-id] --label documentation
+bd create "Update readme if needed" -p 4 --parent [epic-id] --label documentation
+```
+**Dependencies**:
+```bash
+# Investigation tasks are sequential
+bd dep add [root-cause-id] [reproduce-id]
+bd dep add [expected-behavior-id] [root-cause-id]
+# Implementation depends on investigation
+bd dep add [implement-fix-id] [expected-behavior-id]
+bd dep add [error-handling-id] [implement-fix-id]
+bd dep add [update-related-id] [implement-fix-id]
+# Testing depends on implementation
+bd dep add [regression-test-id] [update-related-id]
+bd dep add [test-isolation-id] [regression-test-id]
+bd dep add [test-related-id] [test-isolation-id]
+bd dep add [test-edge-cases-id] [test-related-id]
+# Documentation depends on testing
+bd dep add [changelog-id] [test-edge-cases-id]
+bd dep add [comments-id] [test-edge-cases-id]
+bd dep add [readme-id] [test-edge-cases-id]
+```
+**Task Count**: 13 tasks
+**Estimated Time**: 1-3 days
+---
+## Best Practices for Task Decomposition
+### 1. Granularity
+- **Too large**: Tasks that take more than 1 day
+- **Too small**: Tasks that take less than 30 minutes
+- **Just right**: Tasks that take 1-4 hours
+### 2. Dependencies
+- Use dependencies to enforce order
+- Identify tasks that can run in parallel
+- Don't over-constrain (allow parallelism where possible)
+### 3. Labeling
+Use consistent labels:
+- `scaffolding` - Initial setup
+- `core` - Core functionality
+- `admin` - Admin interface
+- `frontend` - Frontend display
+- `security` - Security measures
+- `testing` - Tests
+- `documentation` - Documentation
+- `implementation` - Feature implementation
+- `integration` - Integration with existing code
+- `optimization` - Performance optimization
+### 4. Priorities
+- P0: Blocking/Critical
+- P1: High priority
+- P2: Medium priority
+- P3: Low priority
+### 5. Estimation
+Include time estimates in task descriptions:
+```bash
+bd create "Task name (est: 2h)" -p 1 --parent [epic-id]
+```
+### 6. Progress Tracking
+Update task status regularly:
+```bash
+bd update [task-id] --status in_progress
+bd comment [task-id] "Progress update"
+bd close [task-id]
+```
+---
+## Usage Examples
+### Example 1: Create Contact Form Plugin
+```bash
+# Use Plugin Creation Pattern
+bd create "Create Simple Contact Form plugin" -p 0 --type epic --label plugin-creation
+# Follow the pattern, customizing task names
+bd create "Create plugin scaffolding for Simple Contact Form" -p 1 --parent bd-xyz
+bd create "Create main plugin file simple-contact-form.php" -p 1 --parent bd-xyz
+# ... continue with pattern
+```
+### Example 2: Add Custom Fields Feature
+```bash
+# Use Feature Addition Pattern
+bd create "Add Custom Fields to Simple Contact Form" -p 0 --type epic --label feature-addition
+# Follow the pattern
+bd create "Create OpenSpec spec for custom fields feature" -p 1 --parent bd-abc
+bd create "Design custom fields database schema" -p 1 --parent bd-abc
+# ... continue with pattern
+```
+### Example 3: Fix Email Notification Bug
+```bash
+# Use Bug Fix Pattern
+bd create "Fix: Email notifications not sending" -p 0 --type epic --label bug-fix
+# Follow the pattern
+bd create "Reproduce email notification bug" -p 1 --parent bd-def
+bd create "Identify root cause of email failure" -p 1 --parent bd-def
+# ... continue with pattern
+```
+---
+## Related Resources
+- [Beads Workflow Documentation](../../beads/README.md)
+- [OpenSpec Workflow Documentation](../../openspec/README.md)
+- [WordPress Plugin Development Workflow](../rules/development-workflow.md)
+- [WordPress Plugin Best Practices](../rules/best-practices.md)