Bulk Import

Workflow

Import existing decisions from Notion, Confluence, GitHub ADRs, or any markdown files.

The Archaeology Problem

Most teams have years of decisions scattered across wikis, ADR folders, and documentation sites. Manually recreating them in Arbtr would take forever.

Bulk Import solves this. Export your existing docs, drop them into Arbtr, and AI extracts the decisions—complete with positions, arguments, and even relationships between them.

Supported Sources

Notion

Export your Notion workspace as Markdown and import the .zip file.

Export: Settings → Export → Markdown & CSV

Confluence

Export space as HTML or use the Markdown export plugin.

Space Settings → Content Tools → Export

GitHub ADRs

Clone your docs folder and import the .md files directly.

Works with standard ADR templates (MADR, etc.)

Any Markdown

Any .md or .txt files with decision-like content.

Best results with structured documents

How Import Works

Select Files

Click New Decision → Import from Files or press 5 from the decision type menu.

Drag and drop your .md files (or a folder of files). Max 50 files, 500KB each.

Automatic Filtering

Arbtr scans files for decision-like content using keyword matching. Files that look like meeting notes or generic docs are filtered out.

High relevance keywords:

ADR, RFC, Decision, Architecture Decision, Status, Context, Consequences

AI Extraction

For relevant files, AI extracts the decision structure—same as Magic Paste, but in batch.

Review as Drafts

Imported decisions are created as Drafts. They don't appear in the graph until you approve them.

Draft→ Hidden from graph

Approved→ Visible in graph

Approve or Delete

Review each draft. Edit if needed, then click Approve to add it to your graph, or Delete to discard.

Automatic Relationship Detection

When importing multiple files, Arbtr detects relationships between them:

Markdown links — [See ADR-001](./adr-001.md)
Title references — "As decided in the Database Choice decision..."
Explicit keywords — "supersedes", "depends on", "relates to"

Detected relationships are shown after import. You can select which ones to create.

Relationship detection also works against existing decisions in your team—not just within the import batch.

Limits

Limit	Value
Max files per import	50
Max file size	500 KB
Max total size	10 MB
Supported formats	.md, .markdown, .txt
Min content length	50 characters

Magic Paste

Governance

Command Palette