outcomeengineering Base directory for this skill: {skill_dir}
Use this path to access skill files:
- References:
{skill_dir}/references/ - Workflows:
{skill_dir}/workflows/
IMPORTANT: Do NOT search the project directory for skill files.
- Every work item requires its spec file (
.capability.md,.feature.md,.story.md) - Missing spec file = ABORT immediately with clear error
- PRD is optional enrichment - read if present, offer to create spec from it if spec is missing
- Read order: Product → Capability → Feature → Story (top-down)
- All ADRs and PDRs at all levels must be read and understood
- This skill runs BEFORE any implementation work begins
Foundational understanding required:
/understanding-durable-map- Specs are permanent product documentation, not work items/understanding-outcome-decomposition- What belongs at each level (capability/feature/story)
Specs describe what the product IS. Status is derived from whether tests pass, not from spec content.
Atemporal voice: All spec content must state product truth without temporal markers. If you encounter "we need", "currently", "has accumulated", or "was decided because" in a spec, flag it as a quality issue — the content should be rewritten in atemporal voice per /understanding-durable-map.
# ALWAYS use full path (REQUIRED)
/understanding-spx 10-cli.capability/20-commands.feature/30-build.story
🚨 NEVER use bare story/feature numbers - BSP numbers are sibling-unique, not globally unique:
# ❌ WRONG: Ambiguous - which story-30?
/understanding-spx 30-build.story
# ✅ CORRECT: Unambiguous full path
/understanding-spx 10-cli.capability/20-commands.feature/30-build.story
The skill will:
- Locate the work item in
spx/ - Read all documents from product level down to target
- Fail immediately if any required document is missing
- Output structured context summary when complete
- Full path (REQUIRED):
NN-slug.capability/NN-slug.feature/NN-slug.story
🚨 BSP numbers are sibling-unique, not globally unique.
| ❌ WRONG (Ambiguous) | ✅ CORRECT (Unambiguous) |
|---|---|
| "30-build.story" | "10-cli.capability/20-commands.feature/30-build.story" |
| "implement feature-20" | "implement 10-cli.capability/20-commands.feature" |
The skill will locate and verify all documents in the hierarchy.
This skill has a single workflow that handles all context ingestion.
| File | Purpose |
|---|---|
references/abort-protocol.md |
Error messages and remediation guidance |
references/document-types.md |
Required documents at each level |
| Workflow | Purpose |
|---|---|
workflows/ingest-context.md |
Hierarchical document verification |
- Work item located in
spx/ - Product guide (
spx/CLAUDE.md) read - All product ADRs and PDRs read
- Capability spec exists and read
- Capability PRD read if present (optional enrichment)
- All capability ADRs and PDRs read
- Feature spec exists and read (if working on feature/story)
- All feature ADRs and PDRs read
- Story spec exists and read (if working on story)
- Structured context summary generated with document count and decision record list