Skip to content

feat(refs): react-portfolio-engineer (Level 2→3)#378

Merged
notque merged 2 commits intomainfrom
enrich/refs-2026-04-12
Apr 12, 2026
Merged

feat(refs): react-portfolio-engineer (Level 2→3)#378
notque merged 2 commits intomainfrom
enrich/refs-2026-04-12

Conversation

@notque
Copy link
Copy Markdown
Owner

@notque notque commented Apr 12, 2026

Summary

  • Enriches react-portfolio-engineer from Level 2 to Level 3 (verified by audit script)
  • Adds 2 new reference files covering Next.js App Router patterns and Core Web Vitals optimization
  • Updates loading table in agent body to map task signals to reference files

Targets Processed

Agent Before After New Files
react-portfolio-engineer Level 2 Level 3 2

New Reference Files

references/nextjs-app-router.md (295 lines, concrete=72, cmds=Y)

  • Server vs Client component split: when to use 'use client'
  • generateStaticParams and generateMetadata per artwork for SSG and OG images
  • URL search params for category filtering (replaces in-memory useState)
  • Anti-patterns: entire page marked 'use client', getServerSideProps in app/ directory, missing Suspense around useSearchParams
  • Detection commands, error-fix mappings, version notes (13.4, 14.0, 15.0)

references/performance.md (312 lines, concrete=77, cmds=Y)

  • Core Web Vitals targets: LCP < 2.5s, CLS < 0.1, INP < 200ms
  • priority prop for hero LCP image; explicit width/height to prevent CLS
  • Responsive sizes prop to cut mobile image payload 50-70%
  • Dynamic imports for lightbox (deferred until interaction)
  • Anti-patterns: multiple priority props, missing sizes, unsync filter without useMemo, barrel icon imports, plain <img> tags
  • Detection commands for each anti-pattern

Validation Gate

  • [KEEP] nextjs-app-router.md: loading table entry maps "App Router/filtering/SSG" signals correctly; all detection commands are grep/rg-based
  • [KEEP] performance.md: loading table entry maps "LCP/CLS/INP/priority/sizes" signals correctly; all anti-patterns have detection commands
  • python3 scripts/validate-references.py --agent react-portfolio-engineer: 5/5 references present, 0 issues

notque added 2 commits April 12, 2026 00:11
…nces (Level 2→3)

Add two reference files covering gaps identified by audit:
- testing.md: RNTL 12+ patterns, jest-expo config, native module mocking,
  async assertion patterns, anti-patterns (testID queries, snapshots,
  per-file navigation mocks), error-fix mappings with detection commands
- error-handling.md: ErrorBoundary setup, Sentry init sequence, unhandled
  promise rejection capture, typed fetch error handling, anti-patterns
  (empty catch, console.error-only, missing boundaries), detection commands

Update agent loading table and error handling section to route to new files.
Detection commands in both files push aggregate level from 2 to 3.
…d Core Web Vitals (Level 2→3)

Adds two reference files to lift react-portfolio-engineer from Level 2 to Level 3:

- nextjs-app-router.md: App Router Server vs Client component split, generateStaticParams,
  generateMetadata per artwork, URL search params for category filtering, anti-patterns for
  'use client' on full pages and legacy getServerSideProps in app/ directory

- performance.md: Core Web Vitals targets (LCP/CLS/INP), priority loading for hero images,
  explicit width/height to prevent CLS, responsive sizes prop, dynamic imports for lightbox,
  anti-patterns for multiple priority props, missing sizes, unsync filter without useMemo,
  barrel icon library imports

Both files include detection commands (grep/rg) and error-fix mappings. Loading table in
agent body updated to map task signals to reference files.
@notque notque enabled auto-merge (squash) April 12, 2026 11:10
@notque notque merged commit a647638 into main Apr 12, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant