메뉴
HN
Hacker News • 45일 전

클로드 코드로 제품 업무 환경 구축하는 법

IMP
8/10
핵심 요약

일반적인 AI 채팅 인터페이스는 대화 내용이 휘발되어 매번 동일한 맥락을 설명해야 하는 비효율이 발생합니다. 이 글은 터미널 기반의 Claude Code를 활용하여 프로젝트 맥락과 반복되는 업무, 그리고 AI에 대한 피드백을 파일로 체계적으로 관리하는 워크스페이스 구축법을 제안합니다. 이를 통해 매번 설명하는 시간을 없애고 AI의 작업 품질을 영구적으로 개선할 수 있습니다.

번역된 본문

제품 업무를 위해 클로드 코드를 조직하는 방법. 시작 워크스페이스를 다운로드하세요. 설정 스킬을 실행하세요. 파일이 얼마나 자주 변경되는지에 따라 정리하세요. 반복되는 작업을 스킬로 만드세요. 모든 수정 사항은 한 번만 파일에 기록하세요.

Adam Faik, 2026년 8월 10일

내 제품 업무를 위한 클로드 코드 워크스페이스에는 코드가 거의 없는 폴더 하나뿐입니다. 이 폴더는 회사에 대한 모든 정보, 즉 제품, 사용자, 경쟁사, 내 선호하는 작업 방식을 담은 컨텍스트 폴더를 보유하고 있습니다. 프로젝트마다 전용 폴더가 있으며, 작업(task)과 결과물(deliverable)은 분리되어 있습니다. 또한 각각 하나의 반복적인 작업을 수행하는 스킬 세트가 있습니다. 상태 업데이트, PRD 검토, 인터뷰 요약 등이 여기에 해당합니다. 피드백을 한 번 주면, 그 이유와 함께 파일에 기록되어 두 번 다시 같은 피드백을 주지 않아도 됩니다.

내가 이 시스템을 설계한 것이 아닙니다. 처음에는 주로 실수를 하면서 이 방식에 도달했습니다. 실수를 겪으면서 이 기사 전체를 관통하는 교훈을 얻었습니다. 기본적인 부분을 넘어서면, 클로드 코드에서의 결과물은 프롬프트를 얼마나 잘 작성하는가에 따라 결정되는 것이 아니라, 파일을 얼마나 잘 정리하는가에 따라 결정됩니다. 좋은 프롬프트는 단 한 번의 세션을 개선하지만, 좋은 파일은 그 이후의 모든 세션을 개선합니다. 당신이 이미 읽었던 프롬프트 튜닝 조언은 파일 정리가 중요해지는 시점에서 더 이상 도움이 되지 않습니다.

그래서 나는 내 시스템을 설명하는 대신 패키지로 만들었습니다. 시작 워크스페이스는 GitHub에 공개되어 있습니다. 폴더, 컨텍스트 템플릿, 그리고 하나의 설정 인터뷰를 통해 개인화되는 5가지 PM 스킬이 포함되어 있습니다. 이 과정을 따르기 위해 기술적인 지식이 필요하지 않습니다. 도구 설치를 포함한 모든 단계가 명시되어 있습니다. 비록 내 예시는 제품 업무에 관한 것이지만, 동일한 구조는 컨텍스트가 많이 필요한 모든 작업에 적합합니다. 예를 들어 디자인 리더의 연구 라이브러리, 데이터 팀의 지표 정의, 창업자의 모든 것을 담은 폴더 등이 있습니다.

진행 방식은 다음과 같습니다.

전환. 채팅 모드와 Cowork가 당신에게 줄 수 없는 것과 제품 관리자에게 터미널이 가치 있는 이유를 보여드리겠습니다. 시작 워크스페이스. 이것을 다운로드하고, 하나의 설정 스킬을 실행한 뒤, 실제 작업을 하나 맡겨보세요. 화면에 표시되는 6단계로 구성되어 있습니다. 관행. 시스템이 누적 효과를 낼 수 있게 만드는 6가지 행동으로, 각각 정확히 무엇을 해야 하고 어떤 결과를 얻는지를 설명합니다. 리듬. 첫 번째 짧은 프롬프트부터 2분짜리 파일 정리 습관까지, 이 시스템 내에서 일어나는 평범한 근무일의 모습을 보여줍니다.

보상은 명확합니다. 한 번의 착석으로 모든 것을 실행할 수 있습니다. 도구를 설치하고, 워크스페이스를 다운로드하며, 설정 인터뷰에 답하고, 첫 번째 실제 작업을 넘겨주면 됩니다. 더 이상 매 세션마다 회사에 대해 재설명하지 않아도 되며, 당신이 하는 모든 수정 사항은 영구적으로 저장됩니다. 모든 단계는 아래에 설명되어 있습니다. 이제 파일 캐비닛을 열 시간입니다.

채팅 모드가 줄 수 없는 것

당신은 오늘 아마도 클로드의 채팅, 즉 브라우저 탭이나 데스크톱 앱, 혹은 에이전트 작업을 위한 Cowork를 통해 제품 업무를 수행할 것입니다. 이 방식은 작동하며, 그것이 바로 함정입니다. 모든 대화는 제로에서 시작합니다. 지난번에 업로드했던 전략 문서는 사라지고, 당신이 인내심을 갖고 설명했던 맥락은 다시는 찾을 수 없는 스레드 속에 갇히며, 마음에 들었던 결과물은 파일로 저장되는 대신 스크롤해야만 하는 메시지 속에 갇힙니다.

채팅은 생각하기에는 좋은 장소지만, 축적하기에는 끔찍한 장소입니다. 가끔 묻는 질문이라면 괜찮습니다. 하지만 매일 하는 제품 업무를 위해서라면, 매일 아침 동일한 설정 비용을 지불해야 함을 뜻합니다.

클로드 코드는 동일한 클로드 모델이지만 거주지가 다릅니다. 클로드가 읽고, 탐색하고, 쓸 수 있는 당신 컴퓨터의 폴더입니다. 맥락은 지속되는 파일 속에 존재합니다. 반복되는 작업은 명령 시 실행되는 스킬에 존재합니다. 결과물은 스크롤하기 위해 찾아야 하는 메시지가 아니라, 당신이 보관하는 문서로 도착합니다. 내 일상적인 사용 경험상, 채팅이나 Cowork에서 하던 모든 작업이 여기서는 더 잘 작동했습니다. 두 번 다시 설명할 필요가 없기 때문입니다. 이것은 법칙이 아니라 내 작업에서의 관찰 결과이지만, 수개월 동안 유지되어 왔습니다.

실제로 내 업무를 바꾼 부분은 그 아래에 있는 터미널입니다. 클로드 코드는 GitHub와 연결 없이 기본적으로 소통합니다. 회사 저장소를 가져와 Repository에 대한 질문에 답할 수 있고, 당신의 작업을 푸시할 수도 있습니다. 제품 뒤에 있는 리포지토리를 가져와 기능 플래그(feature flag)가 실제로 무엇을 하는지 설명해 달라고 요청하세요. 당신의 워크스페이스를 개인 저장소에 푸시하면 팀원이 이를 복제(Clone)하여 작업 환경과 맥락을 그대로 물려받을 수 있습니다.

원문 보기
원문 보기 (영어)
How to organize Claude Code for product work Download the starter workspace. Run the setup skill. Sort files by how fast they change. Turn repeated work into skills. File every correction once. Adam Faik Aug 10, 2026 3 Share My Claude Code workspace for my product job is a folder with almost no code in it. It holds a context folder with everything about the company: the product, the users, the competitors, how I like to work. One folder per project, with the tasks separated from the deliverables. A set of skills that each do one recurring piece of work: the status update, the PRD review, the interview synthesis. When I give feedback once, it lands in a file with a note on why, and I never give that feedback again. I didn’t design this system. I arrived at it, mostly by getting it wrong first. Getting it wrong taught me the lesson that runs this whole article. Past the basics, your results in Claude Code stop depending on how well you prompt and start depending on how well you file. A good prompt improves one session; a good file improves every session after it. The prompt-tuning advice you’ve already read stops helping at exactly the point where the filing starts to matter. So instead of describing my system, I packaged it. The starter workspace is public on GitHub: the folders, the context templates, and five PM skills, personalized by one setup interview. You don’t need to be technical to follow along; every step is spelled out, including installing the tools. And while my example is a product job, the same architecture fits any context-heavy work: a design lead’s research library, a data team’s metric definitions, a founder’s everything-folder. Here’s the route. The switch. I’ll show you what chat mode and Cowork can’t give you, and why the terminal is worth it for a product manager. The starter workspace. Download it, run one setup skill, and give it a real task: six steps, each shown on screen. The practices. Six moves that make the system compound, each one naming the exact thing to do and what you get back. The rhythm. Here’s what a normal workday looks like inside the system, from the first short prompt to the two-minute filing habit. The payoff is concrete. One sitting gets you running: install the tools, download the workspace, answer the setup interview, hand over a first real task. You stop re-explaining your company every session, and every correction you make becomes permanent. Every step is below. Time to open the filing cabinet. What chat mode can’t give you You probably run your product work through Claude’s chat today: a browser tab or the desktop app, maybe Cowork for the agentic tasks. It works, and that’s exactly the trap. Every conversation starts from zero. The strategy doc you uploaded last time is gone, the context you patiently explained lives in a thread you’ll never find again, and the output you liked is trapped inside a conversation instead of sitting in a file. Chat is a great place to think and a terrible place to accumulate. For occasional questions that’s fine. For daily product work, it means paying the same setup cost every single morning. Claude Code is the same Claude with a different home: a folder on your machine that it can read, navigate, and write to. Context lives in files that persist. Recurring work lives in skills that run on command. Outputs land as documents you keep, not messages you scroll for. In my daily use, everything I used to do in chat or Cowork runs better here, because nothing is ever explained twice. That’s an observation from my own work, not a law, but it’s held for months. The part that actually changed my job is the terminal underneath. Claude Code speaks to GitHub natively, no connector needed: it can pull a company repository and answer questions about it, and it can push your own work. Ask it to fetch the repo behind your product and explain what a feature flag actually does. Push your workspace to a private repository and a teammate can clone it and inherit your head start. For a product manager, that’s a direct line into the codebase and a way to share your whole system, both of which chat simply doesn’t have. What nobody hands you is the filing system that makes all this compound. Anthropic’s best-practices guide is written, in its own words, “for engineers using Claude Code across various codebases, languages, and environments,” and engineers get their structure free: the codebase is already organized context. The PM guides that exist, Sachin Rekhi’s being the best known, rightly tell you to “store all of your product data and documentation in local markdown files,” then move on. Organized how? Try it without an answer and you get what I had: forty loose files and a stale setup. The starter workspace is that answer, prebuilt. Let’s set it up. Start with the starter workspace The starter workspace is the structure I run my own product work on, cleaned into a template: the folders, the context files with guided placeholders, an example project, and five skills already installed. The whole thing is free and public: claude-code-pm-starter . Six steps take you from nothing to a first real task, and none of them assume a technical background. One prerequisites note before you start. You need a paid Claude plan for Claude Code. Everything else, including the two tools you’ll install, is free and covered in the steps. Step 1: Install VS Code Claude Code runs in a terminal, and a terminal alone is a bad home for a product manager: you can’t see your files. The fix is an IDE. An IDE is just an editor that shows your folder as a panel of files while you work; developers live in one all day, and you’ll borrow it for the file panel alone. Download VS Code , the free standard, and install it like any app. You won’t write code in it. You’ll watch your workspace organize itself in the left panel, which is exactly the visibility chat mode never gave you. Step 2: Download the workspace Open the repository page , click the green Code button, and choose Download ZIP . No git, no account needed. Unzip it and move the folder wherever you keep your work. This folder is about to become the place your product work lives , so pick somewhere you’ll find it again, like a work folder in your home directory. Step 3: Open it in VS Code, terminal on the right Open VS Code, choose File > Open Folder , and pick the unzipped folder. The left panel now shows the whole structure: context/ , projects/ , operations/ , the skills. Then open the terminal inside VS Code with Terminal > New Terminal , and here’s the small trick that changes how the whole thing feels: right-click the terminal panel’s header and choose Move Panel Right . Files on the left, agent on the right: it stops feeling like a command line and starts feeling like a colleague sitting next to your documents. If you don’t have Claude Code yet, install it now from the official guide ; it’s one command pasted into that terminal. Then type claude and press Enter. Claude Code starts inside the folder, reads the map file, and knows where everything lives from your first message. Step 4: Say hello, then learn four commands One distinction saves beginners a lot of confusion. The terminal wants exact commands; Claude wants normal language. Before you typed claude , you were talking to the terminal, where spelling and syntax matter. Now that Claude Code is running, you’re talking to Claude, exactly like in the chat app. So do the natural first thing: type hello and ask it what it can see in this folder. It will answer like a colleague who just read your files. A few slash commands are worth knowing on day one, typed directly into Claude Code: /model - shows which Claude model you’re running and lets you switch. /effort - sets how much thinking Claude puts into each answer; higher effort for hard work, lower for quick drafts. /mcp - lists your MCPs, the live connections into tools like Jira, Slack, or Confluence, and lets you manage them. /plugins - opens the pl