agentleFS
SWEStashSWEStash/swe-workflow-skills/skills/retrospective/SKILL.md

retrospective

Skill1 starsChanged 6 days agoMITView on GitHub

Facilitate sprint retros, project post-mortems, and incident post-mortems with actionable, owned improvements. Triggers: retrospective, retro, post-mortem, postmortem, lessons learned, what went wrong, what went well, incident review, blameless, action items, sprint review, after action review.

69 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use dev-story, team-level and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • lilangMaxSkill

    dev-story

    Read a story file and implement it. Loads the full context (story, GDD requirement, ADR guidelines, control manifest), routes to the right programmer agent for the system and engine, implements the code and test, and confirms each acceptance criterion. The core implementation skill — run after /story-readiness, before /code-review and /story-done.

    Also in 12 projects that use this

  • CoralGameSkill

    team-level

    Orchestrate level design team: level-designer + narrative-director + world-builder + art-director + systems-designer + qa-tester for complete area/level creation.

    Also in 12 projects that use this

  • CoralGameSkill

    team-narrative

    Orchestrate the narrative team: coordinates narrative-director, writer, world-builder, and level-designer to create cohesive story content, world lore, and narrative-driven level design.

    Also in 12 projects that use this

  • lilangMaxSkill

    create-stories

    Break a single epic into implementable story files. Reads the epic, its GDD, governing ADRs, and control manifest. Each story embeds its GDD requirement TR-ID, ADR guidance, acceptance criteria, story type, and test evidence path. Run after /create-epics for each epic.

    Also in 11 projects that use this

  • +7 more from lilangMax
  • +1 more from CoralGame

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. 0 are common, 14 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 58 edited versions we read keep these.

  • 14

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When: After a significant project or milestone completes

    line 19
  2. Distinctive:

    When: After any production incident that impacted users

    line 25
  3. Distinctive:

    Use one of these formats:

    line 42
  4. Distinctive:

    Don't try to fix everything.

    line 62
  5. Distinctive:

    Before the meeting, gather:

    line 75
  6. Distinctive:

    Use the template at templates/post-mortem.md.

    line 92
  7. Distinctive:

    When did the incident start?

    line 103
  8. Distinctive:

    When was it detected? (By monitoring or by users?)

    line 104
  9. Distinctive:

    When was the team alerted?

    line 105
  10. Distinctive:

    When was the incident resolved?

    line 107
  11. Distinctive:

    When was the root cause confirmed?

    line 108
  12. Distinctive:

    Use the "5 Whys" technique to dig past symptoms:

    line 112
  13. Distinctive:

    Use the template at templates/post-mortem.md.

    line 141
  14. Distinctive:

    Action over discussion: Every retro must produce specific, owned action items.

    line 146

“Common” is measured: kept by at least 6 in 10 of the 58 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Retrospective

Facilitate structured reflection that produces concrete improvements. The goal is not to assign blame — it's to make the next iteration better than the last.

Three Formats

Sprint Retrospective

When: End of every sprint Duration: 30-60 minutes Scope: What happened this sprint Output: 2-3 action items with owners for next sprint

Project Post-Mortem

When: After a significant project or milestone completes Duration: 60-90 minutes Scope: The entire project from planning through delivery Output: Written document with learnings and recommendations

Incident Post-Mortem

When: After any production incident that impacted users Duration: 60 minutes Scope: The incident timeline, response, and systemic causes Output: Blameless post-mortem document with prevention actions

Workflow: Sprint Retrospective

Step 1: Gather Data

Collect information about the sprint before the meeting:

  • Sprint velocity vs commitment
  • Items completed vs carried over
  • Incidents or bugs discovered
  • Team sentiment (optional pulse survey)

Step 2: Facilitate Discussion

Use one of these formats:

Start/Stop/Continue:

  • Start doing: What should we begin doing that we aren't?
  • Stop doing: What's wasting time or causing problems?
  • Continue doing: What's working well?

Went Well / Didn't Go Well / Action Items:

  • What went well this sprint? (Celebrate wins)
  • What didn't go well? (Identify problems without blame)
  • What specific actions will we take to improve?

4Ls (Liked, Learned, Lacked, Longed for):

  • What did we like about this sprint?
  • What did we learn?
  • What was lacking?
  • What did we long for (wish we had)?

Step 3: Prioritize Action Items

Don't try to fix everything. Pick the top 2-3 improvements:

  • Each action item gets an owner (one person, not "the team")
  • Each action item gets a deadline (usually "by end of next sprint")
  • Each action item is specific enough to verify completion

Step 4: Record and Follow Up

Save the retro notes. At the start of next sprint's retro, review the previous action items: were they completed?

Workflow: Project Post-Mortem

Step 1: Prepare the Review

Before the meeting, gather:

  • Original project proposal, PRD, and estimates
  • Actual timeline and effort vs estimated
  • Key decisions made during the project and their outcomes
  • Metrics: did the project hit its success criteria?

Step 2: Walk Through Key Questions

  1. Did we solve the right problem? Was the original problem statement accurate?
  2. Did we estimate well? Where were estimates off and why?
  3. What decisions would we make differently? (Technical, scope, team)
  4. What processes helped? (What to keep)
  5. What processes hindered? (What to change)
  6. What surprised us? (Unknowns that became knowns too late)

Step 3: Produce the Document

Use the template at templates/post-mortem.md. Share with the team and stakeholders.

Workflow: Incident Post-Mortem

Blameless Culture

The most important principle: incidents are caused by systems, not people. If a human made an error, the question is "why did the system allow that error to cause an outage?" not "who messed up?"

Step 1: Build the Timeline

Reconstruct a minute-by-minute timeline:

  • When did the incident start?
  • When was it detected? (By monitoring or by users?)
  • When was the team alerted?
  • What actions were taken and when?
  • When was the incident resolved?
  • When was the root cause confirmed?

Step 2: Identify Root Causes

Use the "5 Whys" technique to dig past symptoms:

Why did users see errors? → The API returned 500s.
Why did the API return 500s? → Database connections were exhausted.
Why were connections exhausted? → A query was holding connections open.
Why was a query holding connections? → A missing index caused full table scans.
Why was the index missing? → No index review process exists for migrations.
→ Root cause: No systematic review of database performance for new migrations.

Step 3: Define Prevention Actions

For each root cause, define an action that prevents recurrence:

ActionTypeOwnerDeadline
Add EXPLAIN ANALYZE check to migration CIPrevention[Name][Date]
Add connection pool monitoring alertDetection[Name][Date]
Document index guidelines for teamProcess[Name][Date]

Action types:

  • Prevention: Makes the incident impossible to recur
  • Detection: Makes the incident detectable before user impact
  • Mitigation: Reduces the blast radius if it happens again
  • Process: Changes how the team works to reduce risk

Step 4: Produce the Post-Mortem

Use the template at templates/post-mortem.md. Publish internally — transparency builds trust and helps other teams learn.

Principles Applied

  • Blameless over blame: Focus on systems, not individuals. "The deploy script didn't validate X" not "Dave forgot to check X."
  • Action over discussion: Every retro must produce specific, owned action items. A retro without action items is just venting.
  • KISS: 2-3 action items per retro, not 15. Fewer items done beats many items forgotten.
  • Continuous improvement: Small improvements every sprint compound. A 5% improvement per sprint is 3x better in a year.

Cross-Skill References

  • incident-response — triggers a post-mortem; use this skill for the post-mortem workflow
  • technical-debt-review — if retrospectives repeatedly surface the same maintenance pain, escalate to a full debt review

See references/facilitation-guide.md for retro formats, handling difficult conversations, and action item quality criteria.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.