- Skills: descriptions cut to routing-hint length (1925w -> 840w), Trigger
phrases removed, Purpose collapsed, Edge cases moved to references/.
- Rule B names the decisions-log exception; "Sync the wiki" trigger dropped;
reserved sections "Four" -> "Three"; directory contract adds ckb.yaml,
docs/, tests/.
- MANUAL/CHANGELOG/OPENSPEC (EN+PL) moved to docs/; template ADRs D-0001 and
D-0002 restored from 0c06cb6 into docs/decisions/; referrers repointed.
- ckb-retrieve: rank fusion moved into scripts/retrieve_candidates.py;
Purpose states the one write it owns (query-gaps).
- tests/: fixture KB, golden JSON, smoke.sh.
- Scaffold: overview.md describes content not schema; graph/index.md names
base skills only; query-gaps.md loses its self-rotting freshness window.
- README/MANUAL/OPENSPEC/CHANGELOG ghost-writer pass in both languages.
- VERSION 1.9.0 -> 1.10.0.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
# ckb-sync-changes — edge cases
|
|
|
|
Reference material for the `ckb-sync-changes` skill. Read when a
|
|
run hits an unusual situation the main steps don't cover.
|
|
|
|
- **Nothing to do on either side** — report "already in sync," make no
|
|
commits, run no push.
|
|
- **Local changes only, remote unchanged** — commit, fast-forward push, no
|
|
merge/conflict step needed.
|
|
- **Remote changes only, local clean** — fast-forward merge, nothing to
|
|
commit, nothing to push; report "pulled N commits, nothing local to
|
|
push."
|
|
- **Push rejected twice in a row** — stop, report the raw git error, do not
|
|
force and do not retry a third time.
|
|
- **No `origin` remote configured** — handled proactively in Step 2 (ask
|
|
the user for the URL and add it), not treated as a failure.
|
|
- **User pastes an invalid or unreachable URL** — `git remote add` itself
|
|
usually still succeeds (it doesn't validate reachability); the failure
|
|
surfaces at the `git fetch origin` in Step 3. Report that raw error and
|
|
ask the user to confirm the URL rather than guessing a correction.
|
|
- **Fetch/push fails on auth/network once a remote is configured** — report
|
|
the error clearly. This skill does not manage git credentials.
|
|
|
|
---
|
|
|
|
*Licensed under the Apache License, Version 2.0 — see [LICENSE](../../../LICENSE)
|
|
at the repository root, or <http://www.apache.org/licenses/LICENSE-2.0>.*
|