Career Tracking for Engineers: One Markdown File, Zero Lost Achievements
Most engineers maintain their resume as a Google Doc or Word file that gets dusted off every few years when they start job hunting. By then it’s outdated, inconsistent, and missing half the things you’ve actually accomplished.
I took a different approach: one file, always current, always complete.
The Problem
Every time I needed my resume, I’d spend hours reconstructing what I’d done. Which projects saved the most money? What was the exact metric on that deployment improvement? Did I already list that certification?
The information existed — scattered across Jira tickets, Slack messages, performance reviews, and my own memory. But assembling it was painful every single time.
The Solution
One markdown file: career-master.md. It contains everything:
- Every role with full bullet points (not the trimmed-down resume version)
- Every metric with context (the $750K savings, the 3-day-to-30-minute improvement)
- Every project, certification, award, and skill
- The raw material I draw from when tailoring a resume for a specific role
This file is the single source of truth. My portfolio site renders from it. When I apply for a job, I pull the relevant bullets and tailor them. Nothing gets lost.
The Structure
The file follows a strict format so it’s scannable and searchable:
## Professional Experience
### Company — Title (Date Range) | Location
Description of the role.
- Bullet with metric: reduced X by Y% through Z
- Bullet with metric: saved $X through Y
---
## Key Metrics (quick reference)
| Metric | Value | Context |
|--------|-------|---------|
| AWS cost savings | $750K/year | Environment consolidation |
| Deployment time | 3 days → 30 min | CI/CD platform |
| Engineers enabled | 25+ | IaC adoption from zero |The metrics table at the bottom is the secret weapon. When a job description asks for “cost optimization experience,” I scan the table, grab the relevant numbers, and have my bullet ready.
How It Connects to My Portfolio Site
My portfolio site is built with Astro, which renders static pages from content files. The experience data on the About page mirrors the master document. When I update career-master.md with a new achievement, I update the site data to match and push — CI deploys it automatically.
It’s not fully automated (the site uses structured data, not raw markdown parsing), but the master file is always the canonical source. The site never has information that isn’t in the master file first.
The Daily Habit
The key is recording achievements when they happen, not when you need them.
Shipped a fix that improved latency by 35%? Add the bullet immediately. Completed a migration across 6 environments? Write it down that day with the exact numbers.
I keep the file in my personal vault alongside daily notes, project plans, and task tracking. When I accomplish something notable at work, it goes into the master file before I close my laptop.
Tailoring for Applications
When it’s time to apply for a role, I don’t start from scratch:
- Read the job description and identify what they value
- Scan the master file for relevant experience and metrics
- Pull the strongest bullets, adjust language to match the JD
- Export the tailored version
What used to take hours now takes 20 minutes. I’m selecting from a complete inventory, not trying to reconstruct my career from memory.
Why This Works
- Nothing gets lost. That impressive fix you shipped on a Friday afternoon? It’s captured immediately.
- Metrics are accurate. You record them when they’re fresh, not from fuzzy memory months later.
- Tailoring is fast. You’re filtering a complete list, not brainstorming from scratch.
- Your portfolio stays current. Updates flow from one source to everything else.
- It compounds. After a year, you have a comprehensive record of everything you shipped. After five years, it’s a career asset no one else has.
Start Today
You don’t need a fancy system. Create a markdown file. Add your current role and your best 3-5 bullets with real metrics. Next time you ship something notable, add it. The discipline of writing it down is the whole system.
Your career history is an asset. Treat it like one.