What problem does it solve?
This Skill solves the problem of keeping the Knowledge Database consistent, complete, and governance-compliant by turning spec creation and updates into a validated, repeatable workflow.
Core Features & Use Cases
- Governed spec-first workflow (GOV-01): Creates or updates specs while enforcing required fields and ID formatting to prevent drift and ambiguity.
- Duplicate prevention & ID validation: Validates SPEC-ID format and checks for duplicates before inserting new records.
- Assertion-driven quality (GOV-18): Encourages machine-verifiable assertions so specs can be verified via automated checks.
- Status transition safety (GOV-02): Restricts updates that would break governance rules, especially around immutable fields and status promotion logic.
Use cases: Drafting new requirements for an application, formalizing governance rules as specs, updating existing specs for implementation/verification stages, and ensuring every spec includes meaningful assertions for later verification.
Quick Start
Run the kb-spec skill with the action new and provide the SPEC-ID you want to create or update, then follow the prompted steps to validate fields, prevent duplicates, and include at least one machine-verifiable assertion.