비개발자용 시작
이 가이드는 풀타임 개발자가 아닌 분을 위한 안내입니다. 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 하는 자리입니다.