docs: regenerate CLAUDE.md (staleness + size)#403
Merged
Conversation
2 tasks
520138d to
8b7a3f1
Compare
Drift accumulated since the file was last touched: Factual corrections - agents 12 → 13 (added `sweep`) - skills 66 → 110 - commands 15 → 23 - ocs atoms 27 → 32 (server registrations vs cap-map 27) - connect atoms 21 → 23 connect_ + 24 commcare_ (was "21 + 5") - mobile atoms 11 → 16 - labs proxy now described as "forwards every labs atom" rather than pinned to a stale count of 9 Broken references removed - docs/superpowers/specs/2026-04-01-ace-design.md (anchor doc — no longer on disk; earliest spec is 2026-05-04) - docs/superpowers/specs/2026-04-07-ace-web-harness-design.md (lives in ace-web sibling, not here) Compression - "Phase preconditions are restored, not adapted" trimmed from ~40 lines to ~17 by replacing the 7-step ordered cold-boot list + the two historical narratives (warm-AVD death, snapshot-load band-aid) with forward pointers to mobile-integration.md and the phase6-validation-arc learning. Principle, canonical implementation pointer, and anti-pattern preserved. Additions - New Convention: "No inferred backstory" — pulled up from the 2026-05-12 learning since it changes how PDD-authoring skills behave at session-start. - New Gotcha: "Connect's 50-char trap on short_description and opp slug" — pairs the 2026-05-12 + 2026-05-17 50-char learnings. Net: 206 → 189 lines. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
8b7a3f1 to
5f7829b
Compare
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.
Summary
Doc-regen sweep against current code. Numbers in CLAUDE.md had drifted significantly since last touch.
Factual corrections
agents/12 → 13 (addedsweep)skills/66 → 110commands/15 → 23ace-ocsatoms 27 → 32ace-connectatoms "21 + 5 commcare" → 23 connect + 24 commcareace-mobileatoms 11 → 16connect-labs"9 atoms" → "forwards every labs atom" (it's a proxy)Broken references removed
docs/superpowers/specs/2026-04-01-ace-design.md(anchor doc — gone)docs/superpowers/specs/2026-04-07-ace-web-harness-design.md(lives inace-websibling)Compression
"Phase preconditions are restored, not adapted" section trimmed from ~40 → ~17 lines. Removed the 7-step ordered cold-boot list and the two historical narratives ("Why the warm-AVD model died", "No snapshot-load fast path"). Forward-pointer to
playbook/integrations/mobile-integration.md+docs/learnings/2026-05-14-phase6-validation-arc.mdcovers the detail. Principle, canonical-implementation pointer, and anti-pattern preserved.Additions
2026-05-12-no-inferred-backstory.md)short_descriptionand slug (pairs2026-05-12+2026-05-17learnings)Net: 206 → 189 lines.
Follow-up items NOT in this PR
test/mcp/registration-coverage.test.tssnapshot is stale (expectedCount: 27for OCS, 30 for Connect; actuals are 32 and 47). Either it's failing onmainor it's being skipped..claude/pm/runs/last entry 2026-05-10 despite ~50 PRs merged since. Either the run-log convention isn't being followed or it should be relaxed.Test plan
clean-installstatus check🤖 Generated with Claude Code