Team Routing Skill

Automatically detect domain from branch names or file paths and find the appropriate reviewer.

When to Use

• Push PR mode: auto-assign reviewer
• Init mode: show domain context
• Any mode needing domain owner lookup

Phases

Phase 1: Extract Keywords

Extract domain keywords from context:

From branch name:

feature/tables-filter     → keywords: ["tables"]
fix/auth-token-expired    → keywords: ["auth"]
chore/settings-refactor   → keywords: ["settings"]

From changed files:

git diff --name-only origin/develop | head -20

Match file paths against known patterns: - apps/web/features/tables/ → "tables" - apps/api/routes/auth/ → "auth" - apps/web/features/settings/ → "settings"

Phase 2: Query Notion Domains Database

API-query-database: [Domains-DB-ID]
Filter: Keywords contains [extracted-keyword]
        OR Codebase_Paths contains [file-pattern]

Expected result: - Domain name - Topology type (stream-aligned, platform, enabling, complicated-subsystem) - Primary keywords

Phase 3: Query Team Capabilities

API-query-database: Team Capabilities
Filter: Primary_Domain matches [domain-name]
        AND Availability = "Available"
Sort: Open_PR_Count ASC

Expected result: - Person name - GitHub handle - Max Open PRs - Current Open PR count

Phase 4: Check Availability

For each candidate: 1. Query current open PRs: bash gh pr list --state open --author [github_handle] --json number | jq length 2. Compare against Max_Open_PRs threshold 3. Skip if at or over capacity

Phase 5: Fallback Logic

If no available primary owner:

1. Backup Owners: Query Skills table for overlapping skills
2. Skills Match: Match changed file extensions to skill file patterns
3. No Match: Return warning: "No available reviewer found for domain [X]"

Output

Present findings as:

## Domain Detection

**Branch:** [branch-name]
**Detected Domain:** [domain-name]
**Topology:** [stream-aligned | platform | enabling | complicated-subsystem]

### Reviewer Assignment

**Primary Owner:** @[github_handle] ([person_name])
**Availability:** [Available | At capacity (X/Y PRs)]
**Assignment:** [Assigned | Fallback to @backup | No available reviewer]

Integration

This skill is invoked by: - push-pr.mdc - Phase 1.2 (Find Reviewer) - init.mdc - Domain context display

Notion Databases Required: - Domains (keywords, codebase paths) - Team Capabilities (person, domain, availability, max PRs) - Skills (file patterns for fallback matching)