convention.sh

convention.sh란 무엇인가요?

convention.sh는 코딩 에이전트가 더 일관되고 배포 가능한 TypeScript를 생성하도록 가르치는 호스팅 툴킷입니다. 에이전트가 정적 프롬프트 크기의 규칙 세트에 의존하는 대신, 요청 시 가져올 수 있는 손수 조정된 TypeScript 컨벤션 라이브러리를 제공합니다.

핵심 목적은 에이전트에게 구체적인 컨벤션—예를 들어 더 엄격한 타이핑 패턴과 런타임 검증 접근 방식—을 표준 인터페이스를 통해 제공하여 부실한 TypeScript 출력을 줄이는 것입니다.

주요 기능

컨벤션용 호스팅 MCP 서버: convention.sh는 에이전트가 필요로 하는 컨벤션 스니펫을 쿼리할 수 있는 호스팅 Model Context Protocol (MCP) 서버로 실행됩니다.
요청 시 스니펫 검색 (27개 컨벤션): 모든 프롬프트에 규칙 벽을 포함하는 대신, 에이전트가 요청할 때 27개 컨벤션 라이브러리에서 관련 스니펫만 가져옵니다.
TypeScript 정확성 중심 컨벤션: 나열된 컨벤션은 엄격한 타이핑(any 피하기), 신뢰할 수 없는 입력 검증에 Zod 사용, 선택적 필드 대신 판별된 유니온 선호를 강조합니다.
MCP를 통한 모델 컨텍스트 통합: MCP 엔드포인트를 에이전트 구성에 추가하면 Standard Model Context Protocol을 지원하는 모든 에이전트와 작동합니다.
재배포 없이 항상 최신 유지: 컨벤션이 호스팅 MCP 엔드포인트에서 제공되므로, 프롬프트 재작성이나 애플리케이션 재배포 없이 후속 요청에서 변경 사항을 반영합니다.

convention.sh 사용 방법

에이전트에 MCP 엔드포인트 추가 제공된 터미널 명령어를 사용하여 호스팅 엔드포인트를 등록하세요: claude mcp add conventiondotsh --transport http https://mcp.convention.sh.
코딩 에이전트에서 평소 TypeScript 작업 실행 시작하세요.
필요 시 에이전트가 컨벤션 요청: 작업 중 에이전트가 필요로 하는 특정 컨벤션 스니펫을 convention.sh 서버에서 요청합니다.

예시와 다른 MCP 지원 에이전트를 사용하는 경우, convention.sh에서 설명된 동일한 호스팅 MCP 엔드포인트를 호출하도록 구성하세요.

사용 사례

일관된 스타일로 TypeScript 모듈 리팩토링: TypeScript 코드를 생성하거나 업데이트할 때 컨벤션을 요청하여 에이전트가 타이핑과 입력 검증에 동일한 패턴을 적용합니다.
API 핸들러에서 신뢰할 수 없는 입력 검증: 입력 확인을 명시적이고 일관되게 유지하기 위해 Zod 검증을 권장하는 컨벤션을 사용합니다.
선택적 필드 모호성 피하기: 데이터 형태를 설계할 때 생성된 코드에서 변형 처리를 더 명확하게 하기 위해 선택적 필드 대신 판별된 유니온을 선호합니다.
긴 코딩 세션에서 프롬프트 팽창 줄이기: 필요할 때만 특정 컨벤션 스니펫을 에이전트가 가져오도록 하여 에이전트 프롬프트를 집중적으로 유지합니다.
팀에서 에이전트 출력 표준화: 공유 호스팅 엔드포인트에서 동일한 컨벤션 스니펫을 제공하여 MCP 통합을 적용한 에이전트가 여러 머신에서 정렬되도록 합니다 (업데이트는 다음 요청에서 반영).

자주 묻는 질문

여기서 “요청 시”는 무슨 의미인가요? 컨벤션은 호스팅 MCP 서버를 통해 제공되며, 에이전트가 작업 중 27개 컨벤션 라이브러리에서 필요한 스니펫만 요청합니다. 전체 규칙 세트를 매번 받지 않습니다.
내가 직접 빌드하거나 호스팅해야 하나요? convention.sh는 호스팅 MCP 서버로 설명되어 있으므로, 컨벤션 라이브러리를 직접 호스팅하는 대신 에이전트에 엔드포인트를 추가합니다.
코딩 에이전트와 어떻게 통합하나요? MCP 통합 흐름을 사용하세요: https://mcp.convention.sh의 호스팅 엔드포인트를 MCP 지원 에이전트에 구성합니다. 페이지에 MCP 서버 추가 예시 명령어가 포함되어 있습니다.
어떤 TypeScript 규칙이 포함되나요? 페이지에 나열된 예시 컨벤션은 엄격한 타이핑(any 없음), Zod로 신뢰할 수 없는 입력 검증, 선택적 필드 대신 판별된 유니온 선호에 중점을 둡니다.
컨벤션이 변경될 때 프롬프트를 업데이트해야 하나요? 아니요—컨벤션이 호스팅 MCP 엔드포인트에서 제공되므로, 에이전트가 다음 요청에서 새 규칙을 가져오며 재배포나 여러 머신의 오래된 복사본이 필요 없습니다.

대안

정적 프롬프트 규칙 목록 또는 위키: 각 프롬프트에 TypeScript 가이드라인을 직접 포함할 수 있지만, 이는 프롬프트 크기를 늘리고 일관되지 않은 적용으로 이어질 수 있습니다.
로컬 린팅/포맷팅 도구 체인 (예: TypeScript ESLint): 이러한 도구는 스타일을 강제하고 문제를 사후에 잡아주지만, convention.sh는 MCP를 통해 코드 생성 중 컨벤션을 제공합니다.
기타 검색 기반 에이전트 컨텍스트 도구: 이미 RAG나 도구 기반 컨텍스트 검색을 코딩에 사용한다면, 유사한 “필요 시 컨벤션 가져오기” 워크플로를 구축할 수 있지만, 컨벤션 라이브러리와 검색 로직을 직접 유지해야 합니다.