Internal Developer Platform Architecture & Golden Paths
Design IDP architecture and golden paths for developer velocity
What You Can Do
Build scalable internal developer platform architectures that reduce cognitive load and standardize workflows for your development organization. Document golden paths that guide developers through common tasks like onboarding, deployment, and troubleshooting. Map platform capabilities, integrations, and service topology to align with your engineering scale and technical strategy.
Features
blueprint service topology, capability boundaries, and integration points
create standardized workflows for onboarding, deployment, testing, and monitoring
catalog and prioritize platform features with cross-team visibility
establish REST/GraphQL conventions, versioning, and documentation standards
assess portal UX, self-service gaps, and friction points
document connections with CI/CD, observability, security, and deployment tools
plan phased platform adoption with user feedback loops and success metrics
tailor golden paths for backend, frontend, DevOps, data, and QA roles
Example Output
IDP Architecture Blueprint
Service topology with platform layers:
- Developer Portal (self-service, golden paths, docs)
- API Gateway (auth, rate limiting, routing)
- Workflow Engine (CI/CD, deployment, observability)
- Catalog Service (service registry, templates, components)
- Integrations (GitHub, Slack, monitoring tools)
Golden Path Example: Deploy a Microservice
- Scaffold service from template → 2 min
- Add API definition (OpenAPI spec) → 5 min
- Push to GitHub → 2 min
- Auto-deploy to staging (CI/CD) → 3 min
- Promote to production with approval → 1 min
Total time: 13 minutes
Capability Roadmap
Phase 1 (Weeks 1-4): Portal, service catalog, CI/CD integration
Phase 2 (Weeks 5-8): Observability dashboards, deployment automation
Phase 3 (Weeks 9-12): Developer onboarding flow, secrets management
What's Included
- SKILL.md: Internal developer platform architecture design skill with decision frameworks
- Golden path templates: User-facing workflows for deployment, onboarding, monitoring, and troubleshooting
- Architecture decision record (ADR) template: Capture design trade-offs and rationale
- Capability prioritization worksheet: Rank platform features by impact and effort
- Developer persona definitions: Tailor UX and paths for different roles
- Integration inventory checklist: Map dependencies with CI/CD, observability, and security tools
- Rollout playbook: Phased adoption strategy with metrics and feedback loops
- Portal design checklist: UX best practices for self-service and discoverability
Who It's For
- Platform engineering teams building or scaling internal developer platforms
- Engineering leaders planning developer experience and velocity improvements
- Tech leads standardizing workflows and reducing developer toil
- DevOps and site reliability engineers architecting platform capabilities
- Technical architects designing internal tooling strategy and tech stack integration
Best For
- Designing new IDPs from scratch aligned with organizational scale and tech strategy
- Improving existing platforms by auditing architecture and identifying capability gaps
- Documenting golden paths for common developer workflows (deployment, debugging, onboarding)
- Planning IDP roadmaps with phased rollout and success metrics
- Integrating new tools into existing platforms without disrupting developer workflows
You might also like
Analyze Solidity and other smart contract code for security vulnerabilities, gas inefficiencies, and best practice violations. Get detailed reports with risk scoring, remediation suggestions, and optimization recommendations. Whether you're auditing before deployment or reviewing third-party contracts, this skill identifies critical issues faster than manual review.
You can systematically diagnose database performance bottlenecks by sharing your schema, slow query logs, and execution plans with Claude. It identifies root causes—missing indexes, inefficient joins, lock contention—and provides prioritized recommendations with ready-to-implement SQL. Skip the manual log analysis and get tuning strategies tailored to your workload.
This skill provides a structured approach to analyzing process problems, identifying root causes, and recommending capacity optimizations. You'll get clear bottleneck identification, data-driven recommendations, and a framework to validate whether your solutions actually work. Perfect for diagnosing why workflows are slow and finding the leverage points that matter most.
Use Claude to systematically analyze your database queries, execution plans, and schema to identify performance bottlenecks. The skill generates actionable optimization recommendations with SQL rewrites, index strategies, and configuration tuning. You'll receive detailed before-and-after performance analysis to validate improvements and prioritize work by impact.
This skill evaluates your research protocols against institutional review board requirements, identifies compliance gaps, and generates the documentation needed for IRB submission. You receive a detailed assessment report, risk analysis, and ready-to-use documentation templates tailored to your specific research design.
Conduct organized security assessments using Claude as your strategic partner. You'll develop comprehensive test plans, identify vulnerabilities through systematic reconnaissance, document findings with professional rigor, and map security gaps to compliance frameworks. Claude helps you maintain audit trails, prioritize risks by business impact, and generate executive reports.
You can systematically evaluate cloud platforms, document architectural decisions with tradeoffs, and validate designs against security and compliance requirements. This skill accelerates architecture reviews, ensures consistency across teams, and reduces the cycles needed to reach approval on complex infrastructure decisions.
You can architect multi-node ROS control systems from scratch, including node design patterns, communication flows, and real-time constraints. You'll debug complex node interactions using publisher/subscriber analysis, service call tracing, and action server diagnostics. You can optimize motion controllers through PID tuning, trajectory planning validation, and performance profiling to achieve precise, responsive robotic behavior.