How does the skill handle IDs for new features?

The skill generates random numeric IDs (e.g., F-1049) with collision detection, where lower IDs represent higher priority within the same entity type.

What is the SPECLAN format?

SPECLAN (Specification as a Living Language) manages project specs as interlinked markdown files with YAML frontmatter in a strict hierarchical directory structure.

Where are requirements stored in the folder structure?

Requirements are stored in subdirectories within their parent feature's 'requirements/' folder, following the pattern: F-####-slug/requirements/R-####-slug/.

Why does the filename have to match the directory name?

For directory-based entities like Features and Requirements, the filename is the authoritative source of truth for the ID and slug, ensuring structure consistency.

When is a specification file locked for editing?

Files marked as in-development, under-test, released, or deprecated are locked. Direct edits are prohibited, requiring a Change Request (CR) to modify.

Speclan Specification Format

Name: Speclan Specification Format
Author: thlandgraf

bythlandgraf

0•

Content Management

Standardizes and manages the creation, structure, and lifecycle of SPECLAN-compliant project specification files.

This skill provides foundational knowledge for the SPECLAN (Specification as a Living Language) methodology, enabling Claude to maintain a structured hierarchy of project goals, features, and requirements within the speclan/ directory. It enforces strict naming conventions, directory nesting rules, and ID generation patterns to ensure a consistent and navigable documentation ecosystem. By understanding the status lifecycle and parent-child relationships, this skill prevents invalid file structures and ensures that modifications to released entities are correctly handled through formal change requests rather than direct edits.

Key Features

01Manages complex hierarchical relationships between goals, features, requirements, and scenarios

02Handles random ID generation with collision detection for all SPECLAN entity types

03Regulates entity editability based on a defined seven-stage status lifecycle

04Enforces standardized directory and file naming conventions based on entity IDs and slugs

05Validates YAML frontmatter including status, owner, and ISO-8601 timestamps

060 GitHub stars

Use Cases

01Initializing a new project specification hierarchy with interconnected goals and features

02Creating detailed requirements and scenarios nested within existing feature directories

03Managing formal change requests for locked specifications that are in development or released

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thlandgraf/cc-marketplace speclan-format

For use in Claude.ai and ChatGPT

Download Skill