클로드코드 /team-onboarding — 내 사용 기록으로 팀 온보딩 가이드 만들기

새 팀원이 들어올 때마다 "우리는 이런 설정을 쓰고, 이런 명령을 자주 써요"를 처음부터 설명하는 건 꽤 번거롭습니다. /team-onboarding은 내가 그동안 어떻게 써왔는지를 분석해, 팀 온보딩(onboarding, 새 구성원이 빠르게 적응하도록 돕는 과정) 가이드를 자동으로 만들어주는 명령입니다.

정의 (뭐냐면)

/team-onboarding은 내 사용 기록을 바탕으로 팀 온보딩 가이드를 만드는 명령입니다. 최근 30일간의 사용 내역을 분석해 문서를 작성해줘요.

온보딩 가이드란 새 팀원이 도구와 작업 방식에 빠르게 적응하도록 정리한 안내 문서를 말합니다. 평소 내가 어떤 명령과 설정을 자주 썼는지를 자동으로 뽑아 문서 형태로 정리해주니, 처음부터 손으로 쓸 필요가 없어요. 팀 작업 방식을 다루는 기능이라 중급으로 분류됩니다.

어떻게 쓰나 (난이도별)

기초 — 온보딩 가이드 생성

입력창에 이렇게 칩니다.

/team-onboarding

그러면 최근 30일의 사용 기록을 분석해 온보딩 문서를 만들어줍니다. 내가 자주 쓴 흐름이 정리되어 나와요.

흔한 함정

• 최근 30일 기록을 기준으로 분석합니다. 그래서 내가 평소 쓰던 대표적인 방식이 잘 드러나도록, 활동이 충분히 쌓인 시점에 돌리는 게 좋아요. 막 시작해 기록이 거의 없으면 가이드가 빈약하게 나올 수 있습니다.

실전 사례

새 팀원이 합류할 때 /team-onboarding 결과를 공유하면, 우리 팀이 실제로 쓰는 명령과 설정을 한 번에 전달할 수 있습니다. 말로 일일이 설명하는 대신 문서를 건네주면, 새 팀원이 스스로 읽고 빠르게 적응할 수 있어요.

이렇게 더 씁니다

사용 패턴을 더 들여다보고 싶다면 /insights(사용 인사이트)와 함께 보면 좋고, 프로젝트 자체의 설명 문서를 만들고 싶다면 /init(프로젝트 문서 초기화)으로 보완할 수 있어요. 분기마다 한 번씩 돌려 가이드를 최신 상태로 갱신해두면, 팀 작업 방식이 바뀌어도 문서가 따라옵니다.

정리

/team-onboarding은 최근 30일 사용 기록을 분석해 팀 온보딩 가이드를 만드는 명령입니다. 새 팀원에게 우리 팀의 작업 방식을 문서로 한 번에 전달할 수 있어, 합류가 빨라져요. 기록이 충분히 쌓인 뒤 돌리면 더 알찬 가이드가 나옵니다.

FAQ · 자주 묻는 질문

어떤 기록이 분석되는 건가요? 걱정해야 할 부분이 있나요?

최근 30일간의 클로드코드 사용 내역이 분석 대상입니다. 평소 어떤 명령과 설정을 자주 썼는지를 뽑아 온보딩 문서 형태로 정리해주는 것이라, 내 작업 흐름이 가이드라는 결과물로 정리되어 나온다고 이해하면 됩니다. 새 팀원과 공유하기 전에 내용을 한 번 읽어보면 더 안심돼요.

온보딩 가이드는 어떻게 만드나요?

입력창에 /team-onboarding 한 줄만 치면 됩니다. 최근 30일의 사용 기록을 분석해 온보딩 문서를 자동으로 만들어주고, 내가 자주 쓴 흐름이 정리되어 나와요. 처음부터 손으로 문서를 쓸 필요 없이, 결과를 새 팀원에게 건네면 됩니다.

막 시작해서 기록이 거의 없는데도 쓸 수 있나요?

쓸 수는 있지만 가이드가 빈약하게 나올 수 있습니다. 최근 30일 기록을 기준으로 분석하기 때문에, 평소 쓰던 대표적인 방식이 잘 드러나도록 활동이 충분히 쌓인 시점에 돌리는 게 좋아요. 이후 분기마다 한 번씩 갱신하면 팀 방식이 바뀌어도 문서가 따라옵니다.

기준: Claude Code v2.1.154 (2026.05)