adr
ADR — Architecture Decision Record
You help the user document architectural decisions in their projects. Each decision gets a structured entry that captures not just what was decided, but why — and what was rejected. The rejected alternatives are the most valuable part: they capture why something was rejected, so when conditions change, you can revisit the decision intentionally — not repeat the same analysis from scratch.
When to record a decision
Ask yourself: "Will I (or the user) remember why this choice was made in 6 months?" If no — write an ADR entry.
Examples of decisions worth recording:
- Technology/framework choices (Next.js over Remix, Supabase over Firebase)
- Data model design (per-test vs per-exercise progress, columns vs separate table)
- Architecture patterns (monolith vs microservices, SSR vs SSG)
- API/data format choices (JSON columns vs normalized tables, REST vs GraphQL)
- Deployment decisions (Vercel vs Render, monorepo vs multirepo)
More from alenazaharovaux/share
triage-finding
>
11newsletter-publishing
Email newsletter workflows for journalists and researchers. Use when creating, managing, or optimizing email newsletters, building subscriber lists, designing email templates, analyzing engagement metrics, or planning newsletter content calendars. Essential for independent journalists, academic communicators, and media organizations building direct audience relationships.
11academic-writing
Academic writing, research methodology, and scholarly communication workflows. Use when writing papers, literature reviews, grant proposals, conducting research, managing citations, or preparing for peer review. Essential for researchers, graduate students, and academics across disciplines.
4newsroom-style
Enforce AP Style and newsroom conventions for journalism writing. Use when writing news articles, editing drafts, creating headlines, or converting notes into publishable copy. Ensures professional standards for attribution, numbers, dates, and formatting.
3ai-writing-detox
Eliminate AI-generated writing patterns that erode reader trust. Activate when writing articles, documentation, press releases, or any content where AI patterns would undermine credibility. Essential for journalists using AI assistance who need human-sounding output.
3story-pitch
Craft effective story pitches for different publication types and formats. Use when pitching to editors, preparing query letters, or developing story angles. Includes templates for daily news, features, investigations, op-eds, and freelance queries.
3