#8. 파일 및 컴포넌트 생성 규칙

#신규 파일 생성 위치

#패키지 신규 생성 시 필요한 파일

새 패키지를 추가할 때는 다음 파일들이 모두 필요합니다:

1. package.json — name, version, description, exports, bin, scripts, dependencies 포함
2. tsconfig.json — @common path alias, NodeNext module, noEmit: true
3. tsup.config.ts — createTsupConfig() 호출
4. src/index.ts — export { tools } from "./tools/index.js" + export { generateSkillMarkdown, generateReadmeSkills } from "@common"
5. src/server.ts — MCP 서버 생성 및 시작
6. src/cli.ts — CLI 실행
7. src/tools/index.ts — tools re-export
8. src/tools/<name>.ts — 실제 도구 정의

#기존 컴포넌트 수정 여부 판단 기준

#공통 로직 추출 시점

다음 조건 중 하나라도 해당되면 공통 로직으로 추출:

1. 동일한 코드가 2개 이상의 패키지에서 사용됨 → packages/common/kit/으로 이동
2. 동일한 코드가 1개 패키지 내 2개 이상의 도구에서 사용됨 → 패키지 내 유틸리티 함수로 추출 (예: cn.ts)
3. 복잡한 Zod 스키마가 재사용됨 → 공유 Zod 스키마로 분리

#공통 네이밍 규칙