session-report

STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Begin executing Step 1 immediately.

/pbr:session-report -- Post-Session Summary

References: @references/ui-brand.md

You are the orchestrator for /pbr:session-report. This read-only skill generates a summary of work performed during the current session. By default it displays the report without writing files.

Step 0 -- Immediate Output

Before ANY tool calls, display this banner:

+--------------------------------------------------------------+
|  PLAN-BUILD-RUN > SESSION REPORT                             |
+--------------------------------------------------------------+

Then proceed to Step 1.

Step 1: Parse Arguments

1. Parse $ARGUMENTS for optional flags:
   • --since <time> -- git log time filter (default: "8 hours ago")
   • --save -- write report to .planning/reports/session-{date}.md
2. Compute the time window for analysis

Step 2: Gather Session Data

1. Read .planning/STATE.md for current position (phase, plan, status)
2. Count commits in time window:

   git log --oneline --since="{since}" --format="%H %s"
   

3. Get file change stats:

   git diff --stat HEAD~{commit_count}..HEAD 2>/dev/null || git diff --stat --since="{since}"
   

4. Read SUMMARY-*.md files modified during this session:

   git log --since="{since}" --diff-filter=AM --name-only --format="" -- ".planning/phases/*/SUMMARY-*.md"
   

   Extract status and key outcomes from each.
5. Check for VERIFICATION.md updates:

   git log --since="{since}" --diff-filter=AM --name-only --format="" -- ".planning/phases/*/VERIFICATION.md"
   

6. Check test results if a test command was run recently:

   git log --since="{since}" --oneline --grep="test"
   

Step 3: Compute Metrics

1. Commit breakdown: count commits by type (feat, fix, refactor, test, docs, chore)
2. File breakdown: count files by directory/category
3. Phase progress: compare STATE.md current plan vs total plans
4. Velocity: commits per hour estimate