핵심 용어 한눈에

워크스페이스

Specnote에 무언가를 처음 등록하면 그 단위가 워크스페이스입니다. 검증하려는 서비스나 앱 하나가 워크스페이스 하나예요. 만들고 있는 쇼핑몰, 사내 도구, 주말에 혼자 만드는 사이드 프로젝트 — 그 한 덩어리가 워크스페이스입니다.

한 워크스페이스 안에는 그 서비스의 테스트, 규칙(정책), 테스트할 주소 같은 환경 정보, 그리고 (연결해 두었다면) 실제 코드 정보가 한곳에 모입니다. 흩어져 있는 게 아니라 워크스페이스 하나로 묶여 있어서, 워크스페이스를 지우면 그 안의 모든 것이 같이 정리돼요.

크레딧 사용량도 워크스페이스 단위로 셉니다. 워크스페이스는 요금제와 상관없이 계정당 1개예요 — 다른 서비스를 확인하려면 쓰던 워크스페이스를 정리하고 새로 만듭니다.

영역 · 테스트(시나리오) · 단계

워크스페이스 안의 검증은 세 층으로 나뉩니다. 큰 묶음에서 작은 동작 순서예요.

• 영역 — 비슷한 목적을 가진 테스트를 한데 모은 묶음입니다. 예를 들어 "회원가입·로그인"이 한 영역이고, "장바구니·결제"가 또 다른 영역이에요. 화면에서는 테스트들이 이 영역 아래로 정리됩니다.
• 테스트(시나리오) — 사용자가 앱에서 처음부터 끝까지 완료하는 하나의 흐름입니다. "이메일로 로그인하기" 같은 한 줄짜리 일이에요. 검증은 이 테스트 단위로 돌아갑니다. 제품 안에서는 같은 것을 시나리오라고도 부릅니다.
• 단계 — 테스트 안의 한 동작입니다. "이메일 입력하기", "로그인 버튼 누르기"처럼 사람이 화면에서 하는 행동 하나하나가 단계예요.

이 모든 걸 모아 보는 곳이 **작업실(보드)**입니다. 내 작업 공간이라고 생각하면 돼요. 보드에 들어가면 기본 화면인 대시보드에 영역과 테스트가 정리돼 보입니다. 어떤 영역에 어떤 테스트가 들어 있는지 한눈에 보이죠. 그 옆에는 테스트 실행(검증을 돌리고 이력을 보는 곳), CI(코드 올릴 때마다 자동 검증하는 곳), 테스트 환경(주소·테스트 계정) 같은 탭이 함께 있어요.

같은 화면을 관점으로 바꿔 볼 수도 있어요. 전체, 방문자(로그인 안 한 사람), 회원(로그인한 사람) — 셋 중 하나를 골라 그 입장에서 어떤 흐름이 있는지 따로 볼 수 있습니다.

검증과 결과

검증은 곧 테스트입니다. Specnote가 테스트를 실제 브라우저로 한 번 재생해 보는 일이에요. 사람이 손으로 클릭하듯, 화면을 열고 입력하고 버튼을 누르며 끝까지 따라갑니다.

결과는 다음 세 가지 상태로 표시됩니다.

• 통과 — 테스트가 의도대로 끝까지 잘 돌아갔습니다.
• 실패 — 중간에서 막혔습니다. 몇 번째 단계에서, 어떤 화면에서 멈췄는지도 함께 남아요.
• 검증 중 — 지금 재생하고 있는 상태입니다.

판정은 통과 아니면 실패, 둘 중 하나로만 갈립니다. 애매한 중간 판정은 없어요. 예를 들어 "로그인 버튼을 눌렀는데 다음 화면으로 안 넘어갔다"면 그 테스트는 실패로 남고, 멈춘 지점이 표시됩니다. 그리고 검증을 돌릴 때마다 화면 영상과 단계별 스크린샷이 저장됩니다. 결과 한 줄만 보고 끝나는 게 아니라, "그래서 화면에서 무슨 일이 있었나"를 영상으로 되돌려 볼 수 있어요.

검증은 언제나 하나의 실행 묶음으로 남아요. 테스트 하나만 돌려도, 여러 개를 한꺼번에 돌려도 그 한 번이 실행 묶음 하나(회차)로 쌓입니다. 그래서 "이번 회차에서 뭐가 통과하고 뭐가 막혔는지"를 되짚어 볼 수 있어요. 어떻게 통과·실패를 가르는지는 검증은 어떻게 작동하나요에서 자세히 다룹니다.

검증 묶음은 사람이 승인한 다음에 돌아가요

새로 검증 묶음(회차)을 시작할 때는, AI가 곧바로 검증을 돌리지 않아요. 먼저 **무엇을 어떤 규칙으로 검증할지 정리한 기획 검토안(PRD)**을 실제 코드를 근거로 만들어 옵니다. 그걸 사람이 한 번 승인해야 그 검토안대로 테스트가 제출되고 첫 검증이 자동으로 돌기 시작해요. "무엇을 검증할지"를 사람이 확인한 뒤에만 검증이 시작된다는 원칙이에요 — AI가 마음대로 돌리지 않습니다. (승인은 사람만 할 수 있어요. AI에게 "승인해 줘"라고 시켜도 거부하고 승인 화면 주소만 돌려줍니다.)

단, 이미 있는 묶음을 다시 검증하거나 실패한 것만 재실행하는 일, 그리고 CI로 도는 자동 회귀 검증은 이 승인 없이 그대로 돌아가요. 검토안 승인은 "새 검증 묶음을 처음 시작할 때" 거치는 관문이에요. 테스트를 만들거나 고치는 일 자체는 언제든 할 수 있고, 새로 만든 테스트의 첫 검증만 이 승인 흐름에 실려 돌아갑니다.

통과 조건 승인과 스스로 따라가기

테스트가 "무엇을 성공으로 볼지"를 통과 조건이라고 불러요. Specnote는 이 통과 조건을 마음대로 정하지 않습니다. 사람이 한 번 승인해야 그 테스트가 "이제 이걸 기준으로 봅니다" 하고 확정돼요. AI는 테스트를 만들고 돌릴 수는 있어도, 통과 조건을 승인하는 일만큼은 대신하지 않습니다. 무엇을 합격으로 볼지는 사람이 정한다는 원칙이에요.

한 번 승인해 둔 테스트는 화면이 조금 바뀌어도 스스로 따라갑니다. 버튼 위치가 옮겨지거나 이름이 살짝 달라진 정도면, 테스트가 알아서 그 변화에 맞춰 자기 단계를 고쳐 잡아요(이걸 자동 복구라고 해요). 반대로 "무엇을 확인하려는지"라는 의도 자체가 바뀌면, 그건 다른 테스트로 보고 새 테스트로 갈아 끼웁니다. 이때는 통과 조건을 다시 승인해 달라고 알려 줘요.

그리고 이 도구는 쓸수록 정확해집니다. 검증을 돌릴 때마다 "이 화면의 이 버튼은 여기 있다"는 사실이 기억으로 쌓여서, 다음 검증은 헤매지 않고 더 빠르고 정확하게 진행돼요.

기획과 달라짐(drift)

코드가 처음 기획한 모습과 어긋난 상태를 기획과 달라짐이라고 부릅니다. 영어로는 drift예요.

만드는 동안 코드는 계속 바뀝니다. 버튼 위치가 옮겨지고, 입력 항목이 늘고, 흐름이 바뀌죠. 예컨대 처음엔 이메일만 받기로 했던 회원가입에 어느새 휴대폰 인증이 끼어들 수 있어요. 그러다 보면 "원래 이렇게 하기로 했던" 기획과 실제 화면이 조금씩 벌어집니다. 사람 눈으로는 그 차이를 매번 따라잡기 어려워요.

Specnote는 테스트를 실제 화면에 다시 비춰 봐서 이 어긋남을 찾아 줍니다. 검증이 실패로 떨어졌다면, 그건 대개 기획과 달라짐이 생겼다는 신호예요. 또 승인해 둔 통과 조건과 지금 테스트가 서로 어긋나면 "승인과 조건이 달라졌어요" 하고 짚어 주고, 다시 승인할 수 있게 해 줍니다. 이 어긋남을 빨리 알아채는 것이 Specnote의 핵심입니다.

CI 포함 — 자동 검증에 넣기

만든 테스트 중 "이건 배포 전마다 꼭 통과해야 해" 싶은 것은 CI 포함으로 켜 둘 수 있어요. 이렇게 켠 테스트는 코드를 올릴 때마다 자동으로 검증됩니다. 이 켜고 끄기도 사람만 할 수 있는 결정이에요(AI가 마음대로 넣지 않습니다). 자세한 연결 방법은 CI 자동 검증 연결하기에서 다룹니다.

Backward 검증과 Forward 기획

Specnote를 이해하는 데 도움이 되는 두 개념이 Backward와 Forward입니다. 이건 화면에 있는 버튼이나 켜고 끄는 스위치가 아니라, "지금 어느 방향으로 일하고 있나"를 가리키는 말이에요.

• Backward 검증 — 이미 만들어 둔 코드에서 거꾸로 거슬러 올라가 테스트를 뽑아 검증하는 방향입니다. 이미 돌아가는 앱이 기획대로 작동하는지 확인할 때의 흐름이에요. Specnote의 주된 쓰임이 여기예요.
• Forward 기획 — 테스트에 "이 기능이 왜 있는가"라는 기획 의도를 사람이 채워 넣는 층입니다. 누가, 무엇을, 왜 하는지를 적어 두면 검증의 기준이 더 또렷해져요.

다시 강조하면, 둘 다 개념을 설명하는 말이에요. 화면 어딘가에서 모드를 직접 바꾸는 게 아니라, 작업의 방향을 부르는 이름으로 알아 두면 됩니다.

크레딧과 플랜

크레딧은 AI가 일한 양을 세는 단위입니다. 테스트를 정리하거나 AI가 화면을 분석하는 것처럼 AI가 움직일 때 크레딧이 줄어들어요. (단계가 화면과 맞는지 먼저 대조하는 과정처럼, 크레딧을 쓰지 않는 작업도 있습니다.)

플랜은 세 가지예요.

• 무료 — 가볍게 시작해 보는 플랜.
• Standard — 본격적으로 쓰기 시작할 때.
• Pro — 더 많은 크레딧이 필요할 때.

결제는 Paddle로 안전하게 처리됩니다. 크레딧이 떨어지면 충전할 수 있어요. 크레딧이 어디에 얼마나 쓰이는지, 플랜이 어떻게 다른지는 크레딧과 요금제에서 정리했습니다.

처음 테스트를 만드는 방법이 궁금하다면 테스트 만들기를 보세요.