Skip to content

v1.2.0 — spec-driven dev, BDD, universal AGENTS.md, docs-gate

Choose a tag to compare

@martinholovsky martinholovsky released this 26 Jun 22:16
· 6 commits to main since this release
b96ea4e

Added

  • Spec-driven development rule — sota-docs-workflow/rules/05: the intent→plan→tasks→implement→verify loop, testable acceptance criteria, [NEEDS CLARIFICATION] markers, spec-drift control, steering vs per-feature specs.
  • BDD / specification by example rule — sota-testing/rules/08: declarative Given-When-Then, the outside-in double loop with TDD, anti-patterns, tracing scenarios to spec acceptance criteria.
  • scripts/gen-agents-md.sh — generate an AGENTS.md so non-Claude agents (Codex, Cursor, Copilot, Gemini CLI, Windsurf, Zed, …) route through the skills. Thin pointer built from frontmatter; reads rules on demand; idempotent.
  • scripts/init-gates.sh --docs-gate — opt-in pre-commit hook that blocks a commit changing code without updating docs (bypassable).

Changed

  • The always-on directive (generated AGENTS.md + README example) now leads with two standing rules for every answer: validate every claim against a primary source before asserting, and keep docs current in the same change.
  • Dropped the README "last refresh" date line (duplicated git history).

Full changelog: https://github.com/martinholovsky/SOTA-skills/blob/main/CHANGELOG.md