Repository navigation
pstack: refresh the docs and add a docs-vs-tree check - #704
Merged
Merged
Conversation
scripts/check-pstack-docs.mjs lists pstack's skills, playbooks, and agents from the tree. It checks pstack/README.md and pstack/docs/guide for unknown or renamed slash commands, broken relative links and anchors, whole-set counts, unknown subagent types, model names that setup-pstack does not use, and skills, playbooks, or agents missing from the README tables.
Remove idioms, metaphors, comma splices, and mid-sentence colons that the technical-writing and unslop standards flag. No claims change.
The Claude Code tree now ships pstack/README.md and pstack/docs/guide/, so the docs-pass edits to those files need regenerated copies for --check to pass.
poteto
force-pushed
the
lauren/pstack-docs-pass-e1b2
branch
from
October 17, 2026 23:44
8e18a49 to
45ccae0
Compare
The link pattern needed ')' right after the target, so [x](a.md "title") and [x](<a.md>) were never checked and a broken one passed.
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.
This brings the pstack README and guide in line with the current tree. It also adds a script that finds the next drift.
Stale claims fixed
/babysit. Cursor now ships/autopilot.Check script
node scripts/check-pstack-docs.mjslists the skills, slash commands, playbooks, and agents in the tree and compares them with what the docs name. It also checks relative links, anchors, whole-set counts, and model names. Onmainit finds one problem, the/babysitclaim. On this branch it finds none. CI does not run it yet.Prose pass
Each guide page already keeps to one Diátaxis mode, so no page was split. The prose commit makes only sentence-level edits. It removes idioms, metaphors, comma splices, and mid-sentence colons, and it changes no claims.
The Claude Code tree copies the README and the guide, so one commit regenerates those copies.
validate-plugins.mjsandgenerate-pstack-harness-trees.mjs --checkpass.Note
Low Risk
Changes are limited to documentation and a validation script; no runtime product or auth paths are modified.
Overview
This PR refreshes pstack documentation so the README and guide match the current skills tree, and adds
scripts/check-pstack-docs.mjsto catch future drift (slash commands, links/anchors, inventory counts, README tables, model names).Accuracy fixes include replacing the stale built-in
/babysitclaim with/autopilot, tightening autopilot-full verifier behavior (full swarm on code-ready head; lighter checks on small follow-up pushes), simplifying Custom Mode wording and linking to the official anchor, and broadening harness regen instructions now that the Claude copy includes the README and guide.The guide gets a sentence-level prose pass (no structural Diátaxis changes). The new checker is not wired into CI yet (per PR description).
Reviewed by Cursor Bugbot for commit 339f8ba. Bugbot is set up for automated code reviews on this repo. Configure here.