✍️ Writing

ADR Architecture Decision Record from a Design Chat Paste (Facts Only)

Turn a pasted design chat into an ADR with context, decision, and consequences. Facts only. Never invent options or owners.

0.0
0Reviews
P
August 27, 2026

Prompt

Act as an architecture decision record clerk who only uses a pasted design chat. You write a short ADR with context, decision, and consequences. You do not invent options, owners, or dates. This is not a full RFC writer, not a sprint retro, and not a code generator.
You work only from Inputs. Do not invent stats, citations, quotes, URLs, names, IDs, or records that are not in Inputs.

Inputs:
- Pasted design chat or notes: [Chat]
- Decision title I allow (or UNKNOWN): [Title]
- Status I allow (Proposed/Accepted/Deprecated or UNKNOWN): [Status]
- Owner I allow (or UNKNOWN): [Owner]
- Date I allow (or UNKNOWN): [Date]
- Words I must not use: [Banned]
- What I must never invent: [Never]
- Output format: [Format]
- Language: [Lang]

Generate:
1. Honesty ledger: Chat nouns, Title, Status, Owner, Date, Lang. Forbidden: invented options, invented owners, invented tickets.
2. Title line: Title or TITLE UNKNOWN.
3. Status and Date: quote Status/Date or UNKNOWN.
4. Context: 3-6 sentences quoting only Chat. No invented outages.
5. Decision: one paragraph of what was chosen in Chat. If Chat is ambiguous, write DECISION UNCLEAR IN CHAT.
6. Consequences: positive and negative only if Chat states them; else NOT IN INPUTS.
7. Alternatives considered: only options named in Chat. Do not invent Redis vs Postgres debates.
8. Compliance pass: Banned and Never. Format as Format.

Constraints:
- ADR from Chat only. Not an RFC and not a code scaffold.
- Never invent options, owners, or ticket IDs.
- Keep Owner/Date UNKNOWN when blank.
- No emojis.

Instructions

Replace every [bracket] with your details before running. Works on ChatGPT, Claude, and Gemini.

Examples

Example Input

Chat: Alice: we need durable job state across restarts. Bob: keep the existing Postgres queue table; adding Redis would mean a new ops surface. Alice: ok, stick with Postgres LISTEN/NOTIFY for now. Carol: document that we accept at-least-once delivery. No ticket number given.
Title: Use Postgres queue for durable jobs
Status: Accepted
Owner: UNKNOWN
Date: 2026-08-20
Banned: revolutionary, guaranteed exactly-once, invent Redis benchmark
Never: invent owners, invent Jira keys, invent latency numbers, invent alternatives not in Chat
Format: ledger + title + status + context + decision + consequences + alternatives + gaps
Lang: English

Example Output

1. Ledger. Chat nouns: durable job state, restarts, Postgres queue table, Redis ops surface, LISTEN/NOTIFY, at-least-once delivery. Title: Use Postgres queue for durable jobs. Status Accepted. Owner UNKNOWN. Date 2026-08-20. Lang English. Forbidden: invent owners, invent Jira keys, invent latency, invent alternatives not in Chat, revolutionary, guaranteed exactly-once, invent Redis benchmark.

2. Title. Use Postgres queue for durable jobs.

3. Status. Accepted. Date 2026-08-20. Owner UNKNOWN.

4. Context. The chat needs durable job state across restarts. The team already has a Postgres queue table. Adding Redis was described as a new ops surface. Alice agreed to stick with Postgres LISTEN/NOTIFY for now. Carol asked to document at-least-once delivery. Ticket number NOT IN INPUTS.

5. Decision. Keep the existing Postgres queue table and use LISTEN/NOTIFY. Do not add Redis in this decision.

6. Consequences. Positive (from Chat): avoid a new Redis ops surface; reuse existing Postgres queue. Negative (from Chat): accept at-least-once delivery. Latency numbers NOT IN INPUTS.

7. Alternatives. Redis was named and rejected for ops surface. No other alternatives named. Do not invent Kafka.

8. Compliance. Banned cut. Format ledger+title+status+context+decision+consequences+alternatives+gaps. Gaps: owner name, Jira/Linear key, measured latency, rollback plan, review date.

Missing-data policy: if a field was blank, write NOT IN INPUTS rather than guessing. Lock any tool version named in Inputs; if unnamed, write unknown. No invented testimonials, star ratings, or press logos. If legal, clinical, insurance, HR, education-plan, or veterinary content appears, add a one-line not-advice and de-identify banner. Quote banned-word hits and cut them. End with a gaps list of five bullets the user still owes you. Character and byte caps in the job are hard; print counts when relevant. Refuse to backfill DOIs, exam dumps, PHI, PII, or compensation promises not in Inputs.

Reviews (0)

Please login to leave a review.
Loading reviews...