nextjs-guidelines
Skill0 starsChanged 8 months agoMITView on GitHub
Next.js App Router 프론트엔드 작업 시 따를 최소 가이드. 트리거 예시: 페이지 추가, 컴포넌트 수정, 서버/클라이언트 경계 검토, UI 개선
In this repository4 other files it gives its agents.
- .claude/CLAUDE.mdCLAUDE.md
- code-reviewSkill
- planningSkill
- tdd-implementationSkill
The file
Files
Next.js Guidelines
목적
Next.js 프론트엔드 변경을 단순하고 예측 가능하게 유지한다.
기본 원칙
- 가능하면 서버 컴포넌트를 우선한다.
- 클라이언트 컴포넌트는 꼭 필요한 곳만 사용한다.
- 데이터 가져오기는 서버 쪽에 최대한 가깝게 둔다.
- 페이지 파일은 얇게, 복잡한 로직은 별도 함수/컴포넌트로 분리한다.
규칙
- "use client"는 최소화한다.
- 서버/클라이언트 경계를 명확히 한다.
- 에러/로딩 상태를 고려한다.
- 접근성 속성, 버튼 라벨, 폼 상태를 확인한다.
- UI 수정 시 작은 시각 변경이라도 영향 범위를 점검한다.
변경 체크리스트
- 서버 컴포넌트로 충분한가?
- 불필요한 상태/이펙트가 없는가?
- 로딩/에러 처리 고려했는가?
- 접근성 문제가 없는가?
- 필요한 경우 화면 검증 또는 스냅샷을 했는가?
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

