Software Development
Architecture Decision Recorder
Captures significant design decisions into structured Architecture Decision Records with context, options considered, decision made, and consequences. Useful for building the decision audit trail teams need for governance and onboarding. Tech leads and architects, engineering managers documenting design choices for governance, staff engineers building institutional memory, teams preparing for regulatory audits (SOC 2 change-control evidence). then vanish. Six months later, someone wants to change the design and nobody remembers why the current approach was chosen. Without ADRs, every decision gets re-litigated from scratch or, worse, gets reversed without anyone realizing there was a reason behind it. Teams that write ADRs well spend less time in meetings and more time shipping. The reason teams do not write ADRs consistently is not that they are hard — it is that nobody owns the first draft. A structured generator produces that first draft from a conversation, leaving review and final wording to a human.
One-Time Purchase
$19.99
ADR 0005 — Adopt Drizzle ORM over Prisma
Status: Accepted · Author: Jared Mabry · Supersedes: ADR 0002 (Adopt Prisma as the default ORM)
| Field | Value | Review note |
|---|---|---|
| Decision | Adopt Drizzle | Accepted |
| Supersedes | ADR 0002 | Historical context |
| Rollback | Stop new conversions | Bounded but real cost |
Context
We adopted Prisma in 2024 (ADR 0002) for its DX. Two production incidents in the past 90 days traced back to Prisma-specific behavior — connection-pool starvation under serverless load and an unexpected schema-push during a deploy. Both were recoverable, but the root cause sat in a layer we don't control. We've outgrown the ergonomics-first ORM choice; we need a thinner SQL-builder layer with explicit query shape.
Options Considered
Option A — Status quo (Prisma)
Keep what we have
Lowest switching cost; recurring incident risk
Option B — Adopt Drizzle (chosen)
Migrate the data layer
Schema-first TypeScript, SQL-shaped queries
A third option (raw pg + a query builder) was considered briefly and rejected — too much custom tooling required to replicate the migration and type-generation story.
Decision
Adopt Drizzle as the default ORM. Migrate incrementally — new tables and new repositories on Drizzle starting this sprint; existing Prisma repositories converted as their owning teams touch them. Sunset Prisma when the last repository converts (estimated three sprints).
Consequences
Positive
Negative
Migration risk
The incremental approach means both ORMs coexist for one quarter. Code reviews must catch cases where a Drizzle repository and a Prisma repository touch the same table — transaction boundaries don't compose across the two. Add a CODEOWNERS pattern that flags any PR touching both directories.
Rollback plan
If Drizzle proves a poor fit before the third sprint, we revert by stopping new Drizzle conversions and consolidating back to Prisma. The new tables added on Drizzle would need to be re-implemented — a real but bounded cost.
This sample illustrates the skill's output format. The decision and product names are illustrative.
View full sample →
All sales final. No refunds on digital products.
Includes support for Claude Code, Codex, OpenClaw, and Google Antigravity in the same license.
Also in Architecture Decisions
Bundle price: $44. Compare this skill with the full workflow bundle or Pro access.
Best for
Staff engineers and architects capturing a real design decision after the discussion has happened — the team agreed to switch ORMs, adopt a new auth model, sunset a service — and the ADR needs to exist so the next team member doesn’t re-litigate it. Most useful in organizations where ADRs are an established practice but the first draft keeps getting deferred.
Not ideal for
Teams that don’t actually consult ADRs after writing them — the artifact becomes ceremony and the discipline collapses. Also a poor fit for decisions that haven’t been made yet; the skill records a conclusion, it doesn’t help the team converge on one.
Included in this purchase
- Claude Code, Codex, OpenClaw, and Google Antigravity skill files.
- Setup guidance for the right adapter in your workspace.
- One-time license for the purchased skill version.
Setup
Plan for a short setup in the repository or workspace where the skill will run. Some coding familiarity helps for implementation-heavy outputs.
Related Skills
$19.99
One-time license
$19.99
One-time license
$19.99
One-time license
Future Updates
This purchase includes the current version of the skill. If you want future adapter updates — meaning compatibility and packaging updates as supported platforms evolve — plus new catalog additions included automatically, upgrade to Pro.