프로젝트 온보딩 문서화

핵심 개념

새 팀원이 합류했을 때, 또는 6개월 후 내가 돌아왔을 때 빠르게 개발 환경을 구성할 수 있는 문서를 작성합니다.

본문

온보딩 문서 구조SETUP.md 필수 내용:1. 필수 설치 (Node 버전 명시)2. 환경변수 설정 (.env.example)3. 실행 명령어권장 구조:## 1. 설치nvm use 20npm install## 2. 환경변수cp .env.example .env.local# SUPABASE_URL 채우기## 3. 실행npm run dev → http://localhost:3000목표: 30분 안에 실행 가능

🛠️ 이 챕터의 실습 방법

실습 1: 런칭 체크리스트 만들기

아래 항목을 노션에 체크리스트로 만드세요:

실습 2: PR 리뷰 연습

GitHub에서 자신의 PR을 셀프 리뷰해보세요:

Files changed 탭에서 코드 변경 확인
각 변경에 코멘트 추가
Approve → Merge

실습 3: 환경변수 보안 점검

BASH📋 코드 (4줄)

# .gitignore 확인
cat .gitignore | grep .env
# Git 히스토리에 시크릿이 있는지 검색
git log --all -p | grep -i 'api_key\|secret\|password'

AI 프롬프트

🤖 AI에게 잘 물어보는 법 — 모델·전략별 프롬프트

무료 모델

Gemini 2.5 Flash(무료) + Claude Sonnet 4.6(무료) + Grok 4.1(무료)

'프로젝트 온보딩 문서화' 기획을 0원으로 시작하고 싶어.
ChatGPT(아이디어) → Gemini(경쟁 분석) → Claude(기획서 구조화) 순서로
Notion+Figma+GitHub Projects만 사용하는 워크플로우를 설계해줘.

소자본 모델

Claude API + Cursor $20/mo + Make.com — 월 10~30만원

'프로젝트 온보딩 문서화' 기획에 AI를 활용해서 시간을 단축하고 싶어.
Perplexity API(시장조사) + Claude API(문서 작성) + Cursor(프로토타입) 조합으로
1주일 안에 기획→MVP까지 끝내는 월 20만원 플랜을 짜줘.

프로덕션 모델

Claude Opus + CrewAI + LangGraph — 월 100만원+

'프로젝트 온보딩 문서화'를 팀 프로젝트로 확장하려 해.
AI PM(Claude Opus) + AI 리서처(Perplexity) + AI 개발(Cursor+Copilot)
에이전트 팀과 AGENTS.md 협업 프로토콜을 월 100만원 예산으로 설계해줘.

스택 프롬프트

0원→$20/mo→$100/mo 단계별 스택 비교

'프로젝트 온보딩 문서화' 기획에 최적화된 AI 도구 조합을 단계별로 알려줘.
무료(Notion+Figma+ChatGPT) → 소자본(Cursor+Perplexity API) → 프로덕션(CrewAI+LangGraph)
각 단계별 도구·결과물·전환 시점을 비교해줘.

⭐ 이것만 기억하세요

프로젝트 온보딩 문서화는 이 3가지만 확실히 잡으세요

1.온보딩 문서가 없으면 새 팀원이 환경 설정에만 하루 이상 걸리고, 기존 팀원이 설명에 시간을 빼앗깁니다

2.환경 설정 가이드, 폴더 구조 설명, 주요 명령어, 코딩 규칙, 브랜치 전략을 문서로 정리합니다

3.다음 챕터에서 기술 부채를 체계적으로 관리하는 법을 배웁니다

💬 이 챕터 질문 보기

PROJECT-PLAN · CH.29 — 질문하거나 답변을 확인하세요

→

진행도 29 / 34

← 커리큘럼으로 ← 목록으로 (프로젝트 기획)