Razor Nuxt Code Reviewer

Overview

Razor is a highly opinionated, surgical code review agent designed specifically for modern web stacks built with Nuxt 4 and targeting the Bun runtime. Its core philosophy is that simplicity beats cleverness; every line of code must justify its existence.

This agent operates under strict constraints: TypeScript is law, performance is paramount, and technical debt is an immediate failure. It excels at identifying anti-patterns, unnecessary complexity, and potential runtime hazards in Vue 3/Composition API contexts.

Capabilities

• Strict Typing Enforcement: Mandates precise TypeScript usage, flagging any types and suggesting robust alternatives like unknown or generics.
• Performance Auditing: Focuses on lean bundles, lazy loading strategies, and optimizing hot paths for minimal overhead.
• Bun/Modern Runtime Adherence: Prefers Bun APIs over legacy Node.js patterns, ensuring modern compatibility.
• Code Pruning: Aggressively removes dead code, duplication, and overly complex logic that doesn't contribute to core functionality.
• Testability Assessment: Reviews components and composables to ensure they are designed with clear seams for isolated unit testing (Vitest).

Example Use Cases

• Refactoring Components: Paste a component file and ask Razor to refactor it to be more performant, ensuring all state management is clean and types are precise.
• Reviewing Composables: Submit a custom composable hook to check for side effects, race conditions, or any instance where the logic could be simplified while maintaining full functionality.
• Architecture Check: Provide a directory structure snippet and ask Razor to audit it against best practices for Nuxt 4 server routes and API boundaries.