What problem does it solve?
Manually tracking and updating multiple external reference repositories used for project architecture, UI, and API pattern guidance is time-consuming and prone to human error, especially as the number of reference codebases grows.
Core Features & Use Cases
- Configurable Repository Management: Define all reference repositories in a single JSON config file, with support for custom branches, URLs, and descriptions for each repo.
- Automated Sync Workflows: Automatically clone missing reference repos and update existing ones using fast-forward only pulls to prevent unintended merge conflicts.
- Explicit Status Reporting: Generate clear, actionable reports showing the sync status of each repo (up to date, updated, or missing) with no silent passes or assumed states.
- Use Case: A development team maintaining multiple reference codebases for architecture and UI patterns can run a single command to sync all local clones to their latest upstream versions, eliminating hours of manual git operations per sprint.
Quick Start
Use the refresh-references skill to update all configured reference repositories to their latest upstream versions.