constraint-driven-development
A skill from Addy Osmani's agent-skills collection that writes a project's quality bar down as a contract in CONSTRAINTS.md and stops agents from quietly lowering it.
What the skill teaches
A skill from Addy Osmani's agent-skills collection that writes a project's quality bar down as a contract in CONSTRAINTS.md and stops agents from quietly lowering it. The agent first reads the stack, test runner, linters, coverage and CI, then asks four questions with defaults: which areas to enforce, whether failures block or warn, target numbers or hold-the-line ratchets, and how long checks may run. It installs common tools for each area, such as type checkers, Semgrep, gitleaks, Lighthouse, axe and mutation testing, checks that each enforced command really fails on violations, and places fast checks in the edit loop and the full set in review and CI. Diffs that skip tests, suppress checks or loosen thresholds are flagged.
Capabilities
- Write a project's quality thresholds into CONSTRAINTS.md
- Install and wire checks for tests, coverage, security and accessibility
- Flag skipped tests, suppressed checks and lowered thresholds
- Hold current metrics with ratchets when no target exists
About
- Publisher
- Addy Osmani
- Tool
- Testing
Install
- Run this to add it to Any client:
npx skills add addyosmani/agent-skills --skill constraint-driven-development
What's inside
- references/floor-guard.md
- scripts/quality-gate.mjs
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
This skill includes scripts that your agent may run.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Testing | |
| Publisher | Addy Osmani | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Cursor, Codex, Gemini CLI, Devin Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 1, 2026115,373 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Sources
- GitHub repositorygithub.com/addyosmani/agent-skills · Backs: AI clients, Licence, Publisher, ActivityNov 11, 2026
- Web pageraw.githubusercontent.comNov 15, 2026
- Skill file (SKILL.md)github.com/addyosmani/agent-skillsNov 10, 2026
- Folder in the repository (constraint-driven-development)github.com/addyosmani/agent-skills · Backs: Includes scriptsNov 10, 2026