# Sync Status

> Shows a summary table of divergence between cardano-parts templates and configured downstream repos, with per-file one-liner descriptions. Use to get a quick overview of sync state before or during a sync cycle.

- Skill: `input-output-hk/sync-status` (Agent Skill)
- Install (CLI): `npx skillmds@latest add input-output-hk/sync-status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/input-output-hk/sync-status/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: input-output-hk (https://skillmd.com/u/input-output-hk)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/input-output-hk/sync-status

---


# Sync Status

## Configuration

Uses `.ai/skills/sync-review/sync-config.local.json`.

## Workflow

1. **Load config**. If missing, tell the user to create one.

2. **Build the changed-files list**. Union of all files changed on the current
   branch (vs base branch) across upstream and every configured downstream:
   ```
   git diff --name-only <base-branch>...HEAD
   ```
   Auto-detect base branch per repo (`main` or `master`), or use the
   `"base_branch"` config override. Only these files are examined.

3. **Process one repo at a time**. For each downstream repo, apply that repo's
   `"exclude"` patterns to remove files, then compare the remaining files from
   the changed-files list against `templates/cardano-parts-project/`:
   - Count files that differ
   - Count files excluded by rules
   - Count files only in downstream
   - Count files only in template

4. **Output a summary table**:

   ```
   Sync Status (as of <date>)
   Template path: templates/cardano-parts-project
   Changed files in union list: 23

   Repo                    | Diverged | Excluded | Down-Only | Tmpl-Only
   ------------------------|----------|----------|-----------|----------
   cardano-playground      |       12 |        4 |         8 |         0
   ouroboros-network-ops   |        5 |        0 |         3 |         1
   ```

5. **Per-file detail**, one repo at a time. For every file from the
   changed-files list (excluding excluded files), include a short one-liner
   (under ~40 chars) hinting at what changed — a module name, script name,
   function name, or brief description like "alloy recording rules". Generate
   by scanning diff hunks for the most prominent changed symbol.

   ```
   cardano-playground — Changed Files (4 excluded by rules):
     flake/colmena.nix                  machine instance defs
     flake/nixosModules/common.nix      alloy config helper
     scripts/bash-fns.sh                sops_config fn fix
     Justfile                           new dedelegate recipe
   ```

   **IMPORTANT**: After showing each repo's detail, STOP and WAIT for the user
   to respond before continuing to the next repo. Do not proceed without user
   input.

## Important Notes

- Read-only — never modifies files.
- Unavailable repo paths show as "unavailable" rather than erroring.
- If a repo has `"rules"` or `"exclude"` entries in the config, note the
  counts in the per-repo detail.