| name | document-spf-feature |
| description | Document an SPF feature record. Use when the user explicitly requests capability scope, relationships, status, constraints, or evidence. |
Document an SPF feature
Read references/workflow.md completely before acting; it contains the detailed registry, decomposition, evidence, cascade, and validation workflow.
Confirm that the user explicitly requested creation or revision of the entry. Do not create adjacent feature, use-case, design, or decision records discovered during the workflow; surface them as candidates instead.
Registry entries guide planning but do not override code. Read internal/design/spf/features/clusters.md, a strong neighboring entry, relevant implementation/tests, and linked records.
- Classify the engine capability and distinguish it from delivery use cases or implementation conventions.
- Separate current behavior from proposed direction and decisions still needed.
- For shipped work, retain decisions, consequences, and current source pointers. For future work, retain scope, boundaries, and evidence required before implementation.
- Update directly affected entries only when their facts changed; verify links and relationship symmetry.
Cite repository paths for implemented behavior. Remove phase tables, speculative file inventories, and progress logs once code lands. Do not mark work implemented without code and verification evidence, and do not implement the feature unless requested.
Example
Input: “Document the current depth of discontinuity handling.”
Output: A compact evidence-backed entry separating implemented behavior, remaining decisions, constraints, and source pointers.
