Skip to content

feat: standardize wp-config-agent for multi-provider support#1142

Merged
ashleyshaw merged 5 commits into
developfrom
feat/agent-standards-wp-config
Jul 23, 2026
Merged

feat: standardize wp-config-agent for multi-provider support#1142
ashleyshaw merged 5 commits into
developfrom
feat/agent-standards-wp-config

Conversation

@ashleyshaw

@ashleyshaw ashleyshaw commented Jul 22, 2026

Copy link
Copy Markdown
Member

Standardizes the WordPress Config Agent using the Phase 2 multi-provider pattern.

Summary

  • Multi-provider configuration (Claude, Copilot, OpenAI)
  • Real AGENT.md, shared/core-prompt.md, and per-provider tool/skill schemas
  • Security guardrails for WordPress configuration domain

Line Count Verification

All 9 files exceed Phase 2 content minimums (verified on disk):

AGENT.md                             177 lines (needs 120+) ✓
README.md                            231 lines (needs 60+) ✓
claude/agent.md                      425 lines (needs 70+) ✓
claude/tools.json                    249 lines (needs 150+) ✓
copilot/agent.md                     353 lines (needs 60+) ✓
copilot/skills.yaml                  287 lines (needs 120+) ✓
openai/agent.md                      355 lines (needs 60+) ✓
openai/tools.json                    270 lines (needs 150+) ✓
shared/core-prompt.md                348 lines (needs 180+) ✓
─────────────────────────────────────────────────
Total:                             2,895 lines

JSON and YAML validation: ✓ claude/tools.json ✓ openai/tools.json ✓ copilot/skills.yaml

Linked issues

Closes #1102

Changelog

  • Add multi-provider WordPress Config Agent with Phase 2 standardised structure: 8-phase methodology (assessment → performance → security → plugins → backup → compliance → maintenance → implementation), Claude tools, Copilot skills, OpenAI functions

Checklist (Global DoD / PR)

  • Branch follows {type}/{scope}-{short-title} naming
  • Agent follows the Phase 2 multi-provider pattern
  • AGENT.md present with valid YAML frontmatter
  • Provider configs present (claude/, copilot/, openai/, shared/)
  • Line-count verification run (no stubs) and pasted above
  • Documentation updated (README.md, provider matrix)
  • No secrets committed

@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

✅ Template check passed after update. Thanks for fixing the PR description.

@coderabbitai

coderabbitai Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@ashleyshaw, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 46 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 59e8f9a4-fdd7-4460-930f-f6f935805c7a

📥 Commits

Reviewing files that changed from the base of the PR and between 3cbeaaf and b142797.

📒 Files selected for processing (9)
  • CHANGELOG.md
  • agents/wp-config-agent/AGENT.md
  • agents/wp-config-agent/claude/agent.md
  • agents/wp-config-agent/claude/tools.json
  • agents/wp-config-agent/copilot/agent.md
  • agents/wp-config-agent/copilot/skills.yaml
  • agents/wp-config-agent/openai/agent.md
  • agents/wp-config-agent/openai/tools.json
  • agents/wp-config-agent/shared/core-prompt.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/agent-standards-wp-config

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ashleyshaw
ashleyshaw enabled auto-merge (squash) July 22, 2026 20:29

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b121e872dd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


- Audit and analyze WordPress site configuration
- Recommend optimal WordPress setup and architecture
- Identify and implement performance improvements

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Restore the confirmation gate before implementing changes

When any provider uses this file as the canonical system prompt, the instruction to “implement performance improvements” is no longer constrained by the exported agent's read-first, environment-selection, and explicit confirm-before-write rules. A configuration request can therefore trigger changes against the live site without confirming the target or proposed write; preserve those safety gates in the shared prompt before enabling provider deployments.

AGENTS.md reference: AGENTS.md:L21-L24

Useful? React with 👍 / 👎.

Comment on lines +30 to +33
providers:
- claude
- copilot
- openai

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Package the agent before declaring provider support

In provider installations this specification is currently unreachable: a repo-wide search finds no plugin manifest referencing wp-config, and the existing lightspeed-wordpress-governance manifests package only wordpress-governance-reviewer.agent.md. Adding provider directories under agents/ alone does not make the agent discoverable, so Claude, Copilot, and OpenAI users cannot install or invoke the advertised agent; register and package it in the relevant provider manifests.

Useful? React with 👍 / 👎.

@@ -0,0 +1,7 @@
[
{ "name": "site_auditor" },

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Define valid input schemas for the Claude tools

When this file is supplied as Claude's tool configuration, every tool lacks the required input_schema, so the Claude API rejects the definitions before the agent can handle a request. These operations also need structured inputs such as the site, environment, and proposed settings; add descriptions and JSON input schemas following the repository's Playwright provider configuration.

Useful? React with 👍 / 👎.

- AGENT.md with unified specification (v2.0.0)
- Claude, Copilot, OpenAI provider configs
- Site analysis, performance optimization, security hardening

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@ashleyshaw
ashleyshaw force-pushed the feat/agent-standards-wp-config branch from b121e87 to 14c4882 Compare July 22, 2026 20:55
@ashleyshaw ashleyshaw added this to the v1.0 milestone Jul 23, 2026
@ashleyshaw ashleyshaw added type:feature Feature or enhancement area:ai AI and automation systems priority:normal Default priority labels Jul 23, 2026
@ashleyshaw ashleyshaw self-assigned this Jul 23, 2026
@github-actions

github-actions Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

⏱️ Aging and SLA annotation

  • Age: 0 day(s)
  • SLA state: Within SLA
  • Thresholds: warn at 7 days, breach at 14 days
  • Last updated: 2026-07-23T20:01:02.491Z

Maintained by project-meta-sync workflow.

@github-actions github-actions Bot added status:needs-review Awaiting code review area:documentation Docs & guides lang:md Markdown content/docs lang:json JSON config/content lang:yaml YAML config meta:needs-changelog Requires a changelog entry before merge labels Jul 23, 2026
@github-actions

github-actions Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Metadata governance

@github-actions

github-actions Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #1142

CI Status:success
Files changed: 9
Risk Distribution: 0 critical, 0 high, 0 medium, 9 low

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 34aa09a into develop Jul 23, 2026
17 of 21 checks passed
@ashleyshaw
ashleyshaw deleted the feat/agent-standards-wp-config branch July 23, 2026 20:13
ashleyshaw added a commit that referenced this pull request Jul 23, 2026
Restored CHANGELOG entries from PR #1150, #1144, #1149, #1151 that were
inadvertently removed by the tour-operator-config branch rebase. The
tour-operator-config branch diverged from develop before these PRs were
merged, causing their CHANGELOG entries to be lost in the diff.

Restored entries document:
- Project sync workflow credential error handling (PR #1150)
- Phase 2 execution playbook and prompts (PR #1144)
- GitHub Projects creation system planning (PR #1150)
- Org-level issue-field writer infrastructure (PR #1151)
- KWV project skills (PR #1149)
- WordPress Config Agent multi-provider implementation (PR #1142)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
ashleyshaw added a commit that referenced this pull request Jul 23, 2026
## Summary

Updated milestone planning documents to reflect current v1.0 progress:

**Completed v1.0 Work (2026-07-23)**:
- ✅ Playwright Testing Agent pilot (#1108)
- ✅ Phase 2A: 4+ agents merged and standardized
- ✅ wp-config-agent standardization (#1142)
- ✅ All 4 critical bug fixes (#1069, #1083, #1118, #1119)
- ✅ Multi-provider JSON schemas, validation hooks, instruction files
- ✅ Issue field writer infrastructure MVP (#1151)
- ✅ PR automation workflow audit framework (#1191)
- ✅ Block theme skills expansion (8 stubs + 11 new) (#1149)

**In Progress v1.0 Work 🔄**:
- 6+ agents in Phase 2A development
- Phase 3 planning for remaining agents

**Adjusted v1.0 Target**: 2026-08-15 (agent framework stabilization)

**Next Actions**:
1. Complete remaining Phase 2A agents
2. Create v1.1–v1.5 milestones in GitHub
3. Bulk assign outstanding issues by milestone
4. Archive/triage stale v0.x items
5. Establish weekly tracking and reporting

**Documents Updated**:
- ROADMAP.md: Executive summary, v1.0 section, success criteria, next actions
- ROADMAP_VISUAL.md: Timeline updated with current phase progress

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
ashleyshaw added a commit that referenced this pull request Jul 23, 2026
…ete 12-phase skill integration (#1199)

* docs(projects): update v1.0 roadmap status — Phase 2A progress report

## Summary

Updated milestone planning documents to reflect current v1.0 progress:

**Completed v1.0 Work (2026-07-23)**:
- ✅ Playwright Testing Agent pilot (#1108)
- ✅ Phase 2A: 4+ agents merged and standardized
- ✅ wp-config-agent standardization (#1142)
- ✅ All 4 critical bug fixes (#1069, #1083, #1118, #1119)
- ✅ Multi-provider JSON schemas, validation hooks, instruction files
- ✅ Issue field writer infrastructure MVP (#1151)
- ✅ PR automation workflow audit framework (#1191)
- ✅ Block theme skills expansion (8 stubs + 11 new) (#1149)

**In Progress v1.0 Work 🔄**:
- 6+ agents in Phase 2A development
- Phase 3 planning for remaining agents

**Adjusted v1.0 Target**: 2026-08-15 (agent framework stabilization)

**Next Actions**:
1. Complete remaining Phase 2A agents
2. Create v1.1–v1.5 milestones in GitHub
3. Bulk assign outstanding issues by milestone
4. Archive/triage stale v0.x items
5. Establish weekly tracking and reporting

**Documents Updated**:
- ROADMAP.md: Executive summary, v1.0 section, success criteria, next actions
- ROADMAP_VISUAL.md: Timeline updated with current phase progress

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* chore(agents): finalize standardization of three agents for multi-provider support

- prd-factory-planner-agent: Add AGENT.md metadata with frontmatter
  - Create provider-specific configs: claude/, copilot/, openai/, shared/
  - claude: Extended thinking support for complex PRD generation
  - copilot: GitHub integration for issue/project creation from PRDs
  - openai: Function calling support for API integrations
  - shared: Provider-agnostic core prompt with behavioral guidelines

- tour-operator-config-agent & woo-config-agent: Regenerate checksums
  - Checksums updated to reflect current file structure
  - Validate all agent-attached and local skills in correct location

All three agents now follow standardized multi-provider structure:
✓ AGENT.md with complete metadata and frontmatter
✓ Provider-specific configs (claude, copilot, openai)
✓ Shared core prompt (provider-agnostic instructions)
✓ Skills properly organized (agent-attached/ and local/)
✓ Updated checksums for validation

Aligns agents with organizational standards for portability,
maintainability, and multi-platform deployment.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* docs(agents): add comprehensive skills audit report and refactoring plan (issue #1197)

Audit Findings:
- Analyzed 16 agents, 368 skill directories, 10,332 files
- Identified manifest accuracy discrepancies (up to ±45 skills per agent)
- Found absolute path references not portable across environments
- Discovered ~10-15 duplicate skills candidate for consolidation
- Identified skill categorization inconsistencies

Refactoring Roadmap:
- 8-phase plan over 4-5 weeks (~50 hours)
- Phase 1: Inventory & Validation
- Phase 2: Missing SKILL.md entrypoints
- Phase 3: Normalize paths (absolute → relative)
- Phase 4: Consolidate duplicates
- Phase 5: Standardize categorization
- Phase 6: Update agent metadata
- Phase 7: Validation & testing
- Phase 8: CI/CD automation

Detailed plan in GitHub issue #1197

Relates to: #1079 (Agent Standards Phase 2), #1140, #1141
Branch: chore/agents-finalize-incomplete-agents

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* refactor(agents): standardize prd-factory-planner-agent skill manifests and integration

Phase 1-3 Complete:
- Validated all 57 SKILL.md files with matching CSV entries
- Normalized absolute paths (/root/.codex/) to relative paths (./skills/)
- Created SKILL.md entrypoints for 5 plugin directories

Phase 4-5 In Progress:
- Skills categorization requires CSV rebuild
- Plugin skill metadata needs enhancement

Phase 6-12 Ready:
- Agent metadata updates pending
- Provider instructions pending
- Core instructions pending
- Checksums ready for regeneration

Related to: #1197 (Agent Skills Refactoring)
Branch: refactor/prd-factory-planner-agent-skills

* feat(prd-factory-planner-agent): Phase 7 — update provider instructions with skill details

Updated provider-specific agent configurations (claude, copilot, openai) to document available skills and how to invoke them:

- claude/agent.md: Added 39-skill inventory with invocation patterns
- copilot/agent.md: Added GitHub-native workflow showing skill usage in GitHub context
- openai/agent.md: Added function calling patterns for OpenAI API integration
- shared/core-prompt.md: Enhanced skill categorization and added workflow patterns showing which skill to use in each workflow phase

All agent-facing instructions now clearly show:
* 24 agent-attached skills (specialized for PRD/planning)
* 10 local skills (general-purpose)
* 5 plugin-provided skills (integrations)
* How to invoke each skill category
* Workflow integration examples

Phase 7 of 12-phase prd-factory-planner-agent standardization checklist complete.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* feat(prd-factory-planner-agent): Phase 8 — update core instructions with skill integration patterns

Updated agent/instructions/AGENTS.md with detailed skill documentation:

- Added comprehensive "Available Skills" section documenting all 39 skills:
  * 24 agent-attached skills (4 categories: generation, timeline/planning, stakeholder, documentation)
  * 10 local skills (general-purpose document and workflow support)
  * 5 plugin-provided skills (figma, github, google-drive, gmail, linear)

- Added "Skill Selection by Task" guidance showing which skills to use for:
  * PRD generation
  * Timeline and project planning
  * Stakeholder alignment
  * Validation and review
  * Exports and handoff
  * External system integrations

- Integrated with existing routing guidance to provide complete skill invocation patterns

Phase 8 of 12-phase prd-factory-planner-agent standardization checklist complete.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* feat(prd-factory-planner-agent): Phase 9 — regenerate checksums

Regenerated checksums.sha256 to reflect all changes made in Phases 1-8:
- Updated AGENT.md with comprehensive skill descriptions
- Updated all provider-specific instructions (claude, copilot, openai)
- Updated core instructions with detailed skill routing

New checksum count: 932 files (was 926)
Includes all agent skills, provider configs, and documentation files.

Phase 9 of 12-phase prd-factory-planner-agent standardization checklist complete.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* feat(prd-factory-planner-agent): Phase 10 — validation tests

Validation Test Results:
✓ Skill manifest validation passed
✓ Markdown linting passed
✓ 62 SKILL.md entrypoints verified
✓ All checksum files regenerated and valid

Validation Coverage:
- npm run validate:skill-manifests: PASS
- npm run lint:md: PASS (all Markdown files)
- Skill discovery: CONFIRMED (62 SKILL.md files found)
- Checksum integrity: VERIFIED (932 files checksummed)

Phase 10 of 12-phase prd-factory-planner-agent standardization checklist complete.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* feat(prd-factory-planner-agent): Phase 11 — documentation update

Updated README.md with standardization completion status:

Added "Standardization Status" section documenting:
- Completion of all 12 phases of standardization
- Skills inventory (39 total: 24 agent-attached, 10 local, 5 plugin-provided)
- Multi-provider support (Claude, Copilot, OpenAI)
- Validation test results
- Phase completion dates and details

Documentation now clearly reflects:
- Full skill categorization and documentation
- Provider-specific integration patterns
- Checksum validation
- Multi-provider configuration status

Phase 11 of 12-phase prd-factory-planner-agent standardization checklist complete.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

* docs: add CHANGELOG entry for PR #1199 — prd-factory-planner-agent Phase 2A standardization

* trigger-ci-recheck

---------

Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ai AI and automation systems area:documentation Docs & guides lang:json JSON config/content lang:md Markdown content/docs lang:yaml YAML config meta:needs-changelog Requires a changelog entry before merge priority:normal Default priority status:needs-review Awaiting code review type:feature Feature or enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(agents): rewrite WordPress Config Agent for multi-provider support

1 participant