architecture-roadmap
Architecture Roadmap
Create strategic architecture roadmap aligned with business goals and organizational capacity.
Context
You are planning architecture evolution over next 2-4 quarters. Prioritize initiatives, estimate effort, communicate strategy to stakeholders. Read business strategy, current technical gaps, team capacity.
Domain Context
Based on strategic planning and architecture roadmapping:
- Architecture Initiatives: Major changes (migrate to microservices, refactor database, implement observability)
- Dependencies: Some initiatives block others. Database migration must complete before service redesign.
- Timeline: When should each initiative start? Capacity constraints (limited team, shared resources).
- Communication: Regular updates to stakeholders. Adapt roadmap as priorities shift.
Instructions
-
Identify Themes:
- Year 1: Foundation (infrastructure, observability, deployment automation)
- Year 2: Scale (microservices, database sharding, multi-region)
- Year 3: Maturity (compliance, security, advanced optimizations)
-
Define Initiatives (per quarter):
- Q1: "Implement centralized logging and monitoring" (2 engineers, 4 weeks)
- Q2: "Migrate from EC2 to Kubernetes" (3 engineers, 8 weeks)
- Q3: "Split monolith into microservices (Payment)" (4 engineers, 10 weeks)
-
Map Dependencies: Q1 enables Q2 (monitoring needed before K8s migration). Q2 enables Q3 (K8s for service deployment).
-
Estimate Effort: Be honest. "Migrate monolith" is 6+ months, not 2. Pad estimates; add contingency.
-
Communicate Regularly: Monthly updates to leadership. Celebrate completions. Adjust for new priorities. Show progress.
Anti-Patterns
- Roadmap Set in Stone: Never changes. Reality doesn't match plan. Result: roadmap ignored, decisions made ad-hoc. Guard: Review quarterly; adjust based on new information.
- Too Ambitious: Promise 10 initiatives in 3 months. Result: miss all deadlines, team burned out. Guard: Realistic scope; 2-3 major initiatives per quarter max.
- No Dependency Tracking: Start initiatives in wrong order, blocked by other work. Result: slow progress. Guard: Explicit dependency map; critical path analysis.
- No Communication: Roadmap exists but teams don't know. Result: surprises, resistance. Guard: Publish and discuss; gather feedback; explain trade-offs.
Further Reading
- Roadmapping in Product Management by Todd Olson — strategic planning
- The Goal by Eliyahu Goldratt — dependency and bottleneck management
- Scaling Up by Verne Harnish — organizational alignment and execution
More from sethdford/claude-skills
api-test-automation
Expert approach to api-test-automation in test automation. Use when working with .
2developer-experience-audit
Systematically assess and improve developer experience (tools, documentation, onboarding, debugging) to increase team productivity. Use in roadmapping or when noticing developer friction.
2design-rationale
Write clear design rationale connecting decisions to user needs, business goals, and principles.
1api-error-handling
HTTP status codes, error response formats, recovery guidance, and client error handling.
1interface-design
Designing minimal, cohesive, role-based interfaces that respect Interface Segregation Principle.
1design-token
Define and organize design tokens (color, spacing, typography, elevation) with naming conventions and usage guidance.
1