cascading-specs

Discover project specification documents and recommend next artifacts via the cascade principle.

Updated Nov 23, 2022
One-click install
npx skills add https://github.com/tjmgregory/.dotfiles --skill cascading-specs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cascading-specs
Source: https://github.com/tjmgregory/.dotfiles/tree/main/agents/skills/cascading-specs
Command: npx skills add https://github.com/tjmgregory/.dotfiles --skill cascading-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you understand your project's specification coverage by automatically discovering existing documents and guiding you on what to create next, ensuring a consistent and traceable development process.

Core Features & Use Cases

  • Specification Discovery: Scans for common specification documents (vision, requirements, use cases, etc.).
  • Gap Analysis: Identifies missing artifacts in the development cascade.
  • Next Step Recommendation: Suggests which document to create next based on the cascade principle.
  • Use Case: When starting a new feature, use this Skill to quickly see what requirements exist, identify gaps in use case coverage, and get a recommendation on what to document next.

Quick Start

Use the cascading-specs skill to review the current specification coverage for the project.

Frequently Asked Questions about cascading-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify missing specifications in my development process?

To identify missing specifications, you can scan your project for existing documents like vision, requirements, and use cases. This Skill performs a gap analysis to find missing artifacts and recommends what document to create next based on the cascade principle.

What is the cascade principle for project documentation?

The cascade principle is a development process rule where changes flow downward only, ensuring consistency from vision to code. It enforces a traceable hierarchy where vision documents dictate requirements, which then dictate use cases and architecture.

How do I check if my project requirements are complete before coding?

You can check project requirements completeness by auto-discovering existing documents and analyzing gaps. This process scans for entity models, architecture, and tests to identify what is missing and suggests the next document to create.

Can this skill discover existing architecture and test documents automatically?

Yes, this skill auto-discovers existing specifications by scanning for common documents like architecture and tests. It analyzes your development process coverage to ensure consistency and recommends the next steps to fill any identified gaps.

What is the best way to maintain consistency from vision to code?

The best way to maintain consistency from vision to code is to enforce a cascade rule where specification changes flow downward only. This ensures that your vision, requirements, use cases, entity models, and architecture remain aligned throughout the development process.

When do I need specification discovery for my development process?

You need specification discovery when starting a new feature to quickly see what requirements exist and identify gaps in use case coverage. It guides you on what to document next to maintain a consistent and traceable development process.