understanding-spx

Load hierarchical product, capability, feature, and story specifications from the SPX CODE framework.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures teams can load complete hierarchical context from product level to story before implementation by locating and validating specifications across the CODE framework (spx/).

Core Features & Use Cases

  • Load context across product, capability, feature, and story levels.
  • Read ADRs and PRDs when present, and prompt for spec creation if a PRD exists but the spec is missing.
  • Abort early with actionable remediation when required documents are missing or ambiguous, and emit a structured context summary.

Quick Start

Use the understanding-spx skill with a full work item path to ingest complete context: /understanding-specs 10-cli.capability/20-commands.feature/30-build.story

Frequently Asked Questions about understanding-spx

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

FAQPage Schema
How do I load hierarchical context from product to story specifications for implementation?

To load hierarchical context, provide a full work item path to ingest product, capability, feature, and story specifications. The skill validates required documents, reads optional PRDs and ADRs, and outputs a structured summary to guide implementation.

What happens when required specifications are missing or ambiguous during context ingestion?

When required specifications are missing or ambiguous, the context ingestion aborts early and provides actionable remediation steps. It also prompts for spec creation if a PRD exists but the corresponding specification document is missing.

Can I read ADRs and PRDs alongside capability and feature specs in the SPX framework?

Yes, you can read ADRs and PRDs alongside capability and feature specs. The context loader automatically detects and reads these optional documents when present, including ADR references in the final structured context summary.

How do I verify the presence of required product and capability documents before starting implementation?

You verify required documents by running the context loader against a work item path. It checks for the presence of mandatory product guides and capability specs, aborting with actionable guidance if any required document is missing.

What is the best way to ingest complete CODE framework context across multiple specification levels?

The best way to ingest complete CODE framework context is using a full hierarchical work item path. This reads across product, capability, feature, and story levels, validating dependencies and outputting a structured summary with document counts and ADR references.

What format should the work item path follow to load SPX context correctly?

The work item path should follow a hierarchical format like 10-cli.capability/20-commands.feature/30-build.story. This structured path enables the loader to traverse and ingest specifications across product, capability, feature, and story levels accurately.