비개발자용 시작
이 가이드는 풀타임 개발자가 아닌 분을 위한 안내입니다. e2e-base는 다른 ddakit base와 성격이 다릅니다. 앱을 만드는 것이 아니라, 이미 있는 내 앱이 설명대로 동작하는지를 자동으로 확인하는 테스트 모음을 만듭니다.
그래서 이 가이드가 끝나면 결과물로 남는 것은 새 앱이 아니라, “로그인이 되나, 결제가 되나, 핵심 기능이 저장되나” 같은 흐름을 매번 사람이 손으로 눌러보지 않아도 한 번에 확인해 주는 자동 검사입니다.
어떤 분을 염두에 두고 썼나
섹션 제목: “어떤 분을 염두에 두고 썼나”이 base를 선택하는 분 중에는 풀타임 개발자가 아닌 경우가 적지 않습니다. 그래서 설명을 친절하게 풀어 썼습니다. 다만 가정하는 학습 수준이 하나 있습니다.
터미널을 한 번이라도 열어 봤고, AI와 코딩해 본 경험이 있다는 가정입니다. 명령을 한 줄씩 풀어 적기는 하지만, “터미널이 뭔지”, “git이 뭔지”, “Node가 왜 필요한지”를 처음부터 설명하지는 않습니다. 그 부분은 옆 탭에 무료 학습 자료를 띄워 두고 참고해 주시면 됩니다.
다음 세 가지를 가정합니다.
- 터미널, git, Node의 이름과 대략의 쓰임은 알고 있습니다. 그 위에서 명령을 한 줄씩 풀어 적습니다.
- 검증할 앱이 이미 있습니다. 이 base는 앱을 만들지 않습니다. 본인이 만든 웹사이트, 데스크톱 앱, 폰 앱 중 하나가 이미 동작하고 있어야 합니다. 그 앱을 e2e-base가 외부에서 직접 조작해 봅니다.
- 테스트 코드는 AI가 씁니다. 이 가이드에서는 Claude Code를 씁니다. 어떤 흐름이 깨지면 치명적인지만 본인이 알면 됩니다.
이미 익숙한 부분이 있다면 그 단계는 훑고 넘어가도 됩니다. 다만 한 번씩은 눈으로 지나가 두는 편이 좋습니다. 기대와 다르게 동작하는 상황을 만났을 때 어디로 돌아와야 하는지가 머릿속에 남기 때문입니다.
단계 안내
섹션 제목: “단계 안내”| 단계 | 무엇을 하나 |
|---|---|
| 사전 준비 | Node, git, 패키지 매니저, Claude Code 설치. 트랙별 테스트 도구는 트랙을 고른 뒤 설치 |
| 내려받기와 설치 | base 받기와 의존성 설치 |
| 첫 실행 | 프로젝트 시작 한 줄로 stage 감지와 진행 방식 결정 |
| 무엇을 테스트할지 정하기 | 내 앱이 웹/데스크톱/모바일 중 무엇인지, 깨지면 치명적인 흐름이 무엇인지 정리 |
| 첫 테스트 한 개 | 핵심 흐름 한 줄이 테스트 한 개가 되는 과정 |
| 실행하고 보고서 읽기 | 테스트를 돌리고 결과를 흐름 언어로 읽기 |
| 자동으로 챙겨주는 안전망 | base가 알아서 돌리는 훅과 자동 검증 게이트 |
| AI가 막혔을 때 | AI 워크플로 자체가 같은 문제에 막힐 때 풀기 |
| 트러블슈팅 | 자주 부딪히는 증상 모음 |
| 베이스 업데이트 받기 | base가 좋아진 부분을 내 사본에 가져오기 |
이미 Playwright나 Maestro가 익숙한 분이라면 전문가용 매뉴얼이 더 짧은 분량으로 같은 base를 설명합니다.
절대 하면 안 되는 한 가지
섹션 제목: “절대 하면 안 되는 한 가지”테스트할 앱을 붙일 때 운영 중인 실제 서비스(운영 환경)와 실제 데이터베이스에는 절대 붙이지 않습니다. 로컬, 스테이징, 또는 테스트 전용 환경에만 붙입니다.
이 한 줄이 이 base에서 가장 중요한 안전 규칙입니다. 테스트는 회원가입을 시도하고, 결제를 누르고, 데이터를 만들고 지웁니다. 그 대상이 실제 사용자가 쓰는 서버라면 진짜 데이터가 오염되고, 진짜 결제가 일어나고, 진짜 계정이 지워질 수 있습니다. 이 규칙은 무엇을 테스트할지 정하기와 자동으로 챙겨주는 안전망에서 한 번 더 짚습니다.
막혔을 때
섹션 제목: “막혔을 때”가장 먼저 볼 곳은 트러블슈팅입니다. 첫 실행에서 흔히 부딪히는 증상은 거의 거기에 정리돼 있습니다.
거기에도 같은 증상이 없으면 에러 메시지를 그대로 복사해서 Claude Code에 붙여 넣고 “이거 어떻게 고쳐?”라고 물어 보세요. 다음에 시도할 만한 방법이 보통 따라옵니다.
AI가 코드가 아니라 워크플로 자체에서 같은 문제에 두 번 막힌다면 그것은 AI가 막혔을 때에서 다루는 영역입니다. 두 페이지가 다루는 막힘이 서로 다릅니다.
라이선스
섹션 제목: “라이선스”이 매뉴얼 본문은 무료로 공개돼 있고, 옆 탭에 두고 따라가시면 됩니다. 실제 base 코드와 .claude/ 전체 구성(에이전트, 스킬, 훅)은 상업 라이선스로 공개합니다. 매뉴얼을 따라가다 “이 자동화가 들어 있는 실제 코드가 어디 있나”가 궁금해지는 시점이 라이선스를 받아 fork 할 때입니다.