Skip to content

docs: regenerate CLAUDE.md (staleness + size)#403

Merged
jjackson merged 1 commit into
mainfrom
docs/regen-2026-05-22
May 22, 2026
Merged

docs: regenerate CLAUDE.md (staleness + size)#403
jjackson merged 1 commit into
mainfrom
docs/regen-2026-05-22

Conversation

@jjackson
Copy link
Copy Markdown
Owner

Summary

Doc-regen sweep against current code. Numbers in CLAUDE.md had drifted significantly since last touch.

Factual corrections

  • agents/ 12 → 13 (added sweep)
  • skills/ 66 → 110
  • commands/ 15 → 23
  • ace-ocs atoms 27 → 32
  • ace-connect atoms "21 + 5 commcare" → 23 connect + 24 commcare
  • ace-mobile atoms 11 → 16
  • connect-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 in ace-web sibling)

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.md covers the detail. Principle, canonical-implementation pointer, and anti-pattern preserved.

Additions

  • New Convention: "No inferred backstory" (from 2026-05-12-no-inferred-backstory.md)
  • New Gotcha: Connect 50-char trap on short_description and slug (pairs 2026-05-12 + 2026-05-17 learnings)

Net: 206 → 189 lines.

Follow-up items NOT in this PR

  1. test/mcp/registration-coverage.test.ts snapshot is stale (expectedCount: 27 for OCS, 30 for Connect; actuals are 32 and 47). Either it's failing on main or it's being skipped.
  2. .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.
  3. The deleted anchor design doc — worth deciding whether to restore in some form.

Test plan

  • Sanity-read regenerated CLAUDE.md
  • CI: clean-install status check

🤖 Generated with Claude Code

@jjackson jjackson enabled auto-merge May 22, 2026 08:34
@jjackson jjackson force-pushed the docs/regen-2026-05-22 branch from 520138d to 8b7a3f1 Compare May 22, 2026 08:57
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>
@jjackson jjackson force-pushed the docs/regen-2026-05-22 branch from 8b7a3f1 to 5f7829b Compare May 22, 2026 08:57
@jjackson jjackson merged commit fb42c69 into main May 22, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant