run-sync-checklisted
Install: claude install-skill Chemaclass/agnostic-ai
<!-- Generated by agnostic-ai. Do not edit this file directly; edit specs under .agnostic-ai/ and run `agnostic-ai sync`. -->
# run-sync-check
Verifies that emitted target files match what the current specs would produce.
## Steps
1. Build the binary if changed: `make build`.
2. Run `./agnostic-ai sync --check`. Exit 0 means the working tree matches the bundle.
3. If exit is non-zero, the tool prints a unified diff per drifting file.
4. Decide:
- Source edited, emitted file lags -> run `agnostic-ai sync` to refresh.
- Adapter edited, emitted files would change -> intentional. Run `agnostic-ai sync` and review the diff in `git diff`.
- Neither edited but check still drifts -> capture mode skipped reading existing files. Re-run with `agnostic-ai sync` and inspect.
5. Never edit emitted files by hand to silence the check. The next sync rewrites them.
## CI
`sync --check` is the gate. A drift exits 1 and fails the workflow. The fix is always to re-sync locally and commit, never to edit the emitted file.