Repository navigation
First release of pgsql-coding: PostgreSQL coding standards for Claude Code and Cursor. It covers queries, json and jsonb, schema design, indexing, performance analysis and safe migrations. PostgreSQL 18 is the floor, and PostgreSQL 19 additions are flagged as hints.
Install and host setup: docs/install.md.
Added
- Skills:
pgsql-codingrouter with theversions.mdreference (what needs PostgreSQL 17, 18 or 19). - Skills:
pgsql-query,pgsql-jsonb,pgsql-schema,pgsql-indexing,pgsql-performanceandpgsql-migrations, each with citedreferences/. - Skills:
/pgsql-lint-setupwrites the reference.squawk.toml. - Agents:
pgsql-reviewer, a report-only SQL reviewer. - Agents:
pgsql-plan-analyst, a report-only analyst of a longEXPLAINplan or a before-and-after pair. - Skills:
pgsql-performanceshipsscripts/plan-summary.py, a TEXT and JSON plan summariser. - Scripts:
scripts/plan-summary-test.pywith real PostgreSQL 18.6 plans inscripts/testdata/plans/. - Hooks:
session-start.sh,lint-on-save.sh(squawk, opt-in through.squawk.toml) andskill-nudge.sh, wired for Claude Code and Cursor. - Cursor rule:
rules/pgsql-context.mdcfor**/*.sql. - References:
references/squawk.toml. - Evals: one case per focused skill under
evals/. - Scripts:
scripts/validate.py(with--selftestand--check-links),scripts/validate.sh,scripts/hooks-test.sh. - Docs:
docs/install.md,docs/testing.md,docs/versioning.md,docs/authoring.md; CI workflowsvalidate.ymlandlinks.yml.