From existing codebase to documented decisions in an afternoon.

01

Connect your GitHub repo

Link Dossier to your GitHub organisation with one OAuth flow. Select which repositories to give Dossier access to — per project, with full control.

Admin sets up once. No tokens in your codebase. Repository access is scoped per project.

02

Discover what already exists

Run Code Archaeology on any linked repository. Dossier analyses commits, PR titles, descriptions, diffs, and comments across your full git history.

Outputs draft ADRs with confidence scores. You review each one before anything is saved.

03

Review, edit, and accept

Every suggested decision enters a review queue. Accept it as-is, edit the context and consequences, or discard it in one click. Nothing publishes automatically.

Accepted ADRs are committed to your repo as Markdown files in /docs/decisions/.

04

Stay current with PR webhooks

After the initial scan, Dossier watches incoming PRs. When a PR looks architectural, it prompts your team to document it — pre-filling a draft from PR context.

One click to dismiss false positives. Configurable per project.

Ready to get started?