Discover

Find and import historical decisions from your existing tools.

Overview

Your team has already made hundreds of decisions buried in Jira tickets, GitHub PRs, and Slack history. Discover uses AI to find these decisions and import them into Align.

How It Works

┌──────────────────┐     ┌──────────────────┐     ┌──────────────────┐
│   Connect        │ ──▶ │   Scan           │ ──▶ │   Review         │
│   Data Source    │     │   AI Analysis    │     │   & Import       │
└──────────────────┘     └──────────────────┘     └──────────────────┘

1. Connect — Link your Jira, GitHub, or other data source
2. Scan — Align's AI analyzes content for decision-like patterns
3. Review — You review suggested decisions
4. Import — Confirmed decisions become searchable snapshots

Supported Sources

Source	What's Scanned
Jira	Issues, comments, epics
GitHub	PRs, issues, ADRs, discussions
Linear	Issues, comments, projects
Confluence	Pages, decision logs (coming soon)
Slack	Channel history (coming soon)

Running a Discovery

Step 1: Configure Source

1. Go to Discover in Align
2. Click New Discovery
3. Select your source (e.g., Jira)
4. Configure:
   • Projects/Repos — Which ones to scan
   • Date Range — How far back to look
   • Filters — Labels, issue types, etc.

Step 2: Run Scan

1. Click Start Discovery
2. Wait for AI analysis (typically 1-5 minutes)
3. Progress is shown in real-time

Step 3: Review Results

For each suggested decision:

• Review the AI-generated summary
• Accept to import as a Decision Snapshot
• Reject if it's not actually a decision
• Edit to refine before importing

Step 4: Import

1. Select decisions to import
2. Click Import Selected
3. Decisions are now searchable in Align

What Discover Looks For

Decision Signals

Align's AI looks for patterns like:

• "We decided to..."
• "Going with option X"
• "Approved: ..."
• "After discussion, we'll..."
• "Sign-off received for..."
• "RFC accepted"

Document Patterns

• Architecture Decision Records (ADRs)
• RFCs (Request for Comments)
• Design documents
• Meeting notes with decisions
• Sign-off comments

Issue Patterns

• Issues with "decision" labels
• Closed issues with approval comments
• Epics with architectural scope
• Discussions with resolution

Discovery Settings

Date Range

Range	Best For
Last 30 days	Recent decisions, quick scan
Last 90 days	Quarter's decisions
Last year	Major architectural decisions
All time	Full historical import

Confidence Threshold

• High — Only very clear decisions (fewer false positives)
• Medium — Balanced (recommended)
• Low — More suggestions (requires more review)

Best Practices

1. Start Narrow

Begin with a specific project and recent timeframe:

Project: platform-core
Date range: Last 90 days

2. Use Filters

Focus on high-value content:

• Filter by labels: architecture, adr, decision
• Filter by issue type: Epic, Story
• Exclude: Bug, Task

3. Review Carefully

Not everything is a decision:

• ✅ "We decided to use Kubernetes" → Import
• ❌ "Discussed Kubernetes options" → Reject (no decision yet)
• ❌ "Fixed the bug" → Reject (not a decision)

4. Iterate

Run multiple discoveries:

1. First pass: High confidence, last 30 days
2. Second pass: Medium confidence, last quarter
3. Third pass: Specific projects/labels

After Import

Imported decisions:

• Appear in your Align dashboard
• Are fully searchable
• Link back to source evidence
• Can be edited and enriched