document-spf-use-case

Creates and updates SPF use-case composition registry entries with grounded evidence and cross-doc cascades.

931|91|Updated Aug 13, 2025
One-click install
npx skills add https://github.com/videojs/v10 --skill document-spf-use-case
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: document-spf-use-case
Source: https://github.com/videojs/v10/tree/main/.agents/skills/document-spf-use-case
Command: npx skills add https://github.com/videojs/v10 --skill document-spf-use-case

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

Documenting a delivery-scenario use case for the SPF playback engine is error-prone: drafts often confuse feature docs with use-case docs, default to subtractive-only composition thinking, or leave the registry internally inconsistent. This Skill enforces a disciplined nine-step workflow that triangulates sources, grounds claims in code, and keeps cross-links symmetric.

Core Features & Use Cases

  • Source triangulation and scoping: Gathers context from Notion docs, GitHub issues, pasted writeups, existing use-case docs, and constituent feature docs before drafting anything.
  • Composition-mechanism framing: Grounds each use case in the four composition mechanisms (subtract, add, alternative implementation, alternative default config) and applies a decomposition rubric to confirm the entry qualifies as a use case rather than a feature.
  • Registry consistency cascade: After drafting, propagates narrow updates to constituent feature docs, Case-1 sibling docs, sibling use cases, and the use-cases README index, then proposes a commit structure.
  • Use Case: When asked to "document low-latency live playback as a composed use case," the Skill produces a delivery-focused entry naming composition, current status, missing prerequisite features, constraints, and source evidence.

Quick Start

Ask the assistant to document a new SPF use case for your delivery scenario, providing any relevant Notion links, GitHub issues, or existing design docs as context.

Frequently Asked Questions about document-spf-use-case

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document a new SPF use case?โ–ผ

Invoke the skill with a use-case name or description, optionally linking Notion docs or GitHub issues. It triangulates sources, confirms scope and definition depth with you, drafts the entry at internal/design/spf/use-cases/, and cascades cross-links to related docs.

What is the difference between an SPF feature doc and a use-case doc?โ–ผ

A feature doc covers source-shape correctness (Case-1: the engine handles this source correctly), while a use-case doc covers delivery-mode composition (Case-2: the engine is composed for a delivery scenario). The skill explicitly checks this distinction and routes feature-shaped requests to the feature skill.

What are the four composition mechanisms in SPF use cases?โ–ผ

The four mechanisms are subtract (omit behaviors), add (include new behaviors), alternative implementation (swap a behavior), and alternative default config (change defaults). The skill evaluates all four at scoping time even if only one ends up populated.

When should a behavior stay in a use-case doc instead of getting its own feature doc?โ–ผ

A behavior stays in the use-case doc when it fails the earns-its-place rubric: no substantial independent implementation footprint, no independent priority or timeline, and no reuse by other engine consumers. Such glue behaviors belong in the Composition specifics section.

Does the skill commit changes automatically?โ–ผ

No. After drafting and cascading updates, it audits the working tree, proposes a commit structure, and asks for explicit confirmation via a question prompt. On decline, it stops and leaves commits to the user.