agentleFS
ArcanEdge-AIArcanEdge-AI/coding-agent-playbook-claude-code/skills/production-performance-review/SKILL.md

production-performance-review

Skill0 starsChanged 4 months agoMITView on GitHub

Review and improve production performance and scalability, including slow queries, missing indexes, N+1 patterns, pagination, bundle size, asset optimization, unnecessary API calls, caching, expensive renders, memory leaks, blocking work, and startup costs. Use when preparing a codebase for production speed and scale.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When optimization changes are authorized, implement safe in-scope optimizations only.

    line 53
  2. Distinctive:

    Document larger changes as deferred recommendations.

    line 60
  3. Distinctive:

    Do not optimize blindly.

    line 75
  4. Distinctive:

    Do not add caching that risks stale or incorrect data without clear invalidation.

    line 76
  5. Distinctive:

    Do not introduce new infrastructure unless required.

    line 77
  6. Distinctive:

    Do not change user-visible behavior for performance unless explicitly justified.

    line 78
  7. Distinctive:

    Prefer measurable improvements where tooling allows.

    line 79
  8. Distinctive:

    Do not add complex optimization patterns for minor gains.

    line 80

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Production Performance Review

Core purpose

Identify production performance risks and apply safe optimizations without changing product behavior.

Use this skill when

  • The production pass needs performance review.
  • The user wants the app checked for production speed or scalability risks.
  • The repository has database, API, frontend, asset, or rendering performance concerns.

Do not use this skill when

  • The task is only security or documentation.
  • The user asks for speculative optimization without evidence.
  • Performance cannot be evaluated from available code or commands.

Check for

  • Slow or inefficient queries
  • Missing database indexes
  • N+1 query patterns
  • Missing pagination
  • Large frontend bundles
  • Unoptimized images or assets
  • Unnecessary API calls
  • Expensive frontend renders
  • Avoidable re-renders
  • Blocking synchronous work
  • Missing caching opportunities
  • Memory leaks
  • Startup performance issues
  • Background job opportunities
  • Excessive network payloads
  • Inefficient loops in critical paths

Default workflow

Resolve the task mode first: assessment-only work reports findings without source, test, or repository-document edits; authorized remediation applies only in-scope fixes. Release, production, and destructive operations retain their separate authority requirements.

  1. Identify stack and performance-relevant tooling.
  2. Inspect data access patterns.
  3. Inspect API and frontend loading patterns.
  4. Inspect asset and bundle configuration.
  5. Identify performance risks in critical user flows.
  6. Classify findings as Blocker, High, Medium, or Low.
  7. When optimization changes are authorized, implement safe in-scope optimizations only; otherwise report the evidence and recommendation:
    • pagination where obviously needed
    • query cleanup
    • index recommendations or safe index additions
    • asset references
    • obvious caching improvements with safe invalidation
    • frontend render improvements where clearly justified
  8. Document larger changes as deferred recommendations.
  9. Run available validation.

Severity guidance

Classify as Blocker when performance prevents critical production flows from working or risks immediate outage.

Classify as High when performance creates serious production risk under expected usage.

Classify as Medium when performance should be improved soon but is not release-blocking.

Classify as Low for optional optimization opportunities.

Guardrails

  • Do not optimize blindly.
  • Do not add caching that risks stale or incorrect data without clear invalidation.
  • Do not introduce new infrastructure unless required.
  • Do not change user-visible behavior for performance unless explicitly justified.
  • Prefer measurable improvements where tooling allows.
  • Do not add complex optimization patterns for minor gains.

Deliverables

Include the following in the requested assessment response or report. Update repository readiness files only when those artifacts are requested or part of authorized remediation:

  • Performance findings
  • Safe optimizations applied
  • Larger deferred recommendations
  • Validation results
  • Remaining scalability risks
  • Files changed and reasons

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.