활용 가이드
새 팀원이 첫 실행과 코드 이해까지 이어갈 수 있도록 설치·실행·탐색 순서와 팀 절차를 정리합니다.
새 팀원이 코드 구조를 이해하고 첫 실행까지 도달할 수 있도록, 저장소에서 확인한 안내와 팀이 보완할 정보를 나눠 정리하세요.
준비할 자료
대상 저장소와 브랜치, 기존 README, 새 팀원의 역할과 첫 목표를 정합니다. 온보딩 자료에 실제 비밀번호·토큰·개인 연락처를 넣지 않습니다.


생성과 리뷰
채팅으로 주요 디렉터리와 진입점, 구성요소의 의존 관계를 설명하는 문서와 아키텍처 다이어그램을 요청합니다. 설치·실행·테스트 명령은 패키지 설정과 스크립트를 근거로 정리합니다. 팀의 권한 요청, 리뷰·배포 합의, 도움을 줄 담당자는 사람이 보완합니다.
코드 변경 후 갱신
새 환경에서 안내 순서대로 실행해 막힌 곳을 문서에 반영합니다. 저장소와 브랜치를 기존 온보딩 문서나 구조 캔버스에 연결하면 이후 push를 근거로 연결된 결과물을 직접 갱신할 수 있습니다. 갱신 후 명령과 경로가 맞는지 다시 확인하고, 권한 요청과 리뷰·배포 같은 팀 절차는 담당자가 별도로 관리하세요.
채팅 요청 예시
이 저장소에 처음 참여하는 백엔드 개발자를 위한 온보딩 문서를 만들어 줘.
프로젝트 개요, 저장소 지도와 아키텍처, 설치·실행·테스트 순서를 포함해 줘.
명령의 근거 파일을 남기고, 코드에서 확인할 수 없는 권한 요청과 팀 절차는 질문으로 남겨 줘.코드 구조가 이해되지 않으면 다이어그램을 보면서 채팅으로 질문하세요. 개선이 필요하면 합의한 내용을 개선 문서로 남기고 코딩 에이전트가 MCP로 읽게 할 수 있습니다. 실제로 실행한 명령에는 환경과 확인한 결과를 함께 기록하세요.