What problem does it solve?
A project often depends on stable, clearly defined contracts (schemas, endpoints, and docs). This skill provides a centralized, versioned, date-stamped registry under contracts/ with a lock mechanism and an append-only ledger to ensure changes are auditable and controlled.
Core Features & Use Cases
- Contract registry and versioning: stores each contract as a stamp with kind (schema, endpoint, doc), version history, and status (draft, etc.), plus an is_locked flag.
- Guarded edits: a PreToolUse hook blocks hand-edits under contracts/ to force using /contract for all mutations, ensuring traceability.
- Lifecycle verbs: init, status, new, update, bump, lock, unlock, off, check; supports auditing and governance during changes across a project.
Quick Start
Initialize the contracts folder and add a new contract with /contract init followed by /contract new my-contract --kind endpoint --why "initial draft".