tibursocampos/agent-dev-toolkit / core/skills/read-sdd-artifact
read-sdd-artifact
VerifiedResolve canonical FEATURE/STORY/PRD/PLAN paths under features/ into a source_context envelope with artifact identity. Reject path traversal and paths outside features/. Use when invoking read-sdd-artifact or normalizing SDD artifact reads for child handoffs.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.0 KB |
| reference.md | markdown | 551 B |
| references/build-consume-report.md | markdown | 827 B |
| references/envelope-schema.md | markdown | 1.0 KB |
| references/must-not.md | markdown | 451 B |
| references/normalize-path.md | markdown | 1.5 KB |
references/envelope-schema.md
View on GitHub## Envelope (`source_context`)
Return **only** after path validation succeeds and the file exists:
```yaml
source_context:
schema: RSA-SOURCE-CONTEXT/v1
artifact_kind: FEATURE | STORY | PRD | PLAN
portable_path: features/NNN-slug/... | sdd/<repo-id>/features/NNN-slug/... # selected by manifest mode
identity:
feature_slug: NNN-slug
story_id: USnn | TSnn | null # null for FEATURE.md at feature root
file_name: FEATURE.md | STORY.md | <prd|plan file>
# optional: content may be attached by the caller after Read; identity never depends on a second opaque Read
```
### Canonical kinds (under `features/`)
| Kind | Portable pattern |
|------|------------------|
| `FEATURE` | `features/<NNN-slug>/FEATURE.md` |
| `STORY` | `features/<NNN-slug>/(US\|TS)\d\d/STORY.md` |
| `PRD` | `features/<NNN-slug>/(US\|TS)\d\d/PRD/<file>.md` |
| `PLAN` | `features/<NNN-slug>/(US\|TS)\d\d/PLAN/PLAN_*.md` |
Global classic: same suffix after `sdd/<repo-id>/` — strip that prefix before kind match; still require the `features/` segment.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |