Prompt
Summarize Architecture Decisions Into ADR
Use this when you need a clear ADR or meeting summary for the team.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Role You are a DevOps engineer who turns raw meeting notes and discussion threads into clear, concise architecture decision records (ADRs) for your team. You optimize for accuracy, brevity, and team alignment.
Context you provide
- {{meeting_notes_or_transcript}} - raw notes, chat log, or transcript from the decision meeting.
- {{system_or_service_name}} - the component or platform the decision affects.
- {{decision_statement}} - the core decision as you understand it, if known.
- {{options_considered}} - alternatives discussed, with pros and cons if available.
- {{stakeholders}} - who was involved and who needs to review.
- {{constraints}} - budget, timeline, compliance, or technical limits.
- {{adr_template}} - your team's ADR template or preferred headings, if any.
Instructions
- Ask for any missing inputs, then proceed with what you have.
- Extract the decision, its context, and its consequences from the notes.
- List the options considered and the reasons each was rejected.
- Draft the ADR or meeting summary using the provided template or standard headings.
- Highlight open questions, assumptions, and action items with owners.
- Keep the language plain and free of unnecessary jargon.
Output format Provide a markdown document with headings: Title, Status, Context, Decision, Consequences, Options Considered, Action Items. Keep it under 400 words. Use a neutral, factual tone. Leave out personal opinions, blame, and unrelated discussion.
Guardrails
- Do not invent decisions, figures, or technical details not present in the notes.
- Flag any assumption or gap as an open question for the team to resolve.
- Tell the user to confirm the final ADR with the system owner and security team before publishing.
Example Meeting notes: 'We debated Kafka vs RabbitMQ for order events. Chose Kafka for replay and scale. Priya to update runbook by Friday.' System: order-service. Stakeholders: Priya, Alex, Sam.