Loading...

개발 규칙 시스템 (Dev Rules System)

01-dev-rules-system/README.md

Open in Viewer Edit

개발 규칙 시스템 (Dev Rules System)

버전: 4.0 | 최종 업데이트: 2026-03-08

Claude Code 기반 웹 개발 프로젝트의 일관된 워크플로우를 정의하는 규칙 체계. 규칙(What) 을 담당하며, 실행(How)은 스킬, 역할(Who)은 에이전트가 수행한다.

섹션 구성

폴더	역할	핵심 파일
`00-overview/`	아키텍처 개요, 세션 생명주기	`README.md`, `architecture.md`, `session-lifecycle.md`
`01-global-rules/`	모든 프로젝트 공통 규칙	`CLAUDE.md` → `~/.claude/CLAUDE.md`에 복사
`02-project-template/`	새 프로젝트 시작 시 복사하는 뼈대	`CLAUDE.md` + `docs/` (commands 13, rules 10)
`03-dev-templates/`	스택 설정, MCP 가이드, 초기화 파일	`stacks/`, `mcp/`, `_init/`
`04-dev-stages/`	Phase 1~8 단계별 개발 가이드	`phase1-init.md` ~ `phase8-session.md`
`05-code-quality/`	React 45룰, Web Design, AI 코딩 한계	`react-best-practices/`, `web-design-guidelines/`
`06-tech-rd/`	Spike > POC > Integration > Iteration	`README.md`, `commands.md`
`07-parallel-dev/`	3-터미널 동시 개발 체계	`README.md`, 10개 세부 문서
`99-appendix/`	전체 명령어, 트러블슈팅, 체계 정리	`all-commands.md`, `범용_개발규칙_체계_정리.md`

5개 레이어 시스템

레이어	위치	역할
L1 글로벌 규칙	`~/.claude/CLAUDE.md`	모든 프로젝트 공통 (낮은 우선순위)
L2 공용 템플릿	`~/dev-templates/`	스택 설정, 인증, 품질 규칙
L3 프로젝트 규칙	`프로젝트/CLAUDE.md`	프로젝트 특화 (높은 우선순위)
L4 프로젝트 문서	`프로젝트/docs/`	상세 규칙, 명령어, 레퍼런스
L5 스킬/에이전트	`03-skills/`, `04-agents/`	자동화 실행 (스킬 24개, 에이전트 11개)

3계층 재사용 모델과의 관계

이 규칙 체계는 3계층 재사용 자산과 함께 작동한다:

계층	저장소	적용 스킬
Design	`02-reusable-design/` (토큰, CSS, Tailwind, 에셋)	`/kdyextract`
Code	`02-reusable-code/` (훅 48개, 유틸, UI 44개 등)	`/kdypick`
Page	`02-reusable-page/` (Footer 4종 등)	`/kdypick`

빠른 시작

글로벌 규칙 설정 (최초 1회): 01-global-rules/CLAUDE.md → ~/.claude/CLAUDE.md
새 프로젝트 시작: 02-project-template/ 복사 또는 /kdysetting 스킬 실행
재사용 코드 적용: /kdypick 스킬로 필요한 코드 선택 적용
상세 개요: 00-overview/README.md

관련 문서

아키텍처 구조도 - 5레이어 시스템 시각화
세션 라이프사이클 - 세션 시작/종료 흐름
전체 명령어 - 자연어 명령어 + 스킬 명령어
체계 종합 정리 - 인덱스 문서
스킬 목록 - 루트 CLAUDE.md 스킬/에이전트 테이블
MCP 가이드 - MCP 서버 설정/관리