🔨 standardize .claude: remove prd+Ralph, add thermo review + onboarding

Merged
MI
3mo ago
+336-747

Summary

Part of the 7-repo .claude/ standardization. Removes the prd + Ralph system and adds two standard skills (thermo-nuclear code quality review, onboarding).

Changes

Phase 1 — remove prd + the entire Ralph system

  • Deleted .claude/skills/prd/ and .claude/skills/ralph/ (real dirs, not symlinked)
  • Deleted scripts/ralph.sh and scripts/ralph/ (no .ralphy/ present)
  • Removed the ralph target from Makefile (kept check_jq, still used by fmt; no .PHONY: ralph entry existed)
  • Removed the "Ralph Wiggum Agent Loop" row from the README.md feature table
  • No prd/ralph references remained in CLAUDE.md or .claude/rules/

Phase 2 — add thermo-nuclear-code-quality-review (was missing)

  • Copied the canonical skill + agent from the Rust template
  • Skill carries Claude-only frontmatter (disable-model-invocation, user-invocable), so it stays a real dir under .claude/skills/ (not shared/symlinked) per .claude/rules/codex-claude-sync.md
  • Agent .md added under .claude/agents/; make sync-agent-config regenerated .codex/agents/thermo-nuclear-code-quality-review.toml

Phase 3 — add onboarding skill (was missing)

  • Authored a new skill tailored to this Python/uv stack and its make onboard interactive CLI (interview → inspect → run onboard.py steps → prune unused systems). Not copied from Rust.
  • Shared-safe frontmatter (name, description) → lives at .agents/skills/onboarding/ with a .claude/skills/onboarding symlink created by make sync-agent-config

Phase 4 — Codex system already exists, left untouched.

Testing

  • make sync-agent-config — zero drift on re-run
  • make ruff, make vulture, make import_lint, make ty, make check_deps, make file_len_check — all pass
  • make docs_lint — fails on a pre-existing bun module-resolution error in the docs-site deps (unist-util-visit-parents/do-not-use-color); confirmed identical failure on a clean tree, unrelated to this change
  • make lint_links — 23 failures are live-GET sandbox egress 403s on external hosts (shields.io, github.com, contrib.rocks, jules.google, fumadocs.dev); none are links added here (README edit only removed a table row)

Related Issues

Closes #

🤖 Generated with Claude Code

Generated by Claude Code

Summary by cubic

Standardizes .claude/ across the repo: removes prd and the Ralph agent, adds a thermo-nuclear code quality review and an onboarding skill, and syncs the thermo review text to the canonical wording. Also fixes onboarding punctuation to satisfy writing checks.

  • New Features

    • Added thermo-nuclear-code-quality-review rubric under .claude/skills/ with a matching agent in .claude/agents/ and .codex/agents/ (synced to canonical text).
    • Added an onboarding skill tailored to this Python/uv stack under .agents/skills/onboarding with a .claude/skills/onboarding symlink; cleaned punctuation for writing checks.

  • Migration

    • Removed the ralph Makefile target and related scripts/docs; use the thermo-nuclear review via a parent Task that supplies diff and file contents.
    • Run make sync-agent-config to regenerate agent config and symlinks.
    • For new projects, run make onboard for the guided CLI and to prune unused systems.