paqad-ai/runtime/base/skills/high-level-design/assets/hld.template.md

Spec-driven development framework — AI agents that think before they type

**High-level design for sign-off: {ticket} {title}**

**In one line:** {what changes and why it matters, one sentence}

**What changes for the user**
- {3 to 5 points, what someone will notice}

**Choices we made**
- {choice}. Why: {reason}
- {up to 4 choices}

**Not part of this change:** {one line}

**To approve:** reply *approved*{or move this ticket to *{approved_status}*}. Questions? Reply here.

---

**More detail**

**How it works for the user**
{the main situations, step by step, as a short numbered list}

**How it fits together**
{the parts involved in business words, and one flow line: A → B → C}

**Options we considered**
| Option | Why we did or didn't pick it |

**What it touches and the risks**
- {areas affected, what could go wrong, how we'll check it works}

**Open questions for you**
- {only if any; otherwise leave this section out}