Cheat sheet · Team Lead & Development Mindset: The Questions Behind "Why?"
Team Lead Mindset cheat sheet
Frameworks and checklists for the questions a team lead hears every week: why this choice, how long, what if it fails, and how you treat people. Think before you choose, give a reason, name the risk. Common practice and opinion, not law.
blogs · jp-blogs.vercel.app/cheatsheets/series/team-lead
The answer shapeLesson 0 →
- Goal: "We needed to ..." (the need, not the tool).
- Options: "I looked at A, B and building it."
- Choice and reason: one to three facts, not feelings.
- Risk: what could go wrong, and how you reduce it.
- Plan B: how you go back, and what it costs.
Right now I'm trying to [goal].
I know [fact]. I don't know [unknown].
My guess is [x]; I'll check it by [step].
If that is wrong, I'll try [other idea]."What are you thinking?" Say this out loud.
Watch out: "Because it is popular" is not a reason alone. Stuck? Try 30 to 60 minutes, then ask with notes of what you tried.
Why this package?Lesson 1 →
- Need: can the platform or 20 clear lines do it? Dates, parsing, crypto deserve a library.
- Alive: last release, unanswered issues, maintainers, security contact.
- Fit: TypeScript types, framework and runtime support.
- Cost: bundle size, transitive dependencies, license.
- Exit: wrap it in one small module of your own.
- Support: more than one person can read it.
- npm view PKG time.modified
- When the package last changed
- npm audit
- Known vulnerabilities
- npm outdated
- Current vs Wanted vs Latest
- npm explain PKG
- Why this is installed
Estimates and code reviewLesson 3 →
- Give a range, name the unknowns, include tests, review and deploy. Split pieces over 2 to 3 days.
- Slipping? Tell the lead the same day: done, left, why, options (cut scope, move date, add help).
- Keep estimate, target, commitment and plan apart.
| Review rule | Value |
|---|---|
| Approve when | It clearly improves code health |
| Reply within | One business day |
| Change size | About 100 lines fine, 1,000 too big |
| Weight labels | Nit:, Optional, FYI |
Tip: A good comment: what you see, why it matters, an option. Comment on the code, not the person.
Incidents and team healthLesson 4 →
- Stop the damage first: roll back, flag off.
- Name one coordinator. Send updates on a schedule.
- When stable, hold a blameless review: how did the system allow this?
- Write a few actions with an owner and a date. Check they were done.
| DORA key | Meaning |
|---|---|
| Deployment frequency | How often you release (speed) |
| Lead time for changes | Median commit to production (speed) |
| Time to restore | Median bad deploy to fix (stability) |
| Change failure rate | Failures / deploys, 1 in 4 = 25% |
Watch out: Measure the process, never rank people. Rewarded numbers get gamed.
Design docs and tool choicesLesson 5 →
# Title: the decision
Status: draft | accepted | replaced
Owner, Reviewers, Decide by: <date>
## Problem ## Goals / Non-goals
## Proposal ## Alternatives
## Risks ## Rollout / rollback
## Test plan ## Open questions- Talk first, then write a short draft with an owner. Give at least two alternatives and why not.
- Set a date for comments. Answer every one.
- Decide, record the reasons and rejected ideas.
- Language or framework: problem, team skills, hiring, ecosystem, running it at 3 a.m., how hard to undo.
- Boring by default: about three innovation tokens. Try new tools in a small spike.
- Skip the doc for tiny, reversible choices.
Debt, rewrites and team lawsLesson 6 →
- Debt is a loan with interest: take it on purpose, write it down, state the cost in business terms.
- Pay first where code changes often or breaks. Refactor in small steps with tests.
- Watch latency, traffic, errors, saturation.
| Law | Ask yourself |
|---|---|
| Conway | Do team borders match design borders? |
| Brooks | More people on a late project slows it |
| Goodhart | A measure used as a target breaks |
| Chesterton | Why does this exist? Find out first |
1:1s, feedback, delegationLesson 8 →
- Their topics first.
- Blockers: what do you need from me?
- Growth, then feedback both ways.
- Write 2 to 3 actions with names and dates.
I saw: [one specific fact]
Effect: [what it caused]
Ask: "How do you see it?"
Try: [one change], then check inHard feedback: soon, private, about the work.
- Goal / Owner
- What "done" is / one name
- Limits
- Deadline, budget, approvals
- Check-ins
- When and how
- Support
- What you give
Tip: 70/10/80: pick someone who can do 70%, teach 10%, accept 80%. Disagree before the decision, commit after.
Mentoring, onboarding, hiringLesson 9 →
| When | What |
|---|---|
| Before day 1 | Access, a buddy, a small first task |
| Week 1 | Run the README setup, ship a tiny change |
| Weeks 2 to 4 | Own a small feature, fix confusing docs |
| Months 2 to 3 | Own a bigger piece, agree goals |
- Mentor: ask "What have you tried?", give the smallest hint, say why.
- Hiring: write 4 to 6 points first, same kind of questions for all, score before the group talks.
- Prefer work-like tasks. Keep take-homes short.
Stakeholders, meetings, changeLesson 10 →
Status: on track | at risk | blocked
Done: <one line, in user terms>
Next: <one line>
Risk: <what, how likely, what we do>
Need from you: <decision, with a date>Status and ask first. Use numbers.
- Why before what. Ask: "If we ship this, what number changes?"
- Meeting: purpose, owner, agenda first, only deciders, actions with name and date.
- Cancel it if you can live with the outcome.
Tip: Change: talk to affected people one by one first, try small with a measure and a way back, set a review date.
Strategy, roadmap, build or buyLesson 12 →
| Part | Question |
|---|---|
| Diagnosis | What is the real problem? Numbers |
| Guiding policy | What rule rules options out? |
| Coherent actions | Which steps fit together? |
- Can it make someone say no? If not, it is a wish list.
- Roadmap = bets with date ranges: Now, Next, Later. Firm near, loose far.
- Buy common plumbing, build the core. Keep your own interface in front.
Watch out: Migration: tests first, run old and new side by side, set an end date, delete the old path.
Growth and promotionLesson 13 →
- Moving up means bigger scope and wider influence, not more output. Management is a different job, not a promotion.
- Promote what the person already does for several months.
| Kind | Does what |
|---|---|
| Mentorship | Advice and teaching in private |
| Sponsorship | Uses your influence in rooms they are not in |
Tip: "Not yet": name the exact gap and a next step. Promotion case: scope and impact with numbers, dated examples, feedback, honest gaps.
Security habits and AI rulesLesson 14 →
| STRIDE | Breaks |
|---|---|
| Spoofing | Authentication |
| Tampering | Integrity |
| Repudiation | Accounting (logs) |
| Info disclosure | Confidentiality |
| Denial of service | Availability |
| Elevation | Authorization |
- 30-minute threat model, then mitigate, eliminate, transfer or accept. Make tickets.
npm ciin CI,npm audit, check new package names. Leaked secret: rotate first.- AI tools: you commit it, you own it. Small changes, read every line, no secrets in prompts, agents in a sandbox.
Ownership, on-call, retrosLesson 16 →
- Team borders are an architecture choice. Keep teams small, split along the work.
- One owner per service in a catalogue. Bus factor one: name a second person.
- Page only for user-visible symptoms, one runbook per alert.
- Retro: process, not people. Check last time's actions.
- Collect in silence, group, vote.
- End with 1 to 3 actions: owner, date, check.
Interview one-linersLesson 11 →
| Question | Short answer |
|---|---|
| Why this package? | Need, options, two or three facts, risk, exit. |
| Rewrite or refactor? | Refactor in small steps. Rewrites lose old fixes. |
| Deadline will slip? | Tell the lead the same day, with options. |
| Risky shortcut asked? | Explain the risk in business words. Never trade security or law. |
| Late project, add people? | Cut scope or move the date first. |
| Trust a popular repo? | Stars show interest, not truth. Try small. |
A cheat sheet is a reminder, not a teacher. Each card links to the lesson that explains it step by step.