KERNEL

DECISIONS.MD

Why I chose this, in one line.

A lean ADR. Format: swapped X for Y on DD/MM because Z.

When Claude (or you) tries to revert something three months from now, this file prevents the classic well, there must be a reason, leave it there.

Only write the entry when the decision is non-obvious. Do not document the trivial.

In practice

# decisions.md

## 2026-05-18 · Hash → canonical URL in /aprenda-claude
Reason: per-item OG image needs a real route,
not just a hash. Hash routing loses the share.

## 2026-04-22 · Convex Auth instead of Clerk
Reason: one backend only, no identity bridge,
costs half on the free plan.

Related practices

This practice is part of Claude Code OS, the full blueprint of the practices that separate following a tutorial from actually working with Claude. Ler em português.