What is the SPX framework?

SPX refers to the Outcome Engineering framework, a documentation-first methodology that organizes product truth into a hierarchy of capabilities, features, and stories.

What are ADRs and PDRs in this context?

Architectural Decision Records (ADRs) and Product Decision Records (PDRs) are documents that capture specific constraints and choices made during the design process, which Claude uses to guide implementation.

What happens if a required spec file is missing?

The skill follows a strict abort protocol. It will stop immediately and provide a clear error message explaining which document is missing so you can create it before proceeding.

Why does this skill require a full path like '10-cli.capability/20-commands.feature'?

The skill uses full paths because BSP numbers are sibling-unique rather than globally unique; providing the full path prevents Claude from reading the wrong specification.

SPX Outcome Engineering Context

Name: SPX Outcome Engineering Context
Author: simonheimlicher

bysimonheimlicher

•

Productivity & Workflow

Ingests hierarchical product specifications and decision records to provide comprehensive context for implementation tasks within the SPX framework.

This skill enables Claude to deeply understand the product hierarchy and constraints of projects using the Outcome Engineering (spx/) framework. By enforcing a top-down reading order—from product guides and Architectural Decision Records (ADRs) to specific story specifications—it ensures that every implementation task is grounded in the full context of the product's design. It acts as a gatekeeper for development, verifying the existence of required documentation and flagging temporal language to maintain a 'durable map' of the product's current state before any coding begins.

Key Features

011 GitHub stars

02Hierarchical context loading from product level down to specific stories

03Automated ingestion of Architectural (ADR) and Product Decision Records (PDR)

04Atemporal voice checking to ensure documentation quality

05Mandatory spec verification with fail-fast error reporting

06Structured context summary generation for implementation readiness

Use Cases

01Auditing project documentation for completeness and consistency with the SPX framework.

02Initializing a new development task to ensure all requirements and constraints are understood.

03Onboarding to complex features by loading all historical decision records and specifications.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add simonheimlicher/spx-claude understanding-spx

For use in Claude.ai and ChatGPT

Download Skill