구조 스키마 레퍼런스
일반 프로젝트의 DB 스키마에 해당하는 문서입니다. 이 프로젝트는 개발 인프라 저장소이므로 스킬/에이전트/재사용 코드의 구조 스키마를 관리합니다.
03-skills (8개 스킬)
| 스킬 | 디렉토리 | 구조 레벨 | 주요 파일 |
|---|---|---|---|
| kdyweb | 03-skills/kdyweb/ | 5레벨 | SKILL.md, phases/6개, references/6개, contract/2개, strategies/1개 |
| kdyextract | 03-skills/kdyextract/ | 1레벨 | SKILL.md |
| kdypick | 03-skills/kdypick/ | 1레벨 | SKILL.md |
| kdysetting | 03-skills/kdysetting/ | 1레벨 | SKILL.md |
| kdyclean | 03-skills/kdyclean/ | 1레벨 | SKILL.md |
| kdyimageanti | 03-skills/kdyimageanti/ | 1레벨 | SKILL.md |
| kdyplanon | 03-skills/kdyplanon/ | 1레벨 | SKILL.md |
| crawler-code-generator | 03-skills/crawler-code-generator/ | 1레벨 | SKILL.md |
kdyweb 상세 구조
03-skills/kdyweb/
├── SKILL.md ← Level 1: 진입점
├── phases/ ← Level 2: 모드별 워크플로우
│ ├── init.md ← 초기화 (9단계)
│ ├── page.md ← 페이지 추가 (7단계)
│ ├── verify.md ← 검증 (7단계, 10가지 이슈유형)
│ ├── migrate.md ← 마이그레이션 (6단계)
│ ├── component.md ← 컴포넌트 (6단계)
│ └── evolve.md ← 계약 진화 (5단계)
├── references/ ← Level 3: 참조 데이터
│ ├── common-pages.md ← 공통 페이지 정의 (7종)
│ ├── shared-variables.md ← 스택별 패턴
│ ├── connection-patterns.md ← 연결 패턴
│ ├── page-companions.md ← 동반 파일 패턴
│ ├── seo-metadata.md ← SEO 메타데이터
│ └── component-registry.md ← 페이지 유형→컴포넌트 매핑
├── contract/ ← Level 4: 계약 템플릿
│ ├── _WEB_CONTRACT_TEMPLATE.md
│ └── _MIGRATION_CHECKLIST.md
└── strategies/ ← Level 5: 전략 가이드
└── large-project.md
04-agents (2개 에이전트)
| 에이전트 | 파일 | 모델 | 용도 |
|---|---|---|---|
| code-reviewer | 04-agents/code-reviewer.md | sonnet | 코드 품질 리뷰 (6가지 검토 항목) |
| web-crawler-builder | 04-agents/web-crawler-builder.md | - | 웹 크롤링 코드 자동 생성 |
code-reviewer 검토 항목
| # | 항목 | 주요 검사 |
|---|---|---|
| 1 | 정확성 | 로직 에러, 경계 조건, null 처리, 에러 핸들링 |
| 2 | 보안 | 입력 검증, 인증/인가, 인젝션 취약점, 민감 데이터 |
| 3 | 성능 | 알고리즘 복잡도, 불필요 연산, N+1, 메모리 누수 |
| 4 | 유지보수성 | 네이밍, 추상화, DRY, 단일 책임, 테스트 가능성 |
| 5 | 표준 준수 | 코딩 표준, 포맷, 문서화, API 설계 |
| 6 | 출력 분류 | Critical/Important/Minor/Positive |
02-reusable-code (TypeScript/React, 10개 카테고리)
| # | 카테고리 | 디렉토리 | 주요 내용 |
|---|---|---|---|
| 01 | UI 컴포넌트 | 01-ui-components/ | shadcn-core, shadcn-form, shadcn-overlay, shadcn-nav, shadcn-data, shadcn-misc, web3 |
| 02 | 훅 | 02-hooks/ | useDebounce, useInfiniteScroll, useAutoSave 등 |
| 03 | 유틸리티 | 03-utils/ | cn, 포맷터(price, date), export(excel, pdf, csv), text-analysis 등 |
| 04 | Supabase 패턴 | 04-supabase-patterns/ | client, server, middleware |
| 05 | 인증/RBAC | 05-auth-rbac/ | 역할 기반 권한, Edge JWT 인증 |
| 06 | API 미들웨어 | 06-api-middleware/ | rate-limiting, 에러 핸들링, API client, retry policy |
| 07 | 컨텍스트 | 07-contexts/ | React 컨텍스트 패턴 |
| 08 | 서비스 | 08-services/ | Cloudinary, Stripe SaaS 패턴 |
| 09 | 템플릿 | 09-templates/ | 프로젝트 템플릿 |
| 10 | Stripe 패턴 | 10-stripe-patterns/ | Stripe SaaS 패턴 (API 7, 컴포넌트 2, DB 스키마, 설정) |
| 10 | Stripe SaaS | 10-stripe-saas/ | API 7개, 컴포넌트 2개, DB 스키마, 설정 |
02-reusable-code-python (Python, 5개 카테고리)
| # | 카테고리 | 디렉토리 | 주요 내용 |
|---|---|---|---|
| 1 | AI | ai/ | Whisper STT 엔진, 오디오 프로세서 |
| 2 | API | api/ | FastAPI 인증, WebSocket 스트리밍 핸들러 |
| 3 | 분석기 | analyzers/ | 데이터 분석 모듈 |
| 4 | 템플릿 | templates/ | 보고서 템플릿 |
| 5 | 유틸리티 | utils/ | Excel 리더, PDF 리더, HWPX 생성기, 오디오, 세션, 디바이스 |
01-dev-rules-system (개발 규칙)
| # | 디렉토리 | 용도 |
|---|---|---|
| 01 | 01-global-rules/ | 글로벌 규칙 (CLAUDE.md 등) |
| 02 | 02-project-template/ | 프로젝트 템플릿 |
| 06 | 06-tech-rd/ | 기술 R&D 방법론 (Spike→POC→Integration→Iteration) |
| 07 | 07-parallel-dev/ | 병렬 개발 규칙 (3-터미널 동시 개발) |
최종 갱신
- 2026-02-16: 초판 작성