뒤죽박죽 뒤섞여있던 수많은 폴더와 파일들, 워크스페이스 개념 공부로 시작해서 깨끗하게 정리했어요
2026.06.04
워크스페이스가 뭐예요...?
스터디에서 워크스페이스에 대한 개념을 접하고, 선생님이 나눠주신 플러그인을 기준으로 워크스페이스 공부를 시작했어요. 처음에는 워크스페이스가 "파일 두는 곳, 파일 정리"정도로 이해했는데, 자세히 들여다보니 "AI가 내 의도대로 일하게 만드는 장치"로 전환이 가능하더라고요!
당연히 Claude Code에게 정독을 시키는 걸로 시작했고요! 단순 점검으로 시작한 일이 → AI 운영체제 전체 구조화 → 비판 검토 22건 → 코드 백업까지 갔습니다. 지난 4일간 단순 정리가 시스템 재설계가 된 과정의 기록입니다.
사용한 도구와 모델
도구: Claude Code
모델: Claude Opus
워크스페이스 개념의 적용과 발견
## 🎯 이런 분들께 도움돼요
- AI 에이전트를 여러 개 굴리는데 체계 없이 그때그때 쓰고 있는 분
- '워크스페이스'를 그냥 폴더 잘 나누는 것 정도로 알고 있는 분
##첫번째로 알게된 사실. 워크스페이스 = 하네스이고 7개의 계층이 합쳐져서 1마리의 에이전트가 된다는 사실. 그리고 하네스 강도에 따라 단순 커맨드 / 여러 에이전트 협업 / 위험을 자동으로 막아주는 훅 / 워크스페이스를 만들어주는 워크스페이스까지 레벨이 나뉜다는 사실!
내건 지금 몇단계지? 라는 질문이 생겼고 실제 환경을 들여다봤습니다.
##표준의 렌즈로 보니 세 가지 구멍이 보였어요.
① 내 '워크스페이스'는 사실 워크스페이스가 아니었다
~/test라는 폴더에 회사 코드, 스터디 실습, 잡동사니가 다 섞여 있었어요. 7층은커녕 '폴더'조차 아니고 그냥 쓰레기통이었죠. 이름은 'test'(실습)인데 실제론 본진.
② 봇이 일을 하는데, 그 일이 어디에도 '안 보였다'
표준은 "워크스페이스 1개 = AI 1명"이라는데, 제 봇들은 각자 일을 하지만 결과가 폴더가 아니라 노션·슬랙·메일에 흩어져 있었어요. 봇 폴더를 열면 기계 부속(sessions·sqlite)만 잔뜩. "메일봇이 오늘 뭐 했지?"를 폴더로는 알 수가 없었어요.
③ 표준이 내 상황을 다 못 담았다
결정적으로, 이 표준은 "AI 한 명을 정돈하는 법"이었어요. 그런데 저는 AI 4명이 서로 일을 넘기는 운영을 하고 있었죠. 라우팅, 데이터 공유, 관측… 이런 건 표준에 없었어요.
> 여기서 큰 깨달음: "좋은 방법론도 내 상황의 한 층(layer)일 뿐이다."
> 표준을 그대로 베끼면 안 되고, 내 규모에 맞게 위로 확장해야 했어요.
표준의 재설계와 적용
## 🛠️ — 내 것으로 적용: 표준을 '내 규모'로 다시 짰다
표준의 개념(워크스페이스=통제환경, 강도 레벨)을 빌리되, 제 멀티에이전트, 회사 운영 방식에 맞게 키웠어요.
### 적용 1 — "워크스페이스에도 종류가 있다"를 2티어로
표준은 워크스페이스를 한 종류로 봤지만, 제 일은 두 종류였어요. 상시 돌아가는 회사 운영과, 끝이 있는 단발 프로젝트(예: 신규 영입 검토, 개인 이사 인테리어)
나
┌─────┴─────┐
상시 OS(회사) 프로젝트 팟(단발)
· 에이전트 상시 · 세션만, 에이전트 없음
· 데이터 공유 · 격리, 끝나면 삭제
└── 단방향 막 ──┘
```
### 적용 2 — 뒤죽박죽 폴더를 '역할 트랙'으로
표준의 "역할 기반 폴더 분리"를 빌려, 본진 ~/test를 성격별로 갈랐어요.
| ~/work | 회사 |
| ~/test | 스터디 실습 (이제 이름값을 함) |
| ~/pods | 단발 프로젝트 |
| ~/prd-kit | 공통 템플릿 |
> 단, 돌아가는 서비스(launchd 경로 의존)는 함부로 안 옮겼어요. "지금 옮기면 깨진다"를 AI한테 먼저 확인시킨 게 사고를 막았습니다.
### 적용 3 — 표준이 못 본 'L2 가독성'을 카드로
"그 AI가 한 일을 어떻게 추적하나"에 대한 문제는, 봇마다 1장짜리 '업무 카드'를 만들었어요. 핵심은 "결과가 어디 남는지":
예)
- 메일봇 → 노션 캠페인 업무 DB
- 비서봇 → 슬랙 (라우터라 자기 DB가 적음)
- 리서치봇 → 노션 리서치 → 비서봇에 납품
- 개발봇 → 파일 우편함
Notion MCP로 메일봇 카드의 DB를 실제로 열어 살아있는 걸 확인까지 하면서, 실제 업무에 마지막단까지 적용될 수 있도록 연결해 나갔습니다
결과와 향후 계획
## ⚡ 충격 — 만든 걸 '의심'했더니 AI가 했던 거짓말이 나왔다
내 식으로 다 짠 다음, 그냥 안 믿었어요. /kkirikkiri로 비판 검증팀을 띄워 "어디서 깨지나" 공격시켰죠. 22건이 나왔는데, 가장 충격적인 건 이거였어요.
> ⚡ AI는 "카드 4장 완성"이라 보고했는데, 실제론 3장이 저장 안 돼 있었다.
병렬 저장이 충돌했는데 AI는 "완성"이라 했고 문서엔 "✅"가 찍혀 있었죠. 검증팀을 안 띄웠으면 없는 파일 위에 다음 작업을 쌓을 뻔.
워크스페이스 개념의 확장
##다른일에 적용한다면
워크스페이스 개념이 잡히자, 머릿속에서 추상적으로 떠돌기만 했던 추가 업무들도 쉽게 체계화가 되더라고요, 워크스페이스를 기반으로 신규 업무를 쉽게 추가, 진행시키고, 워크스페이스간 교차 작업을 시키는 과정에 속도가 나기 시작했어요. 머릿속에 새로운 아이디어가 떠오르면 바로 구조화된 워크스페이스위에서 체계적으로 업무 단계를 진행시킬 수 있어진 것이 가장 큰 소득입니다!
바로 쓰는 프롬프트
## 📋 바로 쓰는 프롬프트 5개
1. "이 방법론/표준 문서를 정독하고, 핵심 '개념'이 뭔지부터 뽑아줘. 폴더 규칙 같은 표면 말고, 그 밑에 깔린 사고방식."
2. "이 개념의 렌즈로 내 실제 환경(폴더/에이전트)을 다시 봐줘. 이 표준이 '내 상황의 몇 층까지' 커버하고, 뭘 더 키워야 하는지."
3. "이 에이전트가 한 일이 어디(노션/슬랙/파일)에 남는지, 내가 이어받으려면 어딜 봐야 하는지 1장 카드로 정리해줘."
4. "/kkirikkiri 비판 검토팀으로 지금까지 만든 구조를 공격적으로 스트레스 테스트해줘. '어디서 깨지나'를 찾아."
5. "내 폴더를 역할별로, 성격별로 분류해줘. 단, 돌아가는 서비스나 경로 의존이 있는 건 옮기지 말고 깨질 게 있는지 먼저 알려줘."


![[Claude Code] 한 줄 명령어로 FDA 가이드라인 수집부터 번역까지 - 규제과학 연구원의 AI 자동화기 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F4664d896962b3c2465bee374.jpg&w=3840&q=75)
