technical-roadmaps

refoundai/lenny-skills · updated Apr 8, 2026

$npx skills add https://github.com/refoundai/lenny-skills --skill technical-roadmaps
0 commentsdiscussion
summary

Help teams create written technical roadmaps aligned to business outcomes using structured frameworks.

  • Applies the Rumelt framework to organize strategy into three parts: Diagnosis (core technical challenge), Guiding Policies (decision-making principles), and Actions (specific initiatives)
  • Emphasizes documenting strategy in writing so it can be critiqued, improved, and aligned across teams rather than existing only in leadership's head
  • Flags common pitfalls including tool proliferati
skill.md

Technical Roadmaps

Help the user create effective technical roadmaps using frameworks and insights from 1 product leader.

How to Help

When the user asks for help with technical roadmaps:

  1. Understand the context - Ask about their current technical state, team size, and business constraints
  2. Ensure it's written down - A strategy that isn't documented can't be debugged or aligned around
  3. Apply the Rumelt framework - Structure as Diagnosis (what's the problem), Guiding Policies (principles for decisions), and Actions (what you'll do)
  4. Favor boring strategies - Help them resist the urge to introduce new tools when existing ones would suffice

Core Principles

Write it down

Will Larson: "The first rule of strategy is that if you write it down, then you can improve it. If it's not written down, it's hard to say if this PM is just not a good PM or if they're trying to apply a strategy they've misunderstood." A written strategy provides a baseline that can be critiqued and improved.

Boring strategies often win

Will Larson: "A common strategy that's really good but very boring is we only use the tools we have today. Engineers want to introduce new programming languages, new databases, new cloud providers. A really good strategy for almost all companies is we just use the standard kit we already have." Focus engineering energy on business-valued problems rather than technical novelty.

Use the Rumelt framework

Structure technical strategy using Richard Rumelt's framework: Diagnosis (what's the core challenge?), Guiding Policies (what principles will guide decisions?), and Actions (what specific things will you do?).

Create a standard kit

Define a list of approved tools, languages, and platforms. This limits technical sprawl and allows teams to focus on solving core product problems rather than reinventing infrastructure.

Questions to Help Users

  • "Is this technical strategy written down somewhere that anyone can reference?"
  • "What is the core technical challenge you're trying to solve (the diagnosis)?"
  • "What principles will guide your technical decisions (the guiding policies)?"
  • "Are you adding new tools because you need them, or because they're interesting?"
  • "What does your 'standard kit' of approved technologies look like?"
  • "How does this technical roadmap connect to business outcomes?"

Common Mistakes to Flag

  • Unwritten strategy - A strategy that only exists in someone's head can't be debugged or aligned around
  • Tool proliferation - Introducing new technologies when existing ones would work creates maintenance burden
  • No connection to business value - Technical roadmaps that don't tie to product or business outcomes lack justification
  • All diagnosis, no action - Good strategy requires specific actions, not just analysis of the problem
  • Missing guiding policies - Without principles, every technical decision becomes a debate from scratch

Deep Dive

For all 2 insights from 1 guest, see references/guest-insights.md

Related Skills

  • Managing Tech Debt
  • Platform Strategy
  • Engineering Culture
  • Prioritizing Roadmap

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.651 reviews
  • Li Brown· Dec 28, 2024

    I recommend technical-roadmaps for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Dhruvi Jain· Dec 24, 2024

    technical-roadmaps has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Ava Jackson· Dec 16, 2024

    Solid pick for teams standardizing on skills: technical-roadmaps is focused, and the summary matches what you get after install.

  • Carlos Park· Dec 12, 2024

    technical-roadmaps has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Amelia Jain· Dec 4, 2024

    technical-roadmaps is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Hassan White· Dec 4, 2024

    technical-roadmaps fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Nia Srinivasan· Nov 23, 2024

    We added technical-roadmaps from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Li Khanna· Nov 19, 2024

    Useful defaults in technical-roadmaps — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Oshnikdeep· Nov 15, 2024

    Keeps context tight: technical-roadmaps is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Aditi Thomas· Nov 7, 2024

    Registry listing for technical-roadmaps matched our evaluation — installs cleanly and behaves as described in the markdown.

showing 1-10 of 51

1 / 6