이 장에서 배우는 것 작업 폴더가 무엇이고 어떻게 나누는지. 이 선택이 나중에 일하는 방식을 좌우합니다.
경로가 무엇인지 모르겠다면 파일 · 폴더 · 경로를 먼저 보세요.
경로만 등록하면 됩니다. 없는 경로면 자동으로 만들어 줍니다.
등록하면 폴더 하나가 왼쪽 끝 작업 폴더 목록의 한 줄이 됩니다. 폴더를 고르면 사이드바와 작업대가 그 폴더의 것으로 바뀝니다.
여기가 중요합니다. 작업 폴더는 에이전트의 활동 범위입니다.
graph TD
W["작업 폴더<br/>/projects/shop-api"] --> A["에이전트가 볼 수 있는 것"]
A --> F1["이 폴더 안의 파일"]
A --> F2["하위 폴더"]
X["폴더 밖"] -.->|"기본적으로 접근 안 함"| A그래서 폴더를 어떻게 잡느냐가 안전 장치이기도 합니다.
| 등록한 폴더 | 결과 |
|---|---|
/Users/me (홈 전체) | 위험. 개인 파일·설정까지 범위 안 |
/Users/me/projects | 넓음. 여러 프로젝트가 섞임 |
/Users/me/projects/shop-api | 적절 |
홈 폴더나 루트를 등록하지 마세요. 필요한 만큼만 좁게 잡는 게 최소 권한 원칙입니다.
등록한 폴더가 왼쪽 끝 목록에 쌓입니다. 줄마다 업무 수와 바뀐 파일 수가 함께 표시됩니다.
가장 자연스럽습니다. 저장소 하나가 폴더 하나입니다.
나눠두면 병렬로 일을 시킬 수 있습니다. 프론트엔드 작업과 API 작업이 서로 안 기다립니다 — 마이크로 스프린트의 독립성이 여기서도 같습니다.
성격이 다르면 지시하는 방식도 다릅니다. 섞이면 매번 맥락을 다시 설명해야 합니다.
운영 배포 스크립트가 있는 폴더와 실험용 폴더는 나누는 게 좋습니다. 자율성 수준을 다르게 줄 수 있기 때문입니다 — 다음 장의 주제입니다.
폴더마다 기본 설정을 둘 수 있습니다.
| 설정 | 무엇 |
|---|---|
| 이름 | 목록에 표시될 이름 (경로와 달라도 됨) |
| 기본 자율성 | 이 폴더의 기본 동작 수준 |
| 설명 | 이 폴더가 무엇인지 (에이전트가 참고) |
설명을 적어두면 매번 설명하지 않아도 됩니다.
이건 좋은 지시의 맥락 요소를 폴더 단위로 미리 적어두는 것입니다.
/Users/me/projects 하나로 등록하면 편할 것 같지만:
매 업무마다 "이 프로젝트는 Node.js이고..."를 다시 적게 됩니다. 한 번 적어두면 됩니다.
쓰지 않는 폴더는 목록에서 지우세요. 줄이 늘어나면 정작 중요한 게 안 보입니다.
1. 작업 폴더를 좁게 잡아야 하는 이유는?
작업 폴더가 곧 에이전트의 활동 범위이기 때문입니다. 홈 폴더를 등록하면 개인 파일과 설정까지 범위에 들어갑니다. 필요한 만큼만 좁게 잡는 것이 최소 권한 원칙입니다.
2. 프로젝트를 여러 폴더로 나누면 무엇이 좋습니까?
병렬로 일을 시킬 수 있습니다. 프론트엔드 작업과 API 작업이 서로 기다리지 않습니다.
3. 폴더 설명을 적어두면 무엇이 달라집니까?
매 업무마다 맥락을 다시 설명하지 않아도 됩니다. 좋은 지시의 맥락 요소를 폴더 단위로 미리 적어두는 셈입니다.
이제 첫 업무를 맡겨봅니다 → 첫 업무 맡기기
/Users/me/projects/shop-frontend/Users/me/projects/shop-api/Users/me/documents/월간보고✓ shop-frontend / shop-api / shop-admin (각각 등록)✗ shop (상위 폴더 하나로)코드 작업 → /projects/shop-api문서 작업 → /documents/기획서자료 변환 → /work/데이터정리설명 예: "쇼핑몰 백엔드 API. Node.js + PostgreSQL. 결제 관련 코드(/payments)는 수정 금지."