docs: fix stale skill/role counts and dead shell-windows link (#168) - #195
Merged
Conversation
Docs stated counts that no longer match reality and linked a template that was intentionally removed by ADR-0004. - README.md, docs/guides/install.md: 18->20 skills, 11->12 roles (verified: 20 dirs in plugin/skills/, 12 cards in plugin/agents/, incl. second-opinion added in v0.14.0). Historical mentions in CHANGELOG/specs/plans/ADR/docs-README SP4 bullet left as-is. - docs/guides/install.md, docs/guides/troubleshooting.md: replace the dead plugin/templates/shell-windows.md link/mention (removed by ADR-0004 with the backends plane) with inline Windows gh-PATH guidance. Closes #168 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
setx truncates PATH at 1024 chars and can duplicate entries on repeat use; point to the Environment Variables GUI instead. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
1 participant
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.
Closes #168
Problem
Docs stated counts that no longer match reality, and linked/mentioned a template file (
plugin/templates/shell-windows.md) that does not exist.Measured facts (verified empirically in this repo)
plugin/skills/has 20 directories (autopilot, board, brainstorm, deliver, design, distill, execute, execute-agents, hotfix, ideate, investigate, maintain, plan, release, respond, review, shape, ship, spike, triage).plugin/agents/has 12 cards, incl.second-opinion.md(added in v0.14.0).plugin/templates/shell-windows.mddoes not exist; ADR-0004 intentionally removed it with the multi-backend plane (it was "used only bysync.renderBlock").Acceptance criteria
README.md:3— 18→20 skills, 11→12 roles ("an 11-role" → "a 12-role").docs/guides/install.md:25— "18 skills" → "20 skills".docs/specs,docs/plans,docs/decisions, and thedocs/README.mdSP4 plan bullet — these describe past state, not the current roster).docs/guides/install.md:65— dead markdown link → GUI Environment-Variables guidance.docs/guides/troubleshooting.md:37— "(see the shell notes template)" mention → Git Bashexport PATH=…guidance.Verification
pnpm verify— 42 files / 356 tests green.shell-windowsoutside historicaldocs/{decisions,plans,spikes}(grep-confirmed).setxfootgun nit addressed by pointing to the Environment Variables GUI instead.)🤖 Generated with Claude Code