AIOpenLibraryAIOpenLibrary
Back to Software Architecture

System Design Document Generator

Generate comprehensive system design documents (RFCs/design docs) with component architecture, data flow, API contracts, and operational considerations.

Updated Mar 11, 2026

ShareLinkedIn

Customize Your Prompt

0/6 filled

Prompt

You are a staff engineer writing a design document for a new system. Create a comprehensive design doc that a team can implement from.

System to design: [SYSTEM_DESCRIPTION]
Problem being solved: [PROBLEM]
Scale requirements: [SCALE_REQUIREMENTS]
Team context: [TEAM_CONTEXT]
Timeline: [TIMELINE]
Existing systems to integrate with: [EXISTING_SYSTEMS]

Write a design document:

## 1. Overview
- **Problem Statement**: What we're solving and for whom
- **Goals**: What success looks like (measurable)
- **Non-Goals**: What we're explicitly NOT doing (prevents scope creep)
- **Background**: Context a new team member would need

## 2. Proposed Design

### High-Level Architecture
- System component diagram (describe each box and arrow)
- Request flow for the 2-3 most important user journeys
- Data flow diagram
- Where this fits in the broader system landscape

### Detailed Design
For each major component:
- Responsibility and interfaces
- Technology choice with rationale
- Data model (key entities and relationships)
- API contracts (key endpoints, request/response shapes)

### Data Design
- Storage technology and rationale
- Schema design for core entities
- Data access patterns
- Indexing strategy
- Data retention and archival

### Infrastructure
- Deployment topology
- Scaling strategy (horizontal/vertical, auto-scaling triggers)
- Configuration management
- Environment strategy (dev, staging, prod)

## 3. Cross-Cutting Concerns
- **Security**: Authentication, authorization, encryption, secrets management
- **Observability**: Logging, metrics, tracing, alerting, dashboards
- **Error Handling**: Failure modes, retry strategies, dead letter queues, circuit breakers
- **Performance**: Latency targets, throughput targets, caching strategy

## 4. Alternatives Considered
- For each major design choice, what else was considered and why it was rejected

## 5. Risks & Mitigations
| Risk | Likelihood | Impact | Mitigation |

## 6. Implementation Plan
- Phase 1: MVP (what and when)
- Phase 2: Production hardening
- Phase 3: Scale and optimize
- Dependencies and blockers
- Migration plan (if replacing existing system)

## 7. Open Questions
- Decisions that still need to be made
- Who needs to weigh in

## 8. Appendix
- Back-of-envelope calculations (storage, throughput, cost)
- Glossary of terms
- References

Powered by Hugging Face Inference API

Pro Tips

  • Google's design doc culture is one of their biggest engineering advantages. A structured template ensures nothing critical is missed while keeping the document scannable.

References

Comments

Log in to leave a comment

More Software Architecture Prompts

🏗️Software ArchitectureNEW

Architecture Decision Record Writer

Write well-structured Architecture Decision Records (ADRs) that document the context, options considered, and rationale behind key technical decisions.

You are a principal software architect who believes that documented decisions ar...

Claude
IntermediateView prompt
🏗️Software ArchitectureNEW

Event-Driven Architecture Planner

Design event-driven systems with event sourcing, CQRS, message brokers, and eventual consistency patterns.

You are a distributed systems architect specializing in event-driven architectur...

Claude
AdvancedView prompt
🏗️Software ArchitectureNEW

Database Scaling Strategy Advisor

Design database scaling strategies with read replicas, sharding, caching layers, and polyglot persistence based on access patterns.

You are a database architect who has scaled systems from thousands to billions o...

Claude
AdvancedView prompt

You Might Also Like

✍️Writing & Content✦ Premium

Blog Post Architect

Create SEO-optimized, engaging blog posts with structured outlines, compelling hooks, and strategic keyword placement.

You are an expert content strategist and SEO specialist. Create a comprehensive ...

Claude Opus 4
IntermediateView prompt
📚Education✦ Premium

Socratic Method Tutor

Learn any concept through guided questioning that builds deep understanding instead of memorization.

You are a Socratic tutor. Your role is to help me deeply understand a concept th...

Claude Opus 4
BeginnerView prompt
📦Product Management✦ Premium

Product Requirements Document (PRD)

Generate comprehensive PRDs with user stories, acceptance criteria, technical requirements, and success metrics.

You are a senior product manager at a top tech company. Write a comprehensive PR...

Claude Opus 4
IntermediateView prompt