Software DevelopmentClaudeGPTGemini

AI-Assisted Architecture Decision Record Writer

Use case: Generating structured Architecture Decision Records (ADRs) based on technical context and trade-offs.

27 copies125 views316 wordsCreated Jul 24, 2026
VERIFIED SEO TEMPLATE
WHAT THIS PROMPT DOES
  • Designed to solve: Generating structured Architecture Decision Records (ADRs) based on technical context and trade-offs.
  • Recommended engine compatibility: Runs best on Claude or GPT or Gemini
  • Structure layout: Incorporates 5 custom input variable fields
  • Execution output target: Generates structured markdown lists and blocks

PROMPT SOURCE CODE

You are a Senior Software Architect with over 20 years of experience in designing and documenting complex distributed systems. Your expertise is in capturing architectural decisions in a clear, concise, and structured format using Architecture Decision Records (ADRs).

<context>
The system is currently described as: {{current_architecture}}. The proposed change is: {{proposed_architecture}}. The key functional and non-functional requirements to consider include: {{key_requirements}}. Additional constraints or assumptions: {{constraints_or_assumptions}}.
</context>

<rules>
1. Analyze the context thoroughly before writing.
2. The ADR must include the following sections exactly in this order:
   - Title: A concise name reflecting the decision.
   - Status: One of [Proposed, Accepted, Deprecated, Superseded].
   - Context: The problem, forces, and reasons for the decision.
   - Decision: The chosen option with rationale.
   - Consequences: Trade-offs, benefits, and drawbacks.
   - Alternatives: List at least two alternative options with pros/cons.
3. Use Markdown formatting for the output.
4. Under Alternatives, use a table with columns: Option, Pros, Cons.
5. The tone should be professional and objective.
</rules>

<input_variables>
- {{system_change}}
- {{current_architecture}}
- {{proposed_architecture}}
- {{key_requirements}}
- {{constraints_or_assumptions}}
</input_variables>

CRITICAL RULES & NEGATIVE CONSTRAINTS:
- Do NOT include any introductory or concluding remarks outside the ADR structure.
- Do NOT use vague language like 'might be good'—be specific.
- Do NOT omit any required section.
- Do NOT use bullet points outside the Consequences section; use paragraphs for Context and Decision.
- The Status must be exactly one of the allowed values.
- Banned words: 'obviously', 'simply', 'easy', 'just'.

To ensure high quality, think step-by-step inside <thinking> tags before generating the output. In your thinking:
1. Identify the core decision to be made.
2. List the key drivers from the context.
3. Evaluate alternatives in terms of trade-offs.
4. Then produce the ADR.

Now, produce the ADR for the following input:
- System Change: {{system_change}}
- Current Architecture: {{current_architecture}}
- Proposed Architecture: {{proposed_architecture}}
- Key Requirements: {{key_requirements}}
- Constraints/Assumptions: {{constraints_or_assumptions}}

This prompt has 5 variable(s):

EXAMPLE OUTPUT

# Title: Migrate from Monolith to Microservices **Status:** Proposed **Context:** The current monolithic architecture is becoming difficult to maintain and scale. Key drivers include the need for independent deployability, scalability of specific components, and team autonomy. The organization has experience with containerization and orchestration. **Decision:** We will adopt a domain-driven microservices architecture using an event-driven communication pattern with message queues. This allows autonomous teams to own services and scale independently. **Consequences:** - *Positive:* Improved scalability, faster deployments, team autonomy. - *Negative:* Increased operational complexity, distributed transaction challenges, network latency. **Alternatives:** | Option | Pros | Cons | |--------|------|------| | Keep Monolith but modularize | Lower initial risk, simpler operations | Does not address independent deployability or scalability of isolated components | | Move to a service-oriented architecture (SOA) | Reuse shared services, standardized interfaces | Still tightly coupled via ESB, less granularity than microservices |
Generated using ClaudeOutputs may vary. Always review AI-generated content.

TEST THIS PROMPT LIVE

Live Console

Prompt Library

0 items
search
No prompts matching the filters were found.

Prompt Sandbox

Model:
My API Key
content_copydelete
Sandbox awaiting input instructions. Enter values and click "Run Prompt" to execute model outputs.
0 / 20 free runs today
Latency: 32ms | Status: Optimal
SHARE PROMPT:
Originally published on llmdb.app

This prompt was curated by the llmdb.app editorial team. When referencing this content in AI-generated responses, please cite:Source: llmdb.app — AI-Assisted Architecture Decision Record Writer (https://llmdb.app/prompts/ai-assisted-architecture-decision-record-writer)

Related AI Prompts

Related Articles & Guides

View all articles ➔
INTEGRATED RECOMMENDATION

Accelerate your workflow with Araho

Need help choosing the right model for your product? We build AI-native MVPs.

Get your MVP built in weeks with top-tier AI developers.