# Specnote가 뭔가요

> 코드를 직접 읽지 않아도 내가(또는 AI가) 만든 앱이 기획한 대로 움직이는지, 사람처럼 직접 눌러 보며 확인해 주는 도구예요. 어떤 문제를 풀어 주는지, 누구에게 맞는지부터 알려드릴게요.

## 어떤 문제를 풀어 주나요

요즘은 AI한테 "회원가입 화면 만들어 줘"라고 말하면 코드가 뚝딱 나옵니다. 그런데 AI가 "다 됐어요"라고 말한 그 화면이 정말 기획한 대로 움직이는지는 누가 확인할까요.

코드를 읽을 수 있다면 직접 들여다보면 됩니다. 하지만 코드를 못 읽는 기획자나 1인 메이커라면, 결국 매번 직접 가입해 보고, 결제해 보고, 메일이 오는지 확인하는 수밖에 없어요. 기능을 하나 바꿀 때마다 이 과정을 처음부터 다시 반복해야 합니다.

이 확인을 건너뛰면 어떻게 될까요. 보통은 **고객이 먼저 버그를 찾아냅니다.** "결제 버튼이 안 눌려요", "가입했는데 메일이 안 와요" 같은 문의가 들어오고 나서야 문제를 알게 되죠. 만드는 일은 즐겁지만, 확인하는 일은 귀찮고 또 빠뜨리기 쉽습니다.

Specnote는 바로 이 "확인" 단계를 대신해 주는 도구예요. 코드를 직접 읽지 않아도, 내가(또는 AI가) 만든 앱이 기획대로 작동하는지 사람처럼 직접 눌러 보며 확인해 줍니다.

## Specnote는 이렇게 작동해요

핵심은 단순한 세 단계 흐름입니다.

1. **내 AI에게 테스트를 맡깁니다.** Cursor·Claude Code 같은 평소 쓰는 AI 코딩 도구에 Specnote를 한 번 연결해 두고, "회원가입하면 환영 메일이 오는지 테스트 만들어 줘"처럼 말하면 됩니다. AI는 무엇을 어떤 규칙으로 검증할지 검토안을 먼저 만들어 오고, 내가 한 번 승인하면 그대로 테스트가 준비돼요. 테스트 하나는 "이렇게 동작해야 한다"를 단계로 적어 둔 확인 항목(시나리오)이에요.
2. **AI가 사람처럼 눌러봅니다.** 실제 브라우저가 그 테스트대로 가입부터 결제까지 직접 클릭합니다. 화면을 눈으로 보고 버튼을 누르는, 진짜 방문자와 똑같은 방식이에요. 통과하면 초록, 실패하면 빨강으로 결과가 나옵니다.
3. **리포트가 나옵니다.** 문제가 생기면 어디서 멈췄는지, 왜 그런지, 어떻게 고치면 좋을지를 담은 **수정 리포트**가 만들어집니다. 이 리포트를 Cursor나 Claude Code 같은 AI 코딩 도구에 붙여넣으면 바로 수정을 시작할 수 있어요.

여기서 "검증"은 곧 테스트를 뜻합니다. 다만 테스트 코드를 한 줄도 쓸 필요가 없어요. 말로 적은 테스트를 AI가 실제 브라우저에서 대신 눌러 보는 것, 그게 Specnote의 검증입니다.

## 누구에게 맞나요

Specnote는 이런 분들을 위해 만들어졌어요.

- **바이브코딩으로 앱을 만드는 비개발 기획자.** AI에게 코딩을 맡기지만, 결과물이 기획대로인지 직접 확인할 방법이 없던 분.
- **PM·서비스 기획자.** 개발자에게 매번 "이거 확인해 주세요"라고 부탁하기 어려운 분.
- **1인 메이커·창업가.** 만들고 확인하는 일을 혼자 다 해야 해서 시간이 늘 부족한 분.

물론 개발자에게도 쓸모가 있습니다. 테스트 코드를 직접 짜는 대신 말로 테스트를 적어 빠르게 검증하고 싶을 때 편하거든요. 한 줄로 요약하면 이렇습니다.

> 코드는 AI가, 확인은 Specnote가.

## 다른 도구와 뭐가 다른가요

테스트를 자동으로 해 주는 도구는 이미 여럿 있습니다. 대부분은 개발자가 코드나 명령어로 다루도록 만들어져 있어요. Specnote는 세 가지가 다릅니다.

- **내 AI를 통해 말로 만듭니다.** 명령어나 테스트 코드 대신, 평소 쓰는 AI 코딩 도구에 "이거 테스트 만들어 줘"라고 말하면 됩니다. 코드를 못 읽어도 시작할 수 있어요.
- **실제 코드를 읽고 확인합니다.** 원한다면 Specnote를 내 코드(깃허브 저장소)에 연결할 수 있는데, 그러면 AI가 코드 구조를 참고해 더 정확한 테스트를 정리합니다. 화면 겉모습만 보는 게 아니라 실제 만든 내용을 바탕으로 확인하는 거예요. (코드 연결 없이도 시작할 수 있습니다.)
- **바뀌어도 따라갑니다.** 한 번 만든 테스트는 화면이 조금 바뀌면 스스로 맞춰 따라가고, 기획과 어긋나면 알려 줍니다. 그래서 한 번 확인하고 끝나는 게 아니라, 코드가 바뀔 때마다 "이번 변경으로 무엇이 깨질 수 있는지"를 계속 지켜볼 수 있어요.

## 이제 시작해 볼까요

개념은 이 정도면 충분합니다. 직접 해 보는 게 가장 빠르게 이해되니까요.

- 가입부터 첫 검증까지 5분 만에 따라가 보려면 → [5분 만에 첫 검증 받기](/ko/docs/quickstart)
- 테스트·단계·검증 같은 용어를 먼저 정리하고 싶다면 → [핵심 개념](/ko/docs/key-concepts)
- AI가 어떻게 사람처럼 눌러 보는지 더 알고 싶다면 → [검증은 어떻게 작동하나요](/ko/docs/how-verification-works)

가입은 이메일로 30초면 끝나고, 신용카드도 필요 없어요. [무료로 시작하기](/ko/docs/quickstart)부터 가볍게 눌러 보세요.

---

Source: https://specnote.io/ko/docs/what-is-specnote