managing-spx

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

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/outcomeeng/claude --skill managing-spx-outcomeeng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: managing-spx
Source: https://github.com/outcomeeng/claude/tree/main/plugins/spx-legacy/skills/managing-spx
Command: npx skills add https://github.com/outcomeeng/claude --skill managing-spx-outcomeeng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a single source of truth for SPX directory structure and document templates, enabling consistent governance over requirements (PRD), decisions (ADR/PDR), and work items (capability/feature/story) across all products using the SPX framework.

Core Features & Use Cases

  • Centralized governance for the spx/ directory structure, templates, and naming conventions.
  • Templates for Product Requirements (PRD), Architecture Decisions (ADR), Product Decisions (PDR), and Work Item patterns (capability/feature/story) with interleaved decisions.
  • Guidance to create and organize SPX documents, tests, and references with consistent placement and co-location rules.

Quick Start

Read the SKILL.md and follow the structure guidance to begin creating ADRs, PDRs, PRDs, and work-item templates within the SPX framework.

Frequently Asked Questions about managing-spx

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

FAQPage Schema
How do I maintain consistent PRD and ADR templates in the spx/ directory?

To maintain consistent PRD and ADR templates, organize SPX templates and docs into a single source of truth governing the spx/ directory structure. This centralizes document templates for product requirements, architecture decisions, and work items across projects.

What is the SPX framework structure for capabilities, features, and stories?

The SPX framework structure uses a BSP-based hierarchy to organize capabilities, features, and stories. It requires YAML frontmatter in SKILL.md for metadata and co-locates templates, tests, and references under structured directories for consistent work item creation.

How do I create and organize Product Decision Records and work items in SPX?

To create and organize Product Decision Records and work items in SPX, follow the structure guidance in SKILL.md to apply specific templates. This ensures consistent placement and co-location rules for PDRs, tests, and references within the framework.

Does the SPX framework require YAML frontmatter in SKILL.md files?

Yes, the SPX framework requires YAML frontmatter in SKILL.md files for name and description metadata. Optional scripts, references, and assets can be included, with document templates located under the templates/ directory.

Can I use this SPX template governance for multiple products with different work item patterns?

Yes, you can use this SPX template governance for multiple products. It applies to any project using the SPX framework, providing centralized governance for directory structure, naming conventions, and interleaved decisions for various work item patterns.

When should I not use a centralized SPX directory structure for documentation?

You should not use a centralized SPX directory structure if your project does not use the SPX framework. It specifically governs the BSP-based hierarchy and document templates for PRD, ADR, PDR, and work item creation within SPX-compliant environments.