사용 가이드

AI에게 시킬 수 있는 일 모음

Specnote를 연결한 AI에게 어떤 일을 말로 시킬 수 있는지, 상황별 예시 문장과 함께 한눈에 정리했어요. 이 문서를 통째로 AI에게 읽혀 두면 더 잘 알아듣습니다.

Specnote를 내 AI에 연결해 두면, 아래 일들을 전부 말 한마디로 시킬 수 있어요. 도구 이름을 외울 필요는 전혀 없습니다 — 하고 싶은 일을 평소 말투로 적으면 AI가 알아서 맞는 도구를 골라 써요.

요령 하나: 이 문서 오른쪽 위의 Markdown 복사를 눌러 통째로 AI에게 붙여넣어 두면, AI가 Specnote로 할 수 있는 일을 더 정확하게 알아듣습니다.

워크스페이스 관리

새 테스트는 테스트 만들기의 승인 흐름을 거쳐야 만들어져요. 아래 표의 첫 두 줄 사이에 내가 화면에서 승인하는 자리가 있습니다. 나머지 세 줄은 이미 만든 테스트를 손보는 일이라 승인이 다시 필요하지 않아요.

이렇게 말해 보세요	무슨 일이 일어나요
"회원가입하면 환영 메일 오는지 확인하고 싶어"	무엇을 어떤 규칙으로 확인할지 검토안(PRD)을 정리해 올려요
"승인된 검토안대로 테스트 제출해 줘"	내가 승인한 범위 안의 테스트만 제출하고 첫 검증을 자동으로 돌려요
"이 테스트 단계 다시 만들어 줘"	실제 화면을 둘러보며 단계를 다시 측정해 채워요
"이 테스트 이름 바꿔 줘 / 단계 순서 바꿔 줘"	테스트와 단계를 정리해요
"비슷한 테스트끼리 영역으로 묶어 줘"	테스트를 영역별로 정리해요

새 검증 묶음(회차)은 사람이 승인한 검토안(PRD) 위에서만 시작돼요. AI에게 이렇게 부탁하면 됩니다.

이렇게 말해 보세요	무슨 일이 일어나요
"이 워크스페이스 검증 묶음 시작해 줘"	무엇을 어떤 규칙으로 검증할지 기획 검토안(PRD)을 정리해 보여줘요
"이 PRD 승인해 줘"	AI는 못 해요 — 거부하고 승인 화면 주소를 돌려줘요 (사람이 화면에서)
"승인된 PRD로 테스트 제출해 줘"	승인된 검토안대로 테스트를 제출하고 첫 검증을 자동으로 돌려요

이렇게 말해 보세요	무슨 일이 일어나요
"이 테스트 검증 돌려 줘"	실제 브라우저로 검증을 시작해요
"전부 다시 검증해 줘"	기존 묶음 자리에서 여러 테스트를 다시 검증해 통과율을 갱신해요
"마지막 검증 결과 알려 줘"	통과·실패와 회차 리포트를 읽어 와요
"실패한 이유 분석해 줘"	수정 리포트(어디서·왜·어떻게)를 받아 와요 — 그대로 수정까지 이어 시키면 돼요
"이 실패 고칠 방법 제안해 줘"	실패 원인 기반의 수정 제안을 받아요

이렇게 말해 보세요	무슨 일이 일어나요
"지금 코드 Specnote로 보내 줘"	AI가 비밀을 가린 코드를 직접 보내요 (깃허브 미연결이거나 아직 안 올린 코드까지 반영하고 싶을 때)
"이번 변경이 어떤 테스트에 영향 주는지 분석해 줘"	바뀐 부분과 맞닿은 테스트·단계를 짚어 줘요

테스트 환경과 계정 설정에서 화면으로 하는 일들을 말로도 할 수 있어요.

이렇게 말해 보세요	무슨 일이 일어나요
"이 워크스페이스가 무슨 서비스인지 한 줄로 적어 줘"	한 줄 소개를 채워요 (Specnote가 보관하는 서비스 설명은 이 한 줄뿐이에요)
"이 서비스가 어떤 서비스인지 정리해 줘"	코드를 근거로 서비스 설명 초안을 만들어 줘요

말로 다 시킬 수 있지만, 두 가지만은 사람이 화면에서 직접 정해요. 일부러 그렇게 만들어 두었습니다.

검증 검토안(PRD) 승인 — 새 검증 묶음을 시작하기 전에 "무엇을 어떤 규칙으로 검증할지"를 확정하는 승인이에요. AI에게 "승인해 줘"라고 시켜도 거부하고 승인 화면 주소만 돌려줍니다.
통과 조건 승인 — "무엇을 성공으로 볼지" 확정하는 승인은 사람만 할 수 있어요.

왜 이런 원칙인지는 검증은 어떻게 작동하나요에서 다뤄요. 연결이 아직이라면 내 AI 연결하기 (MCP 설치)부터 시작해 보세요.