Agent Skills: tech-design-doc

Generate detailed technical design documents including architecture, APIs, database schemas, and implementation specifications

UncategorizedID: dikini/scaffold/tech-design-doc

Install this agent skill to your local

pnpm dlx add-skill https://github.com/dikini/scaffold/tree/HEAD/.opencode/skill/tech-design-doc

Skill Files

Browse the full folder contents for tech-design-doc.

Download Skill

Loading file tree…

.opencode/skill/tech-design-doc/SKILL.md

Skill Metadata

Name
tech-design-doc
Description
Generate detailed technical design documents including architecture, APIs, database schemas, and implementation specifications

What I do

  • Create comprehensive technical design documents from PRD requirements
  • Design system architectures with scalability and maintainability in mind
  • Generate API specifications and database schema designs
  • Provide security considerations and performance requirements
  • Create implementation guidelines and coding standards

When to use me

Use when you need to:

  • Translate business requirements into technical specifications
  • Design system architecture for new products or major features
  • Document technical decisions and implementation approaches
  • Create detailed specifications for development teams
  • Plan system integrations and API designs

How I work

  1. Requirements Analysis - Extract technical requirements from PRD
  2. Architecture Design - Create high-level system architecture and component breakdown
  3. API Design - Define interfaces, endpoints, and data contracts
  4. Database Design - Create schema designs and data relationships
  5. Security Planning - Identify security requirements and mitigation strategies
  6. Performance Planning - Define performance criteria and optimization strategies
  7. Implementation Planning - Create development guidelines and best practices
  8. Technology Selection - Recommend appropriate technology stack and tools

What I need

  • Completed PRD with functional and non-functional requirements
  • Information about existing systems or technical constraints
  • Scalability and performance requirements
  • Security and compliance requirements
  • Team technical expertise and technology preferences

What I produce

A comprehensive technical design document containing:

  • System Architecture - High-level architecture diagrams and component descriptions
  • Technology Stack - Recommended technologies with rationale
  • API Specifications - Complete API design with endpoints and data models
  • Database Design - Schema designs, relationships, and migration strategies
  • Security Architecture - Authentication, authorization, and data protection
  • Performance Design - Caching strategies, load balancing, and optimization
  • Integration Architecture - Third-party integrations and system boundaries
  • Deployment Architecture - Infrastructure, environments, and CI/CD considerations
  • Implementation Guidelines - Coding standards, patterns, and best practices
  • Testing Strategy - Unit, integration, and performance testing approaches
  • Monitoring & Observability - Logging, metrics, and alerting strategies

Usage Example

"Create a technical design document for a real-time collaborative editing platform"

This will generate a complete technical specification that architects and senior developers can use for implementation planning and team coordination.