Yass (Yet Another Spec Syntax)
github.com/shakefu/yass- Category
- Developer Tools
- Rank
- No. 1989Tools index
Previous survey · No. 1910 ·
- Type
- TOOL
- Use case
- Coding
- GitHub
- 3 stars
- Latest release
- v0.6.0
- Date
About
Yass is a minimal YAML-based spec format that uses RFC2119 keywords (MUST, SHOULD, MAY, etc.) to steer AI model behavior, relying on models' trained-in understanding of those keywords instead of long prose instructions. Its author reports validating it through hundreds of experiments across models and platforms, including reproducing byte-exact CLI implementations in seven different languages from a single Yass spec tree using Claude Opus 4.6 inside sandboxed Claude Code harnesses.
At a glance
Yass gives coding agents a YAML vocabulary for describing desired behavior before implementation. It is worth trying if reviews keep reopening what a feature should do and you want an agreement you can validate and keep with the code.
Good fit
Teams willing to review a structured spec before an agent writes tests and implementation.
Consider something else when
Use a short issue and existing acceptance tests when the change is already unambiguous.
Start here
Write one behavior for a small change, validate the spec and review it before implementation. Compare the resulting tests with the agreed behavior.
Cost and requirements
Early-stage AGPL-3.0 CLI with a JSON Schema for editor validation. The project documents macOS, Linux and Windows binaries.
Limits to know
Validation checks spec structure. The specification still needs human judgment, and the resulting tests need to establish that the implementation follows it.
Sources checked 2026-11-05. Source-based assessment.
Why it made the leaderboard
Offers agent builders a lightweight, testable way to write specs that produce consistent behavior across models and languages, backed by an unusual cross-language validation experiment.
Tags
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.