Skip to content

luthersystems/elps / .claude/skills/verify

verify

Verified

/verify — CI Gate Skill

Runs the same checks as the Lint & Test job in .github/workflows/elps.yml, in the same order. Use it before committing or creating a PR. If CI's steps change, update this file to match — the workflow is the authority.

Trigger

Use when asked to verify changes, check CI readiness, or as a pre-commit/pre-PR gate.

Pipeline

Run in order. Stop and report on the first failure.

#StepCommandCI step name
1Confidentiality guardbash scripts/confidentiality-guard.shConfidentiality guard
2Go static checksmake static-checksgolangci-lint, golangci-lint config schema
3Testsmake testTests
4Race detectormake raceRace detection (full)
5Tagged testsmake test-elpscheckSingleton integrity (elpscheck)
6elps's own Go analyzersmake elpsvetSeal contract (elpsvet)
7Sealed-AST benchmark oraclemake bench-elpscheck-smokeSealed-AST oracle over the benchmarks
8Formatgo build -o elps . && ./elps fmt -l ./...Check formatting
9Lisp lint./elps lint --workspace=. --exclude 'grammar' --include '_examples' ./...Lint ELPS source
10Docstrings./elps doc -mCheck missing documentation
11API break gatemake api-break-gate (BASE=origin/main default)API break gate (job api-break)
12Work marker gate(none: shared workflow)quality / result (job work-markers in the shared Quality workflow)

Notes:

  • Step 2: make static-checks runs golangci-lint config verify, then golangci-lint run ./..., then a second pass under --build-tags elpscheck scoped to ./lisp/... (tagged files are invisible to the first, and today they only live there). It warns when your golangci-lint differs from CI's pin; on a mismatch, trust CI — see "golangci-lint version skew" in AGENTS.md before deleting any //nolint.
  • Step 6: two passes (untagged and GOFLAGS=-tags=elpscheck). For interpreting a finding, use the /elpsvet skill.
  • Step 8: -l lists files that would change; fix with ./elps fmt ./... and re-run.
  • Step 9: fix the diagnostic, or add ; nolint:<check-name> only for a genuine false positive.
  • Step 10: add the missing docstring to the builtin/op/macro/export.
  • Step 11: fails when the branch removes or incompatibly changes the Go API of a non-internal package or the Lisp public surface (packages, exports, kind, formals) against its merge base with BASE. If the break is intended, paste the line the gate prints into scripts/api-breaks.txt, fill the issue (and the substrate migration) and reason, and justify it in the PR. Otherwise restore compatibility (keep the old name/arity, add instead of change).
  • Step 12: fails on a work marker that does not name an open issue (MARKER(#N)) and that .github/quality/work-markers.txt does not cover, and on an entry that covers nothing. Do the work, or name its issue. Delete stale entries.
  • CI also builds and vets on Windows (go build ./... && go vet ./...); run go vet ./... if you touched OS-specific code.
  • Touched scripts/, cmd/benchgate, benchmark.yml or fuzz.yml? Also run make ci-gates-test (and make fuzz-classify-test for fuzz changes).

On Failure

  1. Report which step failed and the error output.
  2. Fix the issue.
  3. Re-run the pipeline from the beginning (fixes can introduce new issues).
  4. When a fix to an analyzer (lisp lint/ or cmd/elpsvet) stops it skipping nodes, expect it to surface new true positives in the repo's own files — fix those in the same PR rather than suppressing them.

Quick Mode

For iterative development, run the relevant subset, then the full pipeline before pushing:

  • Changed Go code: steps 2, 3, 6
  • Changed concurrency-sensitive code: add step 4
  • Changed .lisp files: steps 3, 8, 9
  • Added builtins/ops/macros: steps 2, 3, 10

CI on docs-only PRs

A pull request that changes only documentation (*.md outside .github/, scripts/, tree-sitter-elps/ and testdata/; root LICENSE/AUTHORS/CONTRIBUTORS) skips the heavy CI jobs; the Required: * checks still report and pass. docs/lang.md, docs/debugging-guide.md and docs/lsp-guide.md are embedded in the binary and always get the full suite, as do pushes to main and scheduled runs. Rules: scripts/docs-only-changes.sh; skip acceptance: scripts/require-jobs-succeeded.sh.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 192kUpdated Claude CodeCodexVerifiedInstall