핵심 용어 한눈에

프로젝트와 Spec

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

화면 곳곳에서 같은 것을 Spec이라고도 부릅니다. 이름이 둘인 이유는 보는 각도가 달라서예요.

• 프로젝트 — "이 서비스 안에서 사용자가 어떤 흐름을 거치나"를 이야기할 때 쓰는 말입니다.
• Spec — 요금·사용량·제한을 따질 때 쓰는 말입니다. 크레딧이 어느 프로젝트에서 쓰였는지, 플랜에서 몇 개까지 만들 수 있는지를 셀 때는 Spec 단위로 셉니다.

한 프로젝트 안에는 시나리오, 테스트할 주소 같은 환경 정보, 그리고 (연결해 두었다면) 실제 코드 정보가 전부 담깁니다. 그래서 프로젝트를 지우면 그 안의 모든 것이 같이 정리돼요.

영역 · 시나리오 · 단계

프로젝트 안의 검증은 세 층으로 나뉩니다. 큰 묶음에서 작은 동작 순서예요.

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

이 모든 걸 모아 보는 곳이 작업실입니다. 내 작업 공간이라고 생각하면 돼요. 보드의 사용자 시나리오 탭을 열면 영역과 시나리오가 가로로 펼쳐진 서비스 지도가 나옵니다. 어떤 영역에 어떤 시나리오가 들어 있는지 한눈에 보이죠.

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

검증과 결과

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

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

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

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

기획과 달라짐(drift)

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

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

Specnote는 시나리오를 실제 화면에 다시 비춰 봐서 이 어긋남을 찾아 줍니다. 검증이 실패로 떨어졌다면, 그건 대개 기획과 달라짐이 생겼다는 신호예요. 이 어긋남을 빨리 알아채는 것이 Specnote의 핵심입니다.

Backward 검증과 Forward 기획

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

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

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

크레딧과 플랜

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

플랜은 세 가지예요.

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

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

처음 시나리오를 만드는 방법이 궁금하다면 시나리오 만들기를 보세요.