/pastiche-sync

name: pastiche-sync
description: Use when refreshing `pastiche/FACT.md` after a design-system upgrade, refactor, or token change — re-runs the extractor and surfaces drift via lint. FACT-only; never touches KNOWLEDGE/WISDOM/config and never walks the user through remediation.

Pastiche — sync

Refresh FACT after the user's DS changes. Extractor regenerates `pastiche/FACT.md`; lint surfaces orphaned tags in KNOWLEDGE/WISDOM. The user remediates manually.

Preflight

1. Resolve repo root: `git rev-parse --show-toplevel`; on failure, fall back silently to cwd. Print: *"Syncing `<repo-root>/pastiche/FACT.md`."* 2. If `<repo-root>/pastiche/config.yaml` does not exist, stop: > `<repo-root>/pastiche/config.yaml` not found. Run `/pastiche-init` first.

Extract FACT

Shell: `extract-fact` (cwd = `<repo-root>`). It is on PATH via the plugin's `bin/` — do not search for it. Block on completion.

On non-zero exit, print stderr verbatim and stop. Do not run lint — FACT may be stale or unwritten. The extractor's own message (config parse error, missing input file, etc.) is the actionable surface.

On success, the extractor prints `"Wrote pastiche/FACT.md: <N> components, <M> tokens."` to stdout. Forward it as-is.

Lint self-check

Shell: `pastiche-lint` (cwd = `<repo-root>`). It is on PATH via the plugin's `bin/` — do not search for it. Block on completion.

Forward stdout (summary) verbatim. If exit is non-zero, also forward stderr (violations) verbatim. No reformatting.

Classify the outcome by exit code + stdout shape:

• **Clean** — exit 0.
• **Drift** — non-zero exit, stdout summary present.
• **Crash** — non-zero exit, no stdout summary. The lint script itself broke; this is not user-visible drift.

Sync itself never exits non-zero on lint output. Carry the classification into Close.

Close

Print exactly one of:

**Clean:** > Pastiche synced. FACT.md regenerated; no drift detected. > > Run `git diff pastiche/FACT.md` to inspect changes.

**Drift:** > Pastiche synced — FACT.md regenerated, lint surfaced drift (see violations above). > > Remediate by editing `pastiche/WISDOM.md` / `pastiche/KNOWLEDGE.md` directly, or use `/pastiche-write-wisdom` / `/pastiche-write-knowledge` to add or replace rules. Run `git diff pastiche/FACT.md` to inspect the FACT changes that triggered the drift.

**Crash:** > Pastiche synced. FACT.md was regenerated successfully, but the lint script crashed unexpectedly (output above). Report this to the pastiche maintainers. > > Run `git diff pastiche/FACT.md` to inspect changes.

Do not invoke another skill. Do not suggest `/pastiche-setup` — it is curation, not remediation.