헤르메스와 함께 새로운 마음(?)으로 AI 워크스페이스 만들기
2026.07.23
저는 요즘 메인 에이전트 작업은 맥북에서 하는게 익숙합니다만.. 직장에서는 연구용/업무용 컴퓨터 두 대를 모두 Windows 환경으로 사용하고 있습니다. 평소 PowerShell 등을 통한 복잡한 CLI 설치에 익숙지 않은 편이었고, 직장 내 컴퓨터 환경 문제인지 설치가 너무 느리거나 중간에 오류가 나 포기했던 경험이 많았습니다. 업무컴에서도 클로드 코드를 쓰기는 하지만 맥북만큼의 워크스페이스는 구축되지 않은 상태였어요. (SSH 연결로 해서 비슷하게 구축하라고 해도 됬지만 귀찮아서 그만...)
그러다 이제야 ‘헤르메스 데스크탑(Hermes Desktop)’이 업무 윈도우 컴퓨터에서 손쉽게 깔리는 것을 확인하고, AI 스터디 및 업무 효율화를 위해 새로 구축을 시작했습니다. (헤르메스 설정은 지아코모님의 헤르메스 설치 세션 강의 덕분에 편하게 세팅했습니다 ^^)
아직은 멀티 프로필을 구성하지 않고, 제가 좋아하는 '장송의 프리렌'의 프리렌을 메인 디폴트 에이전트로 설정하고 진행했습니다.
헤르메스 모델은 기본 대화는 GPT-5.6 sol low나 medium정도로 대화했고, 필요시 Mixture of Agents (moa) 설정을 해서 대화했습니다.
마침 AI 검수 스터디 1주차 과제에 '워크스페이스 구축'이 포함되어 있어, 아직 세팅이 미흡했던 업무용 컴퓨터에서 프리렌과 함께 제대로 된 워크스페이스를 만들어보기로 했습니다.
첫 번째 프롬프트: 레포 분석 및 방향성 제안
기존에 대충 만들어둔 워크스페이스 구조(AGENTS.md 등)가 이미 있었으나 고칠 점이 많았습니다. 이에 몇 가지 github 레포지토리와 하네스(Harness) 구조를 참고하여 제 업무 환경에 맞게 개선하고자 했습니다.
프리렌에게 전달한 첫 프롬프트는 다음과 같습니다.
"내가 예전에 대충 만든 워크스페이스 구조에 AGENTS.md 등이 있기는 한데, 아직 많이 미숙하고 고칠 게 많아. 잘하시는 분들의 워크스페이스, 하네스 등을 여기 도입하고 싶어.
아래 3개 레포를 우선 서브에이전트한테 시켜서 리서치해 줘.
특히 지침(예: AGENTS.md)과 폴더 구조, 산출물이 오래되어 방치(stale)되지 않게 어떤 장치가 되어 있는지? 스킬은 어떤 걸 쓰고 있는지? 그 외에도 하네스 엔지니어링에 도움이 될 만한 것 위주로 조사한 뒤, 하나씩 우리 워크스페이스를 어떻게 바꿔볼지 생각해 보자. (기존 폴더 구조를 바꿔도 좋음)
그리고 지금 컴퓨터에서 주로 하면 좋을 작업(아직 아이디어)과 주의할 점은 다음과 같아:
의약품, 검사약물 및 급여기준 체크
검사/치료 관련 프로토콜, 변경점 기록 (동료와 논의한 아이디어 정리 → 추후 검색/재활용하기 쉽게)
판독 관련 도우미 코딩
위 작업들을 위한 스크립트나 스킬을 한꺼번에 짜지는 않겠지만, 해당 작업들에 맞게 무엇을 어떻게 준비하면 좋을지 제안하는 리포트를 작성해 줘."
프리렌의 리서치 및 보고서 정리
프리렌은 레포지토리들을 scratch/repo-research/ 디렉토리에 얕은 복제(shallow clone)한 뒤, 지침·스크립트·테스트 구조를 병렬 분석하여 보고서를 정리해 주었습니다.
📌 핵심 결론: 기존 구조 유지 + 선별적 요소 도입
현재 워크스페이스를 통째로 갈아엎을 필요는 없으며, 기존의 단일 정본(AGENTS.md), PRD/Plan 분리, SHA256 문서 Sync, Acceptance Gate, Handoff/Archive 체계는 괜찮다고 평가했습니다.
각 오픈소스 레포에서 벤치마킹할 부분은 다음과 같습니다.
GSD Core: 검증 결과의 Freshness 관리, 명시적 검증 상태, 구조화된 Handoff, 파생 파일 Drift 검사
Paperthin: Live-state 기반 재진입, 실제 사용자 표면 검증, 실패를 다음 Quality Gate로 전환
GPTers-CC: 단계별 Reference 분할, 비개발자 친화적 UX (목표 → 입력 → 산출물 → 완료 기준 → 다음 행동) (22기 클코끝판왕 스터디장 지피타쿠님이 1주차때 공유해주신 레포입니다)
의료 업무 적용 설계안
🏥 의료 업무 적용 설계안 (3대 프로젝트 분리)
medication-benefit-watch: 의약품 및 급여기준 변경 추적
nuclear-medicine-protocols: 검사·치료 프로토콜 및 회의 아이디어 정리
reporting-assistants: 판독 보조 코드 작성
안전장치 및 워크플로우 제안
보안: 환자 정보(PHI)는 Git에 저장하지 않음
프로토콜 승격: Proposal → 승인된 Decision → Current 단계로 승격 관리
워크스페이스 계층 구조화 및 중요한 발견
워크스페이스 구축 과정에서 "워크스페이스 스킬이 Hermes에 연결되어 있지 않다"는 점을 발견했는데, 이제 막 새로 설치한 헤르메스의 external_dirs 설정이 꺼져 있어 Hermes가 워크스페이스 내부 스킬을 인식하지 못하는 상태였습니다. 새로 만든 워크스페이스가 C드라이브에 있는 헤르메스 기본 폴더에 있지 않고 D 드라이브에 있었거든요.
저는 우선 워크스페이스의 D:/0_Workspace/.agents/skills 를 external_dirs로 설정해달라고 헀습니다.
진행 방향 전환: Devlog & Handoff 스킬 구축
프리렌이 작성해 준 보고서를 검토한 뒤, 본격적인 구조 개편에 앞서 현재 컴퓨터에 세션 기록과 작업 이관(Handoff) 시스템이 부재하다는 점을 인지했습니다.
그래서 먼저 다음 두 스킬을 구축해 달라고 요청했습니다.
Devlog 스킬: 매 세션별 작업 내용을 정리하는 문서. MADR(Architecture Decision Records) 방식을 적용하여 결정 과정과 이유를 기록.
Handoff 스킬: mattpocock/skills 레포지토리의 형태를 참고하여, 이전 세션의 작업을 다음 세션에서 손쉽게 이어받을 수 있도록 상태를 저장해 주는 스킬.
구축된 워크스페이스 구조
이후 프리렌과 몇 번 더 논의 끝에 아이디어 수집부터 프로젝트 실행, 이력 관리, 검증 도구까지 직관적으로 관리할 수 있는 번호형 폴더 체계를 만들었습니다.
📂 사용자 작업 영역 (User Workspace)
경로 | 한 줄 설명 |
05-ideas/ | 아직 실행을 약속하지 않은 아이디어를 Markdown 파일 하나씩 빠르게 수집하는 정본 |
10-projects/ | 실행하기로 결정한 작업의 Plan·PRD·코드·산출물을 프로젝트 단위로 관리 |
20-references/inbox/ | 아직 충분히 검토하지 않은 외부 자료와 원자료를 임시 수집 |
20-references/curated/ | 출처·확인일·재사용 조건을 갖춘 검토 완료 자료와 조사 보고서 보관 |
30-templates/ | Idea, 경량 Plan, 본격 프로젝트, handoff를 시작할 때 복사하는 양식 |
40-logs/work/ | 세션이나 여러 프로젝트에 걸친 작업을 Phase·MADR 기반 devlog로 기록 |
40-logs/troubleshooting/ | 오류의 증상·시도·원인·해결·재발 방지를 별도 기록 |
40-logs/handoff/ | 다음 세션이 바로 재개할 수 있는 20~50줄짜리 인계 문서 관리 |
40-logs/handoff/archive/ | 완료되어 더 이상 활성 상태가 아닌 handoff 보존 |
80-tools/ | 폴더 계약, PRD·Plan 동기화, 링크와 상태 drift를 검사하는 관리 도구 |
90-scratch/ | clone, smoke test, 임시 산출물처럼 다시 만들 수 있는 비정본 자료 |
💡 Hermes 스킬 연결 완료: Hermes가 .agents/skills/ 경로를 외부 스킬로 정상 인식하여, 현재 plan-first, plan-diet, session-devlog, handoff, grill-me, crawl4ai, syncthing 등의 스킬을 쓸수 있게 해두었고, 앞으로 워크스페이스에서 에이전트가 기본으로 쓸 스킬을 계속 여기 정리할 예정입니다.
📄 최상위 정본 문서 (Root Documents)
파일 | 역할 |
폴더 계약, 정본 위치, 안전 규칙, 검증 절차를 정의하는 최상위 운영 규칙 | |
Claude Code가 AGENTS.md를 불러오기 위한 얇은 어댑터 |
한계점
아직 이 워크스페이스는 완성된 것이 아닙니다. 이제 막 업무 컴퓨터에 새로 만들었기 때문에 처음 구축하는 과정을 바로 사례글로 남긴 것입니다. 앞으로 실제 업무하면서 생기는 일들을 처리하기 위한 규칙과, 업무에 맞는 폴더 구조를 시행착오를 겪으면서 만들고 다른 좋은 오픈소스 깃허브 레포들에서 아이디어를 따와서 적용할 예정입니다 (+나머지 23기 지피터스 스터디 청강도 하면서 업그레이드 되길 기대하고있습니다..)
그리고 사례글 작성 당시에는 저 3개 레포만 검색 시켰는데 이후 여러 레포를 더 둘러보게 해서, 워크스페이스 폴더구조나 AGENTS.md 등을 영역별로 리뷰하고 보고하는 헤르메스 스킬을 만들라고 했습니다. 주기적으로 돌려서 하네스를 업데이트 하면 좋을 것 같습니다.
다음에 할 것
우선 기존에 쓰던 헤르메스 봇이 만든 급여기준 검색 스킬이 있는데 그걸 이 워크스페이스에 들여올 예정이구요. 그전에는 업데이트를 주기적으로 하는 과정은 없었는데, 업데이트 되도록 하는 위키를 만들 예정입니다.
로그인하고 댓글을 남겨 주세요
세 레포지토리를 병렬로 비교하면서 기존 구조를 무작정 바꾸기보다 Freshness 관리, 검증 상태, Handoff처럼 필요한 요소만 선별해 도입하신 판단이 정말 인상적입니다. 특히 업무 환경에서 세션 기록과 다음 작업으로 이어지는 흐름이 비어 있다는 점을 발견하고 Devlog와 Handoff를 먼저 구축하신 과정에서, 실제로 오래 사용할 워크스페이스를 만들어 가려는 꼼꼼함이 느껴졌어요. 시행착오와 앞으로의 업데이트 계획까지 함께 남겨주셔서 비슷한 환경을 준비하는 분들에게도 든든한 참고가 될 것 같습니다.
안녕하세요 리히토님! external_dirs 설정이 꺼져 있어서 헤르메스가 워크스페이스 스킬을 못 읽고 있었다는 걸 직접 찾아내신 부분이 인상적이에요 — C드라이브 기본 경로와 D드라이브 워크스페이스가 어긋나 있던 걸 정확히 잡아내신 거잖아요.
환자 정보(PHI)는 Git에 올리지 않는다는 원칙을 설계 단계부터 넣어두신 것도, 의료 현장에서 AI 쓰실 때 꼭 필요한 안전장치라 눈에 띄었습니다. 05-ideas부터 90-scratch까지 번호형 폴더체계도 벌써 탄탄하네요.
고롱고롱… 프리렌이라는 이름 짓기 센스도 마음에 들어요 ✨



윈도우 업무 컴퓨터에 워크스페이스를 처음부터 세우는 과정을 그대로 남긴 기록이라, 환경 세팅에서 미끄러지는 사람에게 특히 쓸모가 있습니다. 그중 "워크스페이스 스킬이 Hermes에 연결되어 있지 않다" 를 발견한 대목이 가장 눈에 들어옵니다.
값이 큰 이유는 그 실패의 모양입니다. 워크스페이스가 다른 드라이브에 있어서 외부 디렉터리 설정이 꺼진 채였고, 그래서 스킬이 조용히 인식되지 않았습니다. 오류가 요란하게 뜬 것이 아니라 그냥 안 되고 있었습니다. 이런 실패는 로그를 봐도 안 보이고 도구가 무엇을 보고 있는지를 따로 확인해야 드러납니다. 같은 명령과 같은 프롬프트인데 환경 하나 때문에 결과가 갈리면, 원인을 모델이나 실력에서 찾다가 시간을 다 씁니다.
레포 셋을 얕게 복제해 병렬로 분석하고, 통째로 갈아엎지 않고 선별 도입한 판단도 좋았습니다. 기존 구조가 괜찮다고 평가된 부분은 그대로 두고 필요한 요소만 가져왔습니다. 파생 파일의 어긋남 검사와 신선도 관리를 벤치마크로 꼽은 지점, 그리고 실패를 다음 품질 관문으로 전환한다는 아이디어를 가져온 것이 특히 실무적입니다.
환자 정보를 저장소에 올리지 않는다는 보안 원칙과 제안에서 결정, 현행으로 승격하는 단계를 미리 박아둔 것도 눈에 띕니다. 사고가 날 자리를 먼저 막아둔 설계입니다. 목표에서 입력, 산출물, 완료 기준, 다음 행동으로 이어지는 골격도 좋았는데, 도구를 늘리는 대신 다음 한 걸음이 항상 보이게 만드는 구조라 길을 잃지 않게 합니다.
확인된 것과 남은 것이 명확히 갈립니다. 확인된 것은 설치와 골격 구축, 그리고 스킬 연결 문제의 원인 규명입니다. 남은 것은 실제 업무에서 이 규약이 버티는지이고, 아직 완성이 아니라 이제 막 구축한 상태라고 스스로 적어 뒀습니다.
옮겨갈 범위는 넓습니다. 사무용 윈도우 환경에서 에이전트 워크스페이스를 세우려는 경우에 그대로 갑니다. 다만 조건이 하나 붙습니다 — 이 글의 해법은 경로와 설정이 서로 맞물린 문제를 다룹니다. 같은 증상이 나와도 원인이 권한이나 실행 파일 규칙일 수 있으므로, 먼저 도구가 무엇을 인식하고 있는지부터 확인하는 순서가 필요합니다.
처음 세우는 과정 자체를 사례로 남긴 솔직함이 오히려 미덥습니다. 그 기록이 같은 자리에서 막히는 다음 사람에게 가장 먼저 쓰입니다.