A session wrap-up skill for Claude Code / PAI. One command at the end of a working session that:
- Retrospective — analyzes the session for friction points, missing context, and recurring patterns
- Documentation sync — audits
/docsagainst the actual codebase and updates it to match reality - Git wrap-up — a hard gate against dirty commits on
main, then a contextual commit + push - Learning capture — persists durable lessons so the next session starts faster
The goal: every session ends with accurate docs, a clean git state, and the friction of this session turned into a fix for the next one.
Drop the BetterPAI/ directory into your skills folder:
# PAI / Claude Code default
cp -r BetterPAI ~/.claude/skills/BetterPAIThen invoke it:
/betterpai # full wrap-up (default: Retrospective)
/betterpai docs # documentation audit only
/betterpai commit # commit + push only
| Workflow | What it does |
|---|---|
Retrospective (Workflows/Retrospective.md) |
Session analysis → improvement plan → (optional) TELOS review → (optional) steering-rule harvest → doc sync → commit/push → persist learnings |
SyncDocs (Workflows/SyncDocs.md) |
Standalone documentation audit (Discovery → Gap Analysis → Update → Cleanup) |
CommitAndPush (Workflows/CommitAndPush.md) |
Stage / commit / push, handles missing repo + remote gracefully |
Commit (Workflows/Commit.md) |
Bright-line gate: refuses dirty commits on main unless --force |
| DocSync.md | Shared doc-sync procedure used by both Retrospective and SyncDocs |
Several phases are PAI-specific and are clearly marked as optional in the workflow files:
- Voice notification — assumes PAI's Pulse notifier on
localhost:31337 - TELOS Review (Phase 2.5) — assumes PAI's TELOS life-framework files
- PROJECTS.md size enforcement (Phase 2.6) — assumes an auto-loaded
PROJECTS.md - Steering-rule harvest (Phase 2.7) — assumes a force-loaded steering-rules file
Outside PAI, skip those phases — the core retrospective, documentation sync, and commit-gate workflows work in any Claude Code project. Paths are written as ${PAI_DIR} (defaults to ~/.claude).
The steering-rule harvest (Phase 2.7) is inspired by Ryan Lopopolo's "Garbage Collection Day" pattern, scaled for solo use.
MIT — see LICENSE.