Repository navigation
docs: teach only the KEEP surface in agent skills - #120
Draft
pewpewpotato wants to merge 1 commit into
Draft
pewpewpotato wants to merge 1 commit into
pewpewpotato wants to merge 1 commit into
Conversation
Agent how-tos no longer list deleted CLI/MCP verbs or Rack as the way to operate Spool. Leftover .spl export is a lossy one-shot into the bound context remote, then stop. History and review stay on stock git and GitHub. Refs #115 Co-authored-by: Werner Swart <werner@swart.io>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #115
Agent skills and operator how-tos in this repo now teach the post-cut KEEP surface only. Marketplace (
autonomous-bits/spool-marketplace) is out of scope for this PR, so this does not close #115.Inventory
Rewritten
Skills (current how-to no longer names Rack,
.splas source of truth, or deleted CLI/MCP verbs):.agents/skills/spool/SKILL.md.agents/skills/spool/references/working-changes.md(export was “one-shot or repeatable”; it is now lossy, once, then stop).agents/skills/spool/references/workspaces.md.agents/skills/spool/references/cli-help.md.agents/skills/spool/references/branches-and-history.md.agents/skills/spool/references/maintenance.md.agents/skills/spool/references/merges.md.agents/skills/spool/references/schemas.md.agents/skills/spool/references/batch-authoring.md.agents/skills/spool-technical-implementation/SKILL.mdOperator guidance that still listed deleted verbs as something to know:
README.mddocs/context-bind.mddocs/architecture.md(deleted names point atinternal/surfaceinstead of a verb catalog)docs/README.mdCONTRIBUTING.mdcmd/spl/AGENTS.mdinternal/AGENTS.mdCHANGELOG.md(Unreleased note that skills teach KEEP only)Deleted
None. No skill existed whose only purpose was Rack or
.spl-as-SoT. Bind, query, mutate, merge, and prune skills still map to KEEP work, so they were rewritten in place.Reviewed, already KEEP (no edit)
.agents/skills/spool/references/reading-graphs.md.agents/skills/select-new-goal/SKILL.md.agents/skills/spool-product/SKILL.md.agents/skills/spool-architecture/SKILL.md.agents/skills/spool-engineering-standards/SKILL.md.agents/skills/spool-release/SKILL.mdLeft in place on purpose
CHANGELOG.mdhistorical sections, including the Unreleased stop-list. That list is the release record, andTestSunsetCopyClosesSoftDoorrequires it.docs/context-git-migration.md— the export escape-hatch doc. Its drop list matches tool output (packs, remote config skipped asRack remotes, reflogs, merge leases, projections). It is not the day-to-day operating skill.docs/graphcontract.md— library pack-contract disclaimer, not a CLI how-to.What guidance teaches now
spl context init --remotespl mcpand KEEPspl_*tools, includingspl_mutatequery-context,search,search-expand,filter,resolve,graphschema/validate,asset *, file-graphmerge *,prune.splstore remains, runcontext export/migrate-onceonce into the bound context git remote, then stop. Export is lossy; re-run is overwrite-at-own-risk.cmd/spl/sunset_test.gowalks.agents/skillsand fails if a removed verb or Rack reappears as skill text. The required.splescape-hatch sentence is allowed.spl_context_exportis allowed; the removed tool idspl_contextis not.Verification
make checkpassed tidy, format, vet, staticcheck, golangci-lint,go test, andgo test -race.govulncheck(v1.1.4, vuln DB 2026-10-08) reports pre-existing standard-library findings in Go 1.26.6 (fixed in 1.26.9), including GO-2026-6617. Those calls are unchanged by this PR. Quality onmainlast passed on 2026-09-19, before that database update. This PR does not bump the toolchain.