Development Skill
Angular Migration
Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and…
$15
Architecture Decision Records
Write and maintain Architecture Decision Records (ADRs) following best practices for technical…
A complete system for writing and maintaining Architecture Decision Records so significant technical choices are captured at the moment they're made: with context, alternatives, and consequences. It supplies five battle-tested ADR templates, lifecycle management, superseding chains, and a review process, turning scattered tribal knowledge into a searchable decision history.
$15 one-time
Add to a kit → Prices include 20% VAT. · Forged on real agency work · one-time, no lock-in
- Type Skill
- Category Development
- Delivery Email · instant
- License One-time
Inside the run · no black box
See the actual work before you buy it.
Six months from now, someone will ask why you chose Postgres. ADRs answer that at decision time, and the skill keeps the record honest and lightweight:
- Filters first: significant decisions (framework adoption, database choice, API patterns, security architecture) get an ADR; bug fixes, minor upgrades and config changes are skipped, so the record stays signal not noise.
- Writes the record at decision time, never retroactively: Context, Decision Drivers (3-5 bullets), Considered Options with honest pros and cons including the rejected ones, the Decision itself, and Consequences both positive and negative.
- Classifies reversibility per decision: Type 1 irreversible calls (DB engine change, public API release) require an RFC process and multiple stakeholder approvals; Type 2 reversible calls (library choice, cache strategy) a single engineer can take.
- Scopes the decision explicitly: the title names where it applies and a does-not-apply-to section prevents the decision from being misused outside its bounded context.
- Maintains the superseding chain: a new ADR references the old one with Supersedes, the old one gets a Superseded-by note, the index README updates, and orphan ADRs with no links are flagged in audit.
- Keeps governance lightweight on purpose: MADR format, one page maximum, adr-tools for create, supersede and table-of-contents generation; a process heavier than fifteen minutes per record never gets adopted by a team.
One power source. 6 lines out.
architecture-decision-records · core
core active · 6 lines
- ✓ documenting a significant
Documenting a significant architecture or technology choice
- ✓ recording the alternatives
Recording the alternatives considered and why they were rejected
- ✓ superseding a past decis…
Superseding a past decision with a new, properly linked ADR
- ✓ onboarding new engineers
Onboarding new engineers by giving them the decision history
- ✓ establishing a lightweight
Establishing a lightweight, repeatable decision-making process for a team
- ✓ auditing whether a past
Auditing whether a past architectural choice still holds
Yours to keep.
Drag time forward. Watch what stays.
Forever
That's what owning means.
The rented stack
ai writing tool: subscription
expired · access lostanalytics suite: subscription
expired · access lostdesign platform: subscription
expired · access lost(nothing left)
Your forge
-
Future engineers can answer why a decision was made without guessing
license: perpetual -
Reversibility analysis routes irreversible choices to the right level of review
license: perpetual -
Consistent, low-friction documentation people actually keep up
license: perpetual -
A clean superseding chain so policies never silently contradict each other
license: perpetual
subscriptions expire · deeds don't
Everything in the box.
Pick a piece up. Watch it work.
Five ADR templates: standard MADR, lightweight, Y-statement, deprecation, and RFC
6 parts · one working system · ships instantly by email
This wasn't forged for everyone.
- Not for you if you'd rather rent a tool than own one.
- Not for you if you want someone else to run your stack.
- Not for you if you're happy guessing.
Architects and engineering teams that want to capture and preserve the reasoning behind their technical decisions.
then this was forged for you.Works with
Universal by design: these run in any AI. Delivered in the open Agent Skills + MCP format (native in Claude); ChatGPT, Gemini, Cursor and Copilot adapt the same files their own way.
- Claude Native format
- ChatGPT Adapts via open standards
- Gemini Adapts via open standards
- Cursor Adapts via open standards
- Copilot Adapts via open standards
Catch what's on your mind.
the air is clear. nothing between you and the forge.
catch a spark: the forge will answer
-
We already have a year of undocumented decisions, can we start now without backfilling everything?
Yes. ADRs capture choices from the moment you adopt the practice forward, and you only retroactively write up the few past decisions still causing debate. If you ever revisit an old call, the new ADR links back to it through the superseding chain.
-
Our wiki pages rot within weeks of being written, what keeps an ADR chain from suffering the same fate?
Each ADR is immutable once accepted; you don't edit it, you supersede it with a linked replacement, so the history of why stays intact. Lifecycle states and a review step keep the chain honest instead of leaving orphaned pages.
-
Does this help me decide the architecture, or just write it down?
It's for recording the decision and its alternatives and consequences; the deciding happens elsewhere. Its value is that six months later anyone can read why you chose what you did instead of second-guessing it blind.
-
How is it delivered?
By email right after purchase: ready to run, downloaded instantly, no setup wait.
-
One-time or subscription?
A one-time purchase; no subscription or hidden fees. VAT (20%) is included.
-
Can I get a refund?
As a digital product, it can’t be refunded once downloaded. That’s why we show exactly what’s inside and who it’s for, right here.