Agentic Coding

AI 코드 리뷰 도구는 이제 너무 많다. Claude Code에게 “현재 변경사항 리뷰해줘”라고 말할 수도 있고, Codex나 Cursor에서도 비슷한 일을 시킬 수 있다. 문제는 그 다음이다. 리뷰라는 작업은 생각보다 귀찮게 정확해야 한다. 어떤 파일을 봐야 하는지, 어느 라인에 코멘…

처음에는 단순히 ESLint를 설정하는 과제라고 생각했다. 프론트엔드 프로젝트에서 ESLint와 Prettier를 붙이고, Husky와 lint-staged를 연결하고, 커밋 전에 어느 정도 코드 품질을 확인하게 만드는 일. 익숙한 일까지는 아니어도, 적어도 낯선 일은 아니라고 생각했다…

Hermes Agent를 Discord에 붙이면 거의 곧바로 이런 질문을 하게 된다. 누가 이 에이전트에게 말을 걸 수 있어야 할까. 그리고 누가 이 에이전트를 조종할 수 있어야 할까. 처음에는 이 둘이 같은 문제처럼 보였다. “이 봇을 쓸 수 있는 사람”을 정하면 끝날 것 같았기 때문…

내가 Hermes Agent를 처음 Docker로 띄운 이유는 단순했다. 내 맥에서 돌아가게 만들고 싶었다. 그런데 막상 Discord까지 붙이고 나니 다른 문제가 생겼다. 노트북이 서버처럼 굴기 시작한 것이다. 잠깐 테스트할 때는 괜찮다. 하지만 개인 에이전트를 계속 켜두려면 이야기가…

앞 글에서는 Hermes Agent를 Docker로 실행하는 데까지 갔다. ~/hermes-agents/dev을 상태 디렉터리로 만들고, 그 디렉터리를 컨테이너의 /opt/data로 mount했다. Docker Compose 파일은 ~/hermes-agents/docker에 두었다. 이…

Hermes Agent를 터미널에서 한 번 실행해보는 것은 어렵지 않다. 설치하고, 모델을 고르고, hermes를 실행하면 된다. 문제는 그 다음이다. Discord나 Telegram에서 계속 부르고 싶다면 Hermes는 터미널을 닫아도 살아 있어야 한다. 설정과 메모리와 스킬도 남아…

AI 에이전트에게 API 문서를 건네는 것과 도구를 건네는 것은 다르다. 사람은 문서를 읽고 endpoint를 고르고, 필요한 header와 body를 맞춰서 요청을 만든다. 모델도 어느 정도는 그렇게 할 수 있지만, 매번 그렇게 시키면 작업이 API 사용법 설명으로 흘러간다. 자동화를…

AI 에이전트나 스킬을 만들다보면 비밀값을 어떻게 관리하면 좋을지 하는 생각을 자주 하게 된다. API를 호출하려면 API Key가 필요하고, 특정 기능을 자동화하는 과정에서 아이디와 비밀번호가 필요할 수도 있다. 그런데 그 값을 프롬프트에 박아버리면 대화 기록에 남고, 명령어 인자로…

에이전트를 많이 만든다고 작업이 자동으로 잘 굴러가지는 않는다. 오히려 역할이 겹치고, 권한이 과하게 열리고, 어느 순간부터는 사람이 에이전트들을 관리하느라 더 바빠지는 일이 생긴다. OpenCode와 OMO(Oh My OpenAgent)를 함께 쓸 때 필요한 것은 더 많은 프롬프트가…

테스트 하네스가 테스트 대상을 외부로부터 감싸고 실행 환경을 제어하듯, 에이전트 오케스트레이션 시스템 역시 견고한 하네스가 필요하다. 하네스 없이 개별 에이전트만 늘려가는 방식은 위험하다. 어떤 에이전트가 어떤 권한으로 무엇을 실행했는지 추적이 되지 않을뿐더러, 에이전트의 작은 실수가…

에이전트 하나에게 탐색, 구현, 리뷰를 모두 시키면 일단 코드는 나온다. 하지만 그 코드가 정말 요구사항에 맞는지, 아키텍처를 해치지는 않는지 확인하는 주체가 사라진다. 구현자와 리뷰어가 같은 에이전트라면, 그 리뷰어는 필연적으로 자기 코드가 맞다고 생각하는 확증 편향에 빠지기 때문이다…

OMO는 OpenCode의 대체재가 아니다. OpenCode가 제공하는 에이전트, 커맨드, 스킬, 권한 시스템이라는 물리적 토대 위에 Sisyphus 중심의 오케스트레이션 레이어를 얹는 플러그인이다. 따라서 OMO를 활성화하더라도 기존에 구축한 .opencode/ 하위의 모든 설정 체계…

프롬프트에 “수정하지 마라”고 써도 에이전트는 수정할 수 있다. edit: allow가 열려 있으면 텍스트 지시는 의도일 뿐이고, 실행은 permission 설정이 결정하기 때문이다. 프롬프트는 에이전트를 설득하는 과정이지만, permission은 에이전트가 넘지 못하는 물리적인 경계다…

에이전트 파일의 역할은 단순히 프롬프트를 저장하는 것에 그치지 않는다. 특정 모델, 실행 권한, 온도, 그리고 출력 형식까지 하나의 패키지로 묶어 고정하는 것이 핵심이다. 이를 통해 에이전트를 어디서 호출하든 일관된 성격과 능력을 갖춘 전문가가 나오게 만들 수 있다. OpenCode에서…

커스텀 에이전트 파일을 처음 만드는 사람 대부분은 파일을 만들고 나서야 더 적합한 선택지가 있었다는 사실을 알게 된다. command 하나면 충분했던 작업이 거대한 에이전트가 되어 있고, 에이전트 파일이 늘어날수록 어떤 도구를 언제 호출해야 하는지 모호해지기 때문이다. 결과적으로 시스템…

최근 대규모 언어 모델을 활용한 애플리케이션 개발이 일반화되면서, 프롬프트에 구조화된 데이터를 어떻게 전달할 것인지가 점점 더 중요한 문제로 떠오르고 있다. 기존의 JSON은 웹 API의 표준으로서 널리 사용되고 있지만, LLM에 데이터를 전달하는 데에는 JSON이 불필요한 토큰 사용을…