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.
| # | Step | Command | CI step name |
|---|---|---|---|
| 1 | Confidentiality guard | bash scripts/confidentiality-guard.sh | Confidentiality guard |
| 2 | Go static checks | make static-checks | golangci-lint, golangci-lint config schema |
| 3 | Tests | make test | Tests |
| 4 | Race detector | make race | Race detection (full) |
| 5 | Tagged tests | make test-elpscheck | Singleton integrity (elpscheck) |
| 6 | elps's own Go analyzers | make elpsvet | Seal contract (elpsvet) |
| 7 | Sealed-AST benchmark oracle | make bench-elpscheck-smoke | Sealed-AST oracle over the benchmarks |
| 8 | Format | go build -o elps . && ./elps fmt -l ./... | Check formatting |
| 9 | Lisp lint | ./elps lint --workspace=. --exclude 'grammar' --include '_examples' ./... | Lint ELPS source |
| 10 | Docstrings | ./elps doc -m | Check missing documentation |
| 11 | API break gate | make api-break-gate (BASE=origin/main default) | API break gate (job api-break) |
| 12 | Work marker gate | (none: shared workflow) | quality / result (job work-markers in the shared Quality workflow) |
Notes:
- Step 2:
make static-checksrunsgolangci-lint config verify, thengolangci-lint run ./..., then a second pass under--build-tags elpscheckscoped 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" inAGENTS.mdbefore deleting any//nolint. - Step 6: two passes (untagged and
GOFLAGS=-tags=elpscheck). For interpreting a finding, use the/elpsvetskill. - Step 8:
-llists 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 intoscripts/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.txtdoes 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 ./...); rungo vet ./...if you touched OS-specific code. - Touched
scripts/,cmd/benchgate,benchmark.ymlorfuzz.yml? Also runmake ci-gates-test(andmake fuzz-classify-testfor fuzz changes).
On Failure
- Report which step failed and the error output.
- Fix the issue.
- Re-run the pipeline from the beginning (fixes can introduce new issues).
- When a fix to an analyzer (lisp
lint/orcmd/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
.lispfiles: 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| 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: 192k | Updated | Claude CodeCodex | Verified | Install |