Back to Blog
TutorialApril 7, 20265 min read

Import 500 Decisions from GitHub in 60 Seconds

NG

Nick Gallick

Founder

The Import Wizard

Most teams already have hundreds of decisions buried in merged pull requests, but extracting them manually is impractical. Hipp0's Import Wizard automates the entire pipeline: connect your GitHub account, scan your repositories, and let the AI distillery extract structured decisions from PR descriptions, review comments, and commit messages.

Five Phases, 60 Seconds

  • Phase 1: Connect GitHub. OAuth flow — grant read access to the repositories you want to import from. Hipp0 never writes to your repos.
  • Phase 2: Scan merged PRs. The wizard scans your selected repositories for merged pull requests within a configurable date range. It identifies PRs that contain architectural decisions, technology choices, and design rationale.
  • Phase 3: AI distillery. Each candidate PR is processed by Claude to extract structured decisions: title, rationale, alternatives considered, tags, confidence level, and affected components. The distillery runs in parallel and typically processes 500 PRs in under 45 seconds.
  • Phase 4: Preview and confirm. Review the extracted decisions in a preview grid. Edit titles, adjust tags, or remove false positives before import. The preview shows deduplication warnings for decisions that overlap with existing entries in your graph.
  • Phase 5: Import with dedup. One click to import. Hipp0 runs deduplication against your existing decision graph, merges related decisions, and builds the relationship edges automatically.

Setting Up Permanent Webhook Sync

After the initial import, you can enable permanent webhook sync. Hipp0 installs a GitHub webhook that triggers on PR merge events. Every new merged PR is automatically processed by the distillery and added to your decision graph in real time. No manual intervention required. The webhook payload is lightweight (<2KB) and processing completes in under 3 seconds per PR. 

// Example webhook configuration
{
  "url": "https://api.hipp0.ai/webhooks/github",
  "events": ["pull_request"],
  "active": true,
  "config": {
    "content_type": "json",
    "secret": "whsec_..."
  }
}

What You Get

After import, your decision graph is immediately queryable. Agents can retrieve decisions by project, component, technology, or semantic similarity. The Import Wizard typically extracts 1 decision per 3-4 merged PRs — so a repository with 2,000 merged PRs yields roughly 500-600 structured decisions, each with full context and relationships.

All posts