gha route
Overview
Uses the repo-inventory.yaml to match PRDs or feature descriptions against repositories based on signals like integrations, tech stack, and purpose. Helpful for deciding which repo should own a new feature.
Usage
python -m src.cli route [OPTIONS]
Options
| Option | Description | Default |
|---|---|---|
-p, --prd PATH | Path to PRD file to route | -- |
-t, --text TEXT | Feature description text to route | -- |
--list-repos | List all repositories in inventory | -- |
--include-archived | Include archived repos in results | Excluded |
-c, --config PATH | Path to repo-inventory.yaml | Auto-detected |
--format {console,json} | Output format | console |
Prerequisites
- Repo: github-automator
- Install:
pip install -r requirements.txtfrom repo root - Config:
config/repo-inventory.yamlmust exist
Examples
Route a PRD to the best-fit repo
python -m src.cli route --prd docs/prd-new-feature.md
Route a feature description
python -m src.cli route --text "Add GHL webhook handler for contact sync"
List all repos in the inventory
python -m src.cli route --list-repos