# Rules

The rule files in .claude/rules/, what each enforces and whether enforcement is automatic.

Rules are short files in `.claude/rules/` that Claude follows. `spec-is-source`, `tokens-through-the-harness`, `comment-minimalism` and `no-ai-attribution` are always in context; the others carry `paths:` and load when Claude reads a matching file (components and their specs and stories, contracts, the form-control mixins, the Figma adapter and design docs), so a session that never touches them does not pay for them (SB-0114). They are harness-owned, so `sketchbook upgrade` replaces them.

## spec-is-source

Change the spec, then rebuild. Never edit `generated/**`, `spec/tokens/foundation/*`, `src/index.ts` or `*.styles.ts` by hand. Component CSS uses only its own `--sb-<component>-*` and private `--_*` properties. Accepted decisions are never edited. Partly automatic: the `guard-decisions` hook and checks T4, T5 and G1.

## tokens-through-the-harness

Change foundations in `brand.config.json` or with `sketchbook tokens set|preset`. Semantic renames go through `sketchbook tokens rename`. Imports are proposals until applied. Checks G1, T7 and exit code 2 catch drift.

## planning-gate

Active when `features.planningGate` is true. Before component code, pass `npm run check`, write `plan.md`, then stop for approval. Manual.

## test-first

Active when `features.testFirst` is true. Write the story and behavior spec first and confirm each test fails for the right reason. Manual; check R1 requires that both files exist for `beta`, not that they failed first.

## contract-first

No component implementation without a `contract.json` that passes `npm run check`. Manual; check C3 catches code with no contract.

## comment-minimalism

Write no comments unless they explain a non-obvious why. Manual, no linter.

## form-associated-controls

A component that stands in for a native form control extends `FormAssociated(LitElement)` from its first version and implements `formValue()`, `formReset()`, `formStateRestore()` and `validationAnchor()`. Manual.

## figma-fidelity

Storybook is the reference; the design file must look like it. A pattern is not drawn until `sketchbook sync compare` and a side-by-side look agree. Manual: `docs/design-docs/parity.md` must show a match before a pattern is stamped `checked`.

## no-ai-attribution

Commits and pull requests carry no AI attribution: no `Co-Authored-By:` trailer for an agent, no "Generated with" line. Partly automatic: the `commit-msg` git hook rejects an AI trailer; pull request text is manual.

> **Note** Rules describe how Claude works in the repo. [Checks](/reference/checks/) verify the repo itself.

## Next steps

- [Claude layer](/concepts/claude-layer/): skills, commands and rules together.
- [Checks reference](/reference/checks/): every deterministic check.
