# Cursor fragments — vendored into consumer `.cursor/` on init/sync

Portable rules and skills for the overseer governance method. Token placeholders
(`{{repo.name}}`, etc.) are substituted from `.overseer/config.yaml` at vendoring time.

Source under `cursor/` is **tool-neutral markdown**. On `ok sync` / `ok init`:

- `rules/*` → `.cursor/rules/`
- `skills/**` → **`.cursor/skills/**` (Cursor) and `.claude/skills/**` (Claude Code)** — same bytes

Policy still lives in `policy/*.yaml` for every assistant — see root `README.md` § AI tool
compatibility. Copilot and paste-only tools use `ok` CLI + `docs/CHECK-OK.md`.

| Path | Purpose |
| --- | --- |
| `rules/governance-sync.mdc` | SD-17 mandatory roadmap + handover sync |
| `rules/tier-authority.mdc` | Tier 1/2/3 when to act vs ask |
| `rules/no-docs-only-pr-to-main.mdc` | Docs-only PR guard (configurable per consumer) |
| `skills/governance-sync/SKILL.md` | Session-end hygiene agent workflow |
| `skills/freeze-review/SKILL.md` | Single-pass frozen spec review before Auto build (§6) |
| `skills/freeze-review-loop/SKILL.md` | **Optional** bounded loop until freeze `pass` |
| `skills/build-verification-review/SKILL.md` | **Mandatory** post-build honesty review |
| `skills/check-ok/SKILL.md` | **Check OK** — ad-hoc honesty (`/check-ok`, `ok check-ok`) |
| `skills/print-next/SKILL.md` | **Print NEXT** — closeout CURRENT NEXT from disk (`ok next`) |
| `rules/build-verification-required.mdc` | Always-on: no DONE without build-verification `pass` |
| `rules/check-ok-thinking.mdc` | Always-on: Thinking sessions get freeze + BV gates |
| `rules/print-next-closeout.mdc` | Always-on: final reply includes CURRENT NEXT after living-doc writes |
| `automations/*.json` | Optional Automation templates (not auto-enabled; **Tier 2** confirm-once to enable) |
| `automations/governance-sync-session-end.json` | Session-end `ok governance-sync --dry-run` (GFG; degrade to CLI/skill) |
| `automations/freeze-review-session-end.json` | Session-end freeze-review dry-run template |
| `hooks/` | Optional Cursor `stop` hook snippet for print-next (**not** in footprint; Tier 2; fail-open) |

**Degrade path:** when IDE skills are unavailable, use `./cli/ok check-ok`,
`./cli/ok governance-sync`, `./cli/ok next`, and `./cli/ok review --freeze` from the
terminal instead. Copilot fallback for NEXT: `ok next` + `docs/PRINT-NEXT.md`.

Host niceties improve odds of tab refresh; they do **not** guarantee an accurate open
tab. CLI/Muse/shell rewrites and dirty buffers can still stale a tab.

Open the repository root (the folder that contains `.overseer/`) as the IDE workspace.
If you open a parent folder, project rules and skills under `.cursor/` often do not load.
The CLI still works. The open editor tab is not the source of truth — run `ok next`.