업무 Agent 팀을 만들기 위한 첫걸음: Hermes LLM Wiki 구축 시도기
2026.05.24
소개
최근 저는 업무 Agent 팀을 구축하기 위한 준비 작업으로 Hermes LLM Wiki를 만들어보는 시도를 시작했습니다.
아직 완성된 Agent 시스템을 만든 단계는 아니지만, 앞으로 업무를 단계별로 분해하고, 각 Agent가 수행할 Task 지침을 정의하기 위한 기반을 잡는 것이 목표였습니다. 😊
처음부터 거창한 자동화 시스템을 만들기보다는, 제가 현재 하고 있는 업무를 하나씩 구조화하면서 “이 업무를 나중에 봇에게 위임하려면 어떤 정보와 지침이 필요할까?”를 고민하는 과정에 가까웠습니다.
이번 시도는 4주간의 리서치 Hermes 과정의 초기 단계로 진행했습니다. 궁극적으로는 Hermes Agent, 즉 업무 봇이 일정 수준의 판단과 실행을 맡을 수 있도록 만드는 것이 목표입니다. 다만 이번 OT 스터디에서는 스터디장님들의 가이드를 Hands-on으로 따라 해보며 전체 구조를 이해하는 데 집중했습니다.
진행 방법
1. 먼저 “업무 Agent 팀”이라는 목표를 정했습니다
이번 프로젝트의 출발점은 단순히 Wiki를 하나 만드는 것이 아니었습니다.
제가 궁극적으로 만들고 싶은 것은 업무를 대신 진행할 수 있는 Agent 팀이었습니다.
예를 들면 다음과 같은 흐름을 상상했습니다.
현재 하고 있는 업무를 단계별로 나눈다.
각 단계별로 필요한 Task 지침을 정의한다.
반복되는 판단 기준과 실행 절차를 문서화한다.
이 문서화된 내용을 기반으로 Agent가 업무를 수행할 수 있게 한다.
향후에는 Hermes Agent, Notion, Claude Code 등을 연결해 업무 흐름을 자동화한다.
즉, 이번 Wiki 구축은 “자동화의 결과물”이라기보다 자동화를 가능하게 만드는 업무 지식의 구조화 작업이었습니다.
2. Notion 연동을 염두에 두었습니다
저는 LG전자 노션 챔피언으로 활동하고 있기 때문에, 향후 업무 지식과 실행 흐름을 Notion과 연결하는 방향도 함께 고려했습니다.
Notion은 업무 문서, 데이터베이스, 프로젝트 관리 흐름을 한곳에 모을 수 있는 도구이기 때문에, Agent와 연동했을 때 업무 맥락을 제공하는 기반이 될 수 있다고 생각했습니다.
이번 단계에서는 바로 완성된 Notion 연동을 구현하기보다는, 다음과 같은 질문을 중심으로 구조를 잡아보았습니다.
어떤 업무 정보를 Notion에 정리해야 할까?
Agent가 참고해야 할 문서는 어떤 형태여야 할까?
Task 지침은 어느 정도까지 구체적으로 작성해야 할까?
나중에 봇이 읽고 실행할 수 있는 구조는 어떤 모습이어야 할까?
3. Claude Code를 기본 도구로 사용했습니다
이번 실습에서는 Claude Code를 기본 도구로 활용했습니다.
Claude Code를 사용하면서 단순히 코드를 작성하는 것보다, 프로젝트 구조를 이해하고 지침을 정리하는 방식이 중요하다는 점을 느꼈습니다.
특히 기존에는 작업을 할 때 일종의 “바이브 코딩” 방식으로 많이 진행했습니다.
아이디어가 떠오르면 바로 구현하고, 중간중간 LLM에게 물어보며 이어가는 방식이었습니다.
물론 이 방식은 빠르게 결과를 만들어보는 데는 도움이 되었지만, 프로젝트가 조금만 커지면 다음과 같은 문제가 생겼습니다.
전체 구조가 쉽게 흐트러진다.
어떤 기준으로 구현했는지 나중에 기억하기 어렵다.
Agent에게 맡길 수 있는 Task 단위가 명확하지 않다.
결과물의 품질이 매번 달라진다.
같은 설명을 반복해서 입력하게 된다.
그래서 이번에는 스터디에서 소개된 좋은 Skill과 가이드를 활용해, 먼저 구조를 잡고 그 위에서 구현을 진행하는 방식을 연습했습니다.
4. 이번 OT 세션에서는 Hands-on으로 이해하는 데 집중했습니다
이번 OT 스터디의 목표는 완성도 높은 Hermes Agent를 바로 만드는 것이 아니었습니다.
스터디장님들이 안내해주신 흐름을 직접 따라 해보면서, 앞으로 어떤 식으로 Agent 구축을 진행하면 좋을지 감을 잡는 시간이었습니다.
이번 단계에서 중점적으로 본 것은 다음과 같습니다.
Hermes LLM Wiki가 어떤 역할을 할 수 있는지 이해하기
업무 Agent를 만들기 위해 필요한 지식 구조 파악하기
Task 지침을 어떻게 쪼개야 하는지 고민하기
Claude Code를 활용해 프로젝트를 구조적으로 진행하는 방식 익히기
향후 Notion 연동 가능성을 염두에 두고 문서 구조 잡기
사용한 도구
Hermes LLM Wiki
Claude Code
Notion
스터디에서 제공된 Skill 및 가이드
사용한 프롬프트 / 지침 예시
이번 단계에서는 완성된 프롬프트보다, 앞으로 Agent에게 줄 지침을 어떻게 정리할지 고민하는 데 초점을 맞췄습니다.
목표:
현재 업무를 단계별 Task로 분해하고, 각 Task를 Agent가 이해할 수 있는 지침 형태로 정리한다.
진행 방식:
1. 현재 업무 흐름을 정리한다.
2. 반복되는 업무 단계를 찾는다.
3. 각 단계별 입력값, 판단 기준, 출력물을 정의한다.
4. 향후 Hermes Agent가 참고할 수 있도록 Wiki 형태로 문서화한다.
5. Notion 연동 가능성을 고려해 문서 구조를 설계한다.결과와 배운 점
1. Agent 구축은 코딩보다 “업무 구조화”가 먼저였습니다
이번에 가장 크게 느낀 점은, Agent를 잘 만들기 위해서는 도구를 바로 붙이는 것보다 업무 자체를 잘 쪼개고 설명하는 작업이 먼저라는 점이었습니다.
막연히 “이 업무를 자동화하고 싶다”라고 생각할 때는 쉬워 보였지만, 실제로 Agent에게 맡기려면 다음 질문에 답할 수 있어야 했습니다.
이 업무의 시작 조건은 무엇인가?
중간에 어떤 판단이 필요한가?
결과물은 어떤 형태여야 하는가?
실패했을 때 어떻게 대응해야 하는가?
사람이 확인해야 하는 지점은 어디인가?
결국 Agent를 만든다는 것은 단순히 LLM을 붙이는 일이 아니라, 내 업무 방식을 설명 가능한 형태로 바꾸는 일이라는 생각이 들었습니다.
2. 바이브 코딩만으로는 한계가 있었습니다
이전에는 빠르게 만들어보는 방식으로 접근하다 보니, 결과물은 나와도 구조가 명확하지 않은 경우가 많았습니다.
하지만 이번 스터디에서 소개된 Skill을 활용하면서, 먼저 맥락과 지침을 정리하고 작업하는 방식이 결과의 품질을 높이는 데 도움이 된다는 것을 느꼈습니다.
특히 Agent 구축에서는 “그때그때 잘 물어보기”보다, Agent가 계속 참고할 수 있는 기준 문서와 Task 지침을 만들어두는 것이 중요했습니다.
3. 아직 Hermes Agent를 붙이는 단계는 아닙니다
현재는 Hermes Agent 봇을 실제로 붙여서 완성된 업무 자동화를 구현한 단계는 아닙니다.
지금은 구조를 이해하고, 어떤 방식으로 Wiki를 잡아가야 할지 실험하는 초기 단계입니다.
앞으로 완성도가 올라가면 다음 작업을 추가로 시도해보고 싶습니다.
업무별 Task 지침 고도화
Agent 역할별 문서 분리
Notion 데이터베이스와 Wiki 구조 연결
Hermes Agent가 참조할 수 있는 실행 지침 정리
반복 업무를 Agent에게 위임하는 실험
4. 이번 세션의 의미
이번 OT 스터디는 결과물을 완성했다기보다는, 앞으로의 방향을 잡는 시간이었습니다.
스터디장님들의 가이드를 따라 Hands-on으로 진행하면서, 막연했던 Agent 구축이 조금 더 구체적인 프로젝트로 보이기 시작했습니다.
저에게 이번 시도는 “AI로 뭔가 자동화해보자”에서 한 단계 더 나아가, 내 업무를 Agent가 이해할 수 있는 언어로 다시 정리해보는 출발점이었습니다.
도움 받은 글
Anthropic Claude Code 공식 소개: Claude Code는 코드베이스를 이해하고, 파일을 수정하고, 명령을 실행하며 개발 작업을 도와주는 agentic coding tool로 소개되어 있습니다.
Anthropic Claude 개발 가이드: Claude 기반 애플리케이션 개발을 위한 API 가이드와 모범 사례를 제공합니다.
Notion API 공식 문서: Notion REST API를 통해 워크스페이스의 페이지, 데이터베이스, 사용자, 댓글 등을 읽고 생성·수정할 수 있다는 내용을 확인할 수 있습니다.
마무리
이번 Hermes LLM Wiki 구축 시도는 아직 작은 시작이지만, 업무 Agent 팀을 만들기 위한 중요한 첫걸음이었습니다.
앞으로는 단순히 LLM에게 일을 시키는 것을 넘어, 업무의 구조와 판단 기준을 잘 정리해서 Agent가 실제로 활용할 수 있는 형태로 만드는 것을 계속 실험해보려고 합니다. 🚀




벤쿠버쪼님, 이번 글은 “완성된 에이전트”를 보여주기보다, 업무를 나중에 에이전트에게 맡길 수 있는 형태로 구조화해보신 과정이 잘 드러나서 좋았습니다. 특히 자동화의 결과물보다 먼저 입력값, 판단 기준, 출력물, 실패 대응, 사람 확인 지점을 생각하신 점이 중요한 출발점으로 보였습니다. 또 바이브 코딩의 한계를 “구조가 흐트러지고 기준이 남지 않는다”로 짚으신 부분도 인상적이었습니다. Hermes LLM Wiki나 Notion 연동을 도구 이름으로만 접근한 것이 아니라, 업무 지식과 Task 지침을 계속 참고 가능한 기반으로 만들려는 방향이 분명했습니다. 다음 단계에서는 전체 업무를 한 번에 다 잡으려 하기보다, 실제 업무 하나만 골라서
입력값 → 판단 기준 → 출력물 → 사람이 확인할 지점4칸으로 한 장짜리 지침을 만들어보시면 좋겠습니다. 그 한 장이 생기면 이후 Notion이든 Hermes든 어떤 도구에 연결하더라도 기준점이 훨씬 선명해질 것 같습니다.