architect-diagnose-performance

Correlate observability signals and code changes to diagnose performance regressions.

198|19|Updated Sep 15, 2025
One-click install
npx skills add https://github.com/iterate/iterate --skill architect-diagnose-performance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-diagnose-performance
Source: https://github.com/iterate/iterate/tree/main/.opencode/skills/architect-diagnose-performance
Command: npx skills add https://github.com/iterate/iterate --skill architect-diagnose-performance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams quickly diagnose why latency, errors, or throughput are regressing so they can prevent incidents and restore capacity.

Core Features & Use Cases

  • Regression diagnosis across signals: Correlates latency/error distributions, user impact trends, machine health/usage, and recent commits or PRs to find likely causes.
  • Bottleneck localization: Compares baseline vs incident conditions to identify the most affected route/service and the bottleneck stage driving the change.
  • Safe remediation planning: Produces a remediation plan focused on the smallest safe intervention while capturing metrics and confidence.

Quick Start

Diagnose the current performance regression by identifying the worst affected route and incident window, comparing baseline vs incident metrics to infer the bottleneck stage, and proposing the smallest safe remediation.

Frequently Asked Questions about architect-diagnose-performance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose latency and throughput regressions in web routes?

Diagnose latency and throughput regressions by comparing baseline versus incident metrics across affected endpoints, correlating observability signals with recent commits to localize the bottleneck stage and generate a safe remediation plan.

What is the best way to triage performance incidents and identify impacted endpoints?

Triage performance incidents by identifying impacted endpoints and incident windows, then comparing baseline versus incident metrics to infer the bottleneck stage and generate a remediation plan with a confidence score.

How does correlating recent code changes with observability data help find performance bottlenecks?

Correlating recent code changes with observability data identifies performance bottlenecks by matching latency, error distributions, and machine health trends against specific commits to determine the likely cause of saturation or throughput drops.

Can I use this approach for post-regression analysis on services suffering capacity pressure?

Yes, this approach supports post-regression analysis on services suffering capacity pressure by applying baseline-versus-incident metric comparisons to produce a bottleneck hypothesis with confidence and a targeted remediation plan.

What is the smallest safe intervention for fixing a performance regression?

The smallest safe intervention for fixing a performance regression is a remediation plan focused on the most localized bottleneck stage, capturing relevant metrics and confidence levels to restore capacity without broad changes.

Why do I need baseline versus incident metric comparisons to localize a bottleneck?

Baseline versus incident metric comparisons are required to localize a bottleneck because they reveal the exact route or service stage where latency, saturation, or errors diverged from normal operating conditions to pinpoint the regression cause.