modbender Work Receipt
"If you can't explain what you did today in three sentences, you either did nothing or you did everything. Both need a receipt."
What It Does
End of your session. You've been coding for hours. Someone asks "what did you work on?" and you say "...stuff. The checkout thing. I think I fixed a bug?" Your commit messages say wip, fix, fix again, actually fix, and please work.
Work Receipt analyzes your session's artifacts — git history, file changes, test results, terminal commands — and produces a structured summary of:
- What you accomplished (shipped, fixed, built)
- What you changed (files, lines, architecture)
- What you decided (and why)
- What you left behind (TODOs, known issues, next steps)
- What it cost (time, complexity added, debt incurred)
The Receipt
╔══════════════════════════════════════════════════════════════╗
║ WORK RECEIPT ║
║ ║
║ Session: Tuesday, March 3, 2026 ║
║ Duration: 4h 22m (1:15 PM — 5:37 PM) ║
║ Branch: feature/multi-currency-checkout ║
╠══════════════════════════════════════════════════════════════╣
║ ║
║ ACCOMPLISHED: ║
║ ✓ Multi-currency tax calculation (USD, EUR, GBP, JPY) ║
║ ✓ Zero-decimal currency handling (JPY, KRW) ║
║ ✓ Tax rounding edge case for sub-cent amounts ║
║ ~ Partial: Currency conversion caching (70% complete) ║
║ ║
║ CHANGED: ║
║ ├── Modified: 6 files (+184 lines, -47 lines) ║
║ │ ├── src/checkout/tax.ts .......... +89 / -12 ║
║ │ ├── src/checkout/currency.ts ..... +42 / -8 ║
║ │ ├── src/types/currency.ts ........ +18 / -3 ║
║ │ ├── src/checkout/tax.test.ts ..... +24 / -6 ║
║ │ ├── src/checkout/currency.test.ts +11 / -18 ║
║ │ └── src/config/rates.json ........ +0 / -0 (reformatted)║
║ ├── Created: 1 file ║
║ │ └── src/checkout/decimal-precision.ts (29 lines) ║
║ └── Commits: 4 ║
║ ├── "feat: multi-currency tax calculation" ║
║ ├── "fix: zero-decimal currency handling (JPY/KRW)" ║
║ ├── "fix: sub-cent rounding edge case" ║
║ └── "wip: currency conversion caching (incomplete)" ║
║ ║
║ DECISIONS MADE: ║
║ ├── Used per-currency precision lookup (not flat decimal) ║
║ │ Reason: JPY/KRW have 0 decimals, BHD has 3 decimals ║
║ ├── Round after tax, not before ║
║ │ Reason: Rounding before creates up to 0.5% error ║
║ └── Separate decimal-precision module (not inline) ║
║ Reason: Reusable for display, export, and reporting ║
║ ║
║ TESTS: ║
║ ├── Added: 4 new tests ║
║ ├── Modified: 2 existing tests ║
║ ├── Status: 23/23 passing ✓ ║
║ └── Coverage: 91% → 94% (+3%) for checkout/ ║
║ ║
║ LEFT BEHIND: ║
║ ├── TODO: Currency conversion cache TTL (hardcoded to 1h) ║
║ ├── TODO: Add tests for BHD (3-decimal currency) ║
║ ├── WIP: Caching layer ~70% done (needs invalidation logic) ║
║ └── DEBT: No test for concurrent currency conversions ║
║ ║
║ SESSION METRICS: ║
║ ├── Complexity: Net +12 cyclomatic complexity ║
║ ├── Debt: 1 new entry (concurrent test, ~2h to fix) ║
║ ├── Dependencies: 0 new dependencies added ║
║ └── Breaking changes: 0 ║
║ ║
║ STANDUP SUMMARY: ║
║ "Implemented multi-currency tax calculation supporting ║
║ 22 currencies including zero-decimal (JPY/KRW). Fixed ║
║ rounding edge case for sub-cent amounts. Currency conversion ║
║ caching is 70% done, will finish tomorrow." ║
╚══════════════════════════════════════════════════════════════╝
What It Captures
1. Accomplishments (from commits and diffs)
SOURCE:
├── Commit messages (especially conventional commit prefixes: feat, fix, refactor)
├── Diff analysis (what changed functionally, not just syntactically)
├── Test additions (new tests = new verified behavior)
└── Branch description / PR draft
CLASSIFICATION:
├── ✓ Complete: Committed, tested, ready for review
├── ~ Partial: Work in progress, documented but unfinished
├── ✗ Abandoned: Started but reverted or stashed
└── ⟳ Refactored: Changed structure without changing behavior
2. Decisions (from code patterns and comments)
DETECTION:
├── Stashed alternatives (you tried X, went with Y)
├── TODO/FIXME comments (you noted a decision to defer)
├── Reverted commits (you chose against something)
├── Code comments with "because", "instead of", "rather than"
└── Config changes (explicit choices about values/settings)
3. What's Left (from WIP state)
DETECTION:
├── Uncommitted changes (work still in progress)
├── TODO/FIXME added during this session
├── Failing tests that were added but not yet fixed
├── Incomplete function signatures (return type is any/unknown)
├── Empty function bodies or placeholder implementations
└── WIP commits (literally "wip" in the message)
4. Cost Analysis (from code metrics)
METRICS:
├── Lines of code: net addition/reduction
├── Complexity: cyclomatic complexity change
├── Test coverage: percentage change
├── Dependencies: new libraries added
├── Debt: shortcuts taken, tests skipped, TODOs added
├── Files touched: total surface area of changes
└── Breaking changes: interface/schema modifications
Receipt Formats
Standup Format (3 sentences)
Yesterday: Implemented multi-currency tax calculation for 22 currencies.
Fixed zero-decimal currency handling and rounding edge cases.
Today: Will complete currency conversion caching and add BHD tests.
Blockers: None.
Handoff Format (for passing work to a colleague)
HANDOFF: feature/multi-currency-checkout
├── STATUS: 85% complete
├── WHAT'S DONE: Tax calc works for all currencies, fully tested
├── WHAT'S LEFT: Caching layer needs invalidation logic (see TODO in currency.ts:42)
├── WATCH OUT FOR: JPY and KRW are zero-decimal — don't assume 2 decimal places
├── DECISIONS LOCKED: Round after tax, not before. Precision lookup table in decimal-precision.ts
├── OPEN QUESTIONS: Cache TTL — 1h is a guess, may need tuning in production
└── RUN: npm test -- checkout/ (should be 23/23 green)
PR Description Format
## Multi-Currency Tax Calculation
Adds support for 22 currencies in the checkout tax calculation,
including zero-decimal currencies (JPY, KRW) and 3-decimal currencies (BHD).
### Changes
- New `decimal-precision.ts` module with per-currency precision lookup
- Updated `tax.ts` to use precision-aware calculation
- Fixed rounding: now rounds after tax application (not before)
- 4 new tests, 2 updated tests (91% → 94% coverage)
### Not Included
- Currency conversion caching (separate PR, in progress)
- Concurrent conversion tests (tracked as tech debt)
Commit Log Cleanup
When your session has messy commits, Work Receipt suggests a clean rewrite:
CURRENT COMMITS:
├── "wip"
├── "fix stuff"
├── "actually fix the thing"
└── "wip: caching maybe"
SUGGESTED REWRITE:
├── "feat: multi-currency tax calculation with precision lookup"
├── "fix: handle zero-decimal currencies (JPY, KRW) in tax calc"
├── "fix: round after tax application to prevent sub-cent errors"
└── "wip: currency conversion caching (invalidation pending)"
When to Invoke
- End of every work session. Make it a habit.
- Before standup (generate your update in 5 seconds instead of 5 minutes of remembering)
- Before creating a PR (auto-generate the description)
- Before handing off work (structured handoff instead of "uh, it's on the branch")
- End of sprint (aggregate daily receipts into sprint summary)
- When you feel like you accomplished nothing (the receipt proves otherwise)
Why It Matters
Developers consistently underestimate what they accomplished and overestimate what they have left. Without a receipt, work becomes invisible — to managers, to teammates, and to yourself.
Work Receipt makes invisible work visible. Every decision documented. Every line accounted for. Every TODO tracked.
Zero external dependencies. Zero API calls. Pure git and filesystem analysis.