structural-retrospective

Converts incidents and postmortems into reproducible evidence, system-gap analysis, and owned follow-up issues.

Updated May 27, 2026
One-click install
npx skills add https://github.com/ybaspinar/agent-work-skills --skill structural-retrospective-ybaspinar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: structural-retrospective
Source: https://github.com/ybaspinar/agent-work-skills/tree/main/skills/structural-retrospective
Command: npx skills add https://github.com/ybaspinar/agent-work-skills --skill structural-retrospective-ybaspinar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrospectives and postmortems often end with vague prose, blame on individuals, and action items that never get tracked. This Skill turns incidents into evidence-based analysis and durable system changes so the lesson survives after the meeting ends. ## Core Features & Use Cases - Evidence-Based Reconstruction: Rebuilds failures from logs, traces, metrics, and inputs before allowing any explanation, keeping memory from outranking reproducible evidence. - System-Gap Analysis: Identifies what the system allowed to happen, including missing signals like swallowed errors, absent alerts, and misleading dashboards, instead of blaming individuals. - Guardrail Conversion: Turns lessons into regression tests, assertions, alerts, lint rules, schemas, or runbooks, each with one owner, one due date, and a triage-ready issue. - Use Case: After a production outage caused by a silently swallowed queue error, use this Skill to reconstruct the timeline from logs, identify the missing alert, and produce a tracked follow-up issue assigning a regression test and dashboard fix to a named owner. ## Quick Start Run a structural retrospective on last week's payment-service incident and produce the reconstructed failure, system gap, and owned follow-up issues.

Frequently Asked Questions about structural-retrospective

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

FAQPage Schema
How do I run a blameless postmortem that still produces action items?

Blameless postmortems focus on what the system allowed to happen rather than who made a mistake. Reconstruct the failure from logs and metrics first, identify the missing signal or structural gap, then assign each follow-up one owner and one due date as a tracked issue.

How to turn incident lessons into permanent fixes?

Convert each lesson into something that re-runs without the meeting: a regression test, assertion, alert, lint rule, schema constraint, or runbook entry. Prefer deleting the failure mode entirely over adding another guard, and feed every item back as a triage-ready issue.

What are red flags in a retrospective or postmortem?

Common red flags include confident memory outranking reproducible evidence, citing human error as the root cause, action items like 'be more careful', alerts added without an owner or false-positive control, and retros that end with prose but no tracked issues.

Why do incident follow-up items never get completed?

Follow-ups fail when they lack a single owner, a due date, or a tracked issue in the team's triage system. The retrospective report explains the work but is not the work itself, so every action must be converted into an owned, dated, triage-ready issue.

When should I prefer deleting code over adding a guardrail?

Prefer deletion when the failure mode itself can be removed, such as retiring a dangerous code path, config option, or dependency. Removing the failure mode is more durable than layering guards, alerts, or checks on top of a structure that keeps causing incidents.