Skip to content

Engineering & Creator

Free Architecture Prompts for ChatGPT

A focused, hand-built library of software architecture prompts for engineering teams. Each one is structured for an LLM - role, task, constraints, output - so you can paste it into ChatGPT or Claude and get a usable design document on the first try. Use them as written, or treat them as starting points to fork for your own playbook.

software architecture promptsarchitecture AI promptsChatGPT prompts for software architecturestaff engineer AI prompts

Senior-grade Design document

Produce a senior-level design document ready to ship.

View full prompt
Act as a senior staff engineer with 10+ years specializing in software architecture for engineering teams. I will give you the brief; you will deliver a ship-ready design document.

Brief: [PASTE BRIEF HERE].
Constraints: must be specific, measurable, and grounded in software architecture best practice. Avoid generic advice and obvious tips.

Deliver:
1. The full design document (the actual artifact, not a description of it).
2. Three sharpening notes - what you would test or improve first.
3. One contrarian angle most staff engineers miss.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureseniordeliverable
Open in ChatGPT

Critique my Design document

Tear down an existing design document and rebuild it stronger.

View full prompt
You are a brutal but constructive staff engineer reviewing my design document. Your job is to make it 2x better, not to be polite.

My design document: [PASTE HERE].
Target scalability and clarity: [STATE TARGET].
Audience: engineering teams.

Return:
- 5 specific weaknesses, each tied to scalability and clarity.
- A rewritten design document that fixes them.
- A diff-style explanation of what changed and why.

Be blunt. Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturecritiquereview
Open in ChatGPT

10 variants of a Design document

Spin 10 distinct angles for the same brief.

View full prompt
Generate 10 meaningfully different design documents from the same brief. Each variant must hit a different angle - not paraphrases.

Brief: [PASTE].
Audience: engineering teams.

For each variant provide:
- Angle name (1-3 words).
- Hook / opening line.
- Full design document.
- The single psychological lever it pulls (loss aversion, status, novelty, etc.).

End with your top pick and a one-line reason. Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturevariantsideation
Open in ChatGPT

Apply a proven software architecture framework

Run a named software architecture framework end-to-end on my situation.

View full prompt
Pick the single best-known software architecture framework for this situation, name it, then walk me through applying it to my brief step by step.

My situation: [PASTE].
Goal: scalability and clarity.

Output:
1. Framework name + 1-line origin (so I can verify).
2. Each step labelled, with my inputs filled in.
3. The resulting design document.
4. Where the framework breaks down - and what to swap in.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureframework
Open in ChatGPT

Rewrite for a different audience

Translate the same design document for three different audiences.

View full prompt
Take my existing design document and rewrite it cleanly for three distinct audiences. Keep the core promise; change the vocabulary, references, and emotional register.

My design document: [PASTE].

Audiences:
A) engineering teams (current).
B) A skeptic who has been burned before.
C) An expert peer who could spot fluff in two seconds.

For each: full rewrite + 2-line note on what shifted. Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturetranslationaudience
Open in ChatGPT

Design document in 50 words

Strip a design document to its essential 50 words.

View full prompt
Compress the strongest possible design document into exactly 50 words. Every word must earn its place.

Brief: [PASTE].
Audience: engineering teams.

Deliver:
- The 50-word design document.
- The 3 words you would protect if forced to cut to 30.
- The cheap word you almost used and why you killed it.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureconstrainttight
Open in ChatGPT

Design document optimized for discovery

Make a design document that ranks and gets shared.

View full prompt
Produce a design document that is optimized to be found and shared in the software architecture space, not just to read well.

Topic: [PASTE].
Audience: engineering teams.
Primary keyword/phrase: [PASTE].

Deliver:
- The design document, with the primary phrase used naturally in title, opener, and one mid-point anchor.
- 5 semantic keywords you wove in (and where).
- 3 share-bait one-liners I could pull as social hooks.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureseodistribution
Open in ChatGPT

Compare-and-rank matrix

Score options against the criteria that matter.

View full prompt
Build a comparison matrix that ranks options for my software architecture decision honestly.

Options: [LIST 3-6].
My priority: scalability and clarity.
Constraints: [PASTE].

Deliver:
1. A table - options × criteria - scored 1-5 with a one-line justification per cell.
2. The weighted winner.
3. The "wrong but obvious" pick most staff engineers would default to, and why it loses.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturecomparisondecision
Open in ChatGPT

Speak as the customer persona

Hear the design document through the audience's head.

View full prompt
Embody a precise engineering teams persona and react to my design document as they would, out loud.

The persona: [PASTE 3-5 traits - role, fear, current solution, last frustration].
My design document: [PASTE].

Deliver:
- 3 internal-monologue paragraphs as the persona reading the design document.
- The exact line where they would close the tab - and why.
- 2 edits that would make them keep reading.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturepersonaempathy
Open in ChatGPT

Edge-case enumeration

List the failure modes for a design document before they bite.

View full prompt
Enumerate the edge cases and failure modes that could break my design document in production / in market / in front of engineering teams.

My design document: [PASTE].
Context: software architecture.

Deliver:
- 12 edge cases, ranked by likelihood × damage.
- For each: the trigger, the symptom, and the cheapest mitigation.
- The single edge case I should design around first.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureedge-casesrisk
Open in ChatGPT

Risks & mitigations

Pressure-test a plan before committing.

View full prompt
Stress-test my software architecture plan and surface what could go wrong, with mitigations.

Plan: [PASTE].
Stakes: scalability and clarity.

Deliver:
1. 7 risks across execution, market, technical, legal, reputational.
2. For each - probability (L/M/H), impact (L/M/H), and a mitigation that costs less than the worst case.
3. The 1 risk worth accepting and the 1 risk worth killing the plan over.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureriskplanning
Open in ChatGPT

Reusable design document template

Turn a one-off into a fill-in-the-blank template.

View full prompt
Convert a great design document into a reusable template I can fill in repeatedly.

Reference design document: [PASTE].
What stays fixed: the structure and rhythm.
What varies: the inputs.

Deliver:
- The template with clearly marked [VARIABLES].
- A one-line description of each variable and example values.
- 2 worked examples using different inputs.
- The 1 line I should never let a junior change.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturetemplatereuse
Open in ChatGPT

30-day ramp plan

Go from zero to shipping in 30 days.

View full prompt
Design a 30-day plan to take me from where I am now to shipping a credible design document in software architecture.

Starting point: [PASTE].
Time available per day: [PASTE].
End state: scalability and clarity.

Deliver:
- Week 1-4 milestones (1 sentence each).
- Daily 30-minute focus for every day, grouped by week.
- The 3 things I should NOT do during these 30 days.
- The checkpoint that proves I'm on track at day 14.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureplanonboarding
Open in ChatGPT

Diagnose from symptoms

Root-cause a software architecture problem from the symptoms I see.

View full prompt
I am seeing symptoms in my software architecture work. Diagnose the most likely root causes and propose tests to confirm.

Symptoms: [LIST 3-6].
What I have already ruled out: [PASTE].
Tools available: [PASTE].

Deliver:
1. 3 candidate root causes, ranked by likelihood with a 1-line reason.
2. The fastest test to disprove each.
3. The order to run those tests, and stop conditions.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturediagnosisroot-cause
Open in ChatGPT

End-to-end workflow design

Design the design document workflow staff engineers actually run.

View full prompt
Design the end-to-end workflow a staff engineer would run to produce a high-quality design document repeatedly.

Volume target: [PASTE].
Team size: [PASTE].
Quality bar: scalability and clarity.

Deliver:
- The workflow as a numbered sequence of steps.
- For each step: input, output, owner, tool, and time-box.
- Where to insert review gates without slowing the pipeline.
- The bottleneck step and how to relieve it.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureworkflowops
Open in ChatGPT

Measurement plan & dashboard

Decide what to measure for scalability and clarity.

View full prompt
Design a measurement plan for scalability and clarity in this software architecture context.

Goal: scalability and clarity.
Audience for the dashboard: [PASTE].
Available data sources: [PASTE].

Deliver:
- The 1 north-star metric - defined precisely.
- 3 input metrics that move it, with formulas.
- 3 guardrail metrics so we don't optimize the wrong thing.
- Dashboard layout sketch (sections, charts, refresh cadence).
- The 1 vanity metric I am tempted to track and should not.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturemeasurementkpi
Open in ChatGPT

Objection handling script

Pre-empt and counter the toughest objections.

View full prompt
Build an objection-handling script for my design document aimed at engineering teams.

My offer / position: [PASTE].
The 3 most common objections I hear: [PASTE].

Deliver:
- For each objection: validate, reframe, evidence, ask.
- 2 objections I am probably not hearing but should expect.
- The single phrase to never say in response, and why.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureobjectionspersuasion
Open in ChatGPT

A/B test design

Design a clean experiment with one hypothesis.

View full prompt
Design an A/B test for my design document with one clear hypothesis.

Current design document: [PASTE].
Hypothesis (or what I'm curious about): [PASTE].
Traffic / sample size available: [PASTE].

Deliver:
- The hypothesis sharpened to one sentence.
- Variant A vs Variant B - only one variable changed.
- Primary metric and minimum detectable effect.
- Test duration and stop conditions.
- The decision rule before I peek at results.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureexperimentab-test
Open in ChatGPT

Narrative storyboard

Tell the design document as a story, beat by beat.

View full prompt
Storyboard my design document as a 7-beat narrative arc.

Subject: [PASTE].
Audience: engineering teams.
Emotional outcome I want: [PASTE].

Beats: Hook → Stakes → Conflict → Attempt → Setback → Insight → Resolution.

For each beat: 1 sentence of action + 1 sentence of feeling. End with the single image the audience walks away with. Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturestorynarrative
Open in ChatGPT

Design document glossary

Define the 20 terms anyone serious about software architecture must know.

View full prompt
Build a glossary of the 20 most important terms in software architecture as it relates to design documents and engineering teams.

For each term:
- The term.
- A precise 1-sentence definition (no jargon recursion).
- 1 concrete example.
- The most common misuse I should watch out for.

End with the 1 term that is overused and meaningless. Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureglossaryreference
Open in ChatGPT

One-page cheat sheet

Compress everything I need into one printable page.

View full prompt
Produce a one-page cheat sheet for shipping a design document in software architecture.

Audience: engineering teams.
Bias toward action, not theory.

Sections:
1. The 5-step quick path.
2. 3 hard rules (never break).
3. 3 soft rules (break with a reason).
4. Top mistake at each step.
5. The single check before publishing / shipping / sending.

Plain text, dense, under 400 words. Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturecheat-sheetreference
Open in ChatGPT

Anti-patterns to avoid

What NOT to do - with examples.

View full prompt
List the most damaging anti-patterns in software architecture when producing a design document.

Deliver:
- 8 anti-patterns.
- For each: a named label, a 1-line description, a real-sounding example of the failure, and the corrective principle.
- The anti-pattern that looks like best practice from the outside.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureanti-patternspitfalls
Open in ChatGPT

Recovery / damage-control plan

Stabilize after a software architecture mistake.

View full prompt
My design document or software architecture effort went wrong. Build me a recovery plan.

What happened: [PASTE].
Who noticed: [PASTE].
Reversibility (1=easy, 5=baked-in): [PASTE].

Deliver:
- The first 24 hours: communications and operational steps.
- The next 7 days: trust-rebuild moves.
- The 30-day move that turns this into a credibility gain.
- The 1 thing I must NOT do in the first 24 hours.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architecturerecoverycrisis
Open in ChatGPT

90-day roadmap

Map out a quarter of focused software architecture work.

View full prompt
Build a 90-day roadmap for serious progress on scalability and clarity in software architecture.

Current state: [PASTE].
End state: [PASTE].
Resources: [PASTE].

Deliver:
- Month 1 / Month 2 / Month 3 themes (1 line each).
- 3-5 outcomes per month - each measurable.
- Dependencies and the order they must clear.
- The single bet I should kill if month 1 underdelivers.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureroadmapstrategy
Open in ChatGPT

Build a swipe file

Curate the best design documents I should be learning from.

View full prompt
Build me a swipe file of exceptional design documents in software architecture to study, not copy.

My focus: scalability and clarity.
Audience I serve: engineering teams.

Deliver:
- 10 exemplary design documents (real or plausibly real) with 1-line context for each.
- For each - the one technique to steal and the one tic to avoid.
- 3 patterns that show up across most of them.
- The exemplary design document that is overrated and why.

Ask one clarifying question only if a hard blocker remains; otherwise proceed with stated assumptions. Use plain language, no fluff, no filler. Quote evidence when citing sources.
software architectureswipestudy
Open in ChatGPT

Arregla tu próximo prompt con un clic

Instala el mejorador de prompts de IA gratis para Chrome y ve la diferencia al instante.

5 prompts gratis al día. Sin tarjeta. Funciona en 11 herramientas de IA.

Instalar gratis — Arreglar mi próximo prompt