r/ClaudeCode•4개월 전•8•5
Claude Code 활용을 위한 오픈소스 플레이북 — 28개 챕터, MIT 라이선스, 엔지니어 및 비엔지니어용
Open-source playbook for working with Claude Code — 28 chapters, MIT, written for engineers and non-engineers
핵심 요약
Claude Code를 활용한 에이전트 방식의 업무 가이드를 담은 28개 챕터의 오픈소스 플레이북이 공개되었습니다.
- 에이전트 업무 모델 — '사용자-오케스트레이터-모델-커넥터' 구조로 올바른 멘탈 모델 제시.
- 실전 워크플로우 — 개발부터 비즈니스 업무까지 Claude Code 활용 사례 28개 챕터 수록.
- 병렬 작업 트리 — 여러 작업 공간 운영 시 필요한 설정과 효율적인 관리 팁 공유.
- 도구 중립적 가이드 — Claude Code 외에도 Cursor, Gemini CLI 등 다양한 도구 활용법 병기.
저자 공개: 제가 직접 썼습니다. 무료이고, MIT 라이선스이며, 유료 등급이나 가입, 이메일 수집도 없습니다. 소스: https://github.com/the-good-pixel/learn-agentic-working
지난 1년 동안 기능 개발, 레포 간 버그 추적, CI 모니터링은 물론 Stripe 결제 정산, 회의록 기반 PRD 작성, 주간 Google Ads 검토, Playwright + Remotion 데모 비디오 파이프라인 등 거의 모든 종류의 업무에 Claude Code를 매일 사용했습니다. 무엇이 효과적이었고 무엇이 아니었는지 기록했습니다.
사이트: https://the-good-pixel.github.io/learn-agentic-working/
특히 여기서 관련이 있을 만한 내용들:
- 이 책이 기반으로 하는 아키텍처 모델: 사용자 → 오케스트레이터 → 모델 → 커넥터 → 실제 앱. 오케스트레이터(Claude Code)는 실제로 명령을 입력하는 곳이며, 모델에 자문을 구하고 도구 호출을 보냅니다. 대부분의 초보자 자료는 모델을 입구로 취급하는데, 이는 잘못된 멘탈 모델을 심어줍니다.
- 스킬 관련 챕터 (스킬이 무엇인지, 언제 작성해야 하는지, 수동 작성이 아닌 대화를 통해 작성하는 방법).
- 병렬 작업 트리(worktrees) / 서브 에이전트 관련 챕터 및 설정 비용을 들일 가치가 있는 경우.
- ship-pr 스타일 워크플로우 관련 챕터 — 푸시 → CI → AI 리뷰 코멘트 반복 → 머지 가능 상태.
- 도구 중립적: 모든 챕터에서 Claude Code와 함께 Codex / OpenCode / Cursor / Gemini CLI 대안을 언급합니다.
가장 궁금한 점:
- "사용자 → 오케스트레이터 → 모델 → 커넥터" 멘탈 모델이 공감이 가나요, 아니면 놓친 부분이 있나요?
- 한 머신에서 병렬 Claude Code 작업 트리를 실행하는 분들 — 첫날 누군가 말해줬으면 좋았을 내용이 있나요? (챕터 16에서 이 내용을 다루는데 부족한 점을 알고 싶습니다.)
별점보다 솔직한 비평이 더 좋습니다.
