perf: eliminate Three.js/WebGL, fix render-blocking CSS, add dev team agents
- Replace ShaderGradientBackground WebGL shader (3 static spheres) with pure CSS radial-gradient divs — moves from ClientProviders (deferred JS) to app/layout.tsx as a server component rendered in initial HTML. Eliminates @shadergradient/react, three, @react-three/fiber from the JS bundle. Removes chunks/7001 (~20s CPU eval) and the 39s main thread block. - Remove optimizeCss/critters: it was converting <link rel="stylesheet"> to a JS-deferred preload, which PageSpeed read as a 410ms sequential CSS chain. Both CSS files now load as parallel <link> tags from initial HTML (~150ms). - Update browserslist safari >= 15 → 15.4 (Array.prototype.at, Object.hasOwn are native in 15.4+; eliminates unnecessary SWC compatibility transforms). - Delete orphaned app/styles/ghostContent.css (never imported anywhere, 3.7KB). - Add .claude/ dev team setup: 5 subagents (frontend-dev, backend-dev, tester, code-reviewer, debugger), 3 skills (/add-section, /review-changes, /check-quality), 3 path-scoped rules, settings.json with auto-lint hook. - Update CLAUDE.md with server/client orchestrator pattern, SSR animation safety rules, API route conventions, and improved command reference. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
50
.claude/skills/add-section/SKILL.md
Normal file
50
.claude/skills/add-section/SKILL.md
Normal file
@@ -0,0 +1,50 @@
|
||||
---
|
||||
name: add-section
|
||||
description: Orchestrate adding a new CMS-managed section to the portfolio following the full 6-step pattern
|
||||
context: fork
|
||||
agent: general-purpose
|
||||
---
|
||||
|
||||
Add a new CMS-managed section called "$ARGUMENTS" to the portfolio.
|
||||
|
||||
Follow the exact 6-step pattern from CLAUDE.md:
|
||||
|
||||
**Step 1 — lib/directus.ts**
|
||||
Read `lib/directus.ts` first, then add:
|
||||
- TypeScript interface for the new collection
|
||||
- `directusRequest()` GraphQL query for the collection (with translation support if needed)
|
||||
- Export the fetch function
|
||||
|
||||
**Step 2 — API Route**
|
||||
Create `app/api/$ARGUMENTS/route.ts`:
|
||||
- `export const runtime = 'nodejs'`
|
||||
- `export const dynamic = 'force-dynamic'`
|
||||
- Try Directus first, fallback to hardcoded defaults
|
||||
- Include `source: "directus" | "fallback" | "error"` in response
|
||||
- Error logging behind `process.env.NODE_ENV === "development"` guard
|
||||
|
||||
**Step 3 — Component**
|
||||
Create `app/components/$ARGUMENTS.tsx`:
|
||||
- `"use client"` directive
|
||||
- Skeleton loading state for the async data
|
||||
- Tailwind liquid-* tokens for styling (cards: `bg-gradient-to-br from-liquid-*/15 via-liquid-*/10 to-liquid-*/15 backdrop-blur-sm border-2 rounded-xl`)
|
||||
- Headline uppercase with tracking-tighter and emerald accent dot
|
||||
|
||||
**Step 4 — i18n**
|
||||
Add translation keys to both:
|
||||
- `messages/en.json`
|
||||
- `messages/de.json`
|
||||
|
||||
**Step 5 — Client Wrapper**
|
||||
Add `${ARGUMENTS}Client` to `app/components/ClientWrappers.tsx`:
|
||||
- Wrap in scoped `NextIntlClientProvider` with only the needed translation namespace
|
||||
|
||||
**Step 6 — Homepage Integration**
|
||||
Add to `app/_ui/HomePageServer.tsx`:
|
||||
- Fetch translations in the existing `Promise.all`
|
||||
- Render wrapped in `<ScrollFadeIn>`
|
||||
|
||||
After implementation:
|
||||
- Run `npm run lint` — must be 0 errors
|
||||
- Run `npm run build` — must compile successfully
|
||||
- Report what was created and any manual steps remaining (e.g., creating the Directus collection)
|
||||
39
.claude/skills/check-quality/SKILL.md
Normal file
39
.claude/skills/check-quality/SKILL.md
Normal file
@@ -0,0 +1,39 @@
|
||||
---
|
||||
name: check-quality
|
||||
description: Run all quality checks (lint, build, tests) and report a summary of the project's health
|
||||
disable-model-invocation: false
|
||||
---
|
||||
|
||||
Run all quality checks for this portfolio project and report the results.
|
||||
|
||||
Execute these checks in order:
|
||||
|
||||
**1. ESLint**
|
||||
Run: `npm run lint`
|
||||
Required: 0 errors (warnings OK)
|
||||
|
||||
**2. TypeScript**
|
||||
Run: `npx tsc --noEmit`
|
||||
Required: 0 type errors
|
||||
|
||||
**3. Unit Tests**
|
||||
Run: `npm run test -- --passWithNoTests`
|
||||
Report: pass/fail count and any failing test names
|
||||
|
||||
**4. Production Build**
|
||||
Run: `npm run build`
|
||||
Required: successful completion
|
||||
|
||||
**5. i18n Parity Check**
|
||||
Compare keys in `messages/en.json` vs `messages/de.json` — report any keys present in one but not the other.
|
||||
|
||||
After all checks, produce a summary table:
|
||||
| Check | Status | Details |
|
||||
|-------|--------|---------|
|
||||
| ESLint | ✓/✗ | ... |
|
||||
| TypeScript | ✓/✗ | ... |
|
||||
| Tests | ✓/✗ | X passed, Y failed |
|
||||
| Build | ✓/✗ | ... |
|
||||
| i18n parity | ✓/✗ | Missing keys: ... |
|
||||
|
||||
If anything fails, provide the specific error and a recommended fix.
|
||||
30
.claude/skills/review-changes/SKILL.md
Normal file
30
.claude/skills/review-changes/SKILL.md
Normal file
@@ -0,0 +1,30 @@
|
||||
---
|
||||
name: review-changes
|
||||
description: Run a thorough code review on all recent uncommitted changes using the code-reviewer agent
|
||||
context: fork
|
||||
agent: code-reviewer
|
||||
---
|
||||
|
||||
Review all recent changes in this repository.
|
||||
|
||||
First gather context:
|
||||
- Recent changes: !`git diff HEAD`
|
||||
- Staged changes: !`git diff --cached`
|
||||
- Modified files: !`git status --short`
|
||||
- Recent commits: !`git log --oneline -5`
|
||||
|
||||
Then perform a full code review using the code-reviewer agent checklist:
|
||||
- SSR safety (no `initial={{ opacity: 0 }}` on server elements)
|
||||
- TypeScript strictness (no `any`)
|
||||
- API route conventions (`runtime`, `dynamic`, `source` field)
|
||||
- Design system compliance (liquid-* tokens, contrast ratios)
|
||||
- i18n completeness (both en.json and de.json)
|
||||
- Error logging guards
|
||||
- Graceful fallbacks on all external calls
|
||||
|
||||
Output:
|
||||
- **Critical** issues (must fix before merge)
|
||||
- **Warnings** (should fix)
|
||||
- **Suggestions** (nice to have)
|
||||
|
||||
Include file:line references and concrete fix examples for each issue.
|
||||
Reference in New Issue
Block a user