| name | upstream-refresh |
| description | Refresh pinned upstream repos and check patch compatibility. |
Intent
Use this skill when the user wants to update local upstream checkouts from their remotes, inspect patch compatibility, or refresh one pinned upstream repo to a specific ref.
Workflow model: edit -> sync, or need newer upstream -> update -> sync.
Inputs
- Repo selection:
1541ultimate, spiffy-ultimate, or all.
- Optional explicit ref when refreshing only one repo.
Execution
- Prefer
./forge update as the operator-facing entrypoint.
- Use
./forge update all for both pinned upstream repos.
- Use
./forge update <repo> <ref> only for a single explicit branch, tag, or commit.
- Treat
update as advance upstream checkout(s) -> sync; run ./forge sync <repo|all> immediately after refresh unless the command already performed that check inline.
- Analyze the resulting sync states and advise on them rather than stopping at raw command output.
Validation
- Report the old and new upstream SHA when a checkout moved.
- Report whether sync status is
clean, upstreamed, conflict, orphaned, or retired.
- Advise next action from the state: keep working for
clean, consider pruning for upstreamed, repair and resync for conflict or orphaned.
Safety
- Do not pass an explicit ref together with
all.
- Treat conflicts after refresh as a patch-compatibility issue, not as a reason to overwrite local patches.