Agent Context. Organized.

# Global Claude Code Rules — Jeff (BZY Design)

## Who I Am

Solo designer running BZY Design. Claude Code is my primary design
tool — I create HTML-based deliverables (one-pagers, websites,
landing pages, apps, decks, logos) directly in the terminal. Not
deeply technical with CLI — give me things that just work. JetBrains
Mono is my signature font. Aesthetic: ultra-minimal, restrained,
professional.

## Communication

- Concise, no fluff
- Always use full absolute filepaths — never shortened or relative
- Always give complete, copy-pasteable commands — include
  cd /path/to/dir && command every time
- High-level explanation of what changed at each step

## Code Philosophy

- Simplicity above all — every change should impact as little code
  as possible
- Think through the problem first, read relevant files
- Check in with me before major changes
- Never speculate about code you haven't read

## Design Philosophy

- Apple-level quality. Every frame should survive a design review
  at Apple.
- One hero moment per frame. Don't compete for attention.
- Restraint over spectacle. No glows, gradients, or effects that
  feel "techy."
- Vertical + horizontal balance. Nothing top-heavy or shoved into
  a corner.
- Breathing room. Generous margins (120-160px on 1920px canvases).
- Graduate type sizes — don't jump from 40px to 120px.
- No orphan words. Adjust max-width, rewrite, or use <br>.
- Every pixel considered. No dead zones, no accidental gaps.
- Always create new design versions — never overwrite.

## Design Review — MANDATORY

Before presenting ANY design version, run a minimum 3-pass internal
design review as an Apple lead designer.

Pass 0 — Screenshot (headless Chrome, ground truth)
Pass 1 — Structure & Layout (containers, fill, distribution)
Pass 2 — Spacing & Alignment (gaps, typography, contrast)
Pass 3 — Visual Fidelity (colors, radius, weights, clipping)

Only present after you would sign off on it yourself.

## Style Copy Loop

Pull exact specs from Figma using get_design_context first.
Build → Compare → List differences → Fix → Repeat (up to 5 rounds).

## Reference Image Verification

Implement → Screenshot → Compare side-by-side → Fix before showing.
"Like this" means exactly like that.

## Deployment & Infrastructure

- Wildcard domain: *.bzy.design
- Static sites: GitHub (jsbzy) → Vercel
- DNS is pre-configured, just set the subdomain

## Design Files Convention

When a project has a DESIGN.md, read it before any visual work.
DESIGN.md = visual language. CLAUDE.md = build instructions.

## Available Skills

- svg-precision — deterministic SVG generation
- svg-icon-generator — auto-activating for SVG work
- remotion-best-practices — Remotion video rules

MCP Servers:
  obsidian  — Personal notes at ~/notes
  driftgrid — Custom server via ~/drift/mcp/server.ts
  pencil    — Encrypted .pen file editor

Plugins:
  figma           — Figma MCP (read/write canvas)
  frontend-design — Frontend design generation

Settings:
  effortLevel: high
  Pencil MCP: auto-allowed

# Project Memory

## Projects — Context Locations
- RecovryAI: ~/dev/clients/recovryai/CLAUDE.md + DESIGN.md
- DriftGrid: ~/driftgrid/CLAUDE.md
- Health In Harmony: repo jsbzy/health-in-harmony
  Domains: hih-toc-cards.bzy.design (v4 primary)

## WanderPins (mobile — no CLAUDE.md yet)
- Android onboarding broken
- Confirm platform before OTA
- Stash before OTA push
- Never push with .env.local
- Always mention target platform
- Manifesto reference in Obsidian

## System
- Global rules: ~/.claude/CLAUDE.md
- Maintenance log: ~/.claude/maintenance-log.md
- New project checklist: plan noble-beaming-adleman.md

Step 1 — Where does this project live?
         Client (~/dev/clients/) or Personal (~/dev/projects/)

Step 2 — What is this project?
         One-paragraph description

Step 3 — DriftGrid?
         Default: yes. Scaffolds manifest, concept-1/v1,
         canvas type. Standalone dir still created for
         non-design assets.

Step 4 — Tech stack
         Static HTML / Next.js / Remotion / React Native / Other

Step 5 — Design details
         Mood, brand color, fonts, light/dark, references,
         canvas type (if DriftGrid)

Step 6 — Deployment
         Vercel (*.bzy.design) / Expo/EAS / TBD / Other

Step 7 — Review and create
         Creates: CLAUDE.md + DESIGN.md + DriftGrid scaffold
         Updates: MEMORY.md index

Step 1 — Which project?
         Lists all indexed projects, or name/path one

Step 2 — Context health check
         Scans for CLAUDE.md, DESIGN.md, DriftGrid state,
         git history, project structure.

         Shows status card:
         CLAUDE.md:  ✓ / ✗
         DESIGN.md:  ✓ / ✗
         DriftGrid:  ✓ (concepts, versions, last activity) / ✗
         Skills:     list or "none"
         Last activity: from git log

Step 3 — Fill gaps
         Missing CLAUDE.md? → Drafts from codebase scan
         Missing DESIGN.md? → Extracts from existing CSS/HTML
         Not in DriftGrid? → Offers to scaffold
         All set? → Brief summary of current state

Step 4 — What do you want to work on?
         If DriftGrid: suggests latest version, client
         feedback review, or new iteration