nextjs-architect

Plans Next.js frontend architecture with RSC matrices, React Query hooks, and zod schemas.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/lucaszhh/agents --skill nextjs-architect-lucaszhh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nextjs-architect
Source: https://github.com/lucaszhh/agents/tree/main/skills/front/nextjs-architect
Command: npx skills add https://github.com/lucaszhh/agents --skill nextjs-architect-lucaszhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new frontend feature without a clear technical plan leads to inconsistent module structures, misplaced business logic, and missed edge cases. This Skill produces a complete architecture plan before any code is written, covering files, services, hooks, routes, types, and UI states. ## Core Features & Use Cases - RSC Decision Matrix: Builds a Server vs Client Components table with technical justification for every new or modified component. - Data Flow Design: Traces the full path from page component through React Query hooks to HTTP services, with centralized query keys. - Direct-to-Disk Deliverable: Writes the full plan to .agents/plans/<feature>.md using an official template, keeping the chat response to a concise summary with business questions. - Use Case: Before building a new payments module, ask for an architecture plan and receive a document listing every file to create, the zod schemas for forms, the query keys to centralize, and the loading/empty/error states per screen. ## Quick Start Ask the agent to plan the architecture for a new feature, for example: plan the implementation of a payment requests module and write the plan to .agents/plans/.

Frequently Asked Questions about nextjs-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a Next.js feature architecture before coding?▼

Invoke the skill with a request like plan this feature or review the architecture. It reads AGENTS.md, package.json, and existing modules, then writes a full plan to .agents/plans/<feature>.md covering files, services, hooks, and UI states.

How to decide between Server and Client Components in Next.js?▼

The skill builds an RSC decision matrix for each component. Pages stay as Server Components for SSR and smaller bundles, while components using useState, useQuery, or forms are marked with "use client" with documented justification.

Does this skill work with React Query and zod?▼

Yes, the plan explicitly designs useQuery and useMutation hooks with centralized query keys in query/keys.ts, and defines zod schemas for every form. It validates that these libraries already exist in package.json before proposing them.

When should I not use an architecture planning skill?▼

Skip it for changes under 10 lines, cosmetic hotfixes, or trivial fixes, which should go straight to code review. Purely visual changes belong to a design audit skill, and functional bugs belong to a debug flow.

Where does the architecture plan output get saved?▼

The full plan is written directly to .agents/plans/<feature-name>.md using the bundled template. The chat receives only a short summary, the file path, and open business questions, never the full document.