project-retrospective

Featured

Generates LESSONS.md files capturing institutional knowledge and failures. Use when closing out projects or investigations.

Data & Documents 391 stars 65 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
86
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Project retrospective writer Create LESSONS.md files that capture institutional knowledge, especially failures. Think like a journalist writing about your own project, be specific, be honest, name the actual mistakes. ## Frame the retrospective: blame-aware, not pure-blameless The 2024–2026 consensus in incident-analysis writing (PagerDuty, J. Paul Reed, Lorin Hochstein) is that pure blamelessness is neurobiologically unrealistic, humans default to blame. Healthier framing: acknowledge the blame bias exists and counter it deliberately. Source: https://postmortems.pagerduty.com/culture/blameless/ Cognitive biases to counter explicitly: - **Fundamental attribution error**, blaming individuals for failures the system permitted - **Confirmation bias**, looking for evidence that confirms a pre-formed narrative - **Hindsight bias**, judging past decisions by knowledge that wasn't available at the time - **Negativity bias**, over-weighting what went wrong vs. what worked The voice rule isn't "no blame", it's "name the system that permitted the human action, not just the action." ## Drop the single-root-cause framing Allspaw's canonical critique (still the dominant view in 2024–2026) calls Five Whys / single-root-cause analysis "seductively satisfying and compellingly simple, but false." It locks analysts into a linear causal chain that terminates in individual blame. Source: https://www.kitchensoap.com/2014/11/14/the-infinite-hows-or-the-dangers-of-the-five-whys/ Use "how"...

Details

Author
jamditis
Repository
jamditis/claude-skills-journalism
Created
8 months ago
Last Updated
4 days ago
Language
Python
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

project-retrospective

Generate a LESSONS.md from a finished project: what worked, what didn't, what to reuse, what to retire — formatted for next-project carry-over.

31 Updated 1 weeks ago
ur-grue
AI & Automation Listed

project-postmortem

Generate an evidence-grounded project retrospective — pulled from git history and decision docs, not memory — that grades the project on separate dimensions, splits what went right from wrong, reduces the failure to its root ordering error, extracts transferable lessons for the next project, and names what survives. Use whenever a project ships, stalls, or gets sunset and someone wants the writeup — "post-mortem", "retrospective", "what went wrong with X", "we're sunsetting X, write it up", or mid-project "why did this go sideways". The method cites commit hashes or sources for every claim, builds a timeline of when validation happened vs building, separates pros from cons including uncomfortable symmetries, and ends with a per-dimension scorecard plus a what-survives list — then runs a check that fails any vanity scorecard or uncited narrative. Distinct from drift-check (audits live docs) and conductor-memory/session-bookend (capture session state for continuity); this extracts backward-looking lessons.

0 Updated today
scoobydrew83
AI & Automation Listed

project-retrospective

Run a concise, evidence-based retrospective after a project, lesson, campaign, or creative workflow. Use when users want to capture lessons, identify bottlenecks, decide what to change, or turn an experience into a practical next-cycle plan.

0 Updated 1 months ago
phillipalcock