docs: post-session accuracy pass + remove redundant USAGE.md#42
Merged
Conversation
Bring all docs in line with the current 34-skill roster and this session's removals (upstream-sync cron, TLDR telemetry). - skill counts → 34 (CLAUDE-FULL, CLAUDE, MANUAL) - purge retired/merged skill names (ask, premortem, compare-approaches, discovery, prd, create-handoff, resume-handoff, long-task, lenis, audit, versions) from MANUAL, skills/README, frontmatter-reference, github-workflow, agents/maestro, skills/checkpoint - add missing skills (freeze, plan-ceo-review, retro, strategist) to MANUAL - remove deleted TLDR telemetry hook rows (MANUAL, hooks-reference) - regenerate frontmatter-reference fork/main/inherit lists + agent-delegation table from on-disk frontmatter ground truth - remove USAGE.md: uninstalled, unlinked onboarding doc duplicating MANUAL.md that drifted repeatedly - remove two empty local dirs No source/behavior changes. lint, lint:skills, typecheck green.
arzafran
added a commit
that referenced
this pull request
Jun 3, 2026
Versions work that had accumulated in [Unreleased] without a bump: team-knowledge repo migration (#38), nuclear-review maintainability pass, upstream-sync cron retirement + CC 2.1.161 sync (#40), dynamic-workflow guidance + dead-telemetry removal (#41), docs accuracy pass + USAGE.md removal (#42). VERSION 11.16.0 → 11.17.0; CHANGELOG [Unreleased] promoted to [11.17.0].
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.
What this does
Brings every doc in line with the current 34-skill roster and this session's removals (the upstream-sync cron, the TLDR telemetry pair). Purely docs — no source or behavior changes.
The skill roster had drifted across prior merge passes: docs still named retired/merged skills (
ask,premortem,compare-approaches,discovery,prd,create-handoff,resume-handoff,long-task,lenis,audit,versions) and stated stale counts.Changes
CLAUDE-FULL.md,CLAUDE.md,MANUAL.md(was 31/30;lint:skillsconfirms 34).MANUAL.md,skills/README.md,docs/frontmatter-reference.md,docs/github-workflow.md,agents/maestro.md, and theskills/checkpointdescription — each replaced with its successor (oracle/plan-feature/handoff/orchestrate).freeze,plan-ceo-review,retro,strategist) to the MANUAL All Skills table.track-tldr,mcp__tldr) fromMANUAL.mdanddocs/hooks-reference.md.docs/frontmatter-reference.mdfrom on-disk frontmatter (21 fork / 3 main / 10 inherit; 6 agent delegations).USAGE.md— a 274-line onboarding doc that isn't installed by setup, isn't linked anywhere, duplicatedMANUAL.md, and had drifted repeatedly (the recurring dead-name sweeps were the signal it was redundant)..claude/worktrees,.claude/agent-memory/oracle).Hygiene check (the other two asks)
.claude/.Test Plan
bun run lint:skills— 34 skills, 0 errors/warningsbun run lint(biome) cleanbun run typecheckclean