27 개의 컨벤션

철학

AI가 생성한 코드가 실제로 망가지는 방식에서 출발합니다. 조용히 등장하는 any 타입, 삼켜진 에러, 옵셔널 필드를 통해 도달 가능한 잘못된 상태, 검증되지 않은 입력으로 인한 런타임 크래시 같은 것들이죠. 각 규칙은 이러한 실패 양상 중 하나로부터 모델을 멀어지게 하기 위해 작성되며, 에이전트가 만들어 내는 코드를 실제로 개선할 때만 라이브러리에 남습니다.

각 규칙은 짧고, 의견이 분명하며, 자기 완결적입니다. 에이전트는 세션 시작 시 모든 규칙을 한꺼번에 읽지 않고, 관련 변경을 하기 직전에 해당 규칙 하나만 읽습니다. 그 결과 프롬프트는 작아지고, 비용은 줄며, 모델이 코드를 작성하는 동안 작업 메모리에 실제로 담아 둘 수 있는 규칙이 됩니다.

라이브러리에 포함된 것

현재 라이브러리에는 27개의 컨벤션이 있으며, AI가 생성한 TypeScript에서 가장 자주 잘못되는 영역을 다룹니다. 타입 엄격성, 에러 처리, 신뢰 경계에서의 런타임 검증, 네이밍과 모듈 구조, 제어 흐름, 그리고 프레임워크 특화 패턴(예: React 컴포넌트의 prop 형태, Prisma 모델 컨벤션)이 포함됩니다.

구체적인 규칙은 MCP 서버를 통해 구독자에게 제공됩니다. 전체 목록은 여기에 공개하지 않습니다. 코퍼스에 접근하려면 구독해 주세요.

업데이트

기반 도구와 모델 동작이 발전함에 따라 컨벤션을 추가하고 다듬습니다. 업데이트는 즉시 반영되며, 사용자 측에서 다시 배포할 것은 없습니다. 주요 변경 사항은 이메일로 구독자에게 안내됩니다.