compliance

name	compliance
description	Check a change against WordPress.org plugin rules and PHPCS standards.

WordPress Compliance

Ensure compatibility with:

• WordPress Plugin Check
• Repository PHPCS rules
• WordPress.org expectations

Config loading

The following values are injected via the orchestrator prompt — do not read any config file:

• TEXT_DOMAIN = imagify
• CAPABILITIES = project-registered custom capabilities (see orchestrator Project Config block)

Responsibilities

• Respect repository PHPCS configuration.
• Follow WordPress escaping standards.
• Avoid forbidden or deprecated APIs.
• Avoid direct access to superglobals without sanitization.
• Ensure output is escaped for context.

Escaping heuristics

HTML text: esc_html() HTML attribute: esc_attr() URL: esc_url() Allowed HTML: wp_kses_post()

Text domain

Use {TEXT_DOMAIN} from config for all translation calls:

esc_html__( 'Clear Cache', '{TEXT_DOMAIN}' )
esc_attr__( 'Plugin Settings', '{TEXT_DOMAIN}' )

Custom capabilities

If the project defines custom capabilities, always use those (not manage_options) for capability checks. The PHPCS config should allow them without warnings.

Example — use the project-registered capability, not manage_options directly:

// Correct — use the project-registered capability, not manage_options directly
current_user_can( 'plugin_manage_options' )

Using manage_options directly for plugin-specific actions is incorrect and will flag in code review unless the project's PHPCS config explicitly allows it.

JavaScript

• Do not use jQuery. Use native DOM APIs (document.querySelector, addEventListener, fetch, etc.).
• jQuery is available in WordPress but its use introduces an unnecessary dependency and conflicts with modern bundling practices.

Anti-patterns

• Echoing raw variables
• Introducing unescaped output
• Storing sensitive values in plain text
• Bypassing repository PHPCS configuration
• Using jQuery in new or modified JS code

Related Specs

When relevant, consult repository specs under .claude/specs/, especially:

• .claude/specs/phpcs/nonce-verification-recommended.md
• .claude/specs/phpcs/validated-sanitized-input.md
• .claude/specs/phpcs/escaped-output.md

Git Operations

Follow the policy defined in AGENTS.md §5.1. Outside the issue workflow, do not run git commit or git push.