| name | create-spf-behavior |
| description | Create or extract one SPF playback-engine behavior. Use for a new atomic responsibility with signals, lifecycle, cleanup, composition, and tests. |
Create an SPF behavior
Read references/workflow.md completely before acting; it contains the detailed SPF creation workflow and failure checks.
Read adjacent behaviors, the composition site, state/context slots, and internal/design/spf/conventions/README.md. Load only the applicable signal, actor, reactor, configuration, or behavior convention.
- Define one-sentence purpose, inputs, writes, lifecycle, cleanup, ordering, and source-reset rules.
- Confirm the responsibility is independently testable and does not hide coordination with another behavior.
- Add focused failing tests, implement the smallest behavior, and wire it at the owning composition layer.
- Verify slot ownership, naming, cleanup, boundaries, and final test coverage.
If existing ownership must change, treat the work as a behavior refactor. If the requested capability spans multiple behaviors, keep this workflow scoped to the one atomic responsibility and surface the broader composition work separately.
Run the narrow affected SPF tests. Build SPF when public types or exports change, and measure size when a public entry point can grow.
Example
Input: “Extract manifest refresh scheduling into its own behavior.”
Output: One independently testable responsibility with explicit inputs, writes, lifecycle, cleanup, composition, and proportional verification.