use agent-md-refactor skill to reduce the size and increase the effectiveness of our claude code md files (#23278)

## Reason

Use the agents-md-refactor skill to tighten up our CLAUDE.md files in sparkcore
more on the agents refactor md here : [link](https://skills.sh/softaworks/agent-toolkit/agent-md-refactor
)

## What Changed

  1. Root CLAUDE.md - Cut from 73 to 37 lines. Removed setup prerequisites (not AI instructions), kept only essential commands and links.
  2. sparkcore/CLAUDE.md - Cut from 160 to 68 lines. Removed redundant debugging tips, setup docs, and verbose explanations. Kept actionable patterns.
  3. js/CLAUDE.md - Cut from 163 to 69 lines. Removed release process docs, React stack details, and configuration file explanations. Kept commands and
  patterns.
  4. New linked files - Extracted cross-cutting concerns:
    - .claude/docs/graphql-workflow.md - Single source for GraphQL regeneration
    - .claude/docs/testing.md - Consolidated testing philosophy from your CLAUDE.local.md
  5. Kept untouched:
    - sparkcore/sparkcore/spark/CLAUDE.md - Domain-specific, well-organized, essential for Spark protocol work
    - CLAUDE.local.md - Your personal overrides (git workflow with Graphite, Python commands)

GitOrigin-RevId: 5db5c5e8a25f9dc3b48b83fcfd73e3374a81dadb

Author: matthappens

CLAUDE.md

@@ -1,163 +1,68 @@
-# CLAUDE.md
+# JS Monorepo
 
-This file provides guidance to Claude Code when working in the js/ directory.
+TypeScript monorepo for Lightning Network SDKs and internal applications. Yarn workspaces + Turbo.
 
-## Overview
+## Quick Reference
 
-JavaScript/TypeScript monorepo for Lightspark's Lightning Network and UMA services. Public SDKs, internal applications, and shared packages using Yarn workspaces + Turbo.
+| Action | Command |
+|--------|---------|
+| Install | `yarn` |
+| Start apps | `yarn start site uma-bridge ops` |
+| Build | `yarn build` |
+| Test | `yarn test` |
+| Lint + format | `yarn lint && yarn format` |
+| Full checks | `yarn checks` |
+| GraphQL regen | `yarn gql-codegen` |
+| Clean all | `yarn clean-all` |
 
 ## Structure
 
-- **packages/** - Shared libraries
-  - **core/** - Auth, utilities
-  - **lightspark-sdk/** - Public Lightning SDK
-  - **ui/** - React components, design system
-  - **private/** - Internal utilities, GraphQL clients
-- **apps/examples/** - Public examples and CLI tools
-- **apps/private/** - Internal apps (site, ops, uma-bridge)
-
-## Essential Commands
-
-### Setup
-```bash
-nvm use || nvm install  # Match Node version
-corepack enable && corepack prepare --activate  # Enable Yarn
-yarn  # Install all workspace dependencies
 ```
-
-### Development Workflow
-```bash
-# Start applications
-yarn start site uma-bridge ops  # Specific apps (@lightsparkdev/ prefix implied)
-yarn start private              # All private apps
-yarn start examples             # All examples
-
-# Code quality
-yarn lint && yarn format        # Lint + Prettier
-yarn checks                     # Full validation: deps, lint, format, test, circular-deps
-
-# Building
-yarn build                      # Build all workspaces with Turbo caching
-yarn build --force              # Rebuild without cache
-
-# Testing
-yarn test                       # Run all tests
-yarn workspace @lightsparkdev/ui test  # Test specific workspace
-
-# GraphQL codegen
-yarn gql-codegen                # Regenerate TypeScript types from schemas
+packages/
+  core/           # Auth, utilities
+  lightspark-sdk/ # Public Lightning SDK
+  ui/             # React components
+  private/        # Internal utilities
+apps/
+  examples/       # Public examples
+  private/        # Internal apps (site, ops, uma-bridge)
 ```
 
-### Workspace Targeting
+## Workspace Commands
+
 ```bash
-# From repo root
+# Target specific workspace
 yarn workspace @lightsparkdev/<name> <command>
 
-# From workspace directory
-cd apps/private/uma-bridge && yarn start
+# Examples
+yarn workspace @lightsparkdev/uma-bridge start
+yarn workspace @lightsparkdev/ui test
 ```
 
-## Architecture & Patterns
+## Code Patterns
 
-### Monorepo Management
-- **Yarn workspaces** with workspace protocol (`"@lightsparkdev/ui": "*"`)
-- **Turbo** orchestrates builds with caching and parallelization
+### Dependencies
+- Use workspace protocol for internal deps: `"@lightsparkdev/ui": "*"`
 - Shared configs: `@lightsparkdev/{tsconfig,eslint-config}`
-- Build artifacts in `dist/`, ignored by git
 
 ### GraphQL
-- TypeScript types auto-generated via GraphQL Code Generator
-- Schema variants per API surface (internal, third-party)
-- Fragments/operations defined per app
-- Real-time subscriptions for transaction updates
-- **After Python schema changes**: run `yarn gql-codegen` from root
-
-### React Stack
-- **Vite** - Dev server and bundler
-- **Emotion** - CSS-in-JS styling
-- **React Router** - Navigation
-- **React Query** - Server state
-- **Zustand** - Client state
-
-### Testing
-- **Jest** - Unit/integration tests
-- **React Testing Library** - Component tests
-- **Cypress** - E2E tests
-- Tests colocated with source (`.test.ts`, `.spec.ts`)
-
-## Configuration Files
-
-- **turbo.json** - Build pipeline, task dependencies, caching
-- **package.json** (root) - Workspace definitions, scripts
-- **packages/eslint-config/** - Shared linting rules
-- **packages/tsconfig/** - TypeScript presets
-
-## Code Standards
-
-- **TypeScript strict mode** enabled
-- **ESLint** extends shared configs
-- **Prettier** with import organization
-- **Circular dependency detection** via madge
-- **Prefer Edit tool** over inline rewrites for existing code
-
-## Common Task Workflows
-
-### Adding New Package
-1. Create directory in `packages/` or `apps/`
-2. Add workspace reference in root `package.json`
-3. Create `package.json` with dependencies (use workspace protocol for internal deps)
-4. Add build config to `turbo.json` if needed
-5. Run `yarn` to link workspace
-
-### GraphQL Type Updates
-After Python backend schema changes:
-```bash
-yarn gql-codegen  # All workspaces
-yarn workspace @lightsparkdev/uma-bridge gql-codegen  # Specific app
-```
-
-### Debugging Build Issues
-```bash
-yarn clean-all         # Remove dist/ and caches
-yarn build --force     # Bypass Turbo cache
-yarn clean-resolve     # Nuclear option: reset lockfile
-```
-
-### UMA Bridge Development
+After Python schema changes:
 ```bash
-# Lint bridge + UI package
-yarn run lint --filter=@lightsparkdev/ui --filter=@lightsparkdev/uma-bridge
-
-# Start with Vite dev server (proxy configured for backend)
-yarn workspace @lightsparkdev/uma-bridge start
+yarn gql-codegen                              # All workspaces
+yarn workspace @lightsparkdev/uma-bridge gql-codegen  # Specific
 ```
 
-Integrates with: Plaid, Tazapay, Striga, other payment providers
-
 ### Adding Dependencies
 ```bash
-# Workspace-specific
-yarn workspace @lightsparkdev/<name> add <package>
-
-# Root-level (affects all workspaces)
-yarn add -W <package>
+yarn workspace @lightsparkdev/<name> add <package>  # To workspace
+yarn add -W <package>                               # Root level
 ```
 
-## Release Process
-
-**Public packages** (SDK, core utilities):
-- Changesets for version management
-- Copybara syncs to public repo on main merge
-- Release PR auto-created
-- Merge Release PR → npm publish
-
-**Private packages** (`packages/private/`, `apps/private/`):
-- Not published to npm
-- Versioned internally only
-
 ## Troubleshooting
 
-**Import errors**: Check workspace dependencies use `"*"` not version numbers
-**Type errors after GraphQL changes**: Run `yarn gql-codegen`
-**Stale build artifacts**: `yarn clean-all && yarn build`
-**Turbo cache issues**: Add `--force` flag to bypass cache
+| Issue | Fix |
+|-------|-----|
+| Import errors | Check deps use `"*"` not versions |
+| Type errors after GraphQL | `yarn gql-codegen` |
+| Stale builds | `yarn clean-all && yarn build` |
+| Cache issues | `yarn build --force` |