architect-diagnose-errors

Cluster Cloudflare and PostHog error signatures to identify root-cause groups.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams quickly understand why error spikes are happening by turning raw Cloudflare and PostHog signals into clustered, actionable evidence.

Core Features & Use Cases

  • Error Signature Clustering: Groups related failures into likely root-cause clusters based on observed signatures and trends.
  • Incident Correlation: Links the start of error activity to recent deploys, commits, or configuration changes to narrow regression scope.
  • Evidence-Backed Remediation: Recommends the smallest safe fix with an explicit confidence level, reducing time to restore reliability.

Use Case: After a release, you notice 5xx spikes and repeated exception patterns in production; use this Skill to determine which failure signatures are related, what changed right before the spike, and what code path or owner should act first.

Quick Start

Diagnose the current error spike by clustering exception signatures from Cloudflare and PostHog, correlating the onset with recent commits, and proposing the smallest safe fix with confidence.

Frequently Asked Questions about architect-diagnose-errors

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

FAQPage Schema
How do I diagnose rising 5xx error rates in production after a release?

Diagnose rising 5xx error rates by clustering failure signatures from Cloudflare and PostHog evidence. The analysis correlates the onset of the incident window with recent commits or config changes to identify the likely root-cause cluster.

How do I correlate exception spikes with recent deploys or configuration changes?

Correlate exception spikes with recent deploys by applying time-bounded regression correlation to your incident window. The process links the start of error activity directly to recent commits or configuration changes to narrow regression scope.

What's the best way to group related production failures into root-cause clusters?

Group related production failures into root-cause clusters by analyzing error signature trends from Cloudflare and PostHog. This clustering turns raw signals into actionable evidence, identifying which failure signatures share a common underlying cause.

Can I use this to find the likely owner or code path responsible for an incident triage?

Yes, you can find the likely owner or code path during incident triage. The process outputs evidence links and next-best actions, recommending the smallest safe fix with an explicit confidence level to reduce time to restore reliability.

Do I need both Cloudflare and PostHog data to perform incident triage?

You need Cloudflare and PostHog data to perform incident triage effectively. The analysis relies on raw signals from both platforms to quantify the incident window, cluster failure signatures, and determine likely root-cause clusters.

Why should I use exception clustering instead of reviewing raw error logs during a spike?

Use exception clustering instead of raw error logs to quickly manage high-volume spikes. Clustering groups related failures based on observed signatures, cutting through noise to pinpoint the specific regression correlation and propose the smallest safe fix.