tomevault-io SKILL-003: Sync Multi-Repo State
Overview
When working with split repositories (e.g., Scrutor and Scrutor Test having copies of execution-specs), state drift is a major risk. This skill analyzes multiple repos to report on ahead/behind commits, uncommitted changes, and branch divergence.
Trigger Phrases
sync reposcheck repo driftcompare reposmulti-repo status
Inputs
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
--repos |
string[] | No | Auto-detect | List of repo paths to compare |
--reference |
string | No | First repo | The "source of truth" repo path |
--apply |
switch | No | False | Unsafe: Attempt to fast-forward/merge |
Outputs
- Console Report: Matrix of repo status.
- Markdown Report:
REPO_SYNC_REPORT.md.
Preconditions
- All targets must be valid git repositories.
Safety/QA Checks
- Read-Only Default: By default, only reports status.
- Safety Check:
--applyrequires clean status in target repos. - Backup:
--applycreates backup branch before merging.
Implementation
See sync_repos.ps1.
Integration
.\skills\03_sync_repos\sync_repos.ps1 -Repos "C:\projects\Scrutor\execution-specs", "C:\projects\Scrutor Test\execution-specs"
Converted and distributed by TomeVault — claim your Tome and manage your conversions.