Skip to content

docs: deepen rules overview - #33

Merged
kvlonge merged 1 commit into
mainfrom
feat/chi-286-rules-overview
Sep 9, 2026
Merged

kvlonge merged 1 commit into
mainfrom
feat/chi-286-rules-overview

Conversation

@kvlonge

@kvlonge kvlonge commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Why

Rules need a first-principles overview that explains the review problem they solve, why SQL linting belongs inside the compiler lifecycle, and where Rules fit alongside compiler correctness, formatting, contracts, tests, and audits.

Changes

  • expand the Rules overview with compiler-owned facts and practical review examples
  • explain the SQBRSQL subset and the single sqb compile lifecycle
  • document built-in and custom Rules, focused runs, findings, exceptions, and cache behavior
  • preserve the existing adapter-style overview-plus-detail navigation

Verification

  • parsed docs.json
  • verified all internal links added to concepts/rules.mdx
  • regenerated the packaged SQLBuild skill from this docs tree
  • passed public-repository hygiene scan and git diff --check

@kvlonge
kvlonge enabled auto-merge (squash) September 9, 2026 21:23
@kvlonge
kvlonge merged commit 7adaddf into main Sep 9, 2026
3 checks passed
@kvlonge
kvlonge deleted the feat/chi-286-rules-overview branch September 9, 2026 21:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant