К основному содержанию
скилл CX Codex

project-retrospective — скилл для Claude Code: пишет LESSONS.md

Скилл project-retrospective генерирует LESSONS.md файлы, которые фиксируют знания и ошибки проекта. Пригодится при закрытии проекта или расследования, чтобы не потерять выводы и не повторить ошибки.

MIT 189 установок ★ 458 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jamditis/claude-skills-journalism --skill project-retrospective -a claude-code
Открыть на GitHub

Что делает project-retrospective

Скилл помогает писать осмысленные ретроспективы проектов, отойдя от театра безупречности. Вместо того чтобы искать одну корневую причину, он разбирает систему: какие сигналы были доступны, как люди их интерпретировали, какие цели решали, что делали. Разделяет слои — сначала система, потом действия людей внутри неё.

Скилл предлагает структуру с разделами на то, что сработало и что нет, секцией «The real problem» (что мы думали строить vs. что реально было нужно), и таблицей action items с владельцами и сроками. Подходит для live-event retro (выборы, breaking news — пишется в течение 48 часов) и для project-close ретро (обычно в течение месяца). Основан на практике Google SRE, US Army AAR и современных подходах к анализу инцидентов.

Какие задачи решает

  • Зафиксировать уроки из проекта до того, как команда разойдётся и забудет детали
  • Найти системные проблемы вместо того чтобы винить людей
  • Выявить разрыв между тем, что планировали построить, и тем, что на самом деле нужно было
  • Составить конкретные action items с владельцами вместо размытых советов
  • Провести честный разбор live-события (выборы, breaking news) пока свежо в памяти

Примеры запросов агенту

  • Напиши ретроспективу проекта с ошибками, которые мы допустили в архитектуре
  • Создай LESSONS.md для after action review нашего live-blog во время выборов
  • Разбери, почему мы потратили три месяца на функцию, которую никто не использует

Как установить project-retrospective

1Через Skills CLI (Vercel)

npx skills add jamditis/claude-skills-journalism --skill project-retrospective -a claude-code

2Вручную: положить файлы

~/.claude/skills/project-retrospective/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/project-retrospective/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о project-retrospective

Как установить project-retrospective в Claude Code?

Выполни npx skills add jamditis/claude-skills-journalism --skill project-retrospective -a claude-code, затем отредактируй ~/.claude/skills/project-retrospective/SKILL.md.

Что делает project-retrospective?

Скилл помогает писать LESSONS.md файлы проектов. Структурирует ретроспективу так, чтобы разделить системные проблемы от человеческих действий, найти реальную проблему (что планировали vs. что нужно было) и создать конкретные action items с владельцами.

Когда запускать ретроспективу?

Google SRE рекомендует предопределённые триггеры: live-event failure (downtime во время breaking news), failure в редакционном процессе (missed correction, breach в source management), tool failure (>X% читателей), запрос от редактора. Главное — писать в течение одной недели, пока свежо в памяти.

Исходный текст

SKILL.md · MIT
---
name: project-retrospective
description: Generates LESSONS.md files capturing institutional knowledge and failures. Use when closing out projects or investigations.
---

# 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" narratives instead, gathering on four prompts:
- **Cues**, what signals were available, who saw them when?
- **Interpretation**, how did people make sense of those signals?
- **Goals**, what were people trying to accomplish?
- **Taking action**, what did they do, and what did they expect to happen?

The retrospective's job is to surface contributing factors, not declare a root cause.

## When to run a retrospective

Pre-define triggers before incidents happen, not after. Google SRE specifies criteria: user-visible downtime past a threshold, any data loss, on-call rollbacks, monitoring failures requiring manual discovery, stakeholder request. Source: https://sre.google/sre-book/postmortem-culture/

Translated to journalism:

| Trigger | Examples |
|---|---|
| Live-event failure | Live-blog downtime during election night, breaking-news embed breakage, paywall regression mid-investigation |
| Editorial process failure | Missed correction window, source-management breach, fact-check process bypass |
| Tool failure affecting subscribers | CMS migration regression, paywall logic affecting >X% of readers |
| Stakeholder request | Editor / publisher / source explicitly asking "what happened?" |

Pre-defined triggers prevent retrospective theater on routine work and ensure they happen on real failures.

## Timing: aim for under one week

Google's good-vs-bad postmortem comparison cites a "four months later" example as a quality failure because contributors' memories had decayed. Source: https://sre.google/workbook/postmortem-culture/

Recommended cadence:

| Project type | Target window |
|---|---|
| Live-event retro (election night, breaking news) | Same-day debrief, written within 48h |
| Tool / CMS incident | Within one week |
| Investigation or publication launch | Within one month of project close |
| Annual review of ongoing initiative | Once per year, scoped to discrete decision points |

The empirical floor is "fresh in contributors' minds." Past one week and the narrative gets reconstructed rather than remembered.

## For event-type retros, use AAR structure

The US Army's After Action Review (FM 7-0 Appendix K) was designed for facilitated post-event debriefs and fits live-news realities better than a project-close template. Source: https://www.first.army.mil/Portals/102/FM%207-0%20Appendix%20K.pdf

Four prompts:
1. **What was supposed to happen?**
2. **What did happen?**
3. **What was right or wrong about the difference?**
4. **How do we perform to standard next time?**

Run AAR immediately after the event with all participants, election night newsroom team, live-blog runners, breaking-news desk. Use `event.md` template for this; project-close templates are wrong for live-event retros.

## The critical section: "The real problem"

This is the most valuable part of any retrospective. It answers:

> "What did we THINK we were building vs. what was ACTUALLY needed?"

**Strong example:**
> We built an admin dashboard for editors when they actually needed a Slack bot. They live in Slack, forcing them to open a web app was friction they'd never accept. The dashboard has 2 monthly active users; the Slack bot prototype we built in a day has 47.

**Weak example:**
> We learned the importance of user research.

## Template structure

```markdown
# LESSONS.md

## Project
- **Name:** [Project name]
- **Dates:** [Start - End]
- **Status:** [Completed / Abandoned / Ongoing]
- **Author:** [Your name]
- **Retrospective written:** [Date, should be within timing window above]

## Summary
[One paragraph: what it did, what impact it had, why it matters]

## What worked

### Technical wins
- [Specific decision and WHY it worked]
- [Tool/pattern that saved time]

### Process wins
- [Methodology that helped]
- [Communication pattern that worked]

## What didn't work

For each item below, separate the system layer from the people layer.
"What did the system permit or require?" comes before "What did the
people inside that system do?"

### Critical failures
- **System:** [What the architecture / process / tooling permitted]
- **People:** [What humans did inside that constraint]
- **Cost:** [Quantified impact: hours, subscribers affected, money]

### Technical debt
- [Shortcut that hurt later, and why it was the rational choice at the time]
- [Complexity that wasn't needed]

### External factors
- [Things outside your control that impacted the project]

## The real problem

What we thought: [Initial assumption]
What was actually needed: [Reality]
The gap cost us: [Time / effort / money wasted]

## Action items

Each item must have an owner, a deadline, a tracker URL, and a priority.
"Postmortems without subsequent action are indistinguishable from no postmortem."
- Google SRE

| # | Action | Owner | Deadline | Tracker | Priority |
|---|--------|-------|----------|---------|----------|
| 1 | [Specific change] | [Name] | [Date] | [Issue URL] | P0 / P1 / P2 |
| 2 | [Specific change] | [Name] | [Date] | [Issue URL] | P0 / P1 / P2 |

Failure modes to avoid:
- Ambiguous wording ("make automation better")
- Equal priority across all items (defeats the purpose of priority)
- No tracker bug or issue URL (action items vanish)
- Fixes targeting human behavior instead of system redesign ("be more careful")

Add a 30/60/90-day check-in note: who reviews progress on these, and when.

## Reusable artifacts

| Component | Why it's valuable |
|-----------|-------------------|
| [Name] | [Specific reuse potential] |
| [Name] | [Why someone else should use this] |

## Questions for next time
- [Unanswered questions worth investigating]
- [Things you'd research before starting]
```

## Voice guidelines

- Honest, specific, slightly self-deprecating
- Like explaining to a friend why the project took twice as long
- Name what the system permitted, then what the people did inside it
- Specific mistakes, not vague "challenges"
- Active voice; avoid "mistakes were made" passives that hide who decided what

## Sourcing-decision retrospectives (journalism-native)

The canonical SRE / AAR / Allspaw frameworks don't cover the editorial-judgment retrospective an investigation needs. The `research-project.md` template adds a "Source decisions revisited" section:

- Which sources we trusted, and why?
- Which we declined, and why?
- What was the redaction logic? Did it hold up?
- What would we reconsider if we ran the investigation again?
- What patterns should we carry forward to the next investigation?

Newsroom engineering blogs (NYT Open, ProPublica News Apps, WaPo Engineering) publish project descriptions but rarely retrospective methodologies, so this is treated as a journalism-native extension to the system rather than borrowed from precedent.

## What to include vs exclude

| Include | Exclude |
|---------|---------|
| Specific failures with quantified context | Vague "learnings" |
| Actual time / cost of mistakes | Blame for individuals |
| What the system permitted (then what humans did) | "Mistakes were made" passives |
| Tools that helped or hurt, by name | Generic best practices |
| Decisions you'd reverse, and why now, not then | Obvious statements |
| Surprising discoveries | Information already in other docs |

## The specificity test

For each item in "What didn't work," ask:
- Can I name the specific decision?
- Can I quantify the impact?
- Did I separate what the system permitted from what the people did?
- Would this help someone avoid the same mistake?

If no to any → be more specific.

## Red flags in your writing

If you find yourself writing these, stop and be more specific:
- "Communication is key"
- "We learned the importance of..."
- "Going forward, we should..."
- "Challenges included..."
- "There were some issues with..."
- "Mistakes were made" (who made them? in what system?)

These are placeholders for real insights. Replace them.

## Examples of good vs bad entries

**Bad, too vague:**
> - Communication could have been better
> - We underestimated the complexity
> - Testing was insufficient

**Good, specific and actionable:**
> - The schema validation step was disabled in CI for the data-import script (system) and the freelance reporter who imported new entries didn't know it had been disabled (people). Cost: 3 hours debugging a typo that caused silent failures across 12 published stories.
> - We built a custom date picker when the browser native input would have worked. Tracker: ENG-1247. Owner: K. Park. 2 days wasted.

## Journalism-specific templates

Templates are in the `templates/` directory:

| Template | Use for |
|----------|---------|
| `research-project.md` | Investigations, data journalism projects (includes sourcing-decision retro) |
| `event.md` | Conferences, workshops, campaigns (uses AAR structure) |
| `publication.md` | Newsletters, podcasts, ongoing content |
| `editorial-tool.md` | Newsroom software, AI tools |

### Template selection

```
What kind of project?
├── Investigation/analysis → research-project.md
├── Conference/workshop/election night → event.md (use AAR)
├── Newsletter/podcast → publication.md
└── Newsroom tool → editorial-tool.md
```

## Last currency sweep

2026-05-09. Sources verified: kitchensoap.com (Allspaw "Infinite Hows"), postmortems.pagerduty.com, sre.google/sre-book and /workbook, first.army.mil FM 7-0 Appendix K, adaptivecapacitylabs.com.

---

*The best retrospectives are written by people who got burned and want to save others from the same fate.*

© jamditis · MIT · jamditis/claude-skills-journalism

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
event-debrief Samuel Berthe Скилл event-debrief проводит внутренний разбор прошедшего мероприятия: восстанавливает хронологию, отделяет удачи от провалов и собирает журнал выводов с ответственными и сроками. CX Codex +1 6 800установок after-action-report rampstackco Скилл after-action-report проводит разбор инцидента, запуска или завершённого проекта: восстанавливает ход событий, ищет причины и формирует действия. CX Codex +1 292установок pl-analyze sno-ai Скилл pl-analyze для Claude Code разбирает инциденты и оценивает рабочие процессы. Запускается по запросу на ретроспективу или поиск первопричины, а также через маршрутизацию PL. CX Codex +1 ★ 869звёзд репо run-learning-retrospective cursor Скилл run-learning-retrospective для Claude Code проводит ретроспективу обучения: сверяет сделанное с целями, находит повторяющиеся блокеры и правит план. Запускается после закрытия очередного этапа. CX Codex +1 937установок iterate-retrospective product-on-purpose Скилл iterate-retrospective помогает провести командную ретроспективу, разобрать успехи и сбои спринта, а затем зафиксировать задачи с дедлайнами и ответственными. CX Codex +1 832установок retrospective Donchitos Скилл retrospective для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — проводит ретроспективу спринта или вехи по истории коммитов, планам и статусам задач. Формирует список конкретных действий на следующую итерацию. CX Codex +1 659установок

Из того же набора35

Весь набор →
content-access Скилл content-access для Claude Code описывает легальный доступ журналистов и исследователей к платным статьям и закрытым публикациям через открытые API. CX Codex +1 201установок digital-archive Скилл digital-archive помогает спроектировать цифровой архив: свести материалы из разных источников к общей схеме, обогатить их ИИ и связать упомянутые сущности. CX Codex +1 198установок zero-build-frontend Скилл zero-build-frontend для разработки фронтенда, который работает в браузере без этапа сборки. Подходит для статических сайтов, расширений браузера, карт и лёгких интерфейсов с данными. CX Codex +1 198установок free-apis-catalog Скилл free-apis-catalog для Claude Code собирает бесплатные API новостей, погоды, госданных США и соцплатформ с лимитами free-tier. Помогает агенту выбрать источник данных вместо выдуманного эндпоинта. CX Codex +1 191установок python-pipeline Скилл python-pipeline для Claude Code задаёт шаблоны пайплайнов данных на Python для пакетной обработки, диспетчеризации контента и интеграции с Google Sheets. CX Codex +1 189установок api-hardening Скилл api-hardening для Claude Code помогает укрепить API на Express, FastAPI и serverless. Подключается к задачам с ограничением запросов, настройкой CORS, проверкой данных и ключами API. CX Codex +1 186установок project-memory Скилл project-memory создаёт и обновляет файлы инструкций AGENTS.md или CLAUDE.md. Помогает зафиксировать нетривиальные правила проекта и передать контекст кодинг-агентам без лишней воды. CX Codex +1 180установок mobile-debugging Скилл mobile-debugging учит агента поднимать JavaScript-консоль на телефоне или планшете и отлаживать страницы без десктопных DevTools: Eruda, vConsole, инспекция по USB. CX Codex +1 176установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой