goalforge-archivelisted

goalforge-internal — use entry commands; do not auto-trigger Archive a completed goalforge feature to its terminal `archived` status, optionally recording that it supersedes a prior feature. Fail-closed: REFUSES unless the feature is `status: completed` (cannot archive draft/ready/active). On `--supersedes <old>` writes the `supersedes`/`superseded_by` relationship edges on both features and archives the old one too, verifying both slugs exist first. A `--relocate` mode reconciles a STRANDED archived feature — one already `status: archived` but still physically at the active plans root (status set out-of-band, never moved) — by moving it into `_archived/` (move-only, no frontmatter edit; requires status: archived). Runs the strict validator gate and an ensure-committed check. TRIGGER: 'archive feature', 'archive completed feature', 'feature B supersedes A', 'migration archive', 'relocate stranded archived feature', 'reconcile archived plan at active root'. Human-gated / on-demand — NOT part of the sdd chain.
Truncuso/cogwright · ★ 0 · AI & Automation · score 75

Install: claude install-skill Truncuso/cogwright

# goalforge-archive Drives a feature to its terminal `archived` status — the historical-record end state. Two modes: a **plain archive** of one completed feature, and a **supersession archive** that also records `supersedes`/`superseded_by` edges between a replacing feature and the one it replaced. `completed → archived` is **explicit user action only** — it is never automatic. `goalforge-verify` advances a feature to `completed` (last-WP rule) and then *offers* archival; this skill performs it on request. Schema reference: `${CLAUDE_PLUGIN_ROOT}/references/schema.md`. Archive-consumer contract (what an archived slug guarantees to edge consumers): `${CLAUDE_PLUGIN_ROOT}/references/archive-contract.md`. ## Plans root `<feature>` (and `--supersedes <old>`) name folders inside `<PLANS_ROOT>/`. Resolve `<PLANS_ROOT>` per `${CLAUDE_PLUGIN_ROOT}/references/schema.md` §PLANS_ROOT resolution: env `SDD_PLANS_DIR` → project git-root `plans/` → global `~/.claude/plans/`. ## Inputs - `<feature>` — the feature slug to archive (required). - `--supersedes <old>` — optional; the prior feature slug that `<feature>` replaces. - `--relocate` — optional; reconcile a **stranded** archived feature (move-only). Mutually exclusive with `--supersedes`. See *Relocate mode* below. - `--strict-refs` — optional; escalate the reference-gate (Step 4b) from WARN to REFUSE (exit 6) when inbound **path** references to the feature would dangle after the move. Recommended for interactive archival