spec-organize

What problem does it solve?

This Skill addresses the challenge of managing growing specification documents, ensuring they are well-structured, consistent, and up-to-date, preventing issues like broken links, duplicated content, and outdated information.

Core Features & Use Cases

• Document Review: Diagnoses structural integrity, content consistency, and freshness of specification documents managed with Doorstop and Gherkin.
• Structural Reorganization: Proposes and executes actions like splitting large documents, consolidating similar ones, or changing parent-child relationships to improve clarity.
• Use Case: When a project's specification documents become unwieldy, this Skill can analyze them, identify areas for improvement (e.g., a single document containing too many unrelated requirements), and then help restructure them into a more manageable hierarchy.

Quick Start

Review the current specification documents for structural and content issues.