Performance Engineer

# Performance Engineer

> A Claude Code skill for performance optimization and analysis.

## Installation

This skill is part of the [agent-playbook](../../README.md) collection.

## Usage

```
You: Optimize this code
You: Why is this slow?
You: Profile this application
```

## Performance Targets

| Metric | Target |
|--------|--------|
| API Response (p50) | < 100ms |
| API Response (p95) | < 500ms |
| Database Query | < 50ms |
| Page Load (FMP) | < 2s |
| Time to Interactive | < 3s |

## Scripts

Profile application:
```bash
python scripts/profile.py
```

Generate performance report:
```bash
python scripts/perf_report.py
```

## Resources

- [Web.dev Performance](https://web.dev/performance/)
- [Google Performance](https://developer.chrome.com/docs/lighthouse/performance/)


# Performance Checklist

- [ ] Baseline metrics recorded
- [ ] Bottlenecks identified
- [ ] Fixes verified with benchmarks
- [ ] Regression tests added


# Performance Monitoring

- Track latency percentiles
- Monitor throughput and error rates
- Set alerts on regressions


# Performance Optimization Guide

## Common Levers
- Cache hot paths
- Reduce N+1 queries
- Minimize payload size
- Batch network calls


#!/usr/bin/env python3
# Template generator for performance report.

from pathlib import Path
import argparse
import textwrap


def write_output(path: Path, content: str, force: bool) -> bool:
    if path.exists() and not force:
        print(f"{path} already exists (use --force to overwrite)")
        return False
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")
    return True


def main() -> int:
    parser = argparse.ArgumentParser(description="Generate a performance report.")
    parser.add_argument("--output", default="perf-report.md", help="Output file path")
    parser.add_argument("--name", default="example", help="System or endpoint name")
    parser.add_argument("--owner", default="team", help="Owning team")
    parser.add_argument("--force", action="store_true", help="Overwrite existing file")
    args = parser.parse_args()

    content = textwrap.dedent(
        f"""\
        # Performance Report

        ## Summary
        {args.name}

        ## Ownership
        - Owner: {args.owner}

        ## Baseline Metrics
        - p50 latency:
        - p95 latency:
        - error rate:
        - throughput:

        ## Findings
        - Top bottlenecks
        - Resource saturation

        ## Recommendations
        - Short-term fixes
        - Long-term optimizations

        ## Validation
        - Benchmark commands
        - Regression checks
        """
    ).strip() + "\n"

    output = Path(args.output)
    if not write_output(output, content, args.force):
        return 1
    print(f"Wrote {output}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())


#!/usr/bin/env python3
# Template generator for performance profile.

from pathlib import Path
import argparse
import textwrap


def write_output(path: Path, content: str, force: bool) -> bool:
    if path.exists() and not force:
        print(f"{path} already exists (use --force to overwrite)")
        return False
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")
    return True


def main() -> int:
    parser = argparse.ArgumentParser(description="Generate a performance profile.")
    parser.add_argument("--output", default="perf-profile.txt", help="Output file path")
    parser.add_argument("--name", default="example", help="Scenario name")
    parser.add_argument("--tool", default="perf", help="Profiling tool")
    parser.add_argument("--command", default="run-benchmark.sh", help="Command profiled")
    parser.add_argument("--duration", default="60s", help="Profile duration")
    parser.add_argument("--force", action="store_true", help="Overwrite existing file")
    args = parser.parse_args()

    content = textwrap.dedent(
        f"""\
        Profile: {args.n