session-review

Extract process findings from work sessions into PR review sections.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/semantic-praxis/barwise --skill session-review-semantic-praxis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-review
Source: https://github.com/semantic-praxis/barwise/tree/main/.claude/skills/session-review
Command: npx skills add https://github.com/semantic-praxis/barwise --skill session-review-semantic-praxis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When closing a work session or opening a PR, process failures (gates that did not fire, guards with holes, corrections a human had to supply) are easily forgotten or re-described without ever being fixed. This Skill turns those observations into a structured "Session review" section of the PR body where every finding names the mechanism it landed in, or plainly states it landed nowhere. ## Core Features & Use Cases - Ledger-first repeat detection: Reads a beads issue ledger (node scripts/beads-crud.mjs list --label process) before writing, so recurring failures are flagged as repeats with issue IDs and counts instead of looking new each time. - Landing enforcement: Every entry must name a durable mechanism (CI gate, hook glob, drift test, rule file) or explicitly declare itself unlanded; remedies like "be more careful" are rejected. - Gate verification discipline: Requires watching a gate go red before claiming it works, using scripts/mutate.mjs to plant defects and confirm the check catches them. - Use Case: At the end of a debugging session where a human pointed out two missed checks, generate the PR's Session review section with each finding, why nothing caught it, and where the fix permanently landed. ## Quick Start Use the session-review skill to write the Session review section for this PR based on what went wrong in this session.

Frequently Asked Questions about session-review

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

FAQPage Schema
How do I write a session review for a pull request?▼

Write one bullet per process finding naming what happened, why nothing caught it, and where the fix landed. Run the beads ledger list command first to check whether any finding is a repeat of a previously filed issue.

What belongs in a PR session review section?▼

Process findings belong: gates that did not fire, corrections that came from a human, guards with holes, wrong defaults, and untested assumptions. The code change itself, praise, and narrative summaries do not belong.

How do I verify a CI gate actually catches failures?▼

Plant a real defect where the gate actually looks and watch it go red before trusting a green result. The mutate.mjs script automates this by refusing to proceed when anchors are missing, replacements are no-ops, or restores do not hash-match.

What counts as a landing for a process finding?▼

Legitimate landings include a CI gate, a script with a ratchet baseline, a commit hook glob, a drift test, or a rule in CLAUDE.md or AGENTS.md. A finding that lands nowhere is allowed but must say so plainly with the reason.

What should I do when a session finding repeats a previous one?▼

Name the existing ledger issue ID and the occurrence count, then either land a mechanism this session that closes the issue or escalate it to the user with a decision request. Re-describing the finding more precisely is explicitly forbidden.