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.
Skill: read-sdd-artifact
Trigger
Negative signal: applies as defined in _shared/skill-boilerplate.md; the skill-specific signals are listed below.
Invoke when the consumer asks for skill read-sdd-artifact (host forms: /read-sdd-artifact, $read-sdd-artifact, use skill read-sdd-artifact, OpenCode skill({ name: "read-sdd-artifact" })), or needs a normalized source_context envelope for FEATURE / STORY / PRD / PLAN under features/.
Outcome
- Happy path: one
source_contextenvelope with artifact identity (kind, portable path, feature slug, story id when applicable, file name). - Fail path: no partial envelope — precise reject reason (
path_traversal,outside_features,absolute_path_forbidden,unsupported_kind,not_found,empty_path,invalid_portable_path, or a named storage-manifest/root failure). - Consumers that already hold
source_contextfor a path skip opaque re-read of that artifact (REQ-005).
Lazy-load (only when needed)
| When | Path (after agent sync) |
|---|---|
| Portable path / features layout | {{TOOLKIT_ROOT}}/skills/_shared/sdd-artifacts/STORAGE.md |
| Dynamic manifest / repository-global root resolution (only when resolving storage) | {{TOOLKIT_ROOT}}/skills/_shared/sdd-artifacts/STORAGE-RESOLUTION.md |
| Direct vs orchestrated context | {{TOOLKIT_ROOT}}/skills/_shared/sdd-artifacts/INVOCATION-CONTEXTS.md |
| Selective retrieval | {{TOOLKIT_ROOT}}/skills/_shared/sdd-artifacts/SELECTIVE-RETRIEVAL.md |
| Invocation handoff (orchestrated) | {{TOOLKIT_ROOT}}/skills/_shared/sdd-artifacts/INVOCATION-CONTEXTS.md |
| Reference index (routing only) | {{TOOLKIT_ROOT}}/skills/read-sdd-artifact/reference.md |
| Process step detail (lazy) | {{TOOLKIT_ROOT}}/skills/read-sdd-artifact/references/<section>.md |
Never by default: do not preload all references/*.md, full PRD/PLAN bodies beyond the single target path, memory-bank/, TRACE emitters, or unrelated pipeline skill bodies. Load one section per Process step (SKILL-REFERENCE-RETRIEVAL.md).
Reference routing
| Situation | Path |
|---|---|
| Envelope schema + kinds | references/envelope-schema.md |
| Normalize / validate path | references/normalize-path.md |
| Build envelope + consume + report | references/build-consume-report.md |
| Must not (full) | references/must-not.md |
Rule ID
RSA-SOURCE-CONTEXT
Process
Read references/<section>.md for procedural detail — not full reference.md.
0. Resolve invocation context once
Resolve invocation_context at the start from INVOCATION-CONTEXTS.md, after the read-only gate. Keep it for this invocation and report it when producing a handoff. Do not infer it from FEATURE/STORY/CONTINUITY/REFINE/tasks/Memory Bank or change it because a sibling is present.
Caveman Mode
NEVER — Ignore caveman_mode. Keep reject reasons and envelope fields exact. Do not load CAVEMAN.md for compression.
0. Read-only gates
This skill is read-only. Do not require write_confirmed / new-artifact sim to resolve a path. Do not Write/Delete.
1. Normalize input path
Follow references/normalize-path.md.
2–4. Build envelope, consume, report
Follow references/envelope-schema.md then references/build-consume-report.md.
Must not
Enforce the full list in references/must-not.md. Critical: no partial source_context on fail; no .. / OS absolute / outside features/; no CONTINUITY/ANALYSIS/ARCH/SEC/CHANGE/memory-bank kinds.
Handoff
- Pipeline / O3 children: pass
source_contextin scoped handoff so consumers skip opaque re-read - Next authoring skills stay
sdd-spec/sdd-plan/sdd-developby id — this skill only normalizes reads
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 |