Claude Code에 끌려다니지 않으려면, Workspace 셋업부터
2026.06.07

📝 한줄 요약
지피타쿠님의 2주차 강의 핵심 요약 : Claude Code에 끌려다니지 않으려면, Workspace 셋업부터 제대로 하라. (Workspace가 바로 Agent). 강의에서는 아키타입(유형별) Workspace 표준들을 제시해주셨는데, 과제는 PRD문서를 읽어 역으로 Workspace 구조와 Claude.md, Skill 들을 자동으로 만들어주는 슬래시 커맨드를 만들어 보았다.
바쁘시면 이것만 읽어도 돼요:
Claude Code로
/open-sesame슬래시 커맨드를 제작 — PRD 파일 하나로 워크스페이스 자동 생성CLAUDE.md를 어떻게 써야 할지 고민하는 시간이 사라졌다 — PRD만 있으면 알아서 채워짐
"슬래시 커맨드는 코드가 아니라 지침서" — 단계별로 써주면 그게 자동화가 된다
Phase 1 : 테스트 PRD 넣었더니 폴더 구조 + CLAUDE.md + 설정 파일이 30초 만에 생성됐다
Phase 2 목표: 도메인별 Skills 자동 추천 + 세션 종료 시 자동 handoff 문서 생성
🎯 이런 분들께 도움돼요
show-me-the-prd로 PRD는 만들어봤는데, 그 다음 단계가 막막한 바이브코더CLAUDE.md가 뭔지는 알겠는데 매번 어떻게 써야 할지 헷갈리는 분
새 프로젝트 시작할 때마다 Workspace세팅을 처음부터 다시 하고 있는 분
😫 문제 상황 (Before)
2주차 강의 과제 "Workspace를 만드는 Agent (=Workspace)를 만들어 보라". 다소 막막했으나 22기 동기분들이 정리하신 후기를 보고 "PRD가 있으면 그 목적에 맞는 Workspace를 자동으로 만들게 해보자"라는 컨셉으로 착수.
🛠️ 사용한 도구
도구: Claude Code
활용한 슬래시 커맨드:
/show-me-the-prd(기획),/open-sesame(직접 제작)모델: Claude Sonnet 4.6
🔧 작업 과정
1단계: prd를 기반으로 그에 적합한 workspace를 만들어줘
"자동화하고 싶다"는 생각은 있었지만 어디서부터 시작해야 할지 몰랐다. 그래서 먼저 /show-me-the-prd를 실행했다.
prd를 기반으로 그에 적합한 workspace를 만들어 주는 프로그램을 만들고 싶어.Claude가 선택지를 하나씩 제시했다. "워크스페이스가 어떤 의미인가요?" "누가 주로 쓰나요?" "어떤 형태로 동작하면 좋을까요?" — 클릭 몇 번으로 방향이 잡혔다.
결정된 것들:
형태: Claude Code 슬래시 커맨드 (서버나 앱 없이, 이미 쓰는 도구 안에서)
사용자: 바이브코더 (비개발자)
헬퍼 방식: Bash 스크립트만 (설치 환경 최소화)
입력 방식: PRD 파일 경로 (
/open-sesame PRD/01_PRD.md)
20분 만에 PRD 4종이 완성됐다. 요구사항 문서, 데이터 모델, Phase 분리 계획, 구현 규칙("절대 하지 마" 목록 포함).
2단계: 슬래시 커맨드 만들기 — "코드가 아니라 지침서"
이 PRD를 읽고 Phase 1을 구현해주세요.
@PRD/01_PRD.md @PRD/02_DATA_MODEL.md @PRD/04_PROJECT_SPEC.md
Phase 1 범위:
- /open-sesame 커맨드 스킬 제작
- PRD 파일 파싱
- 도메인별 폴더 구조 생성
- CLAUDE.md 자동 생성 (12섹션 스키마)
- .claude/ 기본 구조 생성슬래시 커맨드 파일(.claude/commands/open-sesame.md)은 사실 Claude한테 주는 지침서다. "1. PRD 읽어, 2. 이 정보 추출해, 3. 이 폴더 만들어, 4. CLAUDE.md 이 형식으로 써줘" — 이걸 단계별로 써두면 그게 자동화가 된다. 코드를 짜는 게 아니라 지침을 잘 쓰는 게 핵심이었다.
중간에 API 오류로 세션이 끊겼다. 당황했지만 다음 세션에서 "이전 세션에서 하던 거 이어서 작업할게" 한 마디로 Claude가 맥락을 이어받았다. 세션이 끊겨도 멈추지 않아도 된다는 걸 알게 됐다.
3단계: 첫 테스트 — task-flow 워크스페이스 생성
구현이 끝나고 테스트 PRD를 넣어봤다. CLI 태스크 매니저 프로젝트 PRD였다.
/open-sesame 70-tests/sample_dev_prd.md30초 뒤, task-flow/ 폴더가 생겼다. 그 안에:
00-system/부터90-archive/까지 10단위 폴더들60-src/,70-tests/,80-docs/(Python 개발 프로젝트라 dev 도메인 자동 감지)CLAUDE.md— Sample PRD에 있던 목적, 기능 목록, 기술 스택이 12섹션에 자동으로 채워진 상태.claude/settings.local.json기본 권한 설정
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
워크스페이스 세팅 | Claude가 만들어준 workspace 에 내가 끌려다님 | 목적별로 최소한의 하네싱 가능 |
CLAUDE.md 작성 | Claude.md를 작성한 적이 없음 | PRD만 있으면 자동 생성 |
결과물
/open-sesame슬래시 커맨드 (.claude/commands/open-sesame.md)Bash 헬퍼 스크립트 2개 (폴더 생성, 설정 파일 생성)
테스트 완료: dev 도메인 워크스페이스 자동 생성 확인
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
PRD가 먼저:
show-me-the-prd로 PRD를 제대로 만들어두면 Worksplace Setting, Claude.md 작성, 목적에 맞는 기본 skill 추천까지open-sesame이 나머지를 알아서 한다. 기획이 잘 될수록 자동화가 잘 된다.슬래시 커맨드 = 지침서: 코드를 짜는 게 아니라 Claude한테 줄 단계별 지침을 마크다운으로 쓰면 된다. "1. 이걸 읽어, 2. 이 정보 추출해, 3. 이 명령 실행해" — 이게 자동화의 전부다.
이렇게 하면 안 돼요
Phase를 건너뛰지 마세요: MVP부터 완성하고 기능을 추가하는 게 맞다. 처음부터 Phase 2, 3까지 한 번에 구현하려다간 복잡해져서 아무것도 안 된다.
지침이 모호하면 결과도 모호해요: 슬래시 커맨드에 "CLAUDE.md 잘 만들어줘"라고 쓰면 Claude도 모른다. "12섹션, 목적별로 각 섹션 이렇게 채워, PRD 내용 반영해"처럼 구체적으로 써야 한다.
🌍 다른 업무에 적용한다면?
이 접근법 — PRD로 설계하고, 슬래시 커맨드로 Workspace 구성과 Claude.md를 자동화하는 흐름 — 은 반복되는 세팅 작업이 있는 곳이라면 어디든 쓸 수 있다.
🚀 앞으로의 계획
Phase 2: 도메인별 Skills 자동 추천. dev 프로젝트면 code-review, verify, security-review 커맨드를 추천하고, content면 write-post, docs-guide를 안내하는 식으로.
Phase 3: /wrap-up 커맨드 제작. 세션이 끝날 때 오늘 한 일 요약 + 다음 세션 handoff 문서를 자동으로 만들어두는 것. 다음번 Claude가 "지난번에 어디까지 했더라"를 묻지 않아도 되도록.
도움 받은 글 (옵션)
Claude Code를 진짜 Agent처럼 쓰려면, 플러그인보다 Workspace가 먼저였다 (Teddy님 감사합니다.)
(내용 입력)



PRD만들고 -> 해당 PRD 기반으로 workspace 적합하게 만들어주는 스킬 작동
요 프로세스 너무 좋네요! 인사이트 얻어갑니다!