00
[사전 준비] 배포 파일 받기
교육 전 · 압축만 풀어 두면 됩니다
배포 파일 내려받기 → 문서(Documents) 폴더에 압축 해제
| Mac | Windows |
|---|---|
| zip을 문서 폴더로 옮기고 더블클릭 | zip을 문서 폴더로 옮기고 우클릭 → 압축 풀기 |
문서 > leader-agent 폴더가 생기면 끝입니다. 두레이 연결 도구가 모두 들어 있어 따로 설치할 것이 없습니다.
숨김 파일 표시: macOS Cmd + Shift + . / Windows 보기 → 표시 → 숨긴 항목
폴더 안 파일 보기
| 파일 | 용도 | 내가 편집? |
|---|---|---|
CLAUDE.md | 팀장 운영 규칙 → 실습 1에서 작성 | 예 |
.env | 두레이 토큰을 적는 곳 → 실습 2에서 작성. 공유 금지 | 예 |
scripts/ | 두레이 MCP 실행 파일 + 런처 + 등록 스크립트 (OS 자동 선택) | 아니오 |
.claude/settings.json | 권한 설정 - .env 읽기 · 메신저 발송 · 일정 등록 금지 | 아니오 |
data/dooray_backup.csv | 두레이 장애 시 백업 데이터 (가상 업무 18건, 기준일 2026-09-14) | 아니오 |
docs/ · output/ | 규칙 예시 카드 / 결과물 저장 위치 | 참고 |
폴더에서 터미널 열기 - 모든 실습의 시작 동작
| Mac | Windows |
|---|---|
Cmd+Space → "터미널" 실행 → cd 입력(뒤에 공백 하나) → Finder에서 leader-agent 폴더를 터미널 창으로 드래그 → Enter |
탐색기에서 leader-agent 폴더 열기 → 빈 곳 우클릭 → 터미널에서 열기 (없으면 주소창 클릭 → cmd 입력 → Enter) |
Claude는 항상 leader-agent 폴더 안에서 실행합니다. 규칙(CLAUDE.md)·금지 설정·백업 데이터·결과물 저장 위치가 모두 이 폴더에 있습니다.
01
[실습 1] 팀장 규칙 CLAUDE.md 작성
Unit 1 · 에이전트 정체성 설계 · 프롬프트 ①·②
미션 - 나를 기억하는 에이전트 만들기. 머릿속 감각을 판정 가능한 문장으로 옮기면, 새 세션에서도 에이전트가 내 규칙대로 시작한다.
1 · 규칙 3개 - 감각을 판정 가능한 문장으로
| 종류 | 머릿속 감각 | 판정 가능한 문장 (예시) |
|---|---|---|
| 보고 형식 | "보고는 짧게" | "결론부터 3줄 이내로 보고한다" |
| 판단 기준 | "늦어지는 일 먼저" | "마감 경과 + 미완료를 최상단에" |
| 금지 사항 | "민감한 건 빼고" | "인사 · 평가 정보는 출력하지 않는다" |
2 · 나의 팀장 운영 규칙 입력 → 프롬프트 ① 자동 생성
떠오르지 않으면
docs/규칙_예시카드_10종.md를 보되, 베끼지 말고 우리 팀 숫자와 단어로 바꾸세요.프롬프트 ① · 작성 - 입력한 규칙이 아래에 바로 들어갑니다. 직접 고쳐도 됩니다
3 · Claude 실행 → 프롬프트 ① 붙여넣기 → 초안 검토 → 수정 지시 1개 이상 → 승인
claude # leader-agent 폴더에서. 첫 실행 시 "이 폴더의 파일을 신뢰합니까" → Yes
권한 승인 팝업이 뜹니다. 에이전트가 '파일을 만든다'는 확인 단계 행동을 하려는 것 - 무엇을 하려는지 읽고 누릅니다. 결재 도장을 내용 안 보고 찍지 않듯이.
4 · 새 세션에서 검증 - 프롬프트 ②
/exit # 나갔다가
claude # 다시 시작 = 기억이 초기화된 상태
보고 형식과 금지 규칙이 적용되는지 확인. 아직 두레이가 연결되지 않아 내용은 비어 있어도, 형식이 내 규칙대로면 성공입니다. 짝과 규칙 1개씩 교환하세요.
도전 과제 - "환경 설정이 빠졌으면 작업을 중단하고 안내하라" 규칙 추가. 에이전트가 틀리면 프롬프트를 고치지 말고 규칙을 고칩니다.
결과 기록 - 입력 후 내려받기
02
[실습 2] .env에 토큰 등록
Unit 2 · 에이전트 확장 · 프롬프트 ③
미션 - 토큰을 채팅창이 아닌 .env에 등록한다. 토큰은 두레이 화면과 .env, 두 곳에만 존재한다. Mac·Windows가 갈리는 곳은 어떤 편집기로 여느냐 하나뿐.
| 단계 | Mac | Windows |
|---|---|---|
| ① 토큰 발급·복사 | 두레이 웹 → 톱니바퀴 → 설정 → API → 개인 인증 토큰 → 생성 → 용도 "Claude 실습" → 복사. 토큰은 한 번만 표시됩니다. | |
| ② .env 열기 | Finder에서 leader-agent → Cmd+Shift+. → .env 우클릭 → 다음으로 열기 → 텍스트 편집기 | 탐색기에서 .env 우클릭 → 연결 프로그램 → 메모장 |
| ③ 입력·저장 | DOORAY_TOKEN= 바로 뒤에 붙여넣기 → Cmd+S | 동일 → Ctrl+S. 파일 이름이 .env.txt로 바뀌지 않았는지 확인 |
| ④ 닫기 | 편집기 닫기. 저장된 모습은 아래 한 줄 (공백·따옴표 없이) | |
DOORAY_TOKEN=여기에붙여넣은토큰
프롬프트 ③ · 등록 확인 - 값은 출력하지 않고 상태만
이어서 ".env 내용을 보여줘"라고 시켜 보세요 - 거부됩니다. 권한 3단(허용/확인/금지) 중 '금지'가 규칙이 아니라 잠금으로 작동하는 장면입니다.
하지 말 것 - ① Claude 채팅창에 토큰 붙여넣기 ② 메신저·메모 앱에 임시 저장 ③ 화면 공유를 켠 채로 발급 화면 열기.
노출됐다고 생각되면 두레이에서 즉시 폐기 → 재발급.
실무에서는 이 폴더를 팀에 나눠줄 때
.env만 빼면 됩니다. 규칙(CLAUDE.md)과 연결 도구는 공유하고 토큰만 각자 - 팀 표준의 시작입니다.03
[실습 3] MCP 연결과 프로젝트 확인
Unit 2 · 에이전트 확장 · 프롬프트 ⑤
미션 - 에이전트에게 '눈'을 달고, 보이는 범위를 확인한다. MCP는 AI 업무 도구의 USB-C - 한 번 꽂으면 어느 폴더에서 Claude를 켜도 두레이가 보인다. 오늘은 조회만.
1 · 두레이 MCP 등록 (한 번만, Mac·Windows 동일) - leader-agent 폴더 터미널에서
node scripts/install-global.js # .env의 토큰으로 두레이 MCP를 내 PC 전체에 등록
claude mcp list # dooray 표시 확인
등록됨: node …/scripts/dooray.js 가 보이면 완료. OS에 맞는 실행 파일 선택, 실행 권한, Mac 보안 경고 해제, 기존 등록 정리까지 스크립트가 처리합니다.2 · Claude 실행 → 연결 확인
claude
/mcp # Claude 안에서 입력 → dooray: connected
프롬프트 ⑤ · 조회 - 수정·발송 금지, 이름과 ID만
권한 결재 - 지금 뜬 도구 사용 팝업은 에이전트가 두레이 '조회' 도구를 쓰겠다고 올린 결재입니다. 발송·일정 등록은 이 폴더 설정에서 이미 금지돼 있습니다.
3 · 3종 점검
| ✓ | 확인 |
|---|---|
| ① | 프로젝트명과 ID가 함께 보이는가 (동명 프로젝트는 ID로 구분) |
| ② | 실습 프로젝트 [리더십캠프] 주간업무 샌드박스가 있는가 |
| ③ | 토큰 문자열이 화면에 출력되지 않았는가 |
장애 시 - 강사가 배포한 프로젝트 ID로 진행. 두레이 자체 장애면 실습 4부터
data/dooray_backup.csv로 완주 가능. 안 될 때는 페이지 맨 아래 [안 될 때].결과 기록 - 입력 후 내려받기
04
[실습 4] 구성원 관리 - 팀 업무 현황과 리스크 진단
Unit 2 · 에이전트 확장 · 프롬프트 ⑥·⑦
미션 - 팀 업무를 표준 스키마로 정리하고, 오늘 확인할 리스크를 찾아낸다. 두레이의 재료는 담당자·마감일·최근 수정일. 원본에 없는 값(진행률)은 만들지 않는다.
프롬프트 ⑥ · 조회 · 정규화
두레이 장애 시 - 프롬프트 앞에 "
data/dooray_backup.csv를 읽어서" 를 붙이고, 이후 프롬프트에 "오늘을 2026-09-14로 가정하고"를 추가.프롬프트 ⑦ · 리스크 진단
검수 - "AI가 잘 요약했는가"가 아니라 "원본으로 돌아갈 수 있는가"
| ✓ | 확인 |
|---|---|
| ① | 두레이 화면의 전체 건수와 표의 건수가 같은가 (샌드박스 18건) |
| ② | 무담당 · 마감일 없음이 '확인 필요'로, 완료 업무가 완료로 표시됐는가 |
| ③ | 업무 ID 2건을 골라 두레이에서 원본을 역추적했는가 |
도전 과제 - "담당자별 미완료 건수와 이번 주 마감 수를 집계하고, 무담당 업무는 따로 모아줘." 이 집계는 평가가 아니라 부하 관리 목적입니다 - CLAUDE.md의 인사·평가 금지 규칙이 출력에도 걸려 있습니다.
결과 기록 - 입력 후 내려받기
5-1
[실습 5-1] 팀원 보고 취합 - 주간회의 브리핑
Unit 3 · 능력 장착과 자율 가동 · 프롬프트 ⑧
미션 - 실습 4의 표를 3분 안에 읽는 주간회의 브리핑으로 바꾼다. 한 번에 "잘 정리해줘" 하지 않고 조회 → 정규화 → 판정 → 보고, 네 단계로 나눈 결과다.
| 품질 기준 | 확인 방법 |
|---|---|
| 3분 안에 읽힌다 | 화면 한 번 스크롤 안에 |
| 사실과 제안이 구분된다 | 제안 앞에 [제안] 같은 표시 |
| 질문에 확인할 사람과 이유가 있다 | "왜 늦었어요?"가 아니라 "무엇이 막혔는지"를 묻는 톤 |
| 수치와 업무 ID를 원본에서 재확인할 수 있다 | ID 1건 클릭해 원문 확인 |
짝 검수 - 옆 사람의 브리핑을 누락 / 오판정 / 근거 없음 / 행동 주체 불명 네 가지로 봐 줍니다.
결과 기록 - 입력 후 내려받기
5-2
[실습 5-2] 주간회의 대시보드
Unit 3 · 능력 장착과 자율 가동 · 프롬프트 ⑨
미션 - 주간회의에서 표 8개를 넘기는 대신, 필터 되는 화면 하나를 띄운다. 파일 하나만 열어도 동작해야 한다.
| 열기 | Mac | Windows |
|---|---|---|
| 터미널에서 | open output/team-dashboard.html | start output\team-dashboard.html |
| 또는 | Finder / 탐색기에서 leader-agent > output > team-dashboard.html 더블클릭 | |
검증 습관 - 원본 건수 = 대시보드 전체 건수(18). 완료 + 미완료 = 전체. 지연 1건은 손으로 재계산해 일치를 확인. 필터를 걸면 KPI·차트·표가 함께 바뀌는가.
결과 기록 - 입력 후 내려받기
5-3
[실습 5-3] Skill 저장과 Routine 예약
Unit 3 · 능력 장착과 자율 가동 · 프롬프트 ⑩
미션 - 실습 4 → 5-2를 매주 반복할 수는 없다. /weekly 명령어 하나로 저장하고, 월요일 아침엔 이미 준비되어 있게 한다. 나의 규칙(Unit 1)과 보안 원칙(Unit 2)이 능력 속으로 이식된다.
| Skill 6요소 | 고정할 내용 |
|---|---|
| 조회 범위 | 어떤 프로젝트, 어떤 기간 |
| 판정 기준 | 지연 · 임박 · 장기 미갱신 · 확인 필요의 정의 |
| 출력 형식 | 브리핑 5개 섹션 순서 + 대시보드 |
| 근거 규칙 | 모든 항목에 업무 ID |
| 보안 | 민감정보 출력 금지 |
| 승인 | 발송 · 등록 전 승인 |
실행 확인
/weekly
Routine 예약 (강사 시연) - 매주 월요일 08:30, 조회·브리핑 초안까지만
claude -p "/weekly 실행하고 결과를 output/에 저장해" # 비대화 모드 → OS 스케줄러에 등록
경계 - 발송 · 일정 등록은 자동화하지 않는다. 08:30 초안 자동 생성 → 09:00 회의는 검토와 결정만.
도전 과제 - 팀장용 / 실장용 출력 깊이 옵션 추가 (팀장: 담당자별 이번 주 마감 · 실장: 프로젝트 간 병목).
결과 기록 - 입력 후 내려받기
6-1
[실습 6-1] 과제 정의와 계획 결재 - Plan Mode
Unit 4 · 통제와 팀 운영 · 프롬프트 ⑪
시나리오 - AI 서비스 신사업 TF를 꾸린다. 예산과 기존 조직 부담을 고려해 3안 중 하나를 다음 주까지 결정해야 한다.
A안 전담 조직 신설 · 8명 전배 | B안 겸직 매트릭스 · 4팀 × 30% | C안 외부 협력 · 내부 3명 + 파트너
A안 전담 조직 신설 · 8명 전배 | B안 겸직 매트릭스 · 4팀 × 30% | C안 외부 협력 · 내부 3명 + 파트너
Plan Mode 켜기 → 프롬프트 ⑪
Shift + Tab # Claude 입력창에서 두 번 → "plan mode" 표시 확인
계획을 읽고 수정 지시를 1개 이상 한 뒤 승인한다. 품의와 결재의 구조 그대로 - 승인 전에는 실행이 없다. 실습 1의 "초안 먼저"가 여기서 "계획 먼저"로 커집니다.
결과 기록 - 입력 후 내려받기
6-2
[실습 6-2] 병렬 분석 - 3안 비교
Unit 4 · 통제와 팀 운영 · 프롬프트 ⑫
미션 - 에이전트를 팀으로 부린다. Sub-agent 3개가 A·B·C안을 동시에 분석하고 웹 검색으로 보강해 비교표 하나로 취합한다. 구조는 조직장의 본업과 같다 - 역할 분담과 취합.
비교표를 읽고 한 단어씩 옮겨 적기 - 에이전트 출력을 베끼는 칸이 아니라 내가 판단한 결과를 적는 칸
| 기준 | A안 전담 | B안 겸직 | C안 외부 | 출처·가정 |
|---|---|---|---|---|
| 비용 | ||||
| 속도 | ||||
| 역량 | ||||
| 리스크 |
셀은 높음 / 중 / 낮음 또는 숫자 하나면 충분합니다. 오른쪽 "출처·가정"은 그 행의 수치·주장에 출처나 가정이 모두 붙어 있을 때만 체크 - 6-3에서 이 표를 보고 선택합니다.
지켜볼 것 - 병렬 실행의 속도, 관점의 폭, 그리고 수치·주장마다 출처 또는 가정이 붙었는가. 출처 없는 숫자는 없는 값과 같습니다.
결과 기록 - 입력 후 내려받기
6-3
[실습 6-3] 권고 그리고 반박
Unit 4 · 통제와 팀 운영 · 프롬프트 ⑬·⑭
미션 - 권고를 받아들이는 것이 아니라, 권고와 반박을 모두 보고 내가 결정하는 것이 에이전트 활용의 완성형.
프롬프트 ⑬ · 권고
프롬프트 ⑭ · 반박
위 비교표 기준 - 내 최종 선택
권고와 반박을 나란히 놓고 최종 선택은 내가 - 선택 이유 1줄을 기록합니다. 손들기로 선택 분포를 확인하고 "권고와 다른 선택을 한 이유"를 들어봅니다.
도전 과제 - 자신의 실제 의사결정 안건으로 6-1 → 6-3을 다시 실행.
결과 기록 - 입력 후 내려받기
END
[마무리] 사람이 최종 서명한다 - 그리고 가져가기
Part 5 · 최종 검증 + 내 PC 전체로 확장
최종 검증 체크리스트 - 서명: 나
| ✓ | 확인 |
|---|---|
| ① | 모든 판단에 근거(업무 ID · 출처 · 가정)가 있는가 |
| ② | 핵심 수치를 수동으로 재확인했는가 |
| ③ | 민감정보가 화면과 산출물에 없는가 |
| ④ | 반대 논거까지 검토하고 결정했는가 |
AI가 분석해도 결정의 책임은 사람에게 있다.
가져가기 · 규칙도 내 PC 전체에 - leader-agent 폴더 터미널에서 (Mac·Windows 동일)
두레이 연결은 실습 3에서 이미 어디서든 됩니다. 다른 폴더에서
claude → "우리 팀 업무 현황을 보고해줘" → 규칙 없이 밋밋한 답(실습 1 데모의 재현). 규칙도 가져갑니다:node scripts/install-global.js --rules # CLAUDE.md → ~/.claude/CLAUDE.md (기존 파일은 백업)
다시 다른 폴더에서 같은 질문 → 결론부터, 업무 ID 붙은 답. 폴더 규칙은 팀 프로젝트용, 개인 규칙은 내 모든 작업용 - 두 층이 같이 읽힙니다.
기억할 것 - ① leader-agent 폴더를 옮기면
node scripts/install-global.js를 다시 실행 ② 발송·일정 등록 금지는 폴더 안에만 걸려 있으니, 밖에서는 승인 팝업을 결재 도장처럼 읽을 것 ③ 교육 종료 시 실습 토큰은 두레이에서 폐기.내일 아침, 무엇부터
| 1 | CLAUDE.md 다듬기 - 오늘 만든 규칙을 내 업무 규칙으로 |
|---|---|
| 2 | 반복 업무 1개 Skill화 - 매주 하는 일부터. 작게 시작해서, 검증하고, 넓힌다 |
| 3 | 다음 회의의 의사결정 안건에 반대 논거를 요청해보기 |
결과 기록 - 입력 후 내려받기
?!
[안 될 때] 위에서부터 순서대로 확인
대부분 1~3번에서 끝납니다 · 해결 안 되면 손 들기
| # | 증상 | 조치 |
|---|---|---|
| 0 | 규칙(CLAUDE.md)이 적용 안 됨 | leader-agent 폴더 안에서 claude를 켰는지. Claude 종료 → 폴더에서 터미널 다시 열기 → claude |
| 1 | install-global.js가 ".env 파일이 없습니다" | 실습 2를 먼저. Windows면 파일이 .env.txt로 저장됐는지 확인(확장명 표시 켜고 .txt 제거) |
| 2 | /mcp에 dooray가 아예 없음 | 등록 전에 Claude를 켜둔 것. Claude 종료 → 폴더에서 node scripts/install-global.js → "등록됨" 확인 → claude |
| 3 | install-global.js가 "등록 실패" | claude --version이 되는지 확인. 안 되면 Claude Code 미설치 → 손 들기 |
| 4 | dooray가 failed | 폴더에서 node scripts/dooray.js 실행 → 메시지가 원인을 알려줌. 아무것도 안 뜨고 멈추면 정상(Ctrl+C) → Claude 완전히 종료 후 다시 |
| 5 | 4번: "DOORAY_TOKEN 값이 비어 있습니다" | .env에 토큰이 저장되지 않음 → 실습 2 ②③ 다시 |
| 6 | 4번: "실행 파일 형식이 아님" / "CPU 종류 불일치" | 배포 파일 손상 → zip을 다시 받아 풀기 |
| 7 | Mac: "개발자를 확인할 수 없음" | 시스템 설정 → 개인정보 보호 및 보안 → 아래쪽 그래도 열기 → 다시 claude |
| 8 | Windows: SmartScreen 파란 창 | 추가 정보 → 실행 |
| 9 | connected인데 프로젝트 조회 실패 | 두레이에서 토큰 폐기 → 재발급 → .env 다시 입력 → Claude 재시작. 그래도 안 되면 강사 배포 프로젝트 ID 사용 |
| 10 | node: command not found | Node.js 미설치 → 손 들기. 그동안 data/dooray_backup.csv로 실습 4 진행 |
| 11 | 두레이 자체 장애 | 전원 data/dooray_backup.csv로 전환 (강사 안내). 실습 4부터는 CSV만으로 완주 가능 |