refresh-references

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.