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.

About

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

Standardized templates for PRDs, TRDs, and ADRs
1 GitHub stars
Automated status tracking based on test existence and DONE.md markers
Hierarchical work item management (Capabilities, Features, Stories)
Integrated test graduation workflow from specs to project-level suites
BSP numbering system for explicit dependency ordering

Use Cases

Setting up a new project's specification and requirement tracking structure
Documenting complex architectural decisions with trade-offs and consequences
Organizing large-scale features into manageable and testable unit stories

About

Key Features

Standardized templates for PRDs, TRDs, and ADRs
1 GitHub stars
Automated status tracking based on test existence and DONE.md markers
Hierarchical work item management (Capabilities, Features, Stories)
Integrated test graduation workflow from specs to project-level suites
BSP numbering system for explicit dependency ordering

Use Cases

Setting up a new project's specification and requirement tracking structure
Documenting complex architectural decisions with trade-offs and consequences
Organizing large-scale features into manageable and testable unit stories