Agent skill · software engineering · aiskillstore
project-structure
Organize project folders following industry best practices. Use when setting up new projects, reorganizing codebases, or when folder structure becomes messy. Covers Next.js, Bulletproof React, and FSD patterns.
Why this skill is useful
Provides specific folder structure patterns and organization strategies for Next.js and React projects that the AI wouldn't reliably generate on its own.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Project Structure 프로젝트 폴더 구조를 업계 표준에 맞게 정리하는 스킬입니다. Core Principles "바탕화면에 코드를 두지 않는다" "분류 기준을 섞지 않는다" Safety Rules 명령어 상태 대안 -------- ------ ------ rm -rf 🔴 금지 legacy/로 이동 rm 🔴 금지 legacy/로 이동 mv to legacy/ ✅ 허용 기본 정리 방식 mkdir ✅ 허용 새 구조 생성 정리 방식 --- Part 1: 개발 루트 디렉토리 권장 루트 위치 컨텍스트(목적) 중심 구조 (추천) 호스트(Source) 중심 구조 (Go 스타일) --- Part 2: 프로젝트 내부 구조 기본 프로젝트 스캐폴딩 --- Part 3: 프론트엔드 아키텍처 패턴 Pattern A: Next.js App Router + Colocation 라우트(페이지) 기준으로 폴더 생성, 필요한 파일을 같은 폴더에 배치 적합한 경우: Next.js 기반 프로젝트 --- Pattern B: Bulletproof React (Feature-based) 기능(Feature) 단위로 묶어서 유지보수 용이한 구조 적합한 경우: 팀 규모가 크거나 기능이 많은 React 프로젝트 --- Pattern C: Feature-Sliced Design (FSD) 계층(Layer)으로 분류하는 아키텍처 방법론 적합한 경우: 규칙을 팀이 같이 지킬 수 있는 중대형 프로젝트 --- Part 4: 하이브리드 패턴 (Next.js + Feature) Next.js App Router를 뼈대로, features 방식을 섞은 실용적 구조 --- Workflow: 폴더 정리 1. 현재 구조 분석 2. 레거시 폴더 생성 3. 정리 대상 이동 4. 새 구조 생성 5. 파일 이동 --- Naming Conventions 규칙 예시 설명 ------ ------ ------ kebab-case my-project 폴더명 (공백 금지) PascalCase UserProfile.tsx React 컴포넌트 camelCase useAuth.ts 훅, 유틸리티 UPPERCASE APIURL 상수 Anti-patterns Quick Setup Scripts macOS/Linux: 개발 루트 생성 프로젝트 스캐폴딩 Bulletproof React 구조 --- References Next.js Project Structure Bulletproof React Feature-Sliced Design
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/project-structure