Skip to content

Comments

feat: add web performance subagent and /performance command#209

Merged
marcusquinn merged 2 commits intomainfrom
feature/t032-performance-subagent
Jan 25, 2026
Merged

feat: add web performance subagent and /performance command#209
marcusquinn merged 2 commits intomainfrom
feature/t032-performance-subagent

Conversation

@marcusquinn
Copy link
Owner

Summary

Adds a comprehensive web performance analysis subagent inspired by @elithrar's web-perf agent skill.

Changes

  • New subagent: tools/performance/performance.md - Core Web Vitals, network dependencies, accessibility analysis
  • New command: /performance - Quick performance audits from CLI
  • Updated: subagent-index.toon - Added performance subagent entry

Features

  • Core Web Vitals monitoring: FCP, LCP, CLS, FID, TTFB with thresholds
  • Network dependency analysis: Third-party scripts, request chains, bundle sizes
  • Accessibility auditing: WCAG compliance checks
  • Actionable output format: File:line references for immediate fixes
  • Chrome DevTools MCP integration: Uses chrome-devtools-mcp for deep analysis

Usage

# Full performance audit
/performance https://example.com

# Local dev server
/performance http://localhost:3000

# Specific categories
/performance https://example.com --categories=performance,accessibility

Related

  • Closes task t032
  • Complements existing tools/browser/pagespeed.md and tools/browser/chrome-devtools.md

Inspired by @elithrar's web-perf agent skill. Provides comprehensive
web performance analysis using Chrome DevTools MCP:

- Core Web Vitals monitoring (FCP, LCP, CLS, FID, TTFB)
- Network dependency analysis (third-party scripts, request chains)
- Accessibility auditing (WCAG compliance)
- Actionable output format with file:line references

New files:
- tools/performance/performance.md - Main subagent
- scripts/commands/performance.md - /performance command
- Updated subagent-index.toon

Closes #t032
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 25, 2026

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 26 minutes and 2 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.


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 and usage tips.

@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the agent's capabilities by introducing a dedicated web performance analysis subagent and a new /performance command. This allows for in-depth auditing of web pages, covering critical metrics like Core Web Vitals, network efficiency, and accessibility standards, all integrated directly into the development workflow for immediate and actionable insights.

Highlights

  • New Web Performance Subagent: Introduces tools/performance/performance.md for comprehensive web performance analysis, covering Core Web Vitals, network dependencies, and accessibility.
  • New /performance Command: Adds a command-line interface (/performance) for quick and detailed performance audits of specified URLs, supporting various options like device emulation and category selection.
  • Chrome DevTools MCP Integration: Leverages chrome-devtools-mcp for deep analysis, providing setup instructions and usage workflows for Lighthouse audits, network monitoring, and web vital measurements.
  • Actionable Output Format: Generates detailed performance reports with Core Web Vitals status, top issues, file:line references, and specific recommendations for fixes.
  • Comprehensive Documentation: Includes extensive documentation within the subagent itself, detailing setup, usage workflows (e.g., local testing, before/after comparison), Core Web Vitals thresholds, and common performance issues with their fixes.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

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

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 new web performance subagent and a corresponding /performance command, which is a valuable addition for performance analysis. The documentation is comprehensive, providing useful examples and potential fixes for common performance issues. My review focuses on improving the clarity and correctness of the provided documentation and examples. I've identified a few minor issues, including an inconsistency in command arguments, a potential for suppressed error messages in a prerequisite check, and a bug in a shell script example. Overall, this is a strong contribution that will be even better with these small adjustments.

```text
Default: Full audit (performance + accessibility + network)
Options:
--categories=perf,a11y,network Specific categories

Choose a reason for hiding this comment

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

medium

There's an inconsistency in the values for the --categories argument. Here you've defined them with short names (perf, a11y), but the example on line 102 uses the full names (performance, accessibility). Using the full, more descriptive names in both places would improve clarity and consistency for the user.

Suggested change
--categories=perf,a11y,network Specific categories
--categories=performance,accessibility,network Specific categories


```bash
# Verify Chrome DevTools MCP is available
which npx && npx chrome-devtools-mcp@latest --version 2>/dev/null || echo "Install: npm i -g chrome-devtools-mcp"

Choose a reason for hiding this comment

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

medium

The prerequisite check redirects stderr to /dev/null (2>/dev/null). This can hide useful error messages from npx if it fails to fetch or run chrome-devtools-mcp (e.g., due to network issues or other problems). Removing this redirection would provide better diagnostics for users trying to troubleshoot setup issues.

Suggested change
which npx && npx chrome-devtools-mcp@latest --version 2>/dev/null || echo "Install: npm i -g chrome-devtools-mcp"
which npx && npx chrome-devtools-mcp@latest --version || echo "Install: npm i -g chrome-devtools-mcp"

--chrome-flags="--headless"

# Check performance score
SCORE=$(jq '.categories.performance.score * 100' lighthouse.json)

Choose a reason for hiding this comment

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

medium

The shell script in this CI/CD example has a potential bug. This jq command can produce a floating-point number for the score, but the if condition on the next line (if [ "$SCORE" -lt 90 ]) performs an integer comparison. This will cause a "integer expression expected" error in bash if the score is not a whole number.

To fix this, you can use jq's round function to convert the score to an integer, ensuring the comparison works correctly.

Suggested change
SCORE=$(jq '.categories.performance.score * 100' lighthouse.json)
SCORE=$(jq '.categories.performance.score * 100 | round' lighthouse.json)

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 447 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 15:03:06 UTC 2026: Code review monitoring started
Sun Jan 25 15:03:06 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 447
Sun Jan 25 15:03:06 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 15:03:08 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 447
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 15:04:22 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

- Use full category names (performance, accessibility) for consistency
- Remove stderr suppression in prerequisite check for better diagnostics
- Add jq round function to CI/CD example to fix integer comparison
@sonarqubecloud
Copy link

@augmentcode
Copy link

augmentcode bot commented Jan 25, 2026

🤖 Augment PR Summary

Summary: This PR introduces a new web performance “subagent” and a matching /performance slash command to run comprehensive audits using Chrome DevTools MCP.

Changes:

  • Added .agent/tools/performance/performance.md with guidance for Core Web Vitals, Lighthouse auditing, network dependency analysis, and accessibility checks.
  • Added .agent/scripts/commands/performance.md to expose a /performance CLI workflow (URL target + optional flags like categories/device/iterations/compare).
  • Updated .agent/subagent-index.toon to register the new tools/performance/ subagent entry.

Technical Notes: The docs emphasize actionable output (metric tables + file:line references), optional baseline comparisons, and using chrome-devtools-mcp (via npx) for deep analysis.

🤖 Was this summary useful? React with 👍 or 👎

Copy link

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

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

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

grep: true
webfetch: true
task: true
mcp:
Copy link

Choose a reason for hiding this comment

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

The aidevops/OpenCode frontmatter pattern enables MCPs via the tools: map (e.g. fluentcrm_*: true), and I don’t see other agents using an mcp: key; if mcp: is ignored by the loader, this subagent may not actually have Chrome DevTools tools available when invoked.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

```text
Default: Full audit (performance + accessibility + network)
Options:
--categories=perf,a11y,network Specific categories
Copy link

Choose a reason for hiding this comment

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

--categories=perf,a11y,network here doesn’t match the later example --categories=performance,accessibility, which could lead to users passing values the command doesn’t recognize.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

@github-actions
Copy link

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 447 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 15:05:44 UTC 2026: Code review monitoring started
Sun Jan 25 15:05:44 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 447
Sun Jan 25 15:05:44 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 15:05:46 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 447
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 15:07:09 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@marcusquinn marcusquinn merged commit 926b817 into main Jan 25, 2026
8 of 9 checks passed
marcusquinn added a commit that referenced this pull request Jan 25, 2026
New features documented:
- /performance command for web performance audits (PR #209)
- /email-health-check command for deliverability checks (PR #213)
- @debug-opengraph and @debug-favicon SEO subagents (PR #206)
- Auto-task completion from commit messages (PR #208)

Updated Core Capabilities section with new monitoring features.
marcusquinn added a commit that referenced this pull request Jan 25, 2026
New features documented:
- /performance command for web performance audits (PR #209)
- /email-health-check command for deliverability checks (PR #213)
- @debug-opengraph and @debug-favicon SEO subagents (PR #206)
- Auto-task completion from commit messages (PR #208)

Updated Core Capabilities section with new monitoring features.
marcusquinn added a commit that referenced this pull request Jan 25, 2026
Performance subagent and /performance command implemented in PR #209.
@marcusquinn marcusquinn deleted the feature/t032-performance-subagent branch February 21, 2026 01:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant