Repository Management Commands

Commands for managing GitHub repositories, maintaining the org inventory, and ensuring compliance.

Repository Discovery

Command	Description
gha list	List repos for a user or organization
gha route	Route PRDs/features to matching repos

Inventory Maintenance

Command	Description
gha reconcile	Reconcile YAML inventory against GitHub API
gha update-repo-inventory	Profile-based reconciliation across all accounts
gha classify	Classify repos by kind and infrastructure
gha export-docs	Export inventory as markdown documentation

Compliance and Security

Command	Description
gha audit	Audit repos for compliance issues (descriptions, config)
gha credential-scan	Scan repos for credentials and secrets

Typical Workflow

Weekly Inventory Check

1. Run gha reconcile to detect drift between YAML and GitHub
2. Run gha audit --org symphonycore-org to check compliance
3. Run gha credential-scan --no-values to audit credentials
4. Apply changes with gha reconcile --apply if drift is found

Routing a New Feature

1. Run gha route --text "description of the feature" to find the best-fit repo
2. Or run gha route --prd docs/prd-feature.md to match a full PRD
3. Review signal matching scores to confirm the recommendation