Adr Generatorv1.0.1

A backend team is moving from MongoDB to PostgreSQL for a core service and needs to capture why the migration is happening, what alternatives were evaluated, and what trade-offs are accepted. The ADR generator analyzes git history, package files, and existing docs to reconstruct the evaluation and produce a formal ADR. This prevents the migration rationale from being lost when the original engineers rotate off the project.

A new principal engineer joins a fintech company and must quickly understand why the monolith is split into specific services, why a particular API gateway was chosen, and where the technical debt hotspots are. The ADR generator scans the repo for decision traces and turns them into ordered ADRs with an index README. This cuts onboarding time and replaces tribal knowledge with durable documentation.

A small startup is choosing between Next.js, Remix, and SvelteKit for a new product and wants a lightweight decision log even without a formal architecture team. The skill detects the chosen framework, captures the alternatives that were tested via spike branches, and writes a 1-page ADR in docs/adr/. Future hires can see exactly why the stack looks the way it does.

A healthcare SaaS platform is defining its API versioning policy and needs a defensible record for compliance and customer inquiries. The ADR generator documents the context, alternatives (URI vs header versioning), and consequences, storing it alongside the OpenAPI specs. This gives auditors and account managers a single place to point to when versioning questions arise.

A platform engineering team frequently adopts tools like Terraform, Pulumi, or ArgoCD and later forgets why older choices were made. The skill mines commits, deleted manifests, and docs to reconstruct each adoption as a numbered ADR and keeps a README index of all decisions. This avoids re-litigating dropped tools and clarifies upgrade paths.

The ADR generator is offered as a free CLI and VS Code extension for individual developers, while teams pay for a hosted dashboard, shared decision index, and PR automations. The paid tier syncs ADRs across repos and provides searchable decision history for the whole organization. This mirrors successful developer-tooling models where individual usage drives bottom-up enterprise adoption.

Consultancies bundle the skill into engagements that assess client codebases, reconstruct missing decision history, and establish an ADR practice. Deliverables include a populated docs/adr/ directory, a review process, and training for staff engineers. The tool accelerates discovery work that would otherwise consume weeks of senior architect time.

Large engineering orgs deploy the skill internally as part of their developer platform to standardize how decisions are recorded across hundreds of repos. Platform teams benefit from consistent ADR formatting, automated PR checks, and searchable institutional memory. Value is realized through reduced onboarding time, fewer repeated debates, and better audit readiness.