
Technical Roadmaps
- 1.8k installs
- 1.2k repo stars
- Updated July 16, 2026
- refoundai/lenny-skills
technical-roadmaps is an agent skill that Help users create technical roadmaps. Use when someone is planning engineering work, prioritizing tech debt, building architecture roadmaps, or aligning technical and pro.
About
The technical-roadmaps skill. Help users create technical roadmaps. Use when someone is planning engineering work, prioritizing tech debt, building architecture roadmaps, or aligning technical and product strategy. **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.
- Understand the context - Ask about their current technical state, team size, and business constraints
- Ensure it's written down - A strategy that isn't documented can't be debugged or aligned around
- Apply the Rumelt framework - Structure as Diagnosis (what's the problem), Guiding Policies (principles for decisions), a
- Favor boring strategies - Help them resist the urge to introduce new tools when existing ones would suffice
- "Is this technical strategy written down somewhere that anyone can reference?"
Technical Roadmaps by the numbers
- 1,848 all-time installs (skills.sh)
- Ranked #249 of 3,301 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
technical-roadmaps capabilities & compatibility
- Capabilities
- understand the context ask about their current · ensure it's written down a strategy that isn't · apply the rumelt framework structure as diagno · favor boring strategies help them resist the u · "is this technical strategy written down somewhe
- Use cases
- documentation · planning · orchestration
What technical-roadmaps says it does
**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.
npx skills add https://github.com/refoundai/lenny-skills --skill technical-roadmapsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.8k |
|---|---|
| repo stars | ★ 1.2k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 16, 2026 |
| Repository | refoundai/lenny-skills ↗ |
How do I apply technical-roadmaps correctly using the SKILL.md workflows and reference files?
Help users create technical roadmaps. Use when someone is planning engineering work, prioritizing tech debt, building architecture roadmaps, or aligning technical and product strategy.
Who is it for?
Developers and software engineers working with technical-roadmaps patterns from the skill documentation.
Skip if: Skip when cached docs are empty, boilerplate-only, or outside the skill documented scope.
When should I use this skill?
Help users create technical roadmaps. Use when someone is planning engineering work, prioritizing tech debt, building architecture roadmaps, or aligning technical and product strategy.
What you get
Grounded technical-roadmaps guidance with highlights, triggers, and evidence quotes from SKILL.md.
- Technical roadmap draft
- Documented constraints
- Guest insight summary
By the numbers
- Sources 1 guest with 2 mentions from Lenny Podcast transcripts
- Includes Will Larson guidance on writing strategy for organizational alignment
Files
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
Technical Roadmaps - All Guest Insights
1 guests, 2 mentions
---
Will Larson
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 the strategy that they've misunderstood... If you have a written document, even if it's not a super compelling strategy, at least you can start debugging."
Insight: A written strategy is essential for organizational alignment and provides a baseline that can be critiqued and improved.
Tactical advice:
- Document the strategy even if it is imperfect to allow for 'debugging' and alignment
- Use the Richard Rumelt framework: Diagnosis, Guiding Policies, and Actions
Timestamp: 00:18:21
---
"A common strategy that's really good but very boring is we only use the tools we have today. So a lot of times you'll get engineers that want to introduce new programming languages, new databases, new cloud providers. And a really good strategy for almost all companies is like we just use the standard kit we already have today."
Insight: Boring strategies that enforce technical constraints allow teams to focus their limited energy on solving core product problems rather than tooling.
Tactical advice:
- Create a 'standard kit' of approved tools to limit technical sprawl
- Focus engineering energy on business-valued problems rather than technical novelty
Timestamp: 00:19:39
Related skills
How it compares
Choose technical-roadmaps when you need expert-sourced engineering strategy framing rather than code-level architecture generation.
FAQ
Who is technical-roadmaps for?
Developers and software engineers working with technical-roadmaps patterns from the skill documentation.
When should I use technical-roadmaps?
Help users create technical roadmaps. Use when someone is planning engineering work, prioritizing tech debt, building architecture roadmaps, or aligning technical and product strategy.
Is technical-roadmaps safe to install?
Review the Security Audits panel on this page before installing in production.