checkpoint-enhancer

name	checkpoint-enhancer
description	Enhance session checkpoints with git context and diff summaries. Use after completing significant work to enrich checkpoint.md files with repository state, recent commits, and code change summaries. Triggers include "enhance checkpoint", "update checkpoint with git", "add git context to checkpoint", or when finishing a multi-file change session.

Checkpoint Enhancer

Enriches checkpoint.md files with git repository context and code change summaries.

When to use

After completing significant work (multiple file changes, bug fixes, feature implementation), run this skill to add:

• Git branch and recent commit history
• Diff summaries for modified files
• File metadata (line counts, last modification)

Usage

Automatic (recommended)

Run the enhance script after completing work:

bash scripts/checkpoint-enhance.sh

This finds the most recent checkpoint and adds §12 (Git context) and §13 (Code changes summary).

Manual (specific checkpoint)

bash scripts/checkpoint-enhance.sh /path/to/checkpoint.md

Integration with workflow

Add to your session completion workflow:

# After committing changes
git commit -m "feat: ..."
bash scripts/checkpoint-enhance.sh

What it adds

§12 Git context

• Current branch name
• Latest commit hash and message
• Last 5 commits for context

§13 Code changes summary

• For each file referenced in §6 of the checkpoint:
  • Line count
  • Last git modification
  • Uncommitted changes (if any)

Sections added

## §12 Git context
_Git repository state at checkpoint time. Auto-generated by checkpoint-enhance.sh._

- **Branch**: `main`
- **Latest commit**: `abc1234 feat: add feature`

### Recent commits (last 5)

abc1234 feat: add feature def5678 fix: bug fix ...

## §13 Code changes summary
_Diff summaries for files referenced in this checkpoint. Auto-generated by checkpoint-enhance.sh._

- `src/train.py` (500 LOC) — last modified: abc1234 implement training
  - Uncommitted changes: 12 insertions(+), 3 deletions(-)

Idempotency

The script is idempotent — running it multiple times won't duplicate sections. It checks for existing §12/§13 sections before adding.