Prompt Claude for Designing Software Architecture

Software architecture design is a fundamental step that determines a project's maintainability, scalability, and robustness. Claude excels in this area thanks to its ability to analyze complex technical constraints, propose suitable architectural patterns, and anticipate design problems before they occur in production. Whether you're starting a new project from scratch, refactoring a monolith to microservices, or evaluating different technological options, Claude can assist you at every stage of the decision-making process. By providing precise context about your constraints (team, budget, expected traffic, existing stack), you get reasoned architectural recommendations, component diagrams, structured Architecture Decision Records (ADRs), and concrete migration plans. The iterative approach with Claude allows exploring multiple alternatives, comparing their trade-offs, and converging on a solution that balances pragmatism and technical excellence. It's like having a senior software architect available constantly to challenge your ideas and enrich your thinking.

The prompt

Claude

You are a senior software architect with 15 years of experience on large-scale distributed systems. I need to design the architecture of a new system.

Project Context

Project Name: [NAME]
Description: [FUNCTIONAL DESCRIPTION IN 2-3 SENTENCES]
Target Users: [TYPE AND ESTIMATED NUMBER]
Expected Load: [REQUESTS/SECOND, CONCURRENT USERS]
Constraints: [BUDGET, TEAM, DEADLINES, REGULATORY COMPLIANCE]
Existing Stack: [TECHNOLOGIES ALREADY IN PLACE, IF APPLICABLE]

What I Expect from You

Overview: Propose an architecture with an ASCII art diagram showing main components and their interactions.
Technology Choices: For each layer (frontend, backend, database, infrastructure, messaging), recommend a technology with justification and considered alternatives.
Architectural Patterns: Identify relevant design patterns (CQRS, Event Sourcing, Saga, Circuit Breaker, etc.) and explain why they apply here.
ADR (Architecture Decision Records): Write 3 ADRs for the most structuring decisions, in the format: Context → Decision → Consequences.
Risks and Mitigations: List the top 5 architectural risks with concrete mitigation strategies.
Evolution Plan: Describe how this architecture can evolve over 6, 12, and 24 months.

Be pragmatic: prioritize simplicity when it's sufficient, and complexity only when justified by constraints.

Personalize this prompt with Léa

Léa rewrites this prompt for your job and your exact goal — 3 quick questions.

Why it works

This prompt works because it assigns a precise expert role to Claude and structures the request into concrete, actionable deliverables. The detailed context (load, constraints, stack) allows Claude to calibrate its recommendations instead of giving generic answers. The final directive on pragmatism steers Claude toward realistic solutions rather than theoretically perfect but unachievable architectures.

Expected result

You will get a complete architecture document including a component diagram, argued technology recommendations for each layer, formalized ADRs, and a progressive evolution plan. The result is directly usable as a basis for discussion with your technical team or as a reference document for development.

Variants by level

FAQ

How can I provide enough context to Claude to get a relevant architecture?

The quality of the proposed architecture directly depends on the context provided. Specify at minimum: expected number of users and peak loads, technical constraints (imposed stack, hosting, budget), non-functional requirements (latency, availability, GDPR compliance), team size and skills, and existing systems the architecture needs to integrate with. The more specific you are about your real constraints, the more actionable and realistic the recommendations will be.

Can Claude help me choose between monolith and microservices?

Yes, and it's one of its strengths. Describe your context (team size, domain complexity, deployment constraints) and explicitly ask for a comparative analysis. Claude will evaluate trade-offs in terms of operational complexity, development velocity, independent scalability, and infrastructure cost. It can also propose intermediate approaches like modular monoliths or macroservices, often more suitable than the extremes.

How to iterate with Claude to refine an architecture?

Proceed in several exchanges. Start with an initial overall proposal, then deep dive component by component. You can challenge each decision by asking 'what are the alternatives to this choice and their trade-offs?'. Submit load or failure scenarios to test the design's robustness. Also ask Claude to play the role of a critical reviewer looking for flaws in the proposed architecture. This dialectical approach yields much more robust results than a single query.

How to use this prompt

Copy the prompt with the button above.
Paste it into ChatGPT, Claude or your favorite AI assistant.
Replace the bracketed variables with your details, then refine the result.

About Prompt Guide

Prompt Guide is a free library of 4800+ ready-to-use prompts for ChatGPT, Claude and other AIs, with guides to learn prompting and tools to build and optimize your own prompts.

Prompt library Learn prompting Prompt builder Prompt optimizer

Already have a prompt?

Paste it into the Optimizer, AI improves it in 5 seconds: role, context, format. Free, no signup.

Open the Optimizer

More prompts to explore

Prompt Claude for Writing a Cover Letter

Writing a convincing cover letter is a delicate exercise that requires finding the right balance between professionalism, authenticity, and relevance.

Prompt Claude for Writing a Professional Bio

Writing a compelling professional bio is a delicate exercise that requires finding the right balance between highlighting your career and authenticity.

Prompt Claude for Writing a Sales Page

Writing an effective sales page is an exercise that combines psychology, copywriting, and business strategy. Every word counts: the hook must grab attention in less than three seconds, the body must maintain interest while building desire, and the call to action must trigger the purchase. Claude excels at this exercise thanks to its ability to structure persuasive argumentation while maintaining an authentic tone. Unlike generic approaches, Claude can adapt the sophistication level of copywriting to your audience: direct and emotional language for B2C, rational and data-driven argumentation for B2B. By providing precise context about your product, target audience, and goals, you get a complete sales page that integrates proven direct-response copywriting principles—from the AIDA formula to open loops and social proof. The result is conversion-ready text that you can refine and test quickly.

Prompt Claude for Writing a Thesis

Writing a thesis is a demanding academic exercise that requires research, analysis, structuring, and writing skills. Claude can become...

Prompt Claude for Writing an Internal Memo

Writing internal memos is a delicate exercise that requires clarity, diplomacy, and adaptation to the organizational context. Whether announcing a restructuring, celebrating a collective success, or communicating a policy change, every word counts. Claude excels in this area thanks to its ability to adjust tone, structure information hierarchically, and anticipate employee questions. By providing Claude with the precise context—nature of the announcement, target audience, company culture, and sensitivity level—you get a professional memo that respects corporate communication codes while remaining human and engaging. The AI also helps you avoid common pitfalls: excessive jargon, ambiguities that generate anxiety, or omission of essential practical information. Whether you are an HR manager, communications director, or team leader, Claude turns your rough notes into a structured, empathetic, and actionable message that your employees will read to the end.

Prompt Claude for Writing Cold Emails

Cold emailing remains one of the most powerful levers for business development, but writing messages that capture attention and generate responses is a real challenge.