Skip to content

chore(agents): add Quint skills, mise tasks and docs - #490

Draft
tobyhede wants to merge 4 commits into
mainfrom
claude/project-thread-98m2dc
Draft

tobyhede wants to merge 4 commits into
mainfrom
claude/project-thread-98m2dc

Conversation

@tobyhede

@tobyhede tobyhede commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Requested by Toby

This is the base of a stack: #485, the Quint model of statement routing, builds on this PR, which adds the agent skills and tooling for it.
Merge this one first.

Agent skills

  • Vendors quint-lang and quint-modeling from quint-co/quint-llm-kit into .claude/skills/. They are pinned to commit cc75369 and keep their Apache-2.0 licence. .claude/skills/VENDORED.md explains how to update them.
  • Adds a proxy-quint skill with the rules specific to Proxy:
    • TLC is part of the checks.
    • Properties are fixed.
    • A finding needs a failing test before any fix.
    • When modelling a code path, trace every Context::begin_*/finish_* hook.
    • Each new rule gets a mutation, and each new action gets a witness.
  • Adds a pointer to the skill in AGENTS.md, which CLAUDE.md links to.

Tooling

  • Adds quint:install and quint:check mise tasks.
  • Puts specs/quint/node_modules/.bin on PATH, so Quint Connect, which runs bare quint, will use the pinned CLI.
  • Documents both in DEVELOPMENT.md, including the Rust-backend download gotcha.

specs/quint/ itself arrives with #485, so until #485 merges the skill and the mise tasks refer to files that don't exist yet.
The witness enforcement and the source-file correspondence table that used to be in this PR are now in #485.

Testing

  • CI passed on the previous version of this branch, which held the same files.
  • I couldn't run the mise tasks here because mise isn't installed in my environment. Their syntax copies the existing tasks.

Acknowledgment

By submitting this pull request, I confirm that CipherStash can use, modify, copy, and redistribute this contribution, under the terms of CipherStash's choice.

🤖 Generated with Claude Code

@tobyhede tobyhede self-assigned this Oct 26, 2026
Vendor the quint-lang and quint-modeling skills from the Quint LLM Kit at a
pinned commit, and add a proxy-quint skill for the rules specific to
Proxy: TLC is part of the checks, properties are fixed, a finding needs a
failing test first, trace every lifecycle hook on a path, and add a
mutation and a witness for each new rule and action. CLAUDE.md points to
it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The earlier commit meant to add this pointer through CLAUDE.md, which is
a symlink to AGENTS.md, so the edit was left unstaged.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Add quint:install and quint:check mise tasks, put the pinned Quint CLI in
specs/quint on PATH for tools such as Quint Connect that call `quint`
directly, and document both in DEVELOPMENT.md.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@tobyhede
tobyhede changed the base branch from claude/project-thread-p8sn3b to main October 26, 2026 01:47
@tobyhede
tobyhede force-pushed the claude/project-thread-98m2dc branch from 8b935bd to 16ecb9f Compare October 26, 2026 01:48
@tobyhede tobyhede changed the title chore(specs): adopt Quint skills and tighten the routing model checks chore(agents): add Quint skills, mise tasks and docs Oct 26, 2026
- Use mise's `usage` spec for the quint:check stage, replacing the
  deprecated `{{arg()}}` template.
- Name the mapped Rust files in the AGENTS.md pointer, so it can fire
  from a diff, and widen the skill description to adding and reviewing
  models.
- In proxy-quint: separate requirements changes from implementation
  changes, bound the path trace by the code rather than the table, list
  all four places a finding is recorded, note the mutate() limits, run
  `check.sh all` in the background, and say how to run the pinned CLI.
- Scope the tracker-ID rule to the public model files.
- Note that quint-execute-spec is not vendored.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

2 participants