implement-spf-feature

Implements SPF engine features from registry docs with tests and status updates.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Implementing a documented SPF engine feature without a disciplined workflow leads to code that drifts from the feature doc, misses open questions, skips conventions, and leaves the feature registry stale. This Skill enforces a structured disambiguation, planning, TDD, and registry-update workflow so implementations match the documented scope.

Core Features & Use Cases

  • Feature disambiguation and routing: Resolves whether a request maps to an existing feature doc, a use case, or cluster policy before any code is written.
  • Destination-architecture framing: Sketches the cluster's target shape and assesses fold-in candidates (full, partial, design-with-in-mind, ignore) so the implementation fits the larger architecture.
  • Test-driven chunked implementation: Splits scope into testable state, behavior, composition, adapter, and documentation chunks, each landing with a failing test first.
  • Registry synchronization: Updates the feature doc's Status, Implementation surface, and Verification sections as code lands.
  • Use Case: Given a request like "implement the smallest useful increment of timeline discontinuity support," the Skill reads the feature doc, resolves open questions, implements the minimal end-to-end increment with tests, and reports deferred scope.

Quick Start

Ask the agent to implement the smallest useful increment of a named SPF feature from the registry, for example "implement audio-abr Phase 1".

Frequently Asked Questions about implement-spf-feature

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

FAQPage Schema
How do I implement an SPF feature from the feature registry?

Invoke the skill with the feature doc name, such as audio-abr. It reads internal/design/spf/features/<name>.md, disambiguates the request, plans the smallest end-to-end increment, implements it test-first in chunks, and updates the doc's status sections.

What is the difference between implementing an SPF feature and an SPF use case?

Features are engine capabilities or source-shape correctness landing in the standard composition, while use cases are delivery-mode or variant assembly choices. The skill's Step 1 disambiguation routes use-case requests to the use-case implementation skill instead.

Does the skill treat the feature doc as a fixed specification?

No. The doc is a planning starting point, not a hardened spec. The skill surfaces every doc revision explicitly during implementation and consolidates cumulative updates in the final registry-update step.

What happens when a fold-in candidate seems too large to implement?

The skill checks for a focused partial-implementation cut rather than rejecting the candidate outright. It distinguishes partial implementation, where concrete code lands, from design-with-in-mind, where only the current feature's shape is constrained.

Why does the skill require tests before implementation?

It enforces TDD per chunk: add or update a failing test, implement the minimum at the correct ownership layer, then run the narrow target. Implementation-first produces tests that pass by construction and hide real defects.