@windyroad/retrospective weekly downloads statistics

@windyroad/retrospective

Session retrospectives for Claude Code. Captures learnings at the end of each session and creates problem tickets for failures and friction. Maturity: Experimental (suite-bootstrap window; 282 invocations / 30d).

Part of Windy Road Agent Plugins.

What It Does

Every coding session produces learnings -- things that went well, things that broke, things that were harder than expected. Without a retrospective, those learnings evaporate.

The retrospective plugin:

• Reminds you to run a retro when a session ends
• Updates docs/BRIEFING.md with session learnings so future sessions start with context
• Creates problem tickets (via @windyroad/itil) for failures and friction encountered during the session

Install

npx @windyroad/retrospective

Restart Claude Code after installing.

Requires: @windyroad/itil and @windyroad/risk-scorer. The installer warns if they're missing.

Usage

Run a session retrospective:

/wr-retrospective:run-retro

This walks through the session's work, identifies what went well and what didn't, updates docs/BRIEFING.md, and creates problem tickets for any failures. The retro also runs every shipped advisory script (briefing budgets, ask-hygiene, README skill-inventory currency per ADR-069, SKILL.md runtime budgets per ADR-054) so doc-content drift surfaces in the retro summary alongside session-level reflections.

Analyse session context usage:

/wr-retrospective:analyze-context

Deep on-demand context-usage analyser per ADR-043. Generates per-source attribution, per-plugin decomposition, and suggested trim actions. Complements the cheap-layer measurement that run-retro always emits.

The plugin also triggers a reminder via a Stop hook when a session ends naturally.

Skills

Skill	Purpose	Maturity
/wr-retrospective:run-retro	Run a session retrospective; emits the briefing update, advisory detector outputs, and the Pipeline Instability section per Step 2b	Alpha
/wr-retrospective:analyze-context	Deep on-demand context-usage analyser per ADR-043; produces per-turn attribution and trim suggestions	Experimental
/wr-retrospective:migrate-briefing	One-time idempotent migration of a legacy single-file docs/BRIEFING.md into the per-topic docs/briefing/ tree the session-start hook + Tier-3 rotation expect (ADR-040)	Experimental

Advisory scripts

Each script ships as a bin/-resolvable shim per ADR-049. They emit signal-as-data on stdout and exit 0 always (advisory per ADR-013 Rule 6). run-retro invokes them as part of Step 2b / Step 3 and surfaces their findings in the retro summary; they can also be invoked manually before a release or audit.

Shim	Purpose
wr-retrospective-check-readme-jtbd-currency	ADR-069 detector — surfaces skill-inventory drift (a shipped skill not named in the plugin's README)
wr-retrospective-check-skill-md-budgets	ADR-054 detector — flags SKILL.md files over the WARN / MUST_SPLIT byte budget
wr-retrospective-check-internal-id-leaks	ADR-055 detector — flags internal IDs leaking into published artefacts
wr-retrospective-list-plugin-attribution	Per-plugin context attribution support for analyze-context
wr-retrospective-measure-context-budget	Cheap-layer context-budget measurement support for run-retro Step 2c

How It Works

Hook	Trigger	What it does
bin/check-deps.sh	Session start	Verifies that wr-itil and wr-risk-scorer are installed
session-start-briefing.sh	Session start	Surfaces the latest docs/BRIEFING.md and any pending retrospective items so the new session begins with prior-session context (per ADR-040)
retrospective-reminder.sh	Session end	Reminds you to run a retrospective

Updating and Uninstalling

npx @windyroad/retrospective --update
npx @windyroad/retrospective --uninstall

Licence

MIT