옵시디언 연동 · 한국어 생산성 · 모두의AI 하네스 사고방식 · Google Workspace CLI
총 20개 스킬 + Stop Hook + settings.json 한 번에 세팅
cp -r skills/* ~/.claude/skills/
cp settings.json ~/.claude/settings.json
cp stop-hook-git-check.sh ~/.claude/stop-hook-git-check.sh
chmod +x ~/.claude/stop-hook-git-check.sh옵시디언 연동 시 .bashrc / .zshrc 에 추가:
export OBSIDIAN_VAULT="$HOME/Documents/Obsidian/MyVault"Claude Code를 단순 채팅이 아니라 에이전트 플랫폼으로 쓰는 방법을 안내합니다.
복잡한 작업을 받으면 → 어떤 에이전트들이 필요한지 → 어떤 순서로 실행할지 → 어떤 부분을 병렬로 돌릴지를 설계해줍니다.
스킬로 추출할 수 있는 반복 패턴도 찾아주고, 훅 자동화 포인트도 제안합니다.
언제 쓰나 "이 작업 어떻게 자동화할까?", "에이전트 설계해줘", 복잡한 멀티스텝 업무 시작 전
하루를 구조적으로 시작하고 마무리합니다.
아침 모드: 오늘 반드시 끝낼 일 3가지(MIT), 방해 요소, 오늘의 의도를 물어보고 일일 노트를 만들어줍니다.
저녁 모드: 완료/미완료 항목을 돌아보고 배운 것, 내일로 넘길 일을 정리합니다.
옵시디언 vault 경로가 설정되어 있으면 자동으로 Daily/YYYY-MM-DD.md로 저장합니다.
언제 쓰나 아침에 일 시작할 때, 저녁에 하루 마무리할 때
데이비드 앨런의 GTD(Getting Things Done) 방식으로 머릿속에 있는 모든 것을 꺼내 정리합니다.
캡처 → 명확화 → 정리 순서로 진행하며, 각 항목을 다음 행동(Next Action) / 프로젝트 / 위임 / 언젠가 로 분류합니다.
"다음에 할 일"이 구체적인 물리적 행동이 될 때까지 쪼개주는 것이 핵심입니다.
주간 검토 모드도 있어서 매주 금요일이나 주말에 쓰기 좋습니다.
언제 쓰나 할 일이 너무 많아서 머리가 복잡할 때, 주간 검토할 때
코드를 바로 짜기 전에 먼저 생각합니다.
목표·성공 기준·제약조건을 파악하고, 기존 코드베이스를 탐색한 뒤, Epic → Story → Task 단위로 작업을 분해합니다.
리스크와 미결 질문을 정리하고, 어떤 파일을 수정할지 예상 목록까지 만들어줍니다.
계획을 제시한 뒤 승인을 받고 나서 구현을 시작하는 것이 원칙입니다.
언제 쓰나 새 기능 시작 전, 구현 방법이 막막할 때, 큰 리팩토링 계획 세울 때
변경된 파일을 분석해서 컨벤셔널 커밋 형식(feat, fix, refactor 등)으로 커밋 메시지를 대신 써줍니다.
"무엇을"이 아닌 "왜" 변경했는지에 초점을 맞춥니다.
아직 스테이징 안 된 파일이 있으면 확인 후 진행하고, push는 명시적으로 요청할 때만 합니다.
git add -A나 --no-verify는 절대 사용하지 않습니다.
언제 쓰나 작업 완료 후 커밋할 때, 커밋 메시지 뭐라 쓸지 모를 때
코드를 🔴Critical / 🟡Important / 🟢Suggestion 세 단계로 분류해 피드백합니다.
보안 취약점·데이터 손실 위험은 Critical, 성능 문제·가독성은 Important, 더 나은 패턴 제안은 Suggestion입니다.
비판이 아닌 개선 제안 형태로 작성하고, 잘 된 부분도 반드시 언급합니다.
리뷰 후 Critical부터 수정 순서를 제안하며, 원하면 바로 수정도 진행합니다.
언제 쓰나 PR 올리기 전, 중요한 코드 작성 후, 남의 코드 검토할 때
추측이 아닌 증거 기반으로 버그를 잡습니다.
재현 → 고립 → 가설 → 검증 → 수정 5단계 루프로 진행합니다.
타입 오류, 경계값, 비동기 문제, 상태 오염, 환경 차이 등 흔한 패턴을 체크리스트로 확인합니다.
Binary search debugging으로 코드 어느 절반에 문제가 있는지 좁혀가며, 여러 가설을 동시에 수정하지 않는 것이 원칙입니다.
언제 쓰나 버그가 재현되는데 원인을 모를 때, "왜 안 되지?" 상태일 때
README, API 문서, 코드 주석을 자동으로 작성합니다.
README는 개요·설치·사용법·설정·기여 방법 구조로, API 문서는 요청/응답 예시와 에러 케이스까지 포함합니다.
언어별 docstring 스타일(Python Google Style, TypeScript JSDoc)을 자동 적용합니다.
한국어/영어 선택 가능하며, 코드 예시는 실제로 실행되는 것만 씁니다.
언제 쓰나 새 프로젝트 README 만들 때, API 명세서 작성할 때, 코드에 주석 달 때
어떤 개념이든 비유 → 정의 → 코드 예시 → 실제 패턴 → 내부 동작 순서로 단계별 설명합니다.
파인만 테크닉 기반: 복잡한 것을 단순하게 설명할 수 없으면 아직 이해한 게 아니라는 원칙을 따릅니다.
사용자 레벨(초보/중급/고급)을 먼저 파악해서 알맞은 깊이로 설명합니다.
헷갈리기 쉬운 유사 개념과의 차이, 언제 써야 하고 언제 쓰면 안 되는지도 정리합니다.
언제 쓰나 개념이 이해가 안 될 때, 누군가에게 설명해야 할 때, 새 기술 공부할 때
코드·기술 문서·대화·회의록 등 종류에 맞는 형식으로 핵심을 정리합니다.
코드는 "목적·핵심 로직·의존성·주의사항", 대화/세션은 "결정 사항·완료 작업·액션 아이템", 회의록은 "결론·논의 내용·다음 단계" 형식입니다.
한 줄 요약부터 섹션별 상세 정리까지 원하는 깊이로 조절 가능합니다.
언제 쓰나 긴 문서 핵심만 보고 싶을 때, 세션 끝날 때 정리, 회의 후 정리
Claude가 만든 결과물을 옵시디언 vault에 마크다운 파일로 저장합니다.
Research·Code Snippet·Meeting·Concept·Project 등 노트 종류에 따라 적절한 폴더에 배치합니다.
YAML frontmatter(title, date, tags, type)를 자동으로 달고, [[wikilink]] 형식으로 기존 노트와 연결할 수도 있습니다.
OBSIDIAN_VAULT 환경변수가 설정되어 있어야 자동 저장됩니다.
언제 쓰나 Claude 답변을 영구 지식으로 저장하고 싶을 때, 학습 노트 정리할 때
macOS에서 Claude Code 등 AI 에이전트를 관리하기 위해 만들어진 전용 터미널입니다. tmux와 달리 AI 에이전트에 특화되어 있습니다.
에이전트가 입력을 기다리면 해당 탭에 파란 링이 표시되어 여러 Claude를 동시에 돌릴 때 어디서 응답이 필요한지 바로 알 수 있습니다.
내장 브라우저 페인이 있어서 Claude Code가 로컬 개발 서버 UI를 직접 클릭·테스트할 수 있습니다.
cmux notify 명령어를 Stop 훅에 연결하면 작업 완료 시 자동 알림이 옵니다.
설치 brew install --cask cmux (macOS 14+)
언제 쓰나 Mac에서 여러 Claude 인스턴스를 병렬로 돌릴 때
SSH 서버에서 터미널을 세션·윈도우·페인 3계층으로 관리합니다.
SSH가 끊겨도 세션이 살아있어 원격 작업이 중단되지 않습니다. 화면을 가로/세로로 분할해 에디터·테스트·로그를 동시에 볼 수 있습니다.
전체 단축키 참조표, 권장 .tmux.conf 설정, 개발자 워크플로 예시를 포함합니다.
언제 쓰나 SSH 원격 서버 작업할 때, 로컬 Mac이면 Cmux 사용 권장
GWS CLI(@googleworkspace/cli)와 GAM(Google Apps Manager) 두 가지 도구를 기반으로 합니다.
| 도구 | 대상 | 설치 |
|---|---|---|
| gws CLI | 개인·팀 사용자 | npm i -g @googleworkspace/cli |
| GAM | 조직 슈퍼관리자 | brew install gam7 |
Google Workspace CLI를 처음 세팅할 때 시작하는 스킬입니다.
gws CLI / GAM / gcloud 설치 상태를 확인하고, 인증 방법을 안내합니다.
요청 내용에 따라 적합한 전문 스킬(Gmail·Drive·Calendar·Sheets·Admin)로 안내해줍니다.
멀티 계정 전환, 공통 패턴, API 쿼터 주의사항도 여기서 다룹니다.
언제 쓰나 GWS CLI 처음 설치할 때, 뭘 써야 할지 모를 때
터미널에서 Gmail을 완전히 제어합니다.
읽지 않은 메일을 JSON으로 가져와 Claude가 우선순위를 분류하는 아침 메일 트리아지가 핵심 워크플로입니다.
특정 발신자·키워드·날짜·첨부파일 조건으로 검색하고, 메일 보내기·초안 저장·레이블 추가·일괄 보관도 할 수 있습니다.
Sheets 데이터를 읽어 주간 보고를 자동 발송하는 파이프라인도 포함됩니다.
언제 쓰나 메일함 정리 자동화, 정기 메일 발송, 메일 검색 스크립트 만들 때
파일 업로드·다운로드·공유 설정을 CLI로 처리합니다.
프로젝트 시작 시 01_기획/02_개발/03_산출물 폴더 구조를 한 번에 만드는 워크플로,
로컬 디렉토리를 정기적으로 Drive에 백업하는 스크립트, CSV 기반 팀원 일괄 공유도 포함됩니다.
Google Docs/Sheets를 PDF·Excel로 내보내는 것도 명령어 한 줄로 가능합니다.
언제 쓰나 파일 공유 자동화, 정기 백업, 프로젝트 폴더 세팅
일정 조회·생성·수정과 가용 시간 찾기를 CLI로 합니다.
여러 사람의 캘린더를 동시에 조회해 모두 비어있는 시간 슬롯을 찾는 회의 시간 조율이 핵심입니다.
반복 이벤트(매주 스탠드업 등), Google Meet 링크 포함 일정 생성, 참석 여부 자동 응답도 지원합니다.
/daily 스킬과 연계해 오늘 일정을 아침 브리핑에 자동 포함할 수 있습니다.
언제 쓰나 회의 시간 조율, 반복 일정 자동 생성, 일정 데이터 가져올 때
스프레드시트 데이터를 CLI로 읽고 씁니다.
데이터를 JSON으로 가져와 Claude가 분석·인사이트·예측을 해주는 데이터 분석 파이프라인이 핵심입니다.
작업 완료 후 로그를 시트에 자동 기록하거나, 여러 월별 시트를 합쳐 통합 분석하는 것도 가능합니다.
/gws-gmail과 연계해 시트 데이터 → 주간 보고 메일로 자동 발송하는 워크플로를 포함합니다.
언제 쓰나 데이터 자동 수집/기록, 보고서 자동화, 스프레드시트 배치 처리
Google Workspace 조직 전체를 CLI로 관리합니다. 슈퍼관리자 권한 필요.
신규 입사자 계정 생성·OU 배치·그룹 추가·라이선스 할당을 한 번에 처리하는 온보딩 스크립트,
계정 정지·파일 이관·그룹 제거·세션 만료를 처리하는 오프보딩 스크립트가 포함됩니다.
2단계 인증 미설정 유저, 90일 미로그인 유저, 과도한 외부 앱 연결을 감지하는 보안 감사도 지원합니다.
언제 쓰나 입사자/퇴사자 처리, 대량 계정 수정, 보안 감사
Claude Code 세션이 끝날 때마다 자동으로 실행됩니다.
- 미커밋 변경사항이 있으면 → 커밋 촉구
- 미추적 파일이 있으면 → 커밋 촉구
- 로컬 커밋이 push 안 됐으면 → push 촉구
작업하다가 커밋 없이 세션을 닫는 실수를 방지합니다.
아침 /daily (MIT 3개 설정) → /gws-calendar (오늘 일정 확인)
업무 /plan (설계) → 구현 → /commit → /review
막힐때 /debug (버그) 또는 /learn (개념 이해)
정리 /gtd (할 일 넘침) 또는 /summarize (내용 정리)
저녁 /daily (회고) → /obsidian (오늘 배운 것 저장)
주말 /gtd 주간 검토 → 다음 주 /plan
- 모두의AI (MoAI): github.com/modu-ai
- Cmux: cmux.com
- GAM: github.com/GAM-team/GAM
- GWS CLI: github.com/googleworkspace/cli