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/TRD are optional enrichment - read if present, offer to create spec from them 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
# ALWAYS use full path (REQUIRED)
/understanding-specs capability-10_cli/feature-20_commands/story-30_build
🚨 NEVER use bare story/feature numbers - BSP numbers are sibling-unique, not globally unique:
# ❌ WRONG: Ambiguous - which story-30?
/understanding-specs story-30_build
# ✅ CORRECT: Unambiguous full path
/understanding-specs capability-10_cli/feature-20_commands/story-30_build
The skill will:
- Locate the work item in
specs/work/ - 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):
capability-NN_slug/feature-NN_slug/story-NN_slug
🚨 BSP numbers are sibling-unique, not globally unique.
| ❌ WRONG (Ambiguous) | ✅ CORRECT (Unambiguous) |
|---|---|
| "story-30_build" | "capability-10_cli/feature-20_commands/story-30_build" |
| "implement feature-20" | "implement capability-10_cli/feature-20_commands" |
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
specs/work/ - Product guide (
specs/CLAUDE.md) read - All product ADRs and PDRs read
- Capability spec exists and read
- Capability PRD/TRD read if present (optional enrichment)
- All capability ADRs and PDRs read
- Feature spec exists and read (if working on feature/story)
- Feature PRD/TRD read if present (optional enrichment)
- 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