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.
You'll design and implement mobile features with architectural rigor, cross-platform considerations, and edge-case handling built-in. This skill generates complete system designs, platform-specific implementation strategies, performance optimization approaches, and testing frameworks. The output is production-ready guidance spanning iOS and Android with security, offline resilience, and deployment strategies included.
You systematically evaluate your internal developer platform across dimensions like onboarding, deployment, tooling, and documentation to identify quantifiable friction points. Claude analyzes your platform's usability, creates a friction scoring matrix, and generates a prioritized improvement roadmap ranked by team impact and implementation effort. You get a data-driven strategy to reduce developer toil and accelerate delivery.
by az9713
Design and optimize injectable formulations by analyzing your active pharmaceutical ingredient (API), selecting compatible excipients, and predicting stability outcomes. You'll receive systematic workflows that guide you through API characterization, formulation architecture, and risk mitigation—enabling faster development cycles and regulatory-ready documentation.
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.