Onboarding Guide

Hugh's Multi-Project
Studio 온보딩 가이드를
90일 작업 기록으로 썼다

새 팀원이 이 스튜디오에 오면 프로젝트 17개, 스킬 12개, MCP 서버 5개(MCP는 Model Context Protocol의 약자로, Claude가 바깥 도구를 불러 쓰도록 연결하는 통로)를 한꺼번에 마주칩니다. 무엇부터 봐야 하는지 알기 어렵습니다. 그래서 Hugh Kim이 지난 90일 동안 실제로 남긴 작업 기록을 바탕으로 한 페이지짜리 안내서를 만들었습니다. 기록은 memory-bank(대화가 끝나도 알아낸 내용을 저장해 두는 기억 창고)에 쌓인 로그를 교차 분석했습니다. 어떤 종류의 일을 얼마나 했는지, 자주 쓰는 스킬(Claude에게 시키는 미리 만든 명령)과 MCP는 무엇인지, 지금 살아 있는 프로젝트마다 무엇을 준비해야 하는지를 담았습니다. 처음 온 팀원을 옆에서 안내하는 길잡이로 쓰세요.

90
Days Analyzed
17
Active Projects
12
Skills Tracked
5
MCP Servers

최근 90일 작업 유형 분포

이 스튜디오의 일은 3분의 1이 새 기능 만들기입니다. 지난 90일간 나눈 대화 기록(기억 창고 memory-bank에 쌓인 로그)을 종류별로 나눠 센 결과입니다. 새 기능 만들기가 35%로 가장 많고, 품질 개선 22%와 버그 수정 15%가 뒤를 잇습니다. 나머지는 문서 쓰기 12%, 기획·설계 10%, 시제품(프로토타입) 만들기 6%입니다.

Task Category % share
Build Feature
35%
Improve Quality
22%
Debug Fix
15%
Write Docs
12%
Plan Design
10%
Prototype
6%

자주 쓰는 스킬 & 명령어

가장 자주 쓰는 명령은 /cc-sync입니다. 최근 30일 동안 쓴 명령어를 센 결과입니다. 명령어는 슬래시(/)로 시작하는, Claude에게 시키는 단축 지시입니다. /cc-sync(내 공용 설정을 지금 프로젝트로 복사하는 명령)가 월 48회로 가장 많았습니다. 그 뒤를 autoresearch(밤새 혼자 실험을 반복해 돌리는 도구) 44회와 self-improve(최근 실수를 분석해 규칙을 고치는 도구) 38회가 잇습니다.

Slash Commands calls / month
/cc-sync
48
/autoresearch-builder
44
/self-improve
38
/plugin
18
/reload-plugins
13
/cc-apply
6
/release-notes
6
/loop
5
/team
3
/qa-cycle
1*
* /qa-cycle(코드가 제대로 도는지 자동으로 검사하고 고치는 명령)과 그 짝인 /qa-scenario-gen(검사할 시나리오를 먼저 만드는 명령)은 이 30일 기준에서는 낮게 보입니다. 90일 전체로 보면 실제로는 훨씬 자주 씁니다.

자주 쓰는 MCP 서버

MCP(Model Context Protocol)는 Claude가 바깥 도구를 불러 쓰도록 연결해 주는 통로입니다. 이 스튜디오에서는 기억 저장, 브라우저 자동 조작, 대화 검색 이 세 가지가 전체 호출의 대부분을 차지합니다. 그중 기억 창고 memory-bank가 90일간 62회로 가장 많이 불렸습니다.

memory-bank
62 calls
대화가 끝나도 알아낸 내용을 저장해 두고, 다음 대화에서 다시 꺼내 쓰는 기억 창고입니다. 다섯 서버 가운데 가장 많이 씁니다. 설치한 뒤 저장 위치는 Hugh에게 물어보세요.
computer-use
53 calls
화면이 실제로 잘 보이고 잘 눌리는지, 진짜 브라우저를 자동으로 조작해 확인합니다. 품질 검사(QA)에 쓰는 도구입니다. 내 컴퓨터에 크롬(Chrome)이 깔려 있어야 합니다. 화면(UI)을 바꿨다면 반드시 거쳐야 합니다.
claude-mem-search
38 calls
지금까지 Claude Code로 나눈 모든 대화 기록을 '뜻'으로 찾아 줍니다. 단어가 똑같지 않아도 의미가 비슷하면 찾습니다. 기록은 알아서 정리되므로 따로 손댈 필요는 없습니다.
episodic-memory
6 calls
지난 대화에서 받은 특별 지시(예: "지금은 서버에 올리지 마")를 다음 대화까지 기억합니다. 대화가 새로 시작돼도 그 약속이 이어지게 합니다.
github
4 calls
코드를 올리고 내려받는 GitHub과 연결합니다. 접근 열쇠(PAT, Personal Access Token의 약자로 GitHub에서 발급받는 개인용 인증 토큰)가 필요합니다. 그 토큰을 아래 환경 변수(env, 프로그램이 시작할 때 읽어 가는 설정값)에 넣어 둡니다. 변수 이름은 다음과 같습니다. GITHUB_TOKEN

90일간 활성 프로젝트 코드베이스

지금 활발히 작업 중인 저장소(리포지토리, 코드를 담아 두는 GitHub 보관함) 17개를 4개 묶음으로 정리했습니다. 새로 합류하면 전부 받을 필요는 없습니다. 맡을 프로젝트만 골라 내 컴퓨터로 내려받으세요(clone).

Client Work · hugh-soft/
정부 지원사업, 매칭 서비스, 스튜디오 운영처럼 고객사 일을 하는 프로젝트들
article21-admin
정부 지원사업에 내는 사업계획서를 관리하는 관리자 화면입니다. 지원사업은 두 가지입니다. 하나는 팁스(TIPS, Tech Incubator Program for Startup의 약자로 정부 창업 지원 프로그램)이고, 다른 하나는 한국콘텐츠진흥원(KOCCA, Korea Creative Content Agency)의 지원사업입니다. 화면은 PrimeVue라는 UI 부품 모음(웹 화면을 만드는 도구 Vue에 끼워 쓰는 부품 묶음)으로 만들었습니다. 파일을 끌어다 놓는 업로드 부품(FileDropZone)이 있습니다. 2026년 1~3월에 집중 작업했습니다.
artricle-docs
사업계획서 원본을 모아 둔 저장소입니다. 같은 내용이 문서 파일(마크다운, md)과 발표 파일(파워포인트, pptx) 두 벌로 있습니다. 두 벌의 내용이 서로 어긋나지 않는지 확인해야 합니다.
match-system
사람이나 업체를 서로 이어 주는 매칭 시스템입니다. 서버는 Kotlin 언어와 Spring Boot 프레임워크(서버 프로그램의 뼈대가 되는 기본 틀)로, 화면은 Next.js라는 웹 프레임워크(React 기반으로 웹 화면을 만드는 도구)로 만들었습니다.
running-web
달리기(러닝) 행사용 웹사이트입니다.
studio-bot
스튜디오 운영을 자동으로 돕는 봇입니다.
Construction Client · bs-hanyang/
건설 회사 고객사의 프로젝트입니다. 견적 계산, 경영정보시스템(MIS, Management Information System의 약자로 회사 운영 숫자를 한곳에 모아 보는 시스템), 사내 지식 창고를 다룹니다.
BisFramework
건설 업무를 담는 기본 틀(프레임워크)입니다. 데이터베이스 구조를 설계하고, 화면 요소를 끌어다 놓는(드래그 앤 드롭) 방식의 화면을 다룹니다.
KFM
건설 견적을 계산하는 재무 모델(FinModel)입니다. Rust 언어와 엑셀로 만들었습니다. 견적 서식 44종을 종류별로 검사(QA)합니다.
HANY / HANY-kpi / HANY-gatekeeper
건설 경영정보시스템(MIS) 5.0판입니다. 7개 업종을 다룹니다. 9개의 검문 관문(Gate Keeper, 다음 단계로 넘어가기 전에 조건을 확인하는 장치)이 단계마다 확인합니다.
AX-Wiki
팀 안에서만 보는 지식 창고(위키)입니다.
Personal Tools · Claude/
Hugh가 직접 쓰는 개인 도구입니다. 설정 맞추기(동기화), 자동 실험 반복, 기억 시스템을 다룹니다.
cc-sync hub
내 공용 설정(User Scope, 모든 프로젝트가 함께 쓰는 기본 설정)과 프로젝트마다 둔 하네스(harness, AI가 다 했다고 거짓말 못 하게 증거를 강제하는 감시 장치)를 서로 똑같이 맞춰 줍니다. jung-wan-kim/cc-sync
trader-hugh
주식 매매 현황판(대시보드)입니다. 차트 모양(패턴)을 알아보고, 과거 데이터로 전략을 미리 시험합니다(백테스팅).
autoresearch-builder
혼자서 실험을 반복해 돌리는 자동 루프의 기본 뼈대(스캐폴드, 새 프로젝트에 복사해 시작하는 틀)입니다.
claude-config-editor
Claude Code의 설정 폴더(홈 폴더 바로 아래 있는 .claude 폴더)를 화면에서 바꾸는 편집기입니다.
insights-ui
사용 분석(Insights) 리포트를 보여 주는 현황판입니다.
memory-bank
대화가 바뀌어도 이어지는 기억 저장소입니다. Hugh가 직접 관리합니다.
Misc
Flutter로 만든 운동(피트니스) 앱
Fit5x5
Flutter(구글의 앱 제작 도구)로 만든 운동 앱입니다. 상태 관리는 Riverpod이라는 라이브러리(앱 안에서 바뀌는 데이터를 한곳에서 다루는 부품)로, 화면 이동은 GoRouter라는 라이브러리(화면 사이를 오가는 길을 정하는 부품)로 합니다.

알아두면 좋은 스킬

크게 세 갈래입니다. 팀에 합류하면 가장 먼저 실행할 것, "다 됐다"고 말하기 전 반드시 통과해야 하는 게이트(gate, 조건을 못 채우면 다음 단계로 못 넘어가게 막는 검문소), 그리고 스스로 규칙을 고쳐 나가는 자동 개선 루프입니다.

/cc-sync Start here
내 공용 설정(User Scope)과 훅(hook, 정해진 순간마다 자동으로 도는 검사 스크립트), 스킬을 지금 프로젝트로 복사해 맞춥니다. 팀에 합류하면 가장 먼저 실행하세요.
/autoresearch-builder:autoresearch
하나의 점수를 기준으로, 좋아지면 남기고 나빠지면 버리며 실험을 자동 반복합니다. 밤새 혼자 돌려 볼 아이디어에 씁니다.
/self-improve
최근에 무엇을 고쳤는지 남긴 기록(수정 이력)을 분석해, 같은 실수를 막을 규칙을 스스로 늘립니다. 작업이 끝나는 순간 자동으로 돕니다.
/cc-apply
/cc-sync의 반대 방향입니다. 프로젝트 안에서 다듬은 설정을 거꾸로 내 공용 설정(User Scope, 홈 폴더의 .claude 폴더)에 반영합니다.
/qa-cycle · /qa-scenario-gen Required
둘은 짝입니다. 뒤의 시나리오 생성 명령이 무엇을 통과해야 하는지 검사 시나리오(테스트 계획)를 먼저 정합니다. 그다음 앞의 /qa-cycle이 그 시나리오로 검사하고 문제를 자동으로 고치기를 반복합니다. "완료"라고 말하기 전 반드시 거쳐야 합니다.
/team
전문 담당자(specialist, 화면·서버·검사처럼 한 분야씩 맡는 에이전트)가 3명 이상 필요한 큰 프로젝트를 지휘합니다. 0~5단계로 나눠 진행합니다.
/auto-issue
GitHub에 등록된 할 일(이슈)을 자동으로 처리합니다. 작업 가지(브랜치)를 만들고, 구현하고, 검사(QA)하고, 반영 요청(PR, 고친 코드를 본줄기에 합쳐 달라는 요청)을 올리는 데까지 이어집니다.
/plugin · /reload-plugins
스킬이나 에이전트(자동으로 일하는 도우미)를 고쳤다면, 반드시 /reload-plugins로 다시 불러와야 반영됩니다.
/loop
정해진 간격마다 같은 명령을 자동으로 반복합니다. 예: /loop 10m /auto-issue.
/release-notes
Claude Code의 최신 변경 내역(changelog)을 정리해 줍니다.
/insights-ui:builder
Claude Code 사용 분석(Insights) 리포트를 보기 좋게 그려 줍니다.
/frontend-design · /vs-design-diverge
밋밋한 기본 AI 디자인 대신, 개성 있는 화면(UI)을 만들어 줍니다.

시작하기

Recommended First Steps
먼저 /cc-sync 를 실행해, 내 공용 설정(User Scope)을 지금 프로젝트에 맞추세요. 그다음 맡을 프로젝트의 저장소만 내 컴퓨터로 내려받으세요(clone). MCP는 세 가지만 먼저 켜면 대부분의 작업이 돌아갑니다. 기억 창고(memory-bank), 브라우저 자동 조작(computer-use), 대화 검색(claude-mem-search), 이 셋입니다.