Deadline Prep

Generate a structured demo outline from your work session. Combines the change log CSV (from the change-logger hook) with git history to create presentation-ready talking points.

Workflow

Step 1: Gather data sources

Change log (primary source if available):

Read .claude/critical_log_changes.csv if it exists
Parse columns: timestamp, tool, file_path, action, details
Group by: files created, files modified, commands executed

Git history (always available):

git log --oneline --since="today 00:00"
git diff --stat HEAD~10 2>/dev/null || git diff --stat

If the CSV doesn't exist, fall back to git-only mode and note this in the output.

Step 2: Analyze and categorize changes

Group all changes into categories:

Category	Signals
Features shipped	New files, new routes, new components, `feat` commits
Bug fixes	Modified files with `fix` commits, error handling changes
Refactors	Renamed files, structural changes, `refactor` commits
Config/Setup	package.json, tsconfig, CI/CD, Docker changes
Tests	Test files created or modified
Documentation	README, docs, comments

Step 3: Generate the demo outline

Create a structured markdown document:

# Demo Outline — [Date]

## What I Shipped
- **[Feature/Fix name]**: One sentence explaining what it does and why it matters
- **[Feature/Fix name]**: One sentence explaining what it does and why it matters
- **[Feature/Fix name]**: One sentence explaining what it does and why it matters

## Architecture Decisions
- **[Decision]**: Why I chose this approach over alternatives
- **[Decision]**: Tradeoff I made and the reasoning

## What I Would Do Next
1. **[Priority 1]**: Why this is the most important next step
2. **[Priority 2]**: What this would unlock
3. **[Priority 3]**: Nice-to-have improvement

## Session Metrics
- Files changed: X
- Lines: +Y / -Z
- Commits: N
- Key files: `path/to/important/file.ts`, `path/to/other.ts`
- Time window: HH:MM - HH:MM

Step 4: Save and present

Save the outline to .claude/demo-outline.md.

Print the full outline to the terminal so the user can review it immediately.

Tips

Run this 30 minutes before your deadline to have time to review and add personal context
The "Architecture Decisions" section is what reviewers care about most — add context about tradeoffs
"What I Would Do Next" shows you think beyond the immediate task
Edit the generated outline to add your own voice and any context the log missed
Works best with the change-logger hook installed, but functions with git history alone

deadline-prep