kb-spec

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.