How is the 'DONE' status determined for a work item?

Status is derived directly from the filesystem: an item is OPEN if no tests exist, IN_PROGRESS if tests are present, and DONE once a DONE.md file is created in its directory.

What is the SPX framework used in this skill?

SPX is a structured methodology for managing software requirements, architectural decisions, and work items within a project's specs directory to ensure clarity, dependency management, and testability.

How does BSP numbering work for managing tasks?

BSP (Binary Search Partition) uses two-digit numbers (10-99) to define dependencies; a task with a lower number must be completed before tasks with higher numbers can begin.

Where are the PRD and ADR templates stored?

Templates are stored within the skill's internal plugin cache directory, allowing Claude to access standardized formats without requiring them to be manually added to your project first.

Managing Specs

Name: Managing Specs
Author: simonheimlicher

bysimonheimlicher

•

Productivity & Workflow

Standardizes project documentation and directory structures using the SPX framework for requirements, decisions, and implementation tasks.

This skill provides a structured approach to technical project management within Claude Code by enforcing the SPX framework. It enables developers to generate and manage a consistent specs/ directory containing Product Requirements Documents (PRDs), Technical Requirements Documents (TRDs), Architectural Decision Records (ADRs), and a hierarchical work-item system ranging from high-level Capabilities to atomic Stories. By utilizing BSP (Binary Search Partition) numbering for dependency management and test-driven status tracking, it ensures a single source of truth for project progress, architectural clarity, and implementation order.

Key Features

01Standardized templates for PRDs, TRDs, and ADRs

021 GitHub stars

03Automated status tracking based on test existence and DONE.md markers

04Hierarchical work item management (Capabilities, Features, Stories)

05Integrated test graduation workflow from specs to project-level suites

06BSP numbering system for explicit dependency ordering

Use Cases

01Setting up a new project's specification and requirement tracking structure

02Documenting complex architectural decisions with trade-offs and consequences

03Organizing large-scale features into manageable and testable unit stories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add simonheimlicher/spx-claude managing-specs

For use in Claude.ai and ChatGPT

Download Skill