skills.rest
simonheimlicher
simonheimlicherCOMMUNITY
Explore all skills by this author →
Website𝕏@simonheimlicherGitHub

managing-specs

Create and organize SPX specs with structured templates and BSP numbering.

1|Updated Jan 6, 2026
Search Tags:#templates#PRD#ADR#specs#work-items#TRD
One-click install
npx skills add https://github.com/simonheimlicher/spx-claude --skill managing-specs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: managing-specs
Source: https://github.com/simonheimlicher/spx-claude/tree/main/plugins/specs/skills/managing-specs
Command: npx skills add https://github.com/simonheimlicher/spx-claude --skill managing-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill acts as a centralized governance layer for the SPX specs framework, providing a single source of truth for specs/ directory structure and all document templates (PRD/TRD, ADRs, and work items) to ensure consistency across products.

Core Features & Use Cases

  • Template access and discovery: Locate and reuse templates for product requirements, architectural decisions, and work items.
  • Structured spec hierarchy: Enforce the specs/ directory layout (PRD/TRD, ADRs, and BSP-based work items) with co-located tests and templates.
  • Work item scaffolding: Create capabilities, features, and stories with the correct folder paths and naming conventions.
  • Template-driven governance: Apply BSP numbering rules and ensure alignment between product, capability, feature, and story artifacts.

Quick Start

  1. Read the templates from the skill base directory, e.g. Read: ${SKILL_DIR}/templates/work-items/feature-name.feature.md
  2. Initialize a specs directory structure under specs/ and begin with a product PRD (PRD template) followed by ADRs, and work items as described.
  3. Use the templates to generate PRD/TRD, ADRs, and work item definitions, then attach co-located tests as you implement.

Frequently Asked Questions about managing-specs

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

FAQPage Schema
How do I standardize PRD and TRD templates across my product specs?▼

To standardize PRD and TRD templates, this skill provides a centralized governance layer that enforces a structured specs directory layout and templating rules to maintain consistency across products.

What is the best way to scaffold product features and user stories with consistent numbering?▼

The best way to scaffold features and stories is by applying the SPX framework patterns and BSP numbering rules, which automatically generate co-located work items with correct folder paths and naming conventions.

How do I organize ADRs alongside product requirements in a specs directory?▼

You can organize ADRs alongside product requirements by initializing the enforced specs directory structure, which co-locates architectural decision records, PRDs, and work items under a unified hierarchy.

Can I use this skill to establish a single source of truth for product specs and work items?▼

Yes, you can use this skill to establish a single source of truth for product specs and work items, as it standardizes template access and enforces the SPX framework for structured spec governance.

How do I start creating new specs and work items using standardized templates?▼

To start creating new specs, read the provided templates from the skill base directory, initialize your specs directory, and generate the required PRD, TRD, ADR, and work item definitions with attached co-located tests.

Related Skills

Explore More Product & Management Skills→
outcomeengineeringoutcomeengineering
1

managing-spx

Create and organize spx/ specifications using templates and BSP numbering.

Official
Intermediate
outcomeengoutcomeeng
1

managing-specs

Enforce canonical specs/ directory structure, templates, and naming conventions.

Official
Advanced
GabeujinGabeujin

breakdown-plan

Generate GitHub project plans and issue templates from feature artifacts.

Community
Advanced
outcomeengoutcomeeng
1

managing-spx

Organize SPX templates and docs into a governed spx/ directory structure.

Official
Advanced