skills.rest
outcomeengineering
outcomeengineeringOFFICIAL
Explore all skills by this author →
GitHub

managing-spx

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

1|Updated Jan 6, 2026
Search Tags:#templates#documentation#specifications#adr#prd#spx#outcome engineering
One-click install
npx skills add https://github.com/outcomeengineering/spx-claude --skill managing-spx-outcomeengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: managing-spx
Source: https://github.com/outcomeengineering/spx-claude/tree/main/plugins/spx/skills/managing-spx
Command: npx skills add https://github.com/outcomeengineering/spx-claude --skill managing-spx-outcomeengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for creating and managing all types of specifications and documentation within the Outcome Engineering (spx/) framework, ensuring consistency and clarity.

Core Features & Use Cases

  • Template Access: Easily locate and use templates for PRDs, ADRs, PDRs, capabilities, features, and stories.
  • Structure Definition: Understand the spx/ directory hierarchy, BSP numbering, and test co-location principles.
  • Use Case: When starting a new feature, use this Skill to access the correct template for a feature specification, understand where to place it in the project structure, and learn how to number it according to the BSP system.

Quick Start

Read the template for creating a new feature specification.

Frequently Asked Questions about managing-spx

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

FAQPage Schema
How do I structure specifications and documentation using the spx framework?▼

The spx framework structures specifications using a defined directory hierarchy, BSP numbering, and test co-location for capabilities, features, stories, PRDs, ADRs, and PDRs. It ensures consistent organization across Outcome Engineering projects.

What templates are available for creating PRDs and ADRs?▼

Templates for PRDs, ADRs, PDRs, capabilities, features, and stories are provided. They standardize specification creation within the spx directory structure to maintain clarity and consistency.

How do I number feature specifications in an Outcome Engineering project?▼

Feature specifications are numbered using the BSP numbering system defined by the spx framework. This system organizes features and stories consistently within the project directory structure.

When should I create a PDR versus an ADR for project documentation?▼

Both PDRs and ADRs are managed within the spx framework to document specifications and decisions. Accessing the provided templates helps determine the correct document type for your specific project needs.

Does the spx directory structure support co-locating tests with specifications?▼

Yes, the spx directory structure defines test co-location principles. This approach places tests directly alongside their corresponding capabilities and feature specifications within the project hierarchy.

What is the best way to start writing a new feature specification in spx?▼

To start writing a feature specification, read the provided feature template to understand the required structure. Place the completed specification in the correct spx directory location using the BSP numbering system.

Related Skills

Explore More Software Engineering Skills→
simonheimlichersimonheimlicher
1

managing-spx

Standardize spx/ directory templates for PRDs, ADRs, capabilities, features, and stories.

Community
Intermediate
outcomeengoutcomeeng
1

understanding-spx

Ingest and validate hierarchical SPX context from ADRs, PDRs, and specs.

Official
Advanced
outcomeengineeringoutcomeengineering
1

migrating-spec-to-spx

Migrate software specifications from 'specs/' to the 'spx/' framework.

Official
Advanced
acme-skunkworksacme-skunkworks

documentation-and-adrs

Automate creation and management of ADRs and project documentation.

Official
Advanced