The Architecture Prompt Pack: 15 Design Prompts
Most teams treat architecture as a technical decision. The teams that build durable products treat it as a product decision.
馃搻 Read time: 14 minutes. Use time: every time you start something new.
Why This Exists
Architecture decisions are the most expensive decisions you will make. Not because the infrastructure bills are large (they might be), but because the wrong call at the design stage compounds into every engineering sprint, every hiring decision, and every pivot you attempt later.
Most founders and PMs hand architecture off entirely to engineers, or worse, let a demo from a vendor make the call for them. The result is a system shaped by whoever was in the room, not by what the product actually needs to do. Teams that build durable products stay in the conversation. They ask better questions, earlier, and they use those questions to pressure-test assumptions before anything is committed.
This prompt pack is for that conversation. Fifteen prompts covering the decisions that matter most: how the system should be structured, what it should handle gracefully, where it will break, and when to stop architecting and start building. Use them with any capable language model. Adapt the outputs to your context. The goal is sharper thinking, not perfect answers.
How to Use This
- Run these before you finalize any technical spec. Architecture prompts do the most work in the ambiguous early stage, when nothing is locked in and the cost of changing direction is still low.
- Paste your actual context into each prompt. The more specific your inputs (user type, scale expectation, failure scenario, business constraint), the more useful the output.
- Treat the output as a starting position, not a conclusion. Use what the model surfaces to stress-test your assumptions with your engineering lead, co-founder, or a trusted technical advisor.
- Return to these prompts at inflection points. A new feature area, a scale threshold, a new integration partner: each one is a reason to re-run the relevant prompts.
The 15 Prompts
Section 1: Framing the System
Before any technical decision, you need clarity on what the system is actually supposed to do and for whom. These prompts establish that foundation.
1. The Capability Map
Use this to get a clear picture of what your product needs to do before deciding how to do it.
Prompt 1: Map the Capabilities
I am building [describe the product in one sentence]. The primary user is [describe who they are and what they are trying to accomplish].
Help me build a capability map by answering these questions:
1. What are the 5-8 core capabilities this system must support on day one?
2. Which of those capabilities are table stakes (users expect them to work, but they won't choose us for them)?
3. Which capabilities are differentiating (users pick us because of these)?
4. Which capabilities are likely to grow in complexity over time as usage scales?
5. What does each capability need to do technically: process data, store state, trigger actions, communicate with external systems, or something else?
Output this as a structured list. Flag any capability where you see a common architectural trap I should watch for.
2. The User Contract
Architecture should reflect what users actually expect from the system, not just what engineers think is reasonable.
Prompt 2: Define the User Contract
For the product I described: [paste Prompt 1 context or summarize briefly]
Help me define the implicit contract users have with this system. Specifically:
1. What response times will users consider acceptable for each major interaction (fast = under 1s, tolerable = 1-5s, okay if async = 5s+)?
2. What data do users expect to be permanent? What do they expect to be ephemeral?
3. What failure modes will users forgive (slow load, temporary error) versus what will break their trust (data loss, silent failure, wrong output)?
4. What does "the system is working" look like from the user's perspective, without them knowing anything about the underlying tech?
Use these answers to identify 3 architectural constraints I should treat as non-negotiable from the start.
3. The Constraint Stack
Every architecture operates inside a set of real constraints. Surfacing them early prevents over-engineering and under-scoping.
Prompt 3: Identify the Constraint Stack
I am building [product summary]. My current situation is:
- Team size: [engineers available now]
- Timeline to first working version: [weeks or months]
- Budget for infrastructure: [rough monthly ceiling]
- Expected initial user volume: [low / medium / high, with a rough number if known]
- Expected growth rate: [flat, steady, or spike-prone]
- Compliance or data requirements: [none / GDPR / HIPAA / SOC2 / other]
Given these constraints, help me:
1. Identify which architectural patterns would be over-engineered for my current stage.
2. Identify which shortcuts are safe to take now and which would create serious debt.
3. Suggest a starting architecture posture (simple + modular, or more structured from day one) with a clear rationale.
4. Flag the one constraint I listed that is most likely to change and explain how that change would affect the architecture.
Section 2: Making Structural Decisions
These prompts help you think through the structural choices that are hardest to reverse.
4. Monolith vs. Modular vs. Microservices
This is the decision that generates the most cargo-culting in early-stage teams. Use this prompt to make the call deliberately.
Prompt 4: Structure Decision
I need to decide on the structural approach for [product summary]. Help me think through this clearly.
1. Lay out the honest trade-offs between a well-structured monolith, a modular monolith, and a microservices approach for a product at my stage ([team size, scale expectation, timeline]).
2. For each option, describe the failure mode: what breaks first when the team grows? When traffic scales? When the product pivots?
3. Which approach does the least damage if I choose wrong early?
4. What signals would tell me it's time to migrate from the starting choice to something more distributed?
5. Give me a specific recommendation with a one-paragraph rationale, not a list of trade-offs to "consider."
5. Data Model Design
The data model is the decision that outlasts everything else. Most teams treat it as a back-end concern. It is a product concern.
Prompt 5: Pressure-Test the Data Model
Here is a rough data model for [product or feature]: [paste your schema, ER diagram description, or rough entity list].
Pressure-test it for me:
1. Which entities are likely to grow in ways I have not anticipated? What would trigger that growth?
2. Where am I storing things in a way that makes sense now but will be painful to query at scale?
3. What relationships am I treating as simple (1:1 or 1:many) that might need to become many:many later?
4. Where does this model break if I add multi-tenancy, user roles, or audit logging later?
5. What is the one change to this model that would buy me the most flexibility without adding meaningful complexity now?
6. The Integration Surface
Every external integration is a dependency you do not control. Use this prompt to map and manage that surface.
Prompt 6: Map the Integration Surface
My product integrates with or will integrate with: [list the APIs, services, or external systems].
For each integration:
1. What is the failure mode if this service goes down or rate-limits us?
2. Am I treating this as a core dependency or a nice-to-have? Is that classification correct?
3. Where should I build abstraction layers so I can swap this integration without rewriting core logic?
4. Which of these integrations is most likely to change its pricing, API terms, or availability in the next 18 months?
Then give me a dependency risk ranking: which integration poses the most risk to my product's stability and why.
7. Build vs. Buy vs. Borrow
Every team faces this at the component level. This prompt makes the reasoning explicit.
Prompt 7: Build vs. Buy vs. Borrow
I need to decide whether to build, buy, or use an open-source solution for [specific component, e.g., auth, search, billing, notifications, queues].
Context:
- My team's current engineering bandwidth: [available hours per week on this]
- How central is this component to our differentiation: [core / supporting / commodity]
- Acceptable maintenance burden: [low / medium / high]
- Budget for a paid solution: [range or constraint]
Help me:
1. List the real costs of each option (time, money, flexibility, vendor risk) for my context.
2. Identify what I give up permanently if I buy or borrow instead of building.
3. Recommend one path with a clear rationale.
4. Tell me what would have to be true about my product for the wrong answer to bite me hardest.
Section 3: Handling the Hard Cases
These prompts cover the scenarios that architecture has to plan for even if they feel unlikely right now.
8. The Failure Mode Audit
Most systems are designed for the happy path. This prompt designs for everything else.
Prompt 8: Failure Mode Audit
Here is a description of how my system handles [a specific flow or the full product]: [paste description].
Run a failure mode audit:
1. Where does this system fail silently (the user thinks something worked but it did not)?
2. Where does this system fail loudly in a way that is embarrassing or trust-destroying?
3. What happens if my primary database is unavailable for 5 minutes? 30 minutes? 2 hours?
4. What happens if a third-party API I depend on starts returning errors?
5. Where is there no fallback logic at all?
Prioritize the top 3 failure modes I should address before launch and suggest a specific mitigation for each.
9. Scale Inflection Points
You do not need to build for 10 million users on day one. You do need to know when you will have to revisit the architecture.
Prompt 9: Identify Scale Inflection Points
My product is [description]. Starting expected load is [rough number of users or requests]. We are hoping to grow to [target scale] in [timeframe].
Help me identify the inflection points where my architecture will need to change:
1. At what user or request volume does my current approach start to strain? What is the first thing that breaks?
2. What is the architectural change required at that point (add caching, shard the database, move a service out, etc.)?
3. What is the next inflection point after that, and what changes then?
4. What can I do now, at low cost, to make those future changes easier without over-engineering the current system?
5. What is the one scaling assumption I am most likely to get wrong?
10. The Multi-Tenancy Decision
If you are building B2B software, this decision shapes everything. Most teams make it too late.
Prompt 10: Multi-Tenancy Architecture
I am building a B2B product. Help me think through the multi-tenancy architecture decision.
My situation:
- Number of expected tenants in year one: [number]
- Sensitivity of customer data: [low / medium / high, and why]
- Compliance requirements: [none / GDPR / HIPAA / SOC2 / contractual isolation requirements]
- Expected variance between tenants (do they all use the same feature set, or will they diverge significantly?): [describe]
1. Walk me through the shared database (row-level), shared database (schema-per-tenant), and database-per-tenant models for my context.
2. What does each model cost me in engineering complexity, infrastructure cost, and compliance posture?
3. Which model is hardest to migrate away from later?
4. Give me a specific recommendation for my situation with a one-paragraph rationale.
11. Security Surface Review
Not a penetration test. A prompt for making sure you have thought through what needs protecting and why.
Prompt 11: Security Surface Review
Here is a description of my product and its architecture: [paste description].
Help me think through the security surface:
1. Where does user data enter the system, and is it validated and sanitized at each entry point?
2. Where are my authentication and authorization boundaries? Are there any flows where a user could access another user's data through a gap in the logic?
3. What sensitive data am I storing, and is the storage approach appropriate to the sensitivity level?
4. Where am I relying on security by obscurity (assuming attackers won't know the URL, ID format, or endpoint) instead of real access control?
5. What is the most likely attack vector for a product like mine, and have I accounted for it?
Flag the top 2 risks I should address before I have real users.
Section 4: AI-Specific Architecture
If your product uses AI components, they introduce architecture questions that traditional software does not. These prompts address them directly.
12. AI Component Boundaries
The hardest AI architecture question is not which model to use. It is where AI should and should not make decisions.
Prompt 12: Define AI Component Boundaries
My product uses AI for: [describe the AI-powered features or flows].
Help me define where the AI component boundaries should be:
1. For each AI-powered flow, what inputs does the model receive? Is that the right scope, or am I sending too much or too little context?
2. Where does the model make a decision that has a downstream effect the user cannot easily reverse? How should I handle those moments?
3. Where should I put a deterministic gate or human review step instead of letting the model decide?
4. What happens in each AI flow if the model returns a malformed output, a refusal, or a hallucinated value? Is there error handling for each case?
5. How will I know when the AI component is degrading in quality over time?
13. Context and State Management for AI Flows
AI systems that forget context destroy user trust. AI systems that retain too much create privacy and cost problems. This prompt finds the right line.
Prompt 13: Context and State Management
My product includes AI-powered flows where context matters across multiple steps or sessions.
Specifically: [describe the flow, e.g., a multi-step assistant, a document editor, a project workspace].
Help me think through context and state management:
1. What context does the model need at each step to produce a useful output? Is any of that context sensitive or user-specific?
2. How should context be stored between steps (in memory, in the prompt, in a database, via embeddings)?
3. When does accumulated context become a liability (cost, privacy, noise)? How do I handle context pruning?
4. If a user returns to this flow after 7 days, what context should I restore and how?
5. What is the failure mode if context is lost mid-flow, and how should the system recover gracefully?
14. Model Selection and Dependency Risk
Picking a model is picking a vendor. This prompt makes sure you are doing it consciously.
Prompt 14: Model Selection and Dependency Risk
I am deciding which AI model(s) to use for [describe the task or product].
My requirements:
- Output type needed: [text / structured data / code / embeddings / images / other]
- Latency requirement: [real-time / async acceptable]
- Cost sensitivity: [describe the volume of calls and budget constraint]
- Privacy and data sensitivity: [can data leave my infrastructure / must it stay on-prem]
Help me:
1. What model properties matter most for this task (context window, instruction-following, structured output reliability, speed, cost per token)?
2. Where am I at risk of vendor lock-in, and what abstraction would reduce that risk without adding unnecessary complexity?
3. What happens to my product if this model is deprecated, repriced, or quietly degraded in quality with 60 days of notice? What is my fallback?
4. Should I route everything to one model, or send different tasks to different models? What does that routing cost me in complexity and evaluation overhead?
5. Give me a specific recommendation, and name the one thing about my requirements that would change your answer.
Section 5: Knowing When to Stop
Architecture has diminishing returns, and past a certain point more design is just a way of avoiding the risk of building. This prompt tells you where that point is.
15. The Reversibility Test
Most architecture debates are about decisions that would cost a week to undo. Sorting the one-way doors from the two-way doors is how you get your time back.
Prompt 15: Run the Reversibility Test
Here is my current architecture plan for [product]: [paste the plan, or summarize every decision you have made so far].
I want to know whether I am done architecting for now or still missing something that gets expensive later.
1. Sort my decisions into one-way doors (hard or costly to reverse once there is real data and real users) and two-way doors (cheap to change later).
2. For every two-way door, tell me to stop deliberating and take the simplest option available. Name them explicitly.
3. Which one-way doors do I still not have a defensible answer for? Those are the only ones worth more design time.
4. What is the smallest thing I could build in the next two weeks that would produce real information about my riskiest assumption, rather than more opinions about it?
5. Give me a straight answer: keep designing, or start building? If it is start building, tell me what to build first and why.
Common Pitfalls
Choosing an architecture for the team you hope to have. Microservices are an organizational solution to an organizational problem. With four engineers, you do not have that problem yet. You have the opposite one.
Letting a demo make the decision. The vendor's demo is the happy path, with their data, at their scale, run by someone who built it. Your product is none of those things.
Treating the data model as a back-end detail. Nearly every other decision in this pack is reversible for longer than the data model is. Schema outlives the code that reads it, and it outlives the people who designed it.
Confusing "we might need this" with "we will need this." An abstraction you never use is not free. It is paid for every sprint, by every engineer who has to read through it to find the thing that actually runs.
Never writing down why. Six months on, nobody remembers whether the queue was a considered choice or an accident, so nobody is willing to touch it. One paragraph per major decision is the cheapest documentation you will ever write and the only kind anyone reads.
Why We Built This
Architecture is where product decisions get made by people who were never invited to the product conversation. Not out of malice. It happens because the questions arrive disguised as technical ones, and by the time the consequences surface as a product limitation, the answer is three quarters old and load-bearing.
This matters more now than it did five years ago. When writing the code was the expensive part, bad structure was partly absorbed by how long everything took. There was time to notice. Today a model will produce a clean, working implementation of the wrong architecture in an afternoon, and it will look finished. Speed does not forgive the design, it just gets you to the consequences faster.
At ProductOS, this is the problem we obsess over. Coding is becoming cheaper. Knowing what to build, and what shape it needs to be, is becoming more valuable. These prompts are the conversation we would want to have before anyone opens an editor.
If any of this lands and you want to see it in action, we're at productos.dev. No pressure. The prompt pack stands on its own.
If you'd rather have humans plus AI run this for you on a real product today, that's what 1Labs AI does.
Built by Heemang Parmar, Founder & CEO of ProductOS. 10+ years in product, 150+ builds. Also runs 1Labs AI, an AI product development agency.