Rules
The rule files in .claude/rules/, what each enforces and whether enforcement is automatic.
On this page
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 verify the repo itself.
Next steps
- Claude layer: skills, commands and rules together.
- Checks reference: every deterministic check.