session-report

name	session-report
description	Generate post-session summary with work performed, outcomes, and resource usage.
allowed-tools	Read, Bash, Glob, Grep, AskUserQuestion
argument-hint	[--since <time>] [--save]

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

Step 4: Generate Report

Display the report:

SESSION REPORT
==============

Session Window:  {since} to now ({duration} estimate)
Current Phase:   {phase_number} - {phase_name}
Current Status:  {status}

WORK PERFORMED
--------------
Commits:         {total_count}
  feat:          {feat_count}
  fix:           {fix_count}
  refactor:      {refactor_count}
  test:          {test_count}
  other:         {other_count}

Files Changed:   {file_count}
  Insertions:    +{insertions}
  Deletions:     -{deletions}

PLAN PROGRESS
-------------
{For each SUMMARY written during session:}
  Plan {NN}: {status} - {one-liner}

VERIFICATION
------------
{If VERIFICATION.md was updated:}
  Score:         {score}
  Status:        {status}
{Else:}
  No verification updates this session.

NEXT STEPS
----------
{Based on STATE.md status, suggest the logical next command:}
  - If status is "planned": /pbr:build {N}
  - If status is "executing": /pbr:build {N} (continue)
  - If status is "verifying": /pbr:review {N}
  - If status is "complete": /pbr:milestone or /pbr:plan {N+1}

Step 5: Optional Save

If --save flag was provided: CRITICAL: Create the reports directory and write the report file NOW.

1. Create directory: .planning/reports/ (if not exists)
2. Write report to .planning/reports/session-{YYYY-MM-DD-HHmm}.md
3. Display: "Report saved to {path}"

If --save was NOT provided:

• Display only. Do not write any files.

Error Handling

• No commits in time window: "No commits found since {since}. Try --since '24 hours ago'."
• No STATE.md: "No .planning directory found. Run /pbr:new-project first."
• Git not available: stop with error