
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.
- Installs
- 1.8K
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/refoundai/lenny-skills --skill technical-roadmaps- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads technical-roadmaps automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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:
- 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), and Actions (what you'll do)
- 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
FAQ
What does the technical-roadmaps skill do?
Help users create technical roadmaps. Use when someone is planning engineering work, prioritizing tech debt, building architecture roadmaps, or aligning technical and product strategy.
How do I install technical-roadmaps?
Run npx skills add https://github.com/refoundai/lenny-skills --skill technical-roadmaps in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/technical-roadmaps/ (personal) or .claude/skills/technical-roadmaps/ (project).
Which AI agents can use technical-roadmaps?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is technical-roadmaps safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains technical-roadmaps?
It is published by refoundai in refoundai/lenny-skills. It has 1,837 recorded installs.
More from refoundai/lenny-skills
personal-productivity
refoundai/lenny-skills
Help users manage their time and tasks more effectively. Use when someone is overwhelmed with work, struggling with focus, trying to balance multiple responsibilities, or asking how to get more done.
writing-prds
refoundai/lenny-skills
Help users transform abstract ideas into actionable project specs that align engineering and design teams on the problem and success metrics.
ai-product-strategy
refoundai/lenny-skills
Help users decide where to apply AI effectively, manage the transition from deterministic to probabilistic software, and build long-term defensibility through verticalization and proprietary data.
competitive-analysis
refoundai/lenny-skills
Help users understand and respond to competition. Use when someone is positioning against competitors, evaluating market threats, running competitive war games, or deciding how much to focus on competitors versus customers.
founder-sales
refoundai/lenny-skills
Help users master the transition from product development to active selling by leveraging their unique status as founders to bridge the trust gap and define a scalable sales motion.
analyzing-user-feedback
refoundai/lenny-skills
Help users convert massive volumes of qualitative and quantitative feedback into high-confidence product decisions through rigorous synthesis and internal immersion.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.