Skip to content
Kitbay
Submit
Skill

constraint-driven-development

MITUpdated on Nov 1, 2026115,373GitHub starsIncludes scripts

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