spec-update
Make a minimal evidence-backed update to a non-plan product, architecture, API, schema, or behavior contract. Use when implementation or validation cannot determine correctness from the current author
SKILL.mdplugins/yarstack/skills/spec-update/SKILL.md
GitHubSpecification Update
Correct an authoritative semantic contract only when current work depends on it.
Workflow
- Identify the missing or incorrect contract, its canonical document and owner, and the current task it blocks.
- Use
plan-updatefor implementation-plan mechanics anddocs-drift-reviewfor ordinary prose drift. - Decide whether the change is a clarification or a new decision. Apply a clarification that code, tests, or other authoritative evidence supports. A new product or architecture decision belongs to the user or the named owner: stop and ask, or use
architecture-refinewhen the user is available for it. - Confirm authority before editing linked documents outside the repository or requested scope.
- Apply only the minimum supported correction in the document's existing structure and style.
- State the downstream acceptance or validation effect, and the compatibility impact when the contract is published to other consumers. Then return to the invoking task.
Do not create speculative features, use specifications as implementation logs, rewrite unrelated sections, or silently invent behavior.
Finish with the changed contract, supporting evidence, concrete decision, downstream impact, and any remaining blocker.