Skip to content
This repository was archived by the owner on Mar 26, 2026. It is now read-only.

v3.0.0 — Shared Conventions & All Skills v2.0

Choose a tag to compare

@Alan-TheGentleman Alan-TheGentleman released this 01 Mar 19:35
· 59 commits to main since this release

What's New

Shared Conventions (skills/_shared/)

  • persistence-contract.md — Mode resolution rules (engram | openspec | none). The auto mode has been removed.
  • engram-convention.md — Deterministic artifact naming (sdd/{change}/{type}), two-step recovery protocol, write/update patterns with topic_key upserts.
  • openspec-convention.md — File paths, directory structure, and config reference for file-based persistence.

All 9 SDD skills now reference these shared files instead of inlining persistence logic, removing ~224 lines of duplication.

Skill Upgrades to v2.0

  • sdd-apply v2.0 — TDD workflow support (RED-GREEN-REFACTOR cycle, tdd: true config option)
  • sdd-verify v2.0 — Real test/build execution, spec compliance matrix with severity levels, configurable pass/fail thresholds
  • All 9 skills — Refactored to use shared conventions for consistent persistence behavior

Breaking Changes

  • auto artifact_store mode removed — Now only engram | openspec | none. Engram is the default when available; openspec is only used when explicitly requested by the user.
  • Engram artifact naming is now deterministic — Sub-agents use sdd/{change-name}/{artifact-type} pattern with topic_key for upserts. This changes how artifacts are stored and recovered.

Other Changes

  • Updated examples/claude-code/CLAUDE.md with Engram convention reference
  • Updated README with shared conventions section and project structure

Full Changelog: v2.5.1...v3.0.0