Skip to content

tibursocampos/agent-dev-toolkit / core/skills/read-sdd-artifact

read-sdd-artifact

Verified

Resolve 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_context envelope 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_context for a path skip opaque re-read of that artifact (REQ-005).

Lazy-load (only when needed)

WhenPath (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

SituationPath
Envelope schema + kindsreferences/envelope-schema.md
Normalize / validate pathreferences/normalize-path.md
Build envelope + consume + reportreferences/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_context in scoped handoff so consumers skip opaque re-read
  • Next authoring skills stay sdd-spec / sdd-plan / sdd-develop by id — this skill only normalizes reads
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall