onboard

onboard skill 개요

onboard가 하는 일

onboard는 c-level-agents 시스템을 위한 Knowledge Capture skill입니다. /cs:onboard를 통해 구조화된 창업자 인터뷰를 진행하고, 그 답변을 가상 C-suite 어드바이저들이 추천을 만들기 전에 참고하는 공통 회사 컨텍스트 파일인 ~/.claude/company-context.md로 정리합니다.

이는 일반적인 온보딩 체크리스트가 아닙니다. onboard skill은 회사 단계, 인원, 지역, 비즈니스 모델, ICP, ACV, 성장, 자금 조달, 런웨이, 전략 목표, 제약 조건, 운영 맥락처럼 오래 유지되어야 하는 사업 정보를 캡처하기 위한 도구입니다. 핵심 목적은 어드바이저 에이전트가 추측으로 판단하지 않게 만드는 것입니다.

onboard skill이 잘 맞는 경우

회사를 위해 c-level-agents를 처음 설정할 때, 큰 변화 이후 컨텍스트를 갱신할 때, 또는 /cs:boardroom, /cs:brief, 역할별 임원 어드바이저 워크플로를 준비할 때 onboard를 사용하면 좋습니다.

특히 AI 에이전트가 동일한 단일 진실 공급원에서 판단하기를 원하는 창업자, chief of staff, 스타트업 운영 담당자, 어드바이저에게 유용합니다. 회사 컨텍스트가 피치덱, CRM 메모, 투자자 업데이트, 기억 속에 흩어져 있다면 onboard는 실무적으로 첫 정리를 해주는 도구가 됩니다.

일반 프롬프트와 다른 점

일반 프롬프트로도 “우리 회사를 학습해줘”라고 요청할 수는 있지만, 보통 중요한 항목을 놓치거나 일관되지 않은 방식으로 기록합니다. onboard skill은 표준화된 7개 차원 스키마와 12개 질문 인터뷰를 사용한 뒤, 나머지 cs-* 어드바이저 생태계가 읽을 수 있는 예측 가능한 파일 경로에 결과를 씁니다.

이 파일 기반 인계가 가장 큰 차별점입니다. onboard의 가치는 일회성 채팅 기록이 아니라 재사용 가능한 컨텍스트를 만든다는 데 있습니다.

onboard skill 사용 방법

onboard 설치와 먼저 확인할 파일

skills CLI로 설치합니다.

npx skills add alirezarezvani/claude-skills --skill onboard

소스는 c-level-advisor/c-level-agents/skills/onboard에 있습니다. 먼저 SKILL.md를 읽어보세요. 이 skill은 저장소 구성이 간결하며 추가 스크립트, 참고 문서, 리소스 폴더에 의존하지 않습니다. 중요한 구현 세부사항은 예상 출력 파일이 ~/.claude/company-context.md라는 점입니다.

설치 후 Claude skills를 사용할 수 있는 환경에서 /cs:onboard 명령을 실행합니다. 다른 C-suite 어드바이저 명령보다 먼저 실행해야, 이후 명령들이 일반적인 가정에 의존하지 않고 회사 컨텍스트를 읽을 수 있습니다.

onboard skill에 필요한 입력

시작하기 전에 사실 기반 입력을 준비하세요. 인터뷰는 회사 기본 정보, 비즈니스 모델, 고객 프로필, 성장, 운영 제약을 다루므로 답변이 약하거나 모호하면 이후 모든 어드바이저의 품질도 떨어집니다.

준비해두면 좋은 메모는 다음과 같습니다.

• 회사명과 한 문장 피치
• 단계, 전체 인원, 기능별 인원
• 본사 위치, 원격 근무 비중, 중요한 운영 국가
• 수익 모델: SaaS, usage, transaction, marketplace, hardware, services, 또는 hybrid
• ICP, 실제 고객 한 곳, 그리고 그 고객이 해당 세그먼트를 대표하는 이유
• ACV 범위, median ACV, 최근 딜 수
• ARR 성장률 또는 매출 이전 회사라면 가장 강한 선행 지표
• 자금 조달 상태, 런웨이, 이사회/투자자 기대치, 현재 전략 우선순위

숫자를 모른다면 그대로 모른다고 말하세요. 확신에 찬 추측보다 명시된 미확인이 더 낫습니다. 이후 어드바이저 작업에서 빠진 데이터를 다시 물어볼 수 있기 때문입니다.

거친 목표를 좋은 onboard 프롬프트로 바꾸기

약한 프롬프트는 다음과 같습니다. “Help onboard my startup.”

더 나은 onboard 사용 프롬프트는 다음과 같습니다.

“Run /cs:onboard for a seed-stage B2B SaaS company. Ask me the founder interview questions one at a time. If my answer is vague, ask a follow-up before writing ~/.claude/company-context.md. Preserve unknowns instead of inventing numbers. Make the final context useful for /cs:boardroom and role-specific cs advisors.”

이렇게 작성하면 회사 단계, 원하는 인터뷰 방식, 불확실성 처리 기준, 목적 파일, 이후 사용 사례를 skill에 명확히 알려주기 때문에 결과 품질이 좋아집니다.

더 나은 결과를 위한 실무 워크플로

onboard는 세 번에 나눠 진행하는 것이 좋습니다. 첫째, 지나치게 다듬으려 하지 말고 인터뷰를 끝까지 완료합니다. 둘째, ~/.claude/company-context.md를 검토해 과도하게 정확한 척하는 수치, 오래된 숫자, 빠진 제약 조건이 없는지 확인합니다. 셋째, 에이전트에게 “잘못된 임원 조언을 유발할 수 있는 컨텍스트 공백”을 찾아달라고 후속 요청을 합니다.

자금 조달, 큰 피벗, 새로운 ICP, 가격 변경, 인수, 리더십 변화, 의미 있는 성장률 변화가 생긴 뒤에는 onboard를 다시 실행하세요. 이런 순간에는 오래된 회사 컨텍스트가 오히려 해로워질 수 있습니다.

onboard skill FAQ

onboard는 창업자만 사용할 수 있나요?

아니요. onboard skill은 창업자 인터뷰 형식으로 작성되어 있지만, 회사에 대해 핵심 질문에 답할 만큼 잘 아는 chief of staff, 운영 담당자, 어드바이저, 창업팀 구성원도 사용할 수 있습니다. 가장 좋은 결과를 얻으려면 실행자가 숫자와 전략적 트레이드오프를 모두 이해하고 있어야 합니다.

언제 onboard를 사용하지 않는 것이 좋나요?

onboard를 완전한 데이터룸, CRM export, 재무 모델, 이사회 메모의 대체물로 사용하지 마세요. 이 skill은 오래 유지되는 운영 컨텍스트를 캡처하는 도구이지, 모든 거래 단위 세부사항을 기록하는 도구가 아닙니다. 더 넓은 c-level-agents 워크플로를 사용할 계획 없이 일회성 브레인스토밍만 필요할 때도 잘 맞지 않습니다.

AI 환경에 민감한 사업 데이터를 공유할 수 없다면 실행 전에 입력을 익명화하거나 일반화하세요.

onboard가 Knowledge Capture에 어떻게 도움이 되나요?

Knowledge Capture 관점에서 onboard는 중요한 사실을 대화 기록 속에 묻어두지 않고 안정적인 회사 컨텍스트 산출물로 만듭니다. 이는 어드바이저 에이전트가 같은 파일을 다시 참고하며 전략, 재무, 제품, GTM, 운영 논의 전반에서 일관성을 유지할 수 있기 때문에 중요합니다.

가장 좋은 사용 방식은 “모든 것을 저장하는 것”이 아닙니다. “미래의 임원급 추론이 다시 찾아낼 필요가 없는 사실을 저장하는 것”입니다.

onboard는 초보자에게도 쉬운가요?

네, 인터뷰 질문에 답할 수 있다면 어렵지 않습니다. 이 skill이 구조를 제공하므로 직접 회사 컨텍스트 스키마를 설계할 필요가 없습니다. 초보자는 천천히 진행하고, 정확한 숫자를 모를 때는 범위로 답하며, 모델이 스타트업에 대한 고정관념으로 빈칸을 채우지 않도록 해야 합니다.

onboard skill 개선 방법

어드바이저를 실행하기 전에 onboard 입력 개선하기

onboard의 품질이 이후 C-suite 조언의 품질을 결정합니다. /cs:boardroom이나 다른 어드바이저를 사용하기 전에 구체적인 숫자, 이름이 있는 고객 사례, 실제 제약 조건, 현재 전략 우선순위로 컨텍스트 파일을 보강하세요.

“we sell to enterprises” 대신 “we sell compliance workflow software to US healthcare providers; strongest fit is 500-5,000 employee systems with internal legal operations teams.”처럼 작성하세요. 구체성이 달라지면 에이전트가 줄 수 있는 조언도 달라집니다.

흔한 실패 패턴 점검하기

가장 큰 실패 패턴은 오래된 지표, 지어낸 듯한 과도한 정밀도, 지나치게 넓은 ICP, 빠진 제약 조건입니다. 컨텍스트에 “enterprise SaaS”라고만 쓰여 있고 영업 사이클 길이, 구매자, ACV, 구현 부담, churn risk가 빠져 있다면, 어드바이저는 그럴듯하지만 실제로 맞지 않는 전략을 추천할 수 있습니다.

또 다른 흔한 문제는 희망 사항을 사실처럼 다루는 것입니다. “현재 ICP”와 “향후 원하는 ICP”를 구분하고, “현재 ARR”과 “목표 ARR”도 분리하세요.

첫 출력 이후 반복 개선하기

첫 ~/.claude/company-context.md가 생성되면 다음과 같이 물어보세요.

• “What assumptions in this context are most likely to mislead a CFO, CMO, or COO advisor?”
• “Which answers are too vague to support board-level recommendations?”
• “What follow-up questions would improve the 7-dimension company context?”
• “Rewrite the context to distinguish facts, estimates, and unknowns.”

이렇게 하면 onboard를 일회성 양식이 아니라 실질적인 컨텍스트 품질 개선 루프로 사용할 수 있습니다.

onboard를 최신 상태로 유지하기

회사 운영 프로세스에 컨텍스트 갱신을 포함하면 onboard의 효과가 더 커집니다. 초기 단계 회사는 매월, 후기 단계 회사는 분기마다 파일을 다시 확인하고, 대규모 자금 조달, 구조조정, 가격, 시장, 제품 변화가 있을 때는 즉시 갱신하세요.

이 skill은 company-context.md가 지난 분기 덱에 적힌 회사가 아니라, 리더들이 지금 실제로 운영하고 있는 회사를 반영할 때 가장 가치 있습니다.