@gobing-ai/spur 0.4.24 → 0.4.25

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
     "plugins": [
         {
             "name": "sp",
-            "version": "0.4.24",
+            "version": "0.4.25",
             "source": "./plugins/sp"
         }
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/spur",
-    "version": "0.4.24",
+    "version": "0.4.25",
     "description": "Spur CLI — local-first harness for mainstream coding agents: constraint checking, workflow orchestration, agent health, and history analytics. Bun-native; exposes the `spur` command.",
     "keywords": [
         "spur",

package/plugins/sp/README.md

@@ -333,6 +333,7 @@ surface or run one workflow. All skills target the same five core platforms: `cl
 | `functional-review`         | 1.0   | Requirements-traceability assessment — per-requirement verdicts with file:line evidence that the implementation satisfies ALL task requirements; pipeline Phase 8b gate                                                                    |
 | `doubt-driven-development`  | 1.0   | In-flight adversarial review of a non-trivial decision before committing it — hand artifact + contract to a fresh-context skeptic, reconcile, stop at 3 cycles                                                                             |
 | `source-driven-development` | 1.0   | Source-first verification — verify framework/API/library facts against primary sources before generating code; separates "the API exists" from "used correctly under its contract"                                                         |
+| `sp-bot-bootstrap`          | 1.0   | Grok Bot toolchain bootstrap — POSIX `sh` check/setup pair installing `bun` plus the three sp CLIs; idempotent after a computer recreate; Team Setup Script variant (1292, feature I14 R4) |
 | `dogfood-testing`           | 1.2   | Dogfood backbone — drives a testee end-to-end with bounded auto-fix, a live monitor ledger, and a structured report; @1.2 adds footer-mandatory reports, 7-check finalize-or-abort, and the `validate-report` CLI; backs `/sp:dev-dogfood` |
 | `next-router`               | 1.0   | Status→command router — resolve a task WBS or feature frontier, TABLE A/B/C lookup with light-gate short-circuit, single dispatch or HITL stop; backs `/sp:dev-next`                                                                       |
 | `parallel-execution`        | 1.0   | Fan-out decision framework — when to parallelize, four proven fan-out patterns, and result synthesis; backs `/sp:dev-runall --mode parallel\|auto`                                                                                                           |
@@ -709,6 +710,57 @@ pipeline owns one lifecycle phase:
 > (zero runs, example-only — `docs/design/workflow-catalogue-refactor.md` §10); the pattern lives on
 > as a test fixture (`packages/app/tests/services/fixtures/decision-routing-example.yaml`).
 
+#### Runtime `requires` metadata (task 1291, superskill 0162)
+
+Every sp entity (`skills/*/SKILL.md`, `commands/*.md`, `agents/*.md`) declares a `requires:`
+frontmatter list in the superskill 0162 grammar — a sorted YAML flow list of tokens:
+
+- `local-fs` — the entity acts on local project files. All 88 entities require it.
+- `cli:<tool>` — a tracked CLI the entity's body invokes directly (`spur`, `superskill`, `kk`,
+  `gh`) or inherits through a dispatched `Skill(skill="sp:<id>…")` skill.
+- `hooks` / `subagents` — reserved tokens; no sp entity currently declares either.
+
+The declared set intentionally equals the union of direct invocations and the transitive `requires`
+of every dispatch target, so the set stays self-maintaining:
+`plugins/sp/tests/runtime-requires.test.ts` derives the expected set from each entity body,
+compares it to the annotation (missing tokens fail on undeclared use, direct or inherited; extra
+stale tokens fail too), and pins the group snapshot from the 2026-11-04 scan: 70 entities
+`[cli:spur, local-fs]`, 2 `[cli:gh, local-fs]`, 2 `[cli:gh, cli:spur, local-fs]`, 14 `[local-fs]`.
+Consumers (e.g. `superskill skill validate`) read the same line, declaring what a skill needs
+before it runs instead of discovering it at invocation time.
+
+#### Grok Bot (task 1291, feature I14 R4)
+
+The `requires` annotations let a Grok Bot (superskill 0162) decide what it can run before it runs it.
+The four tokens mean, in Bot context:
+
+- `local-fs` — the entity needs the local project files (corpus, docs, git checkout). A Bot only has
+  these after a repo is cloned; the operator opts in with `--bot-provides local-fs`.
+- `cli:spur` / `cli:superskill` / `cli:kk` — the tracked, non-baseline CLIs the entity may invoke.
+  Until 1292's `sp-bot-bootstrap` skill installs them on the Bot, these are unmet.
+- `cli:gh` — `gh` CLI use; provide it only when `gh` is authenticated on the Bot.
+- `hooks` / `subagents` — reserved tokens; no sp entity declares either today.
+
+**sp hooks do not run on a Bot.** The hook tools that ship in `hooks/` (task-write guard, careful
+guard, context token ledger, fleet Stop delivery) are harness extensions; a Grok Bot session has no
+hook runtime, so those protections are not claimed on a Bot. Follow the skills' explicit gate
+instructions and the CLI validation instead.
+
+**With defaults every sp entity is excluded.** A Bot that meets none of the declared requirements
+installs nothing; an operator opts an entity set in explicitly with `--bot-provides`.
+
+**Bootstrap first (1292).** For a fresh Bot computer, follow the `sp-bot-bootstrap` skill —
+check, then setup only on a nonzero exit, then check again — before installing the plugin.
+
+**Recommended install after 1292's bootstrap** (follow the `sp-bot-bootstrap` skill first, which
+installs bun plus `spur`, `superskill` and `kk`), then:
+
+```
+superskill install sp --targets grok-bot --bot-provides cli:spur --bot-provides local-fs
+```
+
+plus `--bot-provides cli:gh` when `gh` is available on the Bot.
+
 ### Lifecycle operations
 
 All planning entities (tasks and features) share a common lifecycle, managed by the `spur` CLI:

package/plugins/sp/agents/expert-spur.md

@@ -9,6 +9,7 @@ description: |-
   assistant: "Delegating to sp:expert-spur — loads the task reference, resolves the set, then applies and checks each transition."
   <commentary>A multi-task sweep needs isolated sequencing and between-operation judgment.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: green

package/plugins/sp/agents/super-coder.md

@@ -9,6 +9,7 @@ description: |
   assistant: "Delegating to sp:super-coder — dispatches sp:code-implementation to write the code against the task's requirements and AC."
   <commentary>A single task's implementation is the build agent's core unit of work.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: blue

package/plugins/sp/agents/super-planner.md

@@ -9,6 +9,7 @@ description: |
   assistant: "Delegating to sp:super-planner — resolves feature:A1, topo-sorts by dependencies, runs each through task-pipeline.yaml, emits a report."
   <commentary>A batch needs between-runs judgment: set resolution, dependency ordering, failure policy.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: green

package/plugins/sp/agents/super-reviewer.md

@@ -16,6 +16,7 @@ description: |
   assistant: "Delegating to sp:super-reviewer — pipeline Phase 7 review of task 0042's diff."
   <commentary>Pipeline review step.</commentary>
   </example>
+requires: [cli:spur, local-fs]
 tools: [Read, Grep, Glob, Bash, Skill]
 model: inherit
 color: crimson

package/plugins/sp/commands/dev-arch.md

@@ -1,5 +1,6 @@
 ---
 description: Survey a codebase (or module tree) for shallow modules and deepening opportunities — emit a ranked MARKDOWN candidate report that feeds the planning half; never auto-refactors
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[<module-path>] [--scope <all|path>] [--agent <inline|auto|name>] [--json]"
 allowed-tools: ["Bash", "Read", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-brainstorm.md

@@ -1,5 +1,6 @@
 ---
 description: Interactive solution design — heuristic discovery interview followed by structured ideation with trade-offs and confidence scoring
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "<topic> [--depth <basic|detailed|comprehensive>] [--options <n>] [--agent <inline|auto|name>] [--skip-discovery] [--task [<feature-id>]] [--feature [<parent-id>]] [--next]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-changelog.md

@@ -1,5 +1,6 @@
 ---
 description: Generate changelog from git commits
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[<file>] [--since <tag|commit>] [--until <tag|commit>] [--version <version>]"
 allowed-tools: ["Bash", "Read", "Edit"]

package/plugins/sp/commands/dev-daily.md

@@ -1,5 +1,6 @@
 ---
 description: "Generate a daily summary report from agent usage data, git history, and notes"
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[--date <YYYY-MM-DD>] [--dry-run] [--output <path>] [--no-git] [--no-ccusage]"
 allowed-tools: ["Bash", "Read"]

package/plugins/sp/commands/dev-debug.md

@@ -1,5 +1,6 @@
 ---
 description: "Systematic debugging protocol — reproduce, isolate, diagnose root cause, apply minimal fix, and verify with regression tests"
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "\"<symptom | failing command>\" [--scope <path>] [--task [<wbs>]] [--agent <inline|auto|name>]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/dev-dogfood.md

@@ -1,5 +1,6 @@
 ---
 description: Dogfood an agent skill/command/CLI — drive it end-to-end with bounded auto-fix, self-monitor, and emit a comprehensive report
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "<testee> [--agent <inline|auto|name>] [--max-retry <n>] [--save] [--task] [--chain-follow] [--full]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-feature-change.md

@@ -1,5 +1,6 @@
 ---
 description: "Restructure the feature tree from a mapping file — dry-run then apply via spur feature move / task feature_id edges / root docs/*.md reference rewrites (CLI-gated; no raw Write on docs/features or docs/tasks). Triggers: feature restructure, feature tree move, reparent features, apply mapping file"
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[--map <path>] [--dry-run] [--apply] [--limit <old-id>] [--wave <1|2|3|all>] [--yes]"
 allowed-tools: ["Bash", "Read", "AskUserQuestion", "Skill"]

package/plugins/sp/commands/dev-find-conflict.md

@@ -1,5 +1,6 @@
 ---
 description: "Authority-aware semantic audit across source, task files, feature files, and project authority files — discover conflicts, resolve claim-specific authority, collect reproducible evidence, and route confirmed repairs through owner surfaces. Triggers: find conflict, conflict audit, semantic conflict, authority mismatch, stale projection."
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[--tasks <selector> | --feature <id>[,<id>] | --scope <path>[,<path>]] [--pillar <source|tasks|features|authority|all>] [--mode <adaptive|full>] [--resolve] [--auto] [--agent <inline|auto|name>] [--json]"
 allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-find-issue.md

@@ -1,5 +1,6 @@
 ---
 description: "Generate the daily or ad-hoc history-anatomy diagnostic report over already-imported history: the twelve-section report contract, closed finding taxonomy, cache branch, bounded correction, and atomic publication. Triggers: find historical issues, post-mortem, performance analysis, history-anatomy, run the daily report, ad-hoc diagnosis"
+requires: [local-fs]
 role: reviewer
 argument-hint: "[<focus>] [--mode <daily|ad-hoc>] [--date <YYYY-MM-DD>] [--since <RFC3339>] [--until <RFC3339>] [--recompute] [--agent <auto|name>] [--output <path>]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-find-next.md

@@ -1,5 +1,6 @@
 ---
 description: "Prompt-first feature frontier prioritizer — answers 'which feature should we work on now?' with a ranked, evidence-carrying frontier, and emits rank-distorting tree defects as proposals /sp:dev-feature-change consumes. Triggers: find next, which feature, feature ranking, frontier priority, what should I work on."
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[--task [<feature-id>]] [--agent <inline|auto|name>] [--auto] [--json]"
 allowed-tools: ["Bash", "Read", "Write", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-find-way.md

@@ -1,5 +1,6 @@
 ---
 description: Wayfinder — chart a multi-session investigation map for a foggy destination, or resolve one map ticket, always inside an isolated git worktree + branch
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "<idea> | <feature-id> [<wbs>] [--agent <inline|auto|name>] [--auto] [--worktree [<name>]] [--wrap]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-fixall.md

@@ -1,5 +1,6 @@
 ---
 description: Fix all lint, type, and test errors systematically across the working tree
+requires: [local-fs]
 role: coder
 argument-hint: "[<validation-command>] [--max-retry <n>] [--scope <path>] [--gate-log <path>] [--findings <anchors>]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]

package/plugins/sp/commands/dev-fixgha.md

@@ -1,5 +1,6 @@
 ---
 description: Find and fix failing GitHub Actions runs — gh fetch → diagnose → root-cause fix → commit → push → re-verify until green
+requires: [cli:gh, local-fs]
 role: coder
 argument-hint: "[<context>] [--max-retry <n>] [--no-push]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]

package/plugins/sp/commands/dev-gitmsg.md

@@ -1,5 +1,6 @@
 ---
 description: Generate conventional commit message(s) from the current change set via one bounded gather call, optionally commit
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[--commit] [--squash] [--all] [--scope <path>] [--check <cmd>]"
 allowed-tools: ["Bash", "Read"]

package/plugins/sp/commands/dev-gtd.md

@@ -1,5 +1,6 @@
 ---
 description: Get things done — quality gate → fix → commit → push → gh verify in one flow (optional act CI simulation via --act)
+requires: [cli:gh, local-fs]
 role: coder
 argument-hint: "[<quality-gate-command>] [--dry-run] [--act] [--no-push] [--no-verify] [--scope <path>] [--max-retry <n>]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Grep", "Glob"]

package/plugins/sp/commands/dev-handover.md

@@ -1,5 +1,6 @@
 ---
 description: Generate a structured handover document when blocked — captures goal, progress, blocker, rejected approaches, and next steps
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "\"<blocker description>\""
 allowed-tools: ["Bash", "Read", "Write"]

package/plugins/sp/commands/dev-idea.md

@@ -1,5 +1,6 @@
 ---
 description: Turn a vague idea into a feature with AC and a decomposed task batch — discovery, idea-eval, feature-create, AC, system-design, decompose, batch-create (Design by default), handoff
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "\"<idea>\" | --from-file <path> [--skip-design] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-job-dump.md

@@ -1,5 +1,6 @@
 ---
 description: Dump remaining work to a Markdown handoff file
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "--file <path>"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/dev-job-resume.md

@@ -1,5 +1,6 @@
 ---
 description: Resume remaining work from a Markdown handoff file
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "--file <path>"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill"]

package/plugins/sp/commands/dev-next.md

@@ -1,5 +1,6 @@
 ---
 description: Status-aware router — pick and run the next best /sp:dev-* step for a task or feature frontier
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "[<wbs|feature-id>] [--dry-run] [--once] [--auto] [--agent <inline|auto|name>] [--full]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-plan.md

@@ -1,5 +1,6 @@
 ---
 description: Plan a feature from a description — intake → feature create → AC generation → decomposition → batch-create (Design by default)
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "\"<description>\" [--feature <id>] [--parent <feature-id>] [--skip-design] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-pr-review.md

@@ -1,5 +1,6 @@
 ---
 description: "Local-first PR review — status, a local branch-diff review, and validated fixes; --codex opts into the GitHub Codex review spine."
+requires: [cli:gh, cli:spur, local-fs]
 role: reviewer
 argument-hint: "[status|review|fix] [--codex] [--force] [--no-wait] [--base <branch>] [--agent <inline|auto|name>] [<focus>]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-refactor.md

@@ -1,5 +1,6 @@
 ---
 description: Lens-routed refactoring with a preservation contract — taste lenses classify findings against the shared schema; cutting/breaking changes pause for operator approval
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[<description>] [--scope <path>] [--focus <api|architect|tests|ui|auto>] [--fix <none|blockers-first|all>] [--check <cmd>] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/commands/dev-refine.md

@@ -1,5 +1,6 @@
 ---
 description: Refine or re-audit a task — fill missing sections via Q&A, or with --depth ready verify existing claims and fixes against the tree, correct them, and promote to todo
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "<wbs> [--focus <mode>] [--description <text>] [--depth <standard|ready>] [--agent <inline|auto|name>] [--auto] [--next]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-refineall.md

@@ -1,5 +1,6 @@
 ---
 description: Refine a batch of tasks via structured Q&A — resolve a set (feature or selector), refine each in dependency-correct order, emit a batch report; --depth ready audits, corrects and promotes each task
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "--feature <id> | --tasks <selector> [--focus <mode>] [--description <text>] [--depth <standard|ready>] [--agent <inline|auto|name>] [--auto] [--keep-going] [--status <s>] [--json] [--worktree [<name>]]"
 allowed-tools: ["Bash", "Read", "Skill", "AskUserQuestion"]

package/plugins/sp/commands/dev-refresh.md

@@ -1,5 +1,6 @@
 ---
 description: Refresh feature status by feature ID, task WBS, or batch sweep via spur feature sync
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[<feature-id|wbs>] [--all] [--auto] [--agent <inline|auto|name>]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-reverse.md

@@ -1,5 +1,6 @@
 ---
 description: Reverse engineer a codebase with selectable depth, focus, and output format
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "[<path>] [--mode <briefing|structure|architecture|design|full>] [--focus <all|stack|dependencies|data|flows|api|security|quality|performance>] [--format <markdown|json|both>] [--output <file>] [--agent <inline|auto|name>]"
 allowed-tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash", "Skill"]

package/plugins/sp/commands/dev-review-session.md

@@ -1,5 +1,6 @@
 ---
 description: "Review the active coding-agent session immediately: summarize outcomes, distinguish resolved and open issues with evidence, and propose bounded improvements. With --fix auto (alias --triage): apply pure-doc / one-to-two-line fixes inline, then file remaining findings as one or more implement-ready tasks. With --fix all: fix every actionable finding inline and file no task. Triggers: review this session, session wrap-up, immediate retrospective, what happened, what was resolved, triage findings"
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[<focus>] [--fix <none|auto|all>] [--triage]"
 allowed-tools: ["Bash", "Read", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/dev-review.md

@@ -1,5 +1,6 @@
 ---
 description: "Review code for a task set or paths — multi-dimensional review across functional traceability, SECUA quality, and architectural depth. With --triage: fix small findings directly, then file the rest as implement-ready tasks. Triggers: \"review this\", \"check the code\", \"SECUA review\", \"dev review\", \"audit this\", \"triage review findings\"."
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[--tasks <selector> | --feature <id>[,<id>] | --scope <path>[,<path>]] [--agent <inline|auto|name>] [--focus <dims>] [--triage] [--worktree [<name>]] [--auto]"
 allowed-tools: ["Bash", "Read", "Skill", "Edit", "Write"]

package/plugins/sp/commands/dev-run.md

@@ -1,5 +1,6 @@
 ---
 description: Run a task — full pipeline (precheck→implement→test→review→approve→verify→record→done) or single-step (implement)
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "<wbs> [--mode <full|implement>] [--agent <inline|auto|name>] [--auto] [--next] [--wrap] [--continue] [--worktree [<name>]] [--no-summary]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill"]

package/plugins/sp/commands/dev-runall.md

@@ -1,5 +1,6 @@
 ---
 description: Run a batch of tasks through their pipelines in dependency-correct order — resolve a set, topo-sort, run each via task-pipeline.yaml, emit a batch report
+requires: [cli:spur, local-fs]
 role: planner
 argument-hint: "--tasks <selector> [--feature <id>] [--mode <sequential|parallel|auto>] [--concurrency <n>] [--keep-going] [--auto] [--agent <inline|auto|name>] [--json] [--wrap] [--next] [--continue] [--worktree [<name>]] [--no-summary] [--defer-gate]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-simplify.md

@@ -1,5 +1,6 @@
 ---
 description: Simplify code for clarity without changing behavior — reduce complexity in recent changes (or a given scope), preserving behavior exactly
+requires: [local-fs]
 role: coder
 argument-hint: "[<path-or-scope>] [--scope <recent|all|path>] [--check <cmd>] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/commands/dev-unit.md

@@ -1,5 +1,6 @@
 ---
 description: Generate or extend tests until the unit target is met
+requires: [local-fs]
 role: coder
 argument-hint: "<target> [--coverage <n>] [--agent <inline|auto|name>] [--auto]"
 allowed-tools: ["Bash", "Read", "Write", "Edit", "Skill"]

package/plugins/sp/commands/dev-verify.md

@@ -1,5 +1,6 @@
 ---
 description: Verify a task against its requirements and Acceptance Criteria — traceability check producing a PASS/PARTIAL/FAIL verdict with evidence
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "<wbs> [--agent <inline|auto|name>] [--fix <none|blockers-first|all>] [--focus <lens>] [--bdd] [--auto] [--force] [--next] [--skip-shippable]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-verifyall.md

@@ -1,5 +1,6 @@
 ---
 description: Verify a batch of tasks against their requirements and Acceptance Criteria — batch traceability check producing per-task verdicts and a summary report
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "--tasks <selector> [--feature <id>] [--agent <inline|auto|name>] [--fix <none|blockers-first|all>] [--focus <lens>] [--bdd] [--auto] [--force] [--next] [--json] [--skip-shippable] [--worktree [<name>]]"
 allowed-tools: ["Bash", "Read", "Skill"]

package/plugins/sp/commands/dev-wrap.md

@@ -1,5 +1,6 @@
 ---
 description: Wrap up a single completed task — learnings, metrics, doc-sync, optional branch cleanup
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "<wbs> [--agent <inline|auto|name>] [--auto] [--merge] [--dry-run]"
 allowed-tools: ["Bash", "Read", "AskUserQuestion"]

package/plugins/sp/commands/dev-wrapall.md

@@ -1,5 +1,6 @@
 ---
 description: Wrap up a batch of completed tasks — learnings, metrics, doc-sync, optional branch cleanup
+requires: [cli:spur, local-fs]
 role: coder
 argument-hint: "[--since <iso-date>] [--feature <id>] [--status <s>] [--agent <inline|auto|name>] [--auto] [--merge] [--dry-run]"
 allowed-tools: ["Bash", "Read", "AskUserQuestion"]

package/plugins/sp/commands/rule-add.md

@@ -1,5 +1,6 @@
 ---
 description: Author a validated, smoke-tested constraint rule
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "\"<description>\" [--file <path>] [--preset <target>]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/rule-refine.md

@@ -1,5 +1,6 @@
 ---
 description: Refine a constraint rule or preset, then re-verify it
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "<rule-file-or-preset> [--intent \"<goal>\"] [--severity <sev>] [--scope <glob>] [--exempt <path>] [--disable <id>] [--override <id>] [--dry-run]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/commands/rule-scan.md

@@ -1,5 +1,6 @@
 ---
 description: Discover recurring anti-patterns worth codifying as rules
+requires: [cli:spur, local-fs]
 role: reviewer
 argument-hint: "[<path-or-glob>]"
 allowed-tools: ["Bash", "Read", "Grep", "Glob", "Skill"]

package/plugins/sp/commands/spur-init.md

@@ -1,5 +1,6 @@
 ---
 description: Initialize a new Spur project — scaffold config + docs, then customize for this project's stack and scope
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "[--name <name>] [--minimal] [--force]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/workflow-add.md

@@ -1,5 +1,6 @@
 ---
 description: Author a validated, dry-run-verified workflow in the right execution mode
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "\"<description>\" [--kind <state-machine|transition-flow>] [--file <path>]"
 allowed-tools: ["Bash", "Read", "Write", "Skill"]

package/plugins/sp/commands/workflow-refine.md

@@ -1,5 +1,6 @@
 ---
 description: Refine an existing workflow, then re-validate and re-dry-run it
+requires: [cli:spur, local-fs]
 role: scribe
 argument-hint: "<workflow-file> [--intent \"<goal>\"] [--dry-run]"
 allowed-tools: ["Bash", "Read", "Edit", "Skill"]

package/plugins/sp/plugin.json

@@ -1,5 +1,5 @@
 {
     "name": "sp",
-    "version": "0.4.24",
+    "version": "0.4.25",
     "description": "Spur — a local-first harness engineering toolkit that wraps mainstream coding agents with constraint checking, workflow orchestration, and history analytics."
 }

package/plugins/sp/skills/brainstorm/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: brainstorm
 description: "Structured ideation: generate solution options with trade-offs and source citations, then delegate to research/task-creation skills. Triggers: \"brainstorm ideas\", \"explore solutions\", \"consider options\", \"research approaches\", \"what are my options\", \"how should I approach X\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 created_at: 2026-03-25

package/plugins/sp/skills/branch-workflow/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: branch-workflow
 description: "Branch lifecycle discipline: create, worktree, commit, self-review, merge, cleanup."
+requires: [cli:spur, local-fs]
 disable-model-invocation: true
 license: Apache-2.0
 metadata:

package/plugins/sp/skills/code-implementation/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-implementation
 description: "The implementation competency — turn a task's requirements, AC, and design into production code: task-driven scope, stack-pattern selection, root-cause debugging, a Solution change-map. Triggers: \"implement\", \"write code\", \"add feature\", \"fix the bug\", \"refactor\", \"code this task\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-improvement/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-improvement
 description: "Surface architectural friction and propose deepening opportunities — refactors that turn shallow, tightly-coupled modules into deep, testable, AI-navigable ones. Triggers: \"improve architecture\", \"find refactoring opportunities\", \"shallow module\", \"hard to test\", \"reduce coupling\", \"deepen modules\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-refactoring/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-refactoring
 description: "Refactoring coordinator with a preservation contract: routes the four taste lenses (api, architect, tests, ui), normalizes findings to a shared schema and P1–P4 severities, gates applies, runs a fix ladder with revert-on-regression. Use for 'dev-refactor', 'safe refactor', 'refactor while keeping every feature'."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-review
 description: "Pre-commit self-review checklist, structured review requests, and processing review findings into tasks. Triggers: \"review this\", \"self-review\", \"pre-commit check\", \"code review\", \"review my changes\", \"check before commit\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-simplification/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-simplification
 description: "Simplify code for clarity without changing behavior. Use when refactoring for readability or reducing complexity."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-testing/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-testing
 description: "The testing competency — run tests, measure coverage, categorize gaps, extend the suite with targeted tests across Bun/TS, Python, Go. Triggers: \"write tests\", \"measure coverage\", \"what's untested\", \"coverage gap\", \"extend the test suite\", \"run the tests\"."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/code-verification/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: code-verification
 description: "Verify a task's implementation against requirements and AC; SECUA code review. Produces a PASS/PARTIAL/FAIL verdict with per-requirement evidence. Triggers: \"verify task\", \"verify this\", \"check the requirements\", \"code review\", \"SECUA review\", \"requirements traceability\", \"review the diff\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/conflict-finding/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: conflict-finding
 description: "Authority-aware semantic audit across source, task files, feature files, and project authority files — detect conflicts, resolve claim-specific authority, collect reproducible evidence, and route confirmed repairs through owner surfaces. Triggers: find conflict, conflict audit, semantic conflict, authority mismatch, stale projection."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/daily-summary/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: daily-summary
 description: "Generate a daily summary report from agent usage, git history, and your notes."
+requires: [cli:spur, local-fs]
 disable-model-invocation: true
 license: Apache-2.0
 version: 1.0.0

package/plugins/sp/skills/doc-evolve/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: doc-evolve
 description: "Evolve docs/00-05 + AGENTS.md per docs/99_PROJECT_CONSTITUTION.md: drift audits, same-commit sync checks, frontmatter-contract verification, lesson-append. Triggers: \"doc evolve\", \"doc drift\", \"sync docs\", \"drift audit\", \"are the docs stale\", \"append a lesson\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/dogfood-testing/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: dogfood-testing
 description: "Drive a testee (skill/command/CLI) end-to-end as a real user, fix within a bounded retry budget, monitor with a live ledger, emit a structured report. Triggers: \"dogfood this\", \"drive this command end-to-end\", \"test this skill as a user\", \"dogfood report\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/doubt-driven-development/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: doubt-driven-development
 description: "In-flight adversarial review of a non-trivial decision before you commit it: extract the artifact + contract, hand them (not your reasoning) to a fresh-context skeptic, reconcile findings, stop at 3 cycles. Triggers: \"doubt this\", \"stress-test this decision\", \"adversarial check before I commit\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/fleet-join/SKILL.md

@@ -5,6 +5,7 @@ description: >-
   "join the fleet", "become a fleet guest", "pull fleet inbox work in this session", or when a
   session should receive fleet messages without being supervised. Runs `spur agent join`, then
   loops `spur agent wait --inbox`, and releases the lease with `spur agent leave`.
+requires: [cli:spur, local-fs]
 metadata:
   version: "1.0"
 ---

package/plugins/sp/skills/functional-review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: functional-review
 description: "Requirements traceability assessment: verify implementation satisfies ALL task requirements. Phase 8b gate for the sp pipeline. Produces per-requirement verdicts with file:line evidence. Triggers: \"functional review\", \"traceability check\", \"verify requirements\", \"did we build what was asked\", \"requirements completeness\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/history-anatomy/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: history-anatomy
 description: "Independent owner of diagnostic interpretation over already-imported history — the daily/ad-hoc mode contract, a closed finding taxonomy, the twelve-section report contract, and the enrich/validate rubrics. Triggers: history-anatomy, run the daily report, ad-hoc diagnosis, find issues over history."
+requires: [local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/indexed-context/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: indexed-context
 description: "Cross-agent project intelligence: file index (anatomy), learnings, pitfalls, bug log, token ledger, and session memory under .spur/context/. Triggers: \"load project context\", \"new session\", \"unfamiliar codebase\", \"index this codebase\", \"codebase memory\", \"indexed context\", \"project intelligence\"."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/issue-finding/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: issue-finding
 description: "Render the session forensics report, analyze agent session logs, find performance bottlenecks, propose fixes, and optionally create a structured task. Triggers: find issues, post-mortem, session review, topic focus."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 2.0.0
 metadata:

package/plugins/sp/skills/next-feature/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: next-feature
 description: "Prompt-first feature frontier prioritizer — answers 'which feature should we work on now?' by deriving importance/urgency from corpus, git, and authority-doc evidence, and emits rank-distorting tree defects as proposals /sp:dev-feature-change consumes. Triggers: find next, which feature, feature ranking, frontier priority, what should I work on."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/next-router/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: next-router
 description: "Status→command router backing /sp:dev-next — resolve a task WBS or feature frontier, load corpus signals, look up TABLE A/B/C, dispatch exactly one existing /sp:dev-* command or stop with an exact dev-next: message. Never a second pipeline FSM. Triggers: \"what's next\", \"advance this task\", \"which dev command\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/parallel-execution/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: parallel-execution
 description: "Decide when to fan out independent work across subagents, choose the fan-out pattern, synthesize parallel results. Triggers: \"fan out\", \"run in parallel\", \"parallelize\", \"concurrent execution\", \"multi-agent run\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/pr-reviewing/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: pr-reviewing
 description: "Local-first PR review — status, a local /sp:dev-review of the branch diff, and validated fixes; `--codex` opts into the GitHub Codex review spine. Backs /sp:dev-pr-review. Triggers: PR review, codex review, @codex review, review my PR, dev-pr-review."
+requires: [cli:gh, cli:spur, local-fs]
 license: Apache-2.0
 version: 2.0.0
 metadata:

package/plugins/sp/skills/redesign-web-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: redesign-web-ui
 description: "Upgrade an existing website or app UI past generic AI defaults without rewriting the stack. Triggers: \"redesign this UI\", \"make it look premium\", \"generic AI design\", \"polish this page\", \"restyle the web app\"."
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/reverse-engineering/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: reverse-engineering
 description: "Depth-driven codebase reverse engineering with orthogonal mode, focus, and output format controls. Use for unfamiliar codebases, architecture/design reconstruction, onboarding docs, technical debt assessment, and evidence-backed audit reports."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.1.0
 created_at: 2026-03-28

package/plugins/sp/skills/session-review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: session-review
 description: "Review the active coding-agent session: separate resolved from open issues with evidence, propose bounded improvements. With --fix auto (alias --triage), apply pure-doc / 1–2-line fixes inline and file the rest as tasks; with --fix all, fix every actionable finding inline and file none. Triggers: review this session, wrap-up, triage findings."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.3.0
 metadata:

package/plugins/sp/skills/source-driven-development/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: source-driven-development
 description: "Verify framework / API / library facts against primary sources before generating code, and separate \"the API exists\" from \"I used it correctly under its contract.\" The single sp owner of source-first verification. Triggers: \"check the docs first\", \"verify this API\", \"source-first\", \"is this the real signature\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/sp-bot-bootstrap/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: sp-bot-bootstrap
+description: "Bootstrap the sp toolchain (bun, spur, superskill, kk) on a Grok Bot computer or any fresh host: idempotent install skill that checks the PATH first, installs only what is missing, and is safe to re-run after a computer recreate. Triggers: \"bootstrap spur on Grok Bot\", \"install spur toolchain\", \"after computer recreate\"."
+requires: [local-fs]
+license: Apache-2.0
+metadata:
+  author: spur
+  version: "1.0"
+  platforms: "claude-code,codex,openclaw,opencode,antigravity"
+  interactions:
+    - environment-bootstrap
+  operations:
+    - check-toolchain
+    - install-toolchain
+---
+
+# sp-bot-bootstrap
+
+Bring a fresh host (typically a Grok Bot's cloud computer) to the minimum toolchain the sp
+plugin needs: the `bun` runtime plus the three CLIs `spur`, `superskill` and `kk`. The skill
+declares only `local-fs`: the fenced blocks resolve the tools on `PATH` and touch the official
+bun installer, so the 0162 scanner derives no registry-driven CLI requirement from this body.
+
+**Running it:**
+
+1. Run the **check** block.
+2. If check exits nonzero, run the **setup** block.
+3. Run the **check** block again — it must exit 0. If it does not, stop and report the check
+   output instead of retrying setup in a loop.
+
+Each block is standalone POSIX `sh`; run them exactly as they appear here. They only prepend
+`${BUN_INSTALL:-$HOME/.bun}/bin` to `PATH` inside the block, print one `missing: <tool>` line
+per absent tool, install with the official bun installer and `bun add -g`, and echo the
+`export PATH=…` line to append to the host environment. They never edit shell rc files, never
+read or write secrets or tokens, and write nothing outside `~/.bun` (the package manager's own
+cache aside).
+
+```sh sp-bot-bootstrap:check
+PATH="${BUN_INSTALL:-$HOME/.bun}/bin:$PATH"; export PATH; rc=0
+for pair in bun:bun spur:@gobing-ai/spur superskill:@gobing-ai/superskill kk:@gobing-ai/knowledge-kit; do
+  t=${pair%%:*}
+  if command -v "$t" >/dev/null 2>&1 && "$t" --version >/dev/null 2>&1; then
+    continue
+  fi
+  echo "missing: $t"
+  rc=1
+done
+exit $rc
+```
+
+```sh sp-bot-bootstrap:setup
+set -eu
+PATH="${BUN_INSTALL:-$HOME/.bun}/bin:$PATH"; export PATH
+if ! command -v bun >/dev/null 2>&1; then
+  curl -fsSL https://bun.sh/install | bash
+fi
+pkgs=""
+for pair in spur:@gobing-ai/spur superskill:@gobing-ai/superskill kk:@gobing-ai/knowledge-kit; do
+  t=${pair%%:*}
+  if ! command -v "$t" >/dev/null 2>&1; then
+    pkgs="$pkgs ${pair#*:}"
+  fi
+done
+if [ -n "$pkgs" ]; then
+  bun add -g $pkgs
+fi
+echo 'export PATH="${BUN_INSTALL:-$HOME/.bun}/bin:$PATH"'
+```
+
+**Team Setup Script variant:** to keep the toolchain present across computer recreates, an admin
+can register the **setup** block above as a Grok Team Setup Script (configured through the
+console; see https://docs.x.ai/grok-bot/private-networks — *unverified location*: confirm the
+exact console path with a probe receipt before relying on this pointer). The variant is the same
+block, unchanged, with the same idempotency: after a successful setup a rerun performs zero
+installs.

package/plugins/sp/skills/spec-decomposition/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spec-decomposition
 description: "The decomposition competency — turn a validated feature into a well-formed task batch passing task-batch.schema.json: scenario-to-task mapping, template variants, sizing. Triggers: \"decompose this\", \"break into tasks\", \"task batch\", \"create tasks from this feature\", \"split this work\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/spur-check/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-check
 description: 'Two-tier check primitive for the sp pipeline: light (changed-scope biome, per-workspace typecheck, related tests) during development; full (`spur self exec check`) once at the quality boundary. Reads/writes fingerprint-bound check receipts (.spur/run/<wbs>-check-receipt.json) and reuses a PASS full receipt only at the same proof digest.'
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/spur-cli/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-cli
 description: "Reference and operate the complete `spur` CLI surface: task, feature, rule, workflow, builder, agent, message, decision, self, history, and projects. Use for verb or flag lookup, machine-readable output and exit contracts, or CLI-gated corpus writes. Triggers: \"spur task\", \"spur history\", \"spur projects\", \"spur decision\", \"spur agent join\", \"create a task\", \"task check\", and any Spur CLI convention. Not for planning or execution lifecycle orchestration (`sp:spur-dev`)."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/spur-composer/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-composer
 description: "Select, compose and tune spur artifacts — tasks, features, rules, workflows, decisions, agent specs and project Board modules. Owns workflow catalog selection, the ephemeral→project→shared ladder, ADR-115 budgets, trace-driven rule tuning and applying accepted sp:spur-doctor proposals. Triggers: compose a workflow, tune a rule, add a Board module."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/spur-dev/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-dev
 description: 'The thin orchestration spine for the planning→execution lifecycle: intake, feature-check/batch-create gates, the execution pipeline (precheck→implement→gate⇄remediate→review→done), catalog decision points, HITL gating. Dispatches competency skills; never inlines them. Triggers: "run the pipeline", "drive this task", "plan a feature end to end", "continue the pipeline run", or operating the full lifecycle.'
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/spur-doctor/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: spur-doctor
 description: "Evaluate spur artifacts and plan/design Markdown from read-only evidence, reflect over sp:history-anatomy findings, and return a proposal table. Diagnoses artifacts, not runtime environments (that is spur agent doctor). Triggers: check artifact health, propose evolution, review legacy documents."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 metadata:

package/plugins/sp/skills/sys-architecture/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: sys-architecture
 description: "The architecture competency — decide and record system design before code: module boundaries, data flow, build-vs-extend, transport/storage/auth tradeoffs, ADR routing. Triggers: \"what's the right approach\", \"design this\", \"architecture\", \"should this be an ADR\", \"module boundary\", \"build vs extend\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/sys-debugging/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: sys-debugging
 description: "The systematic debugging protocol: reproduce → isolate → root cause → fix → regression test. Triggers: \"debug this\", \"why is this failing\", \"fix this error\", \"what caused this\", \"trace this bug\", \"root cause\"."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-api/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-api
 description: Design, review, and refactor REST/HTTP, RPC/gRPC, GraphQL, and event API contracts safely.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-architect/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-architect
 description: Review, simplify, and refactor system architecture toward minimum sufficient architecture while preserving required capabilities, quality attributes, delivery safety, and data invariants. Backs architectural refactoring and boundary reviews.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-tests/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-tests
 description: Refactor unit tests for failure sensitivity, deterministic confidence, and regression protection without mock-heavy brittle tests or vanity coverage. Backs test suite quality audits.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/taste-refactoring-ui/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: taste-refactoring-ui
 description: Design, review, and refactor UI hierarchy, layout, typography, spacing, color, and interactions.
+requires: [local-fs]
 license: Apache-2.0
 metadata:
   author: spur

package/plugins/sp/skills/test-driven-development/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: test-driven-development
 description: "Test-driven development discipline: red-green-refactor, behavior-first test design, AAA structure, naming, data builders, mock-at-boundary anti-patterns. Triggers: \"write tests first\", \"TDD\", \"red-green-refactor\", \"characterization test\", \"contract test\", \"how to structure/name a test\"."
+requires: [local-fs]
 license: Apache-2.0
 version: 1.0.0
 created_at: 2026-06-25

package/plugins/sp/skills/wayfinder/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: wayfinder
 description: "Chart a multi-session investigation map when the destination is too foggy to spec in one session. Creates a spur feature as the map, decomposes specifiable questions into spur tasks, and resolves them one at a time until the route becomes visible. Triggers: wayfind, chart a course, multi-session investigation, /sp:dev-find-way."
+requires: [cli:spur, local-fs]
 license: Apache-2.0
 version: 1.0.0
 created_at: 2026-07-06

package/spur.js

@@ -163672,7 +163672,7 @@ init_src2();
 var CLI_CONFIG = {
   binaryName: "spur",
   binaryLabel: "spur",
-  binaryVersion: "0.4.24",
+  binaryVersion: "0.4.25",
   configDir: ".spur",
   configFile: ".spur/config.yaml",
   databaseFile: ".spur/spur.db"
@@ -171235,7 +171235,7 @@ init_dist5();
 import { homedir as homedir17 } from "os";
 import { basename as basename21, join as join94, relative as relative19, resolve as resolve37 } from "path";
 // ../server/package.json
-var version4 = "0.4.24";
+var version4 = "0.4.25";
 
 // ../server/src/modules/health/index.ts
 var startedAt = Date.now();