LLM과 신규 개발자를 생각한 Agent Skills,
업무 번거로움 해결하고 효율성은 높이고
이메일에 기록된 일정과 정보를 캘린더에 등록하고, 운동 루틴과 식단을 계획하며, 생활 속 문제를 해결하고…. AI가 일상화된 시대, 업무 환경에서도 AI는 빼놓을 수 없다. 삶의 질을 증폭시키는 AI는 빠르게 우리 일상으로 들어왔으니까. 데일리펀딩 IT실도 당연히 AI 활용의 공감대를 바탕으로 적용 영역을 확대해 왔다.
대부분은 ‘이런 게 있으면 정말 좋을 텐데….’ 하는 고민에서 출발한다. AI와 함께 일해 본 개발자라면 공감할 만한 이야기인데, 세션이 새로 만들어질 때마다 AI 에이전트(LLM)에게 항상 반복되는 내용을 알려 줘야 하고 비슷한 실수를 거듭하는 AI에 신경 쓰여 에너지와 시간, 토큰 비용을 빼앗기곤 한다. 이로 인해 AI에게 일을 맡겨 놓고도 다른 업무를 하기 힘들다.
혼자만 그런 줄 알고 약간의 스트레스를 견디던 중, 동료 개발자와 대화 나누다 알게 됐다. 나만 그런 게 아니라 다들 비슷한 상황을 겪고 있었다는 것을. 동료들의 공감대는 Agent Skills을 적용해 업무 효율성을 한 단계 강화하자는 결정에 힘을 실어 주었다.
Agent Skills은 LLM에게 업무하는 방법을 가르치는 가이드 문서로, 프로젝트 소개와 개발 규칙 등의 내용을 포함한다. 세션마다 똑같이 적용되는 개발 내용을 문서로 정리하고 소스 코드에 문서 파일을 업로드해 두면, 어떤 요청을 받을 때마다 AI가 자동으로 읽고 처리한다. 신규 입사자 온보딩 프로그램의 내용과 비슷한 내용이라 LLM과 신규 개발자 가이드용 문서로 작성했다.
레거시 호환성, 시스템 안정성 고려한 가이드 작성
LLM과 같이 대화하며 내용 보완해 나가기도
우선 스킬은 프로젝트 구조와 코딩 가이드라인, 환경 구성, 패키지 관리, 테스트로 각각 분류했다. 이렇게 스킬을 분류해 두면 LLM이 작업 시 필요한 스킬만 찾아 읽을 수 있어 업무 효율이 향상된다. 이 분류에 따라 .agents/skills 디렉토리 하위에 각 스킬별로 디렉토리를 만들고 SKILL.md 파일을 작성해 모든 AI 에이전트가 읽을 수 있도록 했다. SKILL.md 파일은 LLM뿐만 아니라 개발자도 읽고 수정하기 쉬운 마크다운 형식으로 작성한 것도 포인트다.
SKILL.md 파일에 담긴 주요 내용은 대부분 소스 코드만으로 알기 어려운 외부 환경 정보나 규칙, 코딩 컨벤션, 유틸 함수, 라이브러리 활용 등이었다. 개발자가 누락하기 쉬운 Django 마이그레이션 생성이나 환경 변수, django settings 같은 설정도 체크하도록 신경 썼다.
특히 더 살폈던 부분은 분류와 레거시 플랫폼과의 호환성이었다. 데일리펀딩이 진행 중인 대규모 마이그레이션 프로젝트는 기존 레거시 플랫폼을 정상적으로 운영하면서 새로운 플랫폼이 데이터 구조를 처리하는 게 관건이다. LLM이 이러한 기반 지식이 없을 경우 호환성을 고려하지 않은 코드를 작성할 가능성이 존재한다. 그럼 기존 플랫폼과의 호환성이 떨어져 서비스 안정성이 낮아진다. 레거시 플랫폼이 사용 중인 DB 모델이나 데이터 처리 방법, 호환 레이어에 대한 설명을 꼼꼼히 챙긴 이유다.
스킬 작성 과정에도 LLM을 적극적으로 활용했다. LLM을 신입 개발자 역할로 정하고, 프로젝트에 대해 같이 이야기하면서 LLM이 잘 이해하지 못하는 부분을 보완해 나갔다.
여러 AI가 한 번에 작업하는 멀티 에이전트 시스템
개발 분야를 넘나들며 사람을 돕는 AI 역할 기대해
Agent Skills은 도입 후 개발 영역에 빠르게 적용됐다. 이미 데일리펀딩은 서비스 개발과 테스트 프로세스 등 모든 개발 과정에서 LLM을 적극 활용하고 있어서다. 그중에서 가장 큰 변화는 ‘멀티 에이전트’ 사용이다. 프로젝트를 어느 정도 이해한 AI와 협업하니 에이전트를 여럿 띄우고 각각의 기능을 동시에 개발하게 된 것이다. 즉, 개발자가 AI 하나하나에 매달리고 잘못된 내용을 새로 지시하는 게 아니라, 결과물만 체크하면 되는 시스템이다. Agent Skills을 바탕으로 LLM이 숙련된 개발자처럼 일한다는 것은 중요한 프로젝트에 힘과 에너지를 더욱 쏟는 환경을 가꿨다는 의미다. 멀티 에이전트 시스템은 꼭 이루고 싶은 꿈 같은 것이었는데 실현하게 돼 개인적으로도 만족감이 높았다.
Agent Skills은 소스 코드에 포함돼 배포되는 문서 파일이라 배포가 매우 쉽다는 점이 좋았다. 프로젝트 전체에 영향을 주는 새로운 기능이나 제약 사항 같은 변경이 발생할 때, 스킬 파일을 업데이트해 커밋하면 모든 개발자에게 새로운 소스 코드와 함께 배포되고 LLM도 최신 문서를 읽고 작업할 수 있었다. 이처럼 사소한 영역에서도 시간과 에너지를 아끼니 코드 생산성도 확연히 높아졌다.
나중에는 Agent Skills을 개발 분야가 아닌 업무에도 활용하리라는 생각도 든다. 특히 사람이 실수할 만한 부분을 미리 문서화해 두면 AI가 사람의 일을 적극적으로 도우면서도 사전 탐지해 휴면에러를 예방하는 데 큰 도움이 될 것 같다.