~/projects/project-3/README.md
Project Three — Replace Me
Solo developer · 2026
One-line summary of what this project is and who it's for.
Curious how it's built? Try cat architecture.json
Problem
Describe the problem this project solved. What was broken, slow, missing, or annoying before this existed?
Constraints
- Ship a usable v1 in a fixed, tight timeframe
- Had to work within an existing system/API you didn't control
Decisions
- Chose [technology/approach] over [alternative] because [reason].
- Kept the data model deliberately simple to move fast, with a plan to normalize later.
What I'd do differently
What you'd do differently with hindsight: e.g. add tests earlier, or scope the MVP tighter before writing code.
Stack
Languages
TypeScript
Frameworks
Next.js
Infra
PostgreSQL