헤르메스와 함께 새로운 마음(?)으로 AI 워크스페이스 만들기

저는 요즘 메인 에이전트 작업은 맥북에서 하는게 익숙합니다만.. 직장에서는 연구용/업무용 컴퓨터 두 대를 모두 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개 레포를 우선 서브에이전트한테 시켜서 리서치해 줘.

1. https://github.com/open-gsd/gsd-core

2. https://github.com/LilMGenius/paperthin

3. https://github.com/fivetaku/gpters-cc

특히 지침(예: 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대 프로젝트 분리)

1. medication-benefit-watch: 의약품 및 급여기준 변경 추적

2. nuclear-medicine-protocols: 검사·치료 프로토콜 및 회의 아이디어 정리

3. reporting-assistants: 판독 보조 코드 작성

안전장치 및 워크플로우 제안

• 보안: 환자 정보(PHI)는 Git에 저장하지 않음

• 프로토콜 승격: Proposal → 승인된 Decision → Current 단계로 승격 관리

워크스페이스 계층 구조화 및 중요한 발견

워크스페이스 구축 과정에서 "워크스페이스 스킬이 Hermes에 연결되어 있지 않다"는 점을 발견했는데, 이제 막 새로 설치한 헤르메스의 external_dirs 설정이 꺼져 있어 Hermes가 워크스페이스 내부 스킬을 인식하지 못하는 상태였습니다. 새로 만든 워크스페이스가 C드라이브에 있는 헤르메스 기본 폴더에 있지 않고 D 드라이브에 있었거든요.

저는 우선 워크스페이스의 D:/0_Workspace/.agents/skills 를 external_dirs로 설정해달라고 헀습니다. 

진행 방향 전환: Devlog & Handoff 스킬 구축

프리렌이 작성해 준 보고서를 검토한 뒤, 본격적인 구조 개편에 앞서 현재 컴퓨터에 세션 기록과 작업 이관(Handoff) 시스템이 부재하다는 점을 인지했습니다.

그래서 먼저 다음 두 스킬을 구축해 달라고 요청했습니다.

1. Devlog 스킬: 매 세션별 작업 내용을 정리하는 문서. MADR(Architecture Decision Records) 방식을 적용하여 결정 과정과 이유를 기록.

2. Handoff 스킬: mattpocock/skills 레포지토리의 형태를 참고하여, 이전 세션의 작업을 다음 세션에서 손쉽게 이어받을 수 있도록 상태를 저장해 주는 스킬.

구축된 워크스페이스 구조

이후 프리렌과 몇 번 더 논의 끝에 아이디어 수집부터 프로젝트 실행, 이력 관리, 검증 도구까지 직관적으로 관리할 수 있는 번호형 폴더 체계를 만들었습니다.

📂 사용자 작업 영역 (User Workspace)

💡 Hermes 스킬 연결 완료: Hermes가 .agents/skills/ 경로를 외부 스킬로 정상 인식하여, 현재 plan-first, plan-diet, session-devlog, handoff, grill-me, crawl4ai, syncthing 등의 스킬을 쓸수 있게 해두었고, 앞으로 워크스페이스에서 에이전트가 기본으로 쓸 스킬을 계속 여기 정리할 예정입니다.

📄 최상위 정본 문서 (Root Documents)

한계점

아직 이 워크스페이스는 완성된 것이 아닙니다. 이제 막 업무 컴퓨터에 새로 만들었기 때문에 처음 구축하는 과정을 바로 사례글로 남긴 것입니다. 앞으로 실제 업무하면서 생기는 일들을 처리하기 위한 규칙과, 업무에 맞는 폴더 구조를 시행착오를 겪으면서 만들고 다른 좋은 오픈소스 깃허브 레포들에서 아이디어를 따와서 적용할 예정입니다 (+나머지 23기 지피터스 스터디 청강도 하면서 업그레이드 되길 기대하고있습니다..)

그리고 사례글 작성 당시에는 저 3개 레포만 검색 시켰는데 이후 여러 레포를 더 둘러보게 해서, 워크스페이스 폴더구조나 AGENTS.md 등을 영역별로 리뷰하고 보고하는 헤르메스 스킬을 만들라고 했습니다. 주기적으로 돌려서 하네스를 업데이트 하면 좋을 것 같습니다.

다음에 할 것

• 우선 기존에 쓰던 헤르메스 봇이 만든 급여기준 검색 스킬이 있는데 그걸 이 워크스페이스에 들여올 예정이구요. 그전에는 업데이트를 주기적으로 하는 과정은 없었는데, 업데이트 되도록 하는 위키를 만들 예정입니다.