Claude Code setup

Personal Claude Code configuration, backed up so it can be restored on a new machine — global CLAUDE.md, settings.json, custom agents, skills, and the full plugin/marketplace roster.

Not included on purpose: ~/.claude.json (holds OAuth tokens and other MCP credentials — e.g. GitHub PAT, Supabase bearer token — in plaintext), .credentials.json, conversation history/sessions/projects, caches, telemetry, settings.local.json (machine-local, regenerates automatically), and ~/.claude-mem/ (claude-mem's own runtime state — SQLite db, worker pid, logs, telemetry; regenerates on first run). None of that belongs in git.

Prerequisites

• Claude Code CLI installed and authenticated (claude auth / OAuth login). Version needs claude plugin and claude mcp subcommands (any reasonably recent build has both).
• git, with SSH access to GitHub configured (git@github.com:...) — the plugin marketplaces below are added as GitHub-sourced marketplaces and Claude Code clones them over SSH.
• Python 3 + pipx (sudo apt install pipx / brew install pipx) — needed for graphify and spec-kit.
• Node.js 20+ + npx — needed for the claude-flow / ruflo MCP server referenced in settings.json, and for claude-mem.
• Bun (curl -fsSL https://bun.sh/install | bash) — runs the claude-mem worker service.
• uv (curl -LsSf https://astral.sh/uv/install.sh | sh) — powers claude-mem's semantic (vector) search via uvx; without it claude-mem still works but search is degraded.
• Docker — only if you also wire up the github MCP server from ~/.claude.json (not mirrored here; recreate it yourself with claude mcp add, see below).

What's here

• claude/ — mirrors ~/.claude/ (global CLAUDE.md, settings.json, all 36 non-symlinked skill directories under claude/skills/, and the plugin manifest: installed_plugins.json + known_marketplaces.json)
• agents-skills/ — mirrors ~/.agents/skills/, the shared skill pack that the 5 symlinked entries in ~/.claude/skills/ point into (frontend-design, nextjs-app-router-patterns, redux-toolkit, typescript-best-practices, vercel-react-best-practices)
• claude/agents/ — five custom subagent definitions (cto, frontend, backend, n8n, marketing) used by the delegate skill's multi-agent orchestration

Of the 36 mirrored skill directories, most (everything except delegate, graphify, and dual-mode) were bulk-generated in one shot by ruflo init (the claude-flow/ruflo package's scaffolding step) rather than hand-written — see the Hooks section for what else that init added.

Restore on a new laptop

1. Clone this repo somewhere, e.g. ~/claude-code-setup.
2. Copy config into place:

   cp -r claude-code-setup/claude/CLAUDE.md      ~/.claude/CLAUDE.md
   cp -r claude-code-setup/claude/settings.json  ~/.claude/settings.json
   mkdir -p ~/.claude/skills ~/.claude/plugins ~/.claude/agents
   cp -r claude-code-setup/claude/skills/*         ~/.claude/skills/
   cp -r claude-code-setup/claude/agents/*          ~/.claude/agents/
   cp claude-code-setup/claude/plugins/*.json      ~/.claude/plugins/
   mkdir -p ~/.agents/skills
   cp -r claude-code-setup/agents-skills/*         ~/.agents/skills/
   

3. Recreate the symlinked skills (these point into ~/.agents/skills, not the repo):

   cd ~/.claude/skills
   for s in frontend-design nextjs-app-router-patterns redux-toolkit \
            typescript-best-practices vercel-react-best-practices; do
     ln -s ../../.agents/skills/$s $s
   done
   

4. Reinstall the marketplaces and plugins (the .json files above only record which were installed — claude plugin install still needs to actually fetch each one):

   # Ponytail — code-minimization guidance
   claude plugin marketplace add DietrichGebert/ponytail
   claude plugin install ponytail@ponytail
   
   # UI/UX Pro Max — design-system generator
   claude plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
   claude plugin install ui-ux-pro-max@ui-ux-pro-max-skill
   
   # Claude Design Skillstack — 22 individual 3D/animation/web-design skills
   claude plugin marketplace add freshtechbro/claudedesignskills
   for p in aframe-webxr animated-component-libraries animejs babylonjs-engine barba-js \
            blender-web-pipeline gsap-scrolltrigger lightweight-3d-effects locomotive-scroll \
            lottie-animations modern-web-design motion-framer pixijs-2d playcanvas-engine \
            react-spring-physics react-three-fiber rive-interactive scroll-reveal-libraries \
            spline-interactive substance-3d-texturing threejs-webgl web3d-integration-patterns; do
     claude plugin install "$p@claude-design-skillstack"
   done
   
   # Warp terminal integration (already in known_marketplaces.json, reinstall if missing)
   claude plugin marketplace add warpdotdev/claude-code-warp
   claude plugin install warp@claude-code-warp
   
   # claude-mem — persistent cross-session memory (prefer this over marketplace add + install:
   # it also sets up the worker service, SQLite db, and ~/.claude-mem/settings.json)
   npx claude-mem install
   npx claude-mem start
   

   Note: the marketplace registered from freshtechbro/claudedesignskills names itself claude-design-skillstack internally — that's the marketplace id to use in plugin@marketplace, not the repo name.
5. Reinstall tools that git can't carry:
   • graphify CLI: pipx install graphifyy then graphify install --platform claude (writes ~/.claude/skills/graphify/ and registers itself in CLAUDE.md — already mirrored above, this step just gets the graphify/graphify-mcp binaries onto PATH).
   • spec-kit: pipx install specify-cli (not a Claude skill — a separate CLI GitHub's spec-kit ships; scaffolds spec files into individual projects via specify init).
6. Recreate MCP servers not mirrored here (they live in ~/.claude.json, which is excluded because it holds credentials):

   claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=<your-ref>" \
     --header "Authorization: Bearer <your-supabase-token>"
   claude mcp add github -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-pat> \
     ghcr.io/github/github-mcp-server
   

Hooks

~/.claude/settings.json currently defines no hooks at all — the only hooks that ever existed here belonged to lean-ctx (PreToolUse/PostToolUse/SessionStart/SessionEnd/Stop/ PreCompact, routing every Read/Grep/Glob/Bash call through its binary) and were removed along with the rest of it. If you want hooks again, add a hooks block to settings.json — see claude/skills/hooks-automation/SKILL.md (mirrored in this repo) for the coordination-hook patterns (pre/post task, session lifecycle, Git integration) that skill was designed around.

Three things still bring their own hooks without touching settings.json:

• warp@claude-code-warp (plugin) — ships hooks/hooks.json inside the plugin package itself, wired automatically on install to emit Warp notifications/status events. Nothing to configure.
• claude-mem@thedotmack (plugin) — registers 5 lifecycle hooks (bundled in the plugin package, not in settings.json) that capture session activity for its memory worker. Its own config lives in ~/.claude-mem/settings.json (not mirrored — machine-local runtime state).
• v3-cli-modernization (skill) — documents a hooks system enhancement for claude-flow v3 (interactive prompts, command decomposition) but doesn't register anything live; it's guidance for building that system, not an installed hook.

Inventory: agents, skills, and plugins

Custom agents (claude/agents/)

Agent	Role	Example
cto	Spec authoring, architecture, task breakdown (Spec-Driven Development). Produces documents, never code.	delegate @cto — write a spec for adding OAuth login
frontend	Next.js/React/React Native implementation — UI, state, responsive design.	delegate @frontend — build the settings page per spec.md
backend	Laravel/Node/FastAPI — DDD modular monolith, APIs, DB schemas, security.	delegate @backend — implement the /orders endpoint per spec.md
n8n	n8n workflows, social/messaging API integrations (Evolution API/WhatsApp, LinkedIn, X), webhooks.	delegate @n8n — build a workflow that posts new orders to Slack
marketing	Instagram/Facebook (Meta) ad creative, copywriting, targeting, and campaign strategy for the mobile-cover business. Hands off publishing to @n8n, coded pages to @frontend.	delegate @marketing — 3 ad concepts for our new iPhone 17 case launch

Skills (claude/skills/)

Hand-written / installed individually:

Skill	Purpose	Example
delegate	Meta-skill: Opus plans, decomposes a task into a self-contained prompt, and dispatches it to a cheaper Claude subagent, a specialist agent, or an external CLI (agy, gemini) — then reviews the result.	delegate claude sonnet — write unit tests for orders.service.ts
graphify	Parses a codebase (tree-sitter AST, fully local) into a queryable knowledge graph — god nodes, communities, cross-file call/import edges — plus an interactive graph.html visualization.	/graphify . then /graphify query "what connects auth to database?"
dual-mode	Orchestrates Claude Code + headless Codex workers together (/dual-spawn, /dual-coordinate, /dual-collect).	/dual-spawn — run 3 headless Codex workers over the src/api/*.ts files

The remaining 33 were bulk-scaffolded by ruflo init (claude-flow v3 skill pack). Grouped by theme:

AgentDB (vector memory for agents)

Skill	Purpose	Example
agentdb-advanced	QUIC sync, multi-database management, custom distance metrics, hybrid search, distributed systems.	"Set up QUIC-synced AgentDB across two agent nodes"
agentdb-learning	9 reinforcement-learning algorithms (Q-Learning, SARSA, Actor-Critic, Decision Transformer, …).	"Train a Q-Learning plugin on this agent's past decisions"
agentdb-memory-patterns	Persistent memory patterns — session memory, long-term storage, pattern learning.	"Add long-term memory to this chat agent using AgentDB"
agentdb-optimization	Quantization (4–32x memory reduction), HNSW indexing (150x faster search), caching, batching.	"This vector search is slow — optimize AgentDB with HNSW indexing"
agentdb-vector-search	Semantic vector search for RAG / similarity matching / knowledge bases.	"Build a RAG pipeline over these docs with AgentDB vector search"

Flow Nexus (cloud swarm platform)

Skill	Purpose	Example
flow-nexus-neural	Train/deploy neural nets in distributed E2B sandboxes.	"Train a classifier on Flow Nexus using an E2B sandbox"
flow-nexus-platform	Auth, sandboxes, app deployment, payments, challenges — general platform management.	"Deploy this app to a Flow Nexus sandbox"
flow-nexus-swarm	Cloud AI swarm deployment + event-driven workflow automation.	"Spin up a Flow Nexus swarm to process this queue"

GitHub swarm coordination

Skill	Purpose	Example
github-code-review	AI-swarm-powered comprehensive code review.	"Run a swarm code review on PR #42"
github-multi-repo	Cross-repo sync, architecture management, org-wide automation.	"Sync the shared config across all our repos"
github-project-management	Swarm-coordinated issue tracking, project boards, sprint planning.	"Set up a sprint board and triage these 20 issues"
github-release-management	Automated versioning, testing, deployment, rollback orchestration.	"Cut a release for v2.3.0 with changelog and rollback plan"
github-workflow-automation	Intelligent CI/CD pipeline generation with adaptive coordination.	"Generate a GitHub Actions pipeline for this monorepo"

Swarm / SPARC / v3 (claude-flow internals)

Skill	Purpose	Example
swarm-advanced	Advanced orchestration patterns for research/dev/test/distributed workflows.	"Coordinate a 5-agent swarm to refactor this module"
swarm-orchestration	Parallel task execution, dynamic topology, multi-agent coordination via agentic-flow.	"Scale this task across a mesh-topology swarm"
sparc-methodology	Specification → Pseudocode → Architecture → Refinement → Completion multi-agent workflow.	"Run the SPARC methodology on this new feature"
stream-chain	Stream-JSON chaining for multi-agent pipelines and sequential data transforms.	"Chain these 3 agents' outputs via stream-JSON"
pair-programming	Driver/navigator/switch pairing modes with real-time review, TDD, security scanning.	"Start a pair-programming session in TDD mode on this bug"
reasoningbank-agentdb	ReasoningBank adaptive learning on AgentDB (trajectory tracking, verdict judgment, replay).	"Log this decision trajectory into ReasoningBank for replay"
reasoningbank-intelligence	Adaptive learning for pattern recognition and strategy optimization generally.	"Optimize this agent's strategy using ReasoningBank patterns"
verification-quality	Truth scoring, code-quality verification, automatic rollback (0.95 accuracy threshold).	"Verify this agent's output against the truth-score threshold"
hooks-automation	Pre/post-task hooks, session management, Git integration, memory coordination, neural pattern training.	"Wire a post-edit hook that auto-formats and logs to memory"
skill-builder	Scaffolds new Claude Code Skills with correct YAML frontmatter and structure.	"Build a new skill for our internal deploy checklist"
browser	Web browser automation with AI-optimized snapshots for claude-flow agents.	"Automate a login flow and snapshot the resulting page"
v3-cli-modernization	CLI modernization + hooks-system enhancement design for claude-flow v3.	"Design the interactive-prompt UX for the v3 CLI"
v3-core-implementation	DDD domains, clean architecture, DI, modular TypeScript for v3 core.	"Scaffold a new DDD bounded context for v3 core"
v3-ddd-architecture	Domain-Driven Design architecture — bounded contexts, microkernel pattern.	"Review this module's bounded-context boundaries"
v3-integration-deep	Deep agentic-flow@alpha integration (ADR-001) eliminating duplicate code.	"Find duplicate logic between claude-flow and agentic-flow"
v3-mcp-optimization	MCP transport/connection-pooling/load-balancing for sub-100ms responses.	"Profile and optimize this MCP server's response time"
v3-memory-unification	Unifies 6+ memory systems into AgentDB with HNSW indexing (ADR-006/009).	"Migrate the legacy memory store into unified AgentDB"
v3-performance-optimization	Flash Attention speedup, 150x+ search improvements, memory reduction benchmarks.	"Benchmark and optimize this attention layer"
v3-security-overhaul	Security architecture overhaul addressing critical CVEs, secure-by-default patterns.	"Audit this module against the v3 secure-by-default checklist"
v3-swarm-coordination	15-agent hierarchical-mesh coordination across security/core/integration domains.	"Coordinate the 15-agent swarm for this v3 milestone"

Plugins (installed via claude plugin, tracked in claude/plugins/*.json)

Plugin	Purpose	Example
warp@claude-code-warp	Native Warp terminal notifications + session-status indicators for Claude Code.	Just run Claude Code inside Warp — no invocation needed, it hooks session events automatically.
claude-mem@thedotmack	Persistent memory across sessions: captures agent activity via lifecycle hooks, compresses it, and retrieves relevant context automatically in future conversations (semantic search over a local SQLite + vector store, web viewer on localhost:37700).	Nothing to invoke for normal use — context injects automatically. Explicit lookup: /mem-search "what did we decide about the auth flow?". Tag anything private with <private>...</private> to keep it out of storage.
ponytail@ponytail	Nudges the agent toward minimal, necessary code (decision ladder: skip → reuse → stdlib → one-liner → write).	/ponytail-review to audit the current diff for over-engineering; /ponytail full to raise intensity.
ui-ux-pro-max@ui-ux-pro-max-skill	Design-system generator: 84 UI styles, 192 color palettes, 74 font pairings, industry-specific reasoning rules. Auto-activates on UI/UX requests.	"Build a landing page for my SaaS product" — no slash command needed.
threejs-webgl	Three.js 3D scenes, WebGL/WebGPU rendering, cameras, materials, lights.	"Create a Three.js scene with PBR materials and orbit controls"
react-three-fiber	Declarative R3F components for 3D in React apps.	"Build a React Three Fiber product configurator with physics"
babylonjs-engine	Babylon.js 3D engine — physics, PBR, shadow mapping.	"Set up a Babylon.js scene with a physics-driven ball"
gsap-scrolltrigger	GSAP timelines, tweens, scroll-driven animation, pinning/scrubbing.	"Add GSAP ScrollTrigger parallax to this landing page"
motion-framer	Framer Motion — variants, gestures, layout animation, AnimatePresence.	"Animate this card list with Framer Motion stagger on mount"
react-spring-physics	Spring-physics animation (React Spring + Popmotion) for natural motion.	"Make this drawer slide in with spring physics, not easing curves"
animejs	Anime.js — timelines, stagger, SVG path morphing.	"Morph this SVG icon on click using Anime.js"
animated-component-libraries	Pre-built animated components (Magic UI + React Bits) instead of hand-rolled animation.	"Use Magic UI components for this marketing page hero"
scroll-reveal-libraries	AOS-based simple scroll-reveal (fade/slide) for content-heavy pages.	"Add basic scroll-reveal fade-ins to each section"
lottie-animations	Lottie/After-Effects JSON animation playback in web/React.	"Embed this Lottie loading animation in the React app"
rive-interactive	Rive state-machine vector animation with runtime interactivity.	"Wire this Rive file's state machine to button hover/click"
locomotive-scroll	Smooth scrolling + parallax + viewport detection.	"Add Locomotive Scroll smooth scrolling with a parallax hero image"
barba-js	Fluid page transitions for SPA-like navigation.	"Add a fade page transition between routes with Barba.js"
aframe-webxr	Declarative HTML-based WebXR (VR/AR) scenes, built on Three.js.	"Build a 360-degree VR photo viewer with A-Frame"
playcanvas-engine	Lightweight WebGL/WebGPU game engine, entity-component architecture.	"Prototype a browser game scene in PlayCanvas"
pixijs-2d	Fast 2D WebGL rendering — sprites, particles, filters at scale.	"Render 5,000 animated sprites with PixiJS particle effects"
lightweight-3d-effects	Zdog/Vanta.js/Vanilla-Tilt micro-3D effects without heavy frameworks.	"Add a Vanta.js animated background to the hero section"
blender-web-pipeline	Blender → glTF export/optimization workflows for the web.	"Write a Blender Python script to batch-export models to glTF"
spline-interactive	No-code 3D design tool export/integration guidance.	"Integrate this Spline scene into the React app"
substance-3d-texturing	Substance 3D Painter PBR texture workflows for real-time engines.	"Optimize these Substance textures for Three.js glTF export"
modern-web-design	2024–2025 design trends/principles — glassmorphism, scrollytelling, a11y.	"What's a modern, accessible layout pattern for a pricing page?"
web3d-integration-patterns	Meta-skill: architecture patterns for combining multiple 3D/animation libraries.	"How should Three.js and GSAP ScrollTrigger coexist in one page?"

Five category bundles (core-3d-animation, extended-3d-scroll, animation-components, authoring-motion, meta-skills) also exist in the same marketplace as group-install shortcuts for the skills above — not installed separately here since each underlying skill was installed individually.

Security note

~/.claude.json (not in this repo) currently has a GitHub PAT and a Supabase bearer token stored in plaintext for the github and supabase MCP servers. Never add that file to this repo; if you need to move those servers to a new machine, recreate them with claude mcp add and fresh tokens (see step 6 above) rather than copying the file.