Skip to content

feat: add 16 new specialist agents to agents directory#1040

Merged
ashleyshaw merged 103 commits into
developfrom
feat/new-agents
Jul 15, 2026
Merged

feat: add 16 new specialist agents to agents directory#1040
ashleyshaw merged 103 commits into
developfrom
feat/new-agents

Conversation

@ashleyshaw

@ashleyshaw ashleyshaw commented Jul 15, 2026

Copy link
Copy Markdown
Member

Linked issues

Closes #1041

Changelog

Added

  • AI Readiness Estimator Agent - assesses WordPress sites for AI readiness and generates detailed reports
  • Client Website Discovery Assistant Agent - guides client discovery and requirements gathering
  • Design Partner Agent - assists with design system and UI/UX decisions
  • Harvest Analytical Agent - analyzes and reports on Harvest time tracking data
  • Linear Advisor Agent - provides guidance on Linear issue management and workflows
  • PageSpeed Agent - analyzes website performance and provides optimization recommendations
  • Playwright Testing Agent - assists with creating and maintaining Playwright E2E tests
  • PRD Agent - helps create Product Requirements Documents
  • PRD Factory & Planner Agent - advanced PRD creation with planning capabilities
  • Proposal Desk Agent - assists with creating client proposals
  • Tour Operator Config Agent - specialized configuration agent for tour operator websites
  • Website Content Strategist Agent - provides content strategy and planning guidance
  • Website Scope Estimator Agent - estimates project scope and effort for website projects
  • WooCommerce Configuration Agent - specialized agent for WooCommerce setup and configuration
  • WordPress Config Agent - assists with WordPress configuration and setup
  • Zendesk Support Agent - integrates with Zendesk for support workflows

Fixed

  • Reverted @babel/plugin-transform-runtime and @babel/preset-react from 8.0.1 to 7.29.7 (see PR #1043 targeting develop, tracked in #1042), which was breaking npm ci repo-wide
  • Fixed ~33,600 markdown lint errors, JSON/YAML syntax errors, and Mermaid syntax/accessibility/contrast issues in the new agent docs
  • Fixed several latent script bugs surfaced by this PR's scale (11K+ files): ENOBUFS/E2BIG crashes in changelog, footer, and link-checking validation scripts
  • Added the required footer to 4,234 new agent docs; fixed two footer-insertion bugs in header-footer.js along the way
  • Replaced the dead .lycheeignore (never actually read by lychee) with a working lychee.toml
  • Fixed a stale link in the ai-ops-standard footer template (docs/AUTOMATION_GOVERNANCE.mddocs/AUTOMATION.md, per the prior deprecation)

Checklist (Global DoD / PR)

  • All AC met and demonstrated
  • Tests added/updated (unit/E2E as appropriate) — agents are documentation-based; existing Jest suite (72 suites / 668 tests) passes unchanged
  • Accessibility checklist completed (where relevant) — N/A for agent specifications; Mermaid diagram accessibility (accTitle/accDescr) and WCAG AA colour contrast verified for all new diagrams
  • Docs/readme/changelog updated (if user-facing)
  • Security checklist completed (where relevant):
    • No secrets/sensitive data introduced
    • OWASP risks reviewed
  • Code/design reviews approved (pending maintainer review)
  • CI green; linked issues closed; release notes prepared (if shipping) — all checks green except two unrelated to this PR's content: sync-metadata (blocked on the separate develop-branch dependency fix in PR #1043) and Mergify's "Configuration changed" flag (reacting to an unrelated recent Mergify config commit on this branch)

Summary

This PR adds 16 new specialist agents to the agents/ directory, significantly expanding the LightSpeed agent ecosystem. Each agent includes comprehensive documentation, configuration files, and reference materials following the LightSpeed agent template standards.

These agents cover a wide range of capabilities:

  • Project Planning & Discovery: Client discovery, PRD creation, scope estimation
  • Configuration & Setup: WordPress, WooCommerce, tour operator systems
  • Quality & Testing: Playwright testing, PageSpeed analysis
  • Content & Design: Content strategy, design partnership
  • Business Operations: Harvest analytics, proposal generation, AI readiness assessment
  • Support & Integration: Zendesk support, Linear workflows

All agents follow the organizational standards defined in AGENTS.md and include proper frontmatter, directory structure, and documentation.

ashleyshaw and others added 18 commits July 14, 2026 13:16
Add the Design Partner Agent export containing:
- Agent instructions and configuration (Codex config, plugin configs)
- Reference documents (design audit framework, UX writing guidelines,
  validation standards, workflow routing, etc.)
- Templates (design brief, critique, audit, handoff, research synthesis)
- Validation scripts (schema, links, memory hygiene, cross-file consistency)
- Skills (agent-attached, directory-installed, local, plugin-provided)
- Manifests and checksums

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add the LightSpeedWP WooCommerce Configuration Agent package
containing 83 agent files and 31 skills.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add the LightSpeed Linear Advisor agent bundle containing:
- Agent instructions, configuration, and memory files
- 42 local/plugin-provided skills
- Manifests, validation notes, and checksums

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add portable Playwright Testing Agent with 95 agent/configuration files
and 21 skills for automated browser testing workflows.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add the harvest-analytical-agent folder containing workspace
instruction files, skill sources, plugin manifests, and validation
manifests exported from the Harvest Analytical Agent environment.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add the full PRD Factory & Planner agent export including:
- Agent configuration, instructions, and memory schemas
- Templates (questionnaires, checklists, PRD templates)
- Local and plugin-provided skills (Gmail, Google Drive, Linear)
- Manifests and SHA-256 checksums for validation

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add PageSpeed Sitemap Audit Reporter agent with instructions,
configuration schemas, validation scripts, report templates,
and attached skills (frontend, spreadsheets, PDF, presentations,
Google Drive plugins).

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add comprehensive Zendesk support agent with:
- Agent configuration and schemas
- Skills for agent-attached and local operations
- Documentation and validation guides
- Business context and operating modes

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
- Add website-scope-estimator-agent with full instruction set
- Includes configuration, templates, and reference materials
- 60 agent files with 49 skills exported
- Supports WordPress rebuild and website solution estimation

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add complete website content strategist agent with instructions,
skills, and manifests to the agents directory.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add portable agent export with instructions, configuration, references, and skills for AI readiness estimation and assessment.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…feat/new-agents

Add AI readiness estimator agent with complete portable export
@github-actions

github-actions Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

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

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request introduces a comprehensive set of configuration files, instructions, templates, and schemas for the LightSpeed AI Readiness Estimator agent, alongside a new VS Code task. The review feedback highlights a few key improvements: resolving an over-eager automated redaction that broke a filename reference in the upload guide, replacing a hardcoded branch name in the VS Code task with a generic HEAD target for better reusability, and renaming documentation files in the docs/ directory to uppercase with underscores to align with repository standards.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

1. `01-custom-gpt-instructions.md`
2. `02-workflow-map-and-routing.md`
3. `03-output-standards-and-file-naming.md`
4. `04-ri[REDACTED OPENAI API KEY].md`

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

high

The automated export tool has incorrectly flagged the filename 04-risk-red-flags-and-strict-mode.md as containing an OpenAI API key (due to the sk- prefix in risk-) and redacted it to 04-ri[REDACTED OPENAI API KEY].md. This breaks the file reference. Please restore it to the actual filename.

Comment thread .vscode/tasks.json
@@ -0,0 +1,257 @@
# Document-Ready Markdown Standard for AI Readiness Outputs

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

According to the repository's general rules, documentation and governance files in the docs/ directory must use UPPERCASE naming with underscores (e.g., DOCUMENT_READY_MARKDOWN_STANDARD.md), as the lowercase-with-hyphens naming convention does not apply to docs/ files. Please rename this file to adhere to the repository standard.

References
  1. Documentation and governance files in the docs/ directory must use UPPERCASE naming with underscores (e.g., GOVERNANCE_REVISION_LOG.md), as the lowercase-with-hyphens naming convention applies to other asset types and not to docs/ files.

@@ -0,0 +1,70 @@
# Output Template Library

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

According to the repository's general rules, documentation and governance files in the docs/ directory must use UPPERCASE naming with underscores (e.g., OUTPUT_TEMPLATE_LIBRARY.md), as the lowercase-with-hyphens naming convention does not apply to docs/ files. Please rename this file to adhere to the repository standard.

References
  1. Documentation and governance files in the docs/ directory must use UPPERCASE naming with underscores (e.g., GOVERNANCE_REVISION_LOG.md), as the lowercase-with-hyphens naming convention applies to other asset types and not to docs/ files.

@chatgpt-codex-connector

Copy link
Copy Markdown

💡 Codex Review

Queenspark has asked LightSpeed to submit the final proposal on 2026-07-01 after the original 2026-06-30 deadline passed. Queenspark has stated that additional clarification from LightSpeed at this stage could be considered an unfair advantage over other bidders because LightSpeed has extensive prior knowledge of the current site.

P1 Badge Remove client project memory from the export

This committed memory snapshot exposes client-specific RFP/proposal context, including timing, competitive-positioning details, named source documents, and private repository names. In any shared or public copy of this community-health repo, that publishes customer data that the root AGENTS.md explicitly treats as sensitive; the export should redact or omit real client project memory before it lands in the repository.


VALIDATION_README = ROOT / "tests" / "validation-readme.md"

P2 Badge Point the validator at the exported tests folder

In the Woo export, validation-readme.md was committed under agent/configuration/tests/validation-readme.md, but this validator hard-codes ROOT / "tests" / "validation-readme.md". I checked the runner from agents/woo-config-agent/agent, and bash scripts/run-master-validation.sh fails at the source-priority step with missing file: tests/validation-readme.md, so the packaged validation command cannot pass in a fresh checkout unless this path is updated or the tests are moved back to the expected location.


5d206ad4b514a87abb68e92ece8115b1734da9a0858892e0a5d748dc501f21c6 agent/references/agent_files/agentskills-main/.claude/hooks/session-start.sh

P2 Badge Regenerate checksum manifests after pruning ignored files

This checksum entry points at a .claude/ file that is not present in the commit because the root .gitignore excludes .claude/; git ls-tree shows no file at this path. Since sha256sum --check verifies the listed files, users running sha256sum -c checksums.sha256 for this export get a missing-file failure, so the advertised integrity manifest is unusable until ignored/uncommitted files are removed from it and the hashes are regenerated.

ℹ️ 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".

…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
@github-actions

Copy link
Copy Markdown
Contributor

Metadata governance

Resolves the merge conflict from PR #1043 (Babel peer-dependency fix)
landing on develop after this branch already carried the same fix
locally. package.json/package-lock.json merged cleanly (identical
resulting babel versions); CHANGELOG.md had a duplicate "Babel
peer-dependency conflict" entry from both sides, consolidated into one
referencing the canonical fix (#1042, PR #1043).
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

Now that CHANGELOG.md carries a real entry, it's part of the changed-file
set lint-and-links checks — and its two standard header links
(semver.org, keepachangelog.com) are exactly the kind of external
reference link that occasionally flakes in CI (this run hit a transient
"Connection reset by peer"), same category as the existing gnu.org/w3.org
exclusions.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

ashleyshaw and others added 2 commits July 15, 2026 19:25
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

ashleyshaw and others added 3 commits July 15, 2026 19:26
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

3 similar comments
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

ashleyshaw and others added 2 commits July 15, 2026 19:31
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

ashleyshaw and others added 3 commits July 15, 2026 19:32
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
…tion or class'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>
Signed-off-by: Ash Shaw <ashley@lightspeedwp.agency>
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

3 similar comments
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Caution

Failed to replace (edit) comment. This is likely due to insufficient permissions or the comment being deleted.

Error details
Validation Failed: {"resource":"IssueComment","code":"custom","field":"body","message":"body is too long (maximum is 65536 characters)"} - https://docs.github.com/rest/issues/comments#update-an-issue-comment

* @returns {Promise<{variables: Record<string, Variable>}>}
* `variables` maps each token name to its created Variable object.
*/
async function createSemanticTokens(collection, modeIds, tokenMap, runId) {
* }>}
* `modeIds` maps each mode name to its modeId string.
*/
async function createVariableCollection(name, modeNames, runId) {
* effectStyles: Array<{id: string, name: string, effectCount: number}>
* }>}
*/
async function inspectFileStructure() {
* `passed`: Array of nodeIds that passed all checks.
* `failed`: Array of objects with the nodeId and a human-readable reason string.
*/
function validateCreation(checks) {
* @param {string} runId - The run ID to filter by (optional — if omitted, returns ALL dsb-tagged nodes)
* @returns {{ runId: string, taggedNodes: Object<string, {nodeId: string, type: string, name: string, phase: string}>, variableCollections: Array, variables: Array, styles: Array }}
*/
async function rehydrateState(runId) {
@ashleyshaw ashleyshaw merged commit 816aea3 into develop Jul 15, 2026
26 checks passed
@ashleyshaw ashleyshaw deleted the feat/new-agents branch July 15, 2026 17:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:a11y Accessibility-focused work area:assets Assets (images, fonts, static files) area:ci Build and CI pipelines area:documentation Docs & guides area:scripts Scripts & tooling area:tests Test suites & harnesses area:theme Theme & styles lang:js JavaScript/TypeScript 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.

Add 16 new specialist agents to the agents/ directory

2 participants