Workspace Performance Audit

Authorized Scope

Apply this engine only within the user's requested task and existing explicit authorization. Loading or delegating to it grants no additional authority. Preserve report-only restrictions and the caller's target, host, provider, and cost limits. Existing approval satisfies a gate only for the same actions and scope; obtain approval before expanding them. Forward these limits to delegates.

Contract

Inputs:

• Monorepo root path (defaults to current working directory)
• Optional: target domain(s) to focus on (frontend, backend, database, extension)
• Optional: audit mode (quick or full)

Outputs:

• Consolidated performance audit report
• Prioritized recommendations with severity ratings

Creates/Modifies:

• .agents/memory/performance-audit-YYYY-MM-DD.md — writes the audit report

External Side Effects:

• None. Read-only analysis only; does not deploy, modify, or install anything.

Confirmation Required:

• Before writing the output report if the target path is outside the current workspace

Delegates To:

• performance-expert for metrics and optimization
• design-consistency-auditor for UI/UX consistency
• qa-reviewer for validation and prioritization

Skills Orchestrated

Orchestration Flow

Phase 0: Workspace Discovery
    → Identify apps, packages, tech stacks

Phase 1: Frontend Audit (Next.js)
    → Core Web Vitals, Bundle Analysis, Design, A11y

Phase 2: Backend Audit (NestJS)
    → API Response Times, N+1 Queries, Security

Phase 3: Database Audit (MongoDB)
    → Query Performance, Index Analysis

Phase 4: Extension & Packages
    → Bundle Sizes, Memory, Dependencies

Phase 5: Consolidation
    → Aggregate, Score, Prioritize, Report

Key Metrics by Domain

Usage Modes

Quick Audit: Essential checks only → 1-page summary Full Audit: All phases → Complete report Domain-Specific: Single domain focus

For detailed phase execution, metric collection commands, report templates, and example interactions: load ${CLAUDE_SKILL_DIR}/references/full-guide.md when starting a full audit or when a specific phase requires detailed guidance.