Technical Design Doc Creator

The technical-design-doc-creator skill generates comprehensive technical design documents based on project requirements and architectural constraints. It structures output to include system diagrams, data models, API specifications, and implementation strategies for complex software initiatives.

When to use it

• Planning a new microservices architecture requiring clear service boundaries and interaction flows.
• Documenting database schema changes and migration strategies for legacy system modernization.
• Creating initial design specs for internal tools to align engineering teams before development begins.
• Drafting integration plans for third-party APIs to ensure security and compliance standards are met.

Key capabilities

• Generates structured technical documentation covering architecture, data flow, and deployment strategies.
• Produces system diagrams and visual representations of component interactions.
• Defines API endpoints, request/response formats, and authentication mechanisms.
• Outlines risk assessments, scalability considerations, and performance optimization tactics.

Example prompts

• "Create a technical design document for a real-time analytics dashboard processing 10k events per second."
• "Draft a design spec for migrating our monolithic user service to a serverless architecture using AWS Lambda."
• "Generate a comprehensive design doc including data models and API contracts for a multi-tenant SaaS platform."

Tips & gotchas

Ensure you provide detailed context about existing infrastructure, security requirements, and performance targets to maximize document relevance. The skill focuses on structural planning; always have senior engineers review generated designs before final implementation.