docs: shorten the README, split the roster out, and stop promising an uninstalled tool - #29
Merged
Merged
Conversation
… uninstalled tool The README was 935 lines with the install instructions at line 652, so anyone who wanted to try this scrolled past two thirds of the file to find git clone. The seventeen persona dossiers are now TEAM.md, linked from the glance tables, and Installation sits at line 70. README is 632 lines and nothing was deleted. The v1.0 changelog credited Kai with image generation via Hugging Face MCP. Commit 68e3a96 removed that capability and handed raster work to Iris, and the README's own Kai section already said so six hundred lines earlier. The changelog now matches the profile. /parallel assumed claude-conductor, which nothing installs. It invoked six subcommands across ten references, including one marked "Always", and the README's companion snippet fetches a SKILL.md rather than the binary, so even following the docs exactly left every invocation failing. The command now checks once for the companion and branches: the base template contains no conductor references at all, and three named additions are applied only when it is present. Without it the plan works and never mentions a tool the user does not have. CONTRIBUTING gains one step: search for stale rosters when adding or removing a persona, and prefer pointing docs at claude-team list over hand-listing the team again. Three separate rosters had drifted to three different counts because the checklist never mentioned documentation. 269 tests unchanged. No code touched. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019j5DHEZsoeCGRueTbNLuTb
d6veteran
marked this pull request as ready for review
July 30, 2026 21:54
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
2 participants
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.
Docs only. No code touched, 269 tests unchanged.
README 935 → 633 lines. Installation moved from line 652 to line 70.
The funnel
Anyone who wanted to try this scrolled past two thirds of the file to reach
git clone. The seventeen persona dossiers are nowTEAM.md, linked from the glance tables. Nothing was deleted.Two claims that were false
Kai. The v1.0 changelog credited him with "AI image generation via Hugging Face MCP (FLUX.1, Qwen-Image)". Commit
68e3a96removed that capability and handed raster work to Iris, and the README's own Kai section said so six hundred lines earlier in the same file. Now matches the profile./parallel. It assumedclaude-conductor, which nothing installs — six subcommands across ten references, one of them marked "Always". Worse, the README's companion snippet fetches aSKILL.md, not the binary, so even following the docs exactly left every invocation failing.It now checks once for the companion and branches. The base template contains no conductor references at all; three named additions are applied only when it's present. Without it the plan works and never mentions a tool the user doesn't have.
The root cause of the roster drift
CONTRIBUTING.mdgains one step: search for stale rosters when adding or removing a persona, and prefer pointing docs atclaude-team listover hand-listing the team again. Three separate rosters had drifted to three different counts because the checklist never mentioned documentation at all.Generated by Claude Code