사용 가이드
AI에게 시킬 수 있는 일 모음
Specnote를 연결한 AI에게 어떤 일을 말로 시킬 수 있는지, 상황별 예시 문장과 함께 한눈에 정리했어요. 이 문서를 통째로 AI에게 읽혀 두면 더 잘 알아듣습니다.
Specnote를 내 AI에 연결해 두면, 아래 일들을 전부 말 한마디로 시킬 수 있어요. 도구 이름을 외울 필요는 전혀 없습니다 — 하고 싶은 일을 평소 말투로 적으면 AI가 알아서 맞는 도구를 골라 써요.
요령 하나: 이 문서 오른쪽 위의 Markdown 복사를 눌러 통째로 AI에게 붙여넣어 두면, AI가 Specnote로 할 수 있는 일을 더 정확하게 알아듣습니다.
워크스페이스 관리
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "내 Specnote 워크스페이스 목록 보여 줘" | 만들어 둔 워크스페이스를 조회해요 |
| "'우리 쇼핑몰' 워크스페이스 만들어 줘" | 새 워크스페이스를 만들어요 |
| "이 워크스페이스 한 줄 소개를 바꿔 줘" | 제목·소개를 고쳐요 |
테스트 만들기와 다듬기
테스트 만드는 4가지 방법의 네 가지가 전부 여기에 해당해요.
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "회원가입하면 환영 메일 오는지 테스트 만들어 줘" | 한 문장으로 테스트를 만들고, 실제 화면을 둘러보며 단계를 채워요 |
| "이 기획 문서로 테스트 만들어 줘" | 문서를 서비스 지식으로 보관하고, 근거 삼아 테스트 초안을 만들어요 |
| "방금 바꾼 파일들 기준으로 테스트 손봐 줘" | 바뀐 범위만 다시 실측해 테스트를 갱신해요 |
| "코드 보고 어떤 테스트가 필요한지 제안해 줘" | 테스트 후보를 이유와 함께 제안하고, 고른 것만 만들어져요 |
| "이 테스트 이름 바꿔 줘 / 단계 순서 바꿔 줘" | 테스트와 단계를 정리해요 |
| "비슷한 테스트끼리 영역으로 묶어 줘" | 테스트를 영역별로 정리해요 |
검증 묶음 시작하기 — PRD 승인 플로우
새 검증 묶음(회차)은 사람이 승인한 검토안(PRD) 위에서만 시작돼요. AI에게 이렇게 부탁하면 됩니다.
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "이 워크스페이스 검증 묶음 시작해 줘" | 무엇을 어떤 규칙으로 검증할지 기획 검토안(PRD)을 정리해 보여줘요 |
| "이 PRD 승인해 줘" | 내가 명시적으로 시켰을 때만 — 검토안을 대신 승인해 줘요 (결정은 사람 몫) |
| "승인된 PRD로 테스트 제출해 줘" | 승인된 검토안대로 테스트를 제출하고 첫 검증을 자동으로 돌려요 |
검증 돌리기와 결과 읽기
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "이 테스트 검증 돌려 줘" | 실제 브라우저로 검증을 시작해요 |
| "전부 다시 검증해 줘" | 기존 묶음 자리에서 여러 테스트를 다시 검증해 통과율을 갱신해요 |
| "마지막 검증 결과 알려 줘" | 통과·실패와 회차 리포트를 읽어 와요 |
| "실패한 이유 분석해 줘" | 수정 리포트(어디서·왜·어떻게)를 받아 와요 — 그대로 수정까지 이어 시키면 돼요 |
| "이 실패 고칠 방법 제안해 줘" | 실패 원인 기반의 수정 제안을 받아요 |
코드 연결과 동기화
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "지금 코드 Specnote로 보내 줘" | 비밀을 가린 코드를 보내요 (깃허브 미연결이거나 아직 안 올린 코드까지 반영하고 싶을 때) |
| "이번 변경이 어떤 테스트에 영향 주는지 분석해 줘" | 바뀐 부분과 맞닿은 테스트·단계를 짚어 줘요 |
테스트 환경·계정·시크릿
테스트 환경과 계정 설정에서 화면으로 하는 일들을 말로도 할 수 있어요.
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "테스트 환경 등록해 줘. 주소는 ○○○" | 테스트할 사이트 주소를 등록해요 |
| "스테이징을 기본 환경으로 해 줘" | 기본 환경을 바꿔요 |
| "테스트 계정 ○○○ 등록해 줘" | 검증이 로그인할 계정을 등록해요 (즉시 암호화 보관) |
| "이 테스트는 회원으로 검증해 줘" | 테스트의 로그인 여부(회원/방문자)를 정해요 |
CI 자동 검증
CI 자동 검증 연결하기의 연결 작업을 통째로 맡길 수 있어요.
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "이 저장소에 Specnote 자동 검증 연결해 줘" | CI 전용 토큰을 발급하고 워크플로우 파일을 만들어 줘요 |
| "CI 검증 상태 알려 줘" | 최근 CI 검증이 어떻게 됐는지 읽어 와요 |
서비스 지식과 문서
| 이렇게 말해 보세요 | 무슨 일이 일어나요 |
|---|---|
| "이 정책 문서 Specnote에 보관해 줘" | 기획·정책 문서를 워크스페이스의 밑바탕 지식으로 저장해요 |
| "이 서비스가 어떤 서비스인지 정리해 줘" | 코드를 근거로 서비스 설명 초안을 만들어 줘요 |
AI가 못 하는 일 (사람만 하는 결정)
말로 다 시킬 수 있지만, 세 가지만은 사람이 화면에서 직접 정해요. 일부러 그렇게 만들어 두었습니다.
- 검증 검토안(PRD) 승인 — 새 검증 묶음을 시작하기 전에 "무엇을 어떤 규칙으로 검증할지"를 확정하는 승인이에요. 이것만큼은 본인이 AI에게 "승인해 줘"라고 명시적으로 시키면 AI가 대신 눌러 줄 수도 있어요(그래도 결정은 사람 몫이에요).
- 통과 조건 승인 — "무엇을 성공으로 볼지" 확정하는 승인은 사람만 할 수 있어요.
- CI 포함 켜고 끄기 — 배포를 막을 수도 있는 기준이라, 사람만 정해요.
왜 이런 원칙인지는 검증은 어떻게 작동하나요에서 다뤄요. 연결이 아직이라면 내 AI 연결하기 (MCP 설치)부터 시작해 보세요.