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.csvif 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-loggerhook installed, but functions with git history alone