← ClaudeAtlas

closelisted

Retires a single SpecScore artifact — an Idea, Feature, or sidekick seed — by driving the appropriate `specscore <kind> change-status` CLI verb with an optional/required `--note`, never by hand-editing. One artifact, one change-status call: the status transition, the `## Resolution` note, any relocation, and the index sync all happen atomically in that single verb. Negative transitions (e.g. a seed `Rejected`) require a reason. Close confirms the terminal status, drives the verb, and branches on its exit code — it never edits the `**Status:**` line, frontmatter, `type:`, or an index row, even on CLI failure. Trigger: "close", "/close", "specstudio:close", "retire this artifact".
specscore/specstudio-skills · ★ 0 · AI & Automation · score 69
Install: claude install-skill specscore/specstudio-skills
# Close Retire one SpecScore artifact when its work is done. `close` is a thin driver over the `specscore <kind> change-status` CLI verbs: it resolves the artifact's kind, confirms the terminal status with the user, captures a reason when one is required, and performs **exactly one** `change-status` call. That single call does the status rewrite, writes any `## Resolution` note (`--note`), relocates a seed to `archived/`, and syncs the index — atomically, with rollback on failure. **Load-bearing invariant:** `close` NEVER hand-edits status. Every transition goes through the CLI verb — not as a primary path, and not as a fallback on failure. A hand-edit anywhere is a contract violation. Implements the [Close Skill Feature](../../spec/features/skills/close/README.md). ## When to Use - A single Idea, Feature, or sidekick seed has reached end-of-life (shipped, superseded, rejected, or parked) and the user wants to retire it. - The user types `/close <artifact>` or asks to retire/close/reject an artifact. **Refuse and redirect when:** - The invocation does not resolve to exactly one existing artifact, or resolves ambiguously to more than one kind → stop and ask the user which artifact; write nothing. (AC: `resolves-kind-and-verb`) - The transition would be illegal for the resolved artifact (the CLI returns exit `4`) → surface the current status and the legal source set; do not retry, do not hand-edit. (AC: `surfaces-illegal-transition`) ## Kind → verb → terminal