Show GN: LLM 기반의 코드 컨벤션 린터를 만들었습니다.

안녕하세요! 저희는 sym-cli를 개발하고 있는 대학생 팀 심포니입니다.

요즘 Cursor나 Claude Code 같은 도구를 써서 바이브 코딩을 많이 하시나요? 저희 팀도 개발 과정에서 LLM을 적극적으로 활용하고 있습니다. 그런데 쓰다 보니 한 가지 아쉬운 점이 있었습니다.

AI가 짜준 코드는 기능적으로는 잘 돌아가지만, 우리 팀만의 컨벤션(변수 명명법, 주석 스타일, 특정 라이브러리 사용 규칙 등)은 자꾸 무시한다는 것이었습니다. 매번 프롬프트에 규칙을 적어주자니 번거롭고 또 쓰다보면 점점 컨벤션을 까먹어가는 문제도 있었습니다.

그래서 "LLM이 코드를 짜기 전에, 혹은 짜는 도중에 스스로 컨벤션을 확인하게 할 수는 없을까?"라는 고민에서 sym-cli를 만들기 시작했습니다.

[sym-cli는 무엇인가요?]

sym-cli는 AI 코딩 도구를 위한 정책 기반 코드 컨벤션 린터입니다. 핵심은 MCP를 활용하여 LLM과 직접 소통한다는 점입니다.

기존 린터와 다른 점은 다음과 같습니다.

1. (자연어 기반 설정) 복잡한 설정 파일 대신, "절대로 log를 print로 작성하지마"처럼 자연어로 규칙을 정의하면 LLM이 이를 이해하고 따릅니다.
2. (Context 최적화)LLM이 프로젝트의 모든 규칙을 다 읽는 게 아니라, MCP 도구를 통해 현재 작업에 필요한 규칙만 똑똑하게 가져갑니다.
3. (능동적 검사) validate_code 도구를 통해 LLM이 코드를 생성한 직후 스스로 규칙 준수 여부를 검사할 수 있습니다.

[어떻게 작동하나요?]

sym 명령어를 다운로드 후 sym init 명령을 실행하면 MCP 서버 설정이 자동으로 구성되어, MCP를 지원하는 IDE(Cursor 등)나 LLM 도구에서 바로 이 규칙들을 참조하기 시작합니다.

[피드백을 부탁드립니다!]

저희는 아직 대학생 팀이고, 프로젝트도 이제 막 뼈대를 갖춘 초기 단계입니다. 부족한 점이 많고 버그가 있을 수도 있습니다. 하지만 현업 개발자분들이나 LLM 도구에 관심 많은 분들의 응원과 피드백이 절실합니다.

"이런 기능이 있으면 좋겠다", "이 부분은 구조적으로 문제가 있어 보인다", "실제 현업에서는 이렇게 쓴다" 등 어떤 의견이든 감사하게 듣겠습니다. 오픈소스이므로 기여나 GitHub Star는 저희 팀에게 정말 큰 힘이 됩니다!

GitHub Repository: https://github.com/DevSymphony/sym-cli
npm: npm install -g @dev-symphony/sym

읽어주셔서 감사합니다.