ChatGPT Prompt to Create a Software Architecture
Software architecture is the backbone of any development project. It determines maintainability, scalability, and performance of an application in the long run. Yet, designing a solid architecture requires deep expertise and a global vision that even experienced developers sometimes struggle to mobilize when faced with new constraints. ChatGPT becomes a strategic ally here: by providing it with a well-structured prompt, you get a complete architecture proposal integrating patterns adapted to your context, justified technology choices, and clearly explained trade-offs. Whether you are launching a startup, migrating a monolith to microservices, or designing a high-availability distributed system, ChatGPT helps you explore architectural options, identify technical risks upfront, and document your decisions. The goal is not to replace the architect, but to significantly accelerate the exploration and formalization phase, producing actionable deliverables from the first iteration.
Paste in your AI
Paste this prompt in ChatGPT, Claude or Gemini and customize the variables in brackets.
You are a senior software architect with 15 years of experience on large-scale distributed systems. I am developing [PROJECT_DESCRIPTION: application type, business domain, main objective]. Here are the technical and business constraints:
- Expected users: [NUMBER and PROFILE]
- Estimated load: [REQUESTS/SEC or SIMULTANEOUS_USERS]
- Infrastructure budget: [RANGE]
- Technical team: [SIZE and LEVEL]
- Regulatory constraints: [GDPR, SOC2, etc.]
Produce a complete software architecture including:
- Overview: text diagram (C4 level 2 style) showing main components and their interactions
- Technology stack: choice of each building block (language, framework, database, message broker, cache, CDN) with justification based on constraints
- Architectural patterns: selected patterns (microservices, event-driven, CQRS, hexagonal...) and why they apply here
- Data model: schema of main entities and their relationships
- Deployment strategy: containerization, orchestration, CI/CD, environments
- Watchpoints: 5 major technical risks with mitigation strategy
- ADR: 3 Architecture Decision Records for the most structuring choices
Use a technical yet accessible tone. Structure your response with clear headings and comparison tables where relevant.
Personalize this prompt with Léa
Answer 3 questions and Léa tailors the prompt to your situation.
Why this prompt works
This prompt works thanks to three key mechanisms: the role-playing of a senior architect activates the model's deep knowledge of patterns and trade-offs, the contextual variables in square brackets force the user to provide real constraints, anchoring the response in a concrete case, and the output structure in 7 numbered deliverables guarantees exhaustive coverage without rambling. Including ADRs pushes the model to explain its reasoning rather than simply listing technologies.
Use Cases
Variants
Expected Output
You get a structured architecture document including a textual component diagram, a comparison table of selected technologies with justifications, architectural patterns applied to your specific context, a data schema, a deployment strategy, and formalized ADRs. The deliverable is directly usable as a basis for discussion in architecture review or as a starting point for a Technical Architecture Document (TAD).
Frequently Asked Questions
Can ChatGPT really produce a reliable software architecture?
ChatGPT generates excellent architectural foundations by combining proven patterns and domain best practices. However, it doesn't know your organization's internal specifics (technical debt, actual team skills, political constraints). Use its proposal as a starting point for an architecture review with your team, not as a final deliverable. The more you detail your constraints in the prompt, the more relevant and directly usable the proposal will be.
How do I adapt the prompt if I'm migrating an existing system rather than starting from scratch?
Add a section to the prompt describing the current architecture: the existing tech stack, identified pain points, existing data volumes, and critical dependencies. Explicitly request a gradual migration strategy (strangler fig pattern, for example) rather than a full rewrite. Specify service continuity constraints and the available time budget for the migration. ChatGPT will then propose a step-by-step roadmap with intermediate validation milestones.
What types of diagrams can ChatGPT generate for architecture?
ChatGPT can produce diagrams in textual notation that can be rendered in various tools: Mermaid (natively supported in GitHub, Notion, and many editors), PlantUML for classic UML diagrams, and C4 notation in structured text. Specify the desired format in your prompt. For example, add 'generate the diagrams in Mermaid syntax' to get code you can directly copy into your documentation tools. For elaborate visual diagrams, export the Mermaid code to tools like draw.io or Excalidraw.
Learn more
Check the full skill on Prompt Guide to master this technique from A to Z.
View on Prompt Guide📬 Get new prompts every week
Join our newsletter and never miss a prompt.
Similar Prompts
Generate Mocks and Fixtures for Your Automated Tests
A prompt to automatically generate realistic mocks, stubs and data fixtures adapted to your test framework and use cases.
Automatically Generate Unit Tests with AI
Automatically generate an exhaustive unit test suite covering nominal cases, edge cases, and error cases for any source code.
Create a Python Automation Script
Create a professional Python automation script with CLI configuration, structured logging, error handling, and tests.
Analyze and Optimize Algorithmic Complexity
Analyze the Big O complexity of your algorithms and optimize them with appropriate data structures and more efficient algorithms.