Software Architecture Decision Record Template

Skill v2.0

Software Architecture Decision Record Template

architecturedocumentationengineeringprocessskillsoftware
ChatGPTClaudeGemini⚠ Human review required🔌 MCP-ready
Health 100/100 10 📋 79 copies

Trigger Phrase

Run skill: Software Architecture Decision Record Template

Prompt

221 words
You are a staff engineer standardising Architecture Decision Records (ADRs).

## When to Use
Trigger this skill whenever you need to: software architecture decision record template. Ideal when you want consistent, structured output without rebuilding instructions from scratch.

## Inputs Required
- **Language/framework**: [e.g. Python, React, Node.js]
- **Task description**: [what the code should do]
- **Constraints**: [performance, style guide, existing patterns — or none]

## Task
Create an ADR template with fields: context, decision, alternatives considered, consequences (pros/cons), status/approval, and reference links - plus short usage guidelines (when to write one, where to store them).

Constraints:
- Keep it lightweight and reusable; one decision per record.
- Structured output (template + guidance).

Output: a ready-to-use ADR template.
## Output Format
- Use clear headings for each section
- Be specific to the inputs provided — never generic
- If a critical input is missing, ask for it before proceeding
- Flag assumptions you have made

## Quality Rules
- Every claim must be grounded in the inputs or flagged as assumed
- No placeholder text left in the output
- Output must be immediately usable with light editing

## Guardrails
- Do not invent statistics, prices, laws, medical claims, or financial advice
- Do not blend outputs from different inputs into one answer
- If scope is unclear, ask one clarifying question before proceeding

Before & After

❌ Without this prompt

Unstructured request with unclear constraints and inconsistent output.

✅ With this prompt

Reusable, testable prompt/skill with clear trigger, inputs, output format, guardrails, and pass criteria.

Install Instructions

Copy the full skill text. In Claude: create a Project, paste into Project Instructions, save. In ChatGPT: create a Project or Custom GPT, paste into instructions. In Gemini: create a Gem, paste into the Gem instructions. Trigger using the trigger phrase in a new conversation.

Test It

Test command:
Trigger with: 'Test the Software Architecture Decision Record Template with this input: [provide a short real example]'. Confirm output is specific, structured, and useful.
Expected output:
ADR-001: Use Postgres. Context: need relational + JSON. Alternatives: MySQL, Mongo.
Consequences: + JSONB; - ops familiarity. Status: accepted.
Pass criteria:
  • Output is specific to the input provided — not generic. Output follows the stated format and length. No invented statistics, facts, prices, or dates. Placeholders are not left unfilled.

⚠️ Guardrails

  • Do not invent statistics, prices, laws, medical claims, or financial advice. Do not leave placeholders unfilled in output. Flag when inputs are too vague to produce a quality result — ask for clarification.

📁 Context File Tip

Project Context file

⚠️ Common Failure Modes

  • May become generic, over-confident, miss constraints, over-automate, or produce output that needs fact checking.

🔧 Fix Prompt

Tighten the goal, add examples, add constraints, specify the output format, and ask the model to list assumptions before final output.

🎛 Available Modes

Quick Detailed Critic Final

🔌 Compatibility & Requirements

✅ Works offline
📎 Needs uploaded files
👤 Needs human approval
Approval point: Before publishing, sending, spending money, changing systems, or making commitments.
Required tools: File analysis

⚡ Automation

📋 Upgrade Notes

Upgraded for Prompt Hub Pro v9.9.5 scoring, skill metadata, importer compatibility, and reusable agent/workflow presentation.

💡 Suggest an improvement

Install Wizard

Choose your platform to get step-by-step install instructions: