8. 파일 및 컴포넌트 생성 규칙
신규 파일 생성 위치
새 도구 추가 시 체크리스트
src/tools/<name>.ts—toolDef()로 도구 정의 (description, inputSchema, handler).inputSchema의 모든 필드는.nullable()이어야 하고.describe()에 기본값을 적습니다 — 04-coding-rules 참고src/tools/index.ts— 새 도구를tools객체에 병합src/tools/<name>.test.ts— 핸들러 단위 테스트src/tools/openai-schema.test.ts— 도구 개수를 올려 새 도구까지 검사에 포함README.md— 인자 표·기본값·범위·반환 형태·예제를 손으로 추가skills/mcp-kit-cli/SKILL.md— 같은 인자 표를 손으로 추가- 도구가 노출하는 이름(
name필드)은 MCP 클라이언트 호환성에 직결되므로 신중히 결정
기존 컴포넌트 수정 여부 판단 기준
공통 로직 추출 시점
다음 조건 중 하나라도 해당되면 공통 로직으로 추출:
- 동일한 코드를 MCP 서버와 CLI가 함께 사용함 →
src/common/kit/으로 이동 - 동일한 코드가 2개 이상의 도구에서 사용됨 → 해당 도메인 디렉터리의 유틸리티로 추출 (예:
src/exchange/parse.ts) - 복잡한 Zod 스키마가 재사용됨 → 공유 Zod 스키마로 분리