Document Control-Plane Commands in README · Entire
Branch Overview
Branch promotes 4 control-plane command groups out of labs → make visible in root help.
Commands: org, project, repo, grant.
Changes:
- labs.go — remove 4 groups from
experimentalCommandslist +--helphints. - root.go — flip 4 groups from Hidden (was "hidden during maturation") to visible.
- org/project/repo.go — unhide command (drop
Hidden: true). - grant.go — same unhide.
- CLAUDE.md — doc update.
Net: these graduate from experimental to first-class visible commands. One commit 1d5cc0607.
Documentation Check
Checked all docs. No stale labs references left behind.
Verified:
- CLAUDE.md / AGENTS.md (symlink → CLAUDE.md) — 4 commands documented as full noun groups; labs section only lists
tokens: profile. ✅ - Command help strings (org/project/repo/grant
.go) — no "experimental/labs/hidden/maturation" wording. ✅ - README.md — never mentioned these commands. ✅ (nothing to update)
- superpowers specs/plans — mention
entire repo mirroras usage, no labs framing. ✅
Only remaining hits = CHANGELOG.md — historical release entries (entire labs review, blame/why labs, etc.). Those are past-tense records, correct to leave.
Documentation Addition
Bottom line: strictly required — nothing. Recommended — one small README addition.
Why not much is needed:
entire agent-helprenders live from the cobra tree — it's the documented source of truth, auto-picks up the now-visible commands. No edit needed.entire <cmd> --helpworks; all 4 have solidShort/Longstrings already.- CLAUDE.md already documents them as noun groups.
Gap Analysis:
- README.md "Commands Reference" table (line 241) is the one human-facing curated list. It's a subset — already omits
auth,api,dispatch,activity— so it's not exhaustive by design. But since org/project/repo/grant just became public control-plane commands, adding them keeps the table honest.
Proposed rows: [Add these commands to the README]
| Command | Description |
|---|---|
entire org |
Manage Entire organizations (create, list, get, delete) |
entire project |
Manage Entire projects (create, list, get, delete) |
entire repo |
Manage Entire repositories (create, list, get, delete, clone, mirror, visibility) |
entire grant |
Manage access grants and org membership (org, project, repo) |
Final Steps
- Commit Message: Document promoted control-plane commands in README
- Pushed Changes: 4 rows added after
entire login(control-plane cluster, logical spot). README changeis within the PR's existing scope (docs for promoted commands). Proposed: tweak one bullet in the Changes section to mention the README.
Updated Bullet:
- Docs & comments: updated the registration comments in
root.go, documented the four groups in the CLAUDE.md / AGENTS.md command-layout section, and added them to the README Commands Reference table.
Shipped successfully with commit 685e24bbe, updates pushed to PR #1672.
Copilot Review Feedback:
- Both Copilot comments handled. Valid changes applied.
- Documentation consistency confirmed.