로그인 기능 만들어줘
UC-013 으로 정리했습니다.
Goal: 30초 안에 로그인 Actor: 미로그인 방문자 Steps: 1. /login 접속 2. GitHub 인증 3. /dash 리디렉트
이대로 진행할까요?
COMPATIBLE WITH
당신이 이미 쓰는 코딩 에이전트와 그대로 연결됩니다.
DIAGNOSIS · 진단
바이브코딩이 흔들리는 이유,
기획부터 모호하기 때문입니다.
제대로 개발하려면 구체적인 유스케이스 수준으로 기획 문서를 잡고, 코드를 그 문서와 정확히 일치시키는 과정이 필요합니다.
Vooster는 이 프로세스를 강제하는 도구입니다.
HOW IT WORKS
바이브코딩이 실패하는
3가지 원인을 해결합니다.
-
01 Problem → Fix 기획 자체가 모호한 문제
한국어 자연어로 쓴 기획을 유스케이스 형식으로 구조화해, 이해관계자·목표·시나리오·확장을 1급 필드로 박습니다. 빈칸 자체가 사라지므로, AI가 해석으로 채울 여지가 없습니다.
specs/UC-013.md # UC-013 GitHub OAuth Goal: 30초 안에 로그인 Actor: 미로그인 방문자 Steps: 1. /login 접속 2. GitHub 인증 ... -
02 Problem → Fix 멀티 에이전트 환경에서 스펙이 꼬이는 문제
여러 에이전트가 동시에 작업을 하다보면 문서도, 코드도 꼬이기 쉽습니다. Vooster는 작업중인 기능을 Lock 상태로 전환해서, 다른 에이전트가 침범할 수 없게 만듭니다. 결과적으로 몇십 개의 에이전트도 충돌없이 작업할 수 있게 됩니다.
UC-013 · Lockedclaude-code 작업 중 (45m)cursor 침범 2회 차단 -
03 Problem → Fix Spec 링크와 테스트가 끊기는 문제
시간이 지나면 코드와 spec은 따로 놀게 됩니다. Vooster는 각 step에 연결된 코드/테스트 링크를 CI에서 확인합니다. 링크가 깨졌거나 테스트가 실패하거나 연결 없는 step이 있으면 PR을 통과시키지 않습니다.
traceability drift detectedUC-013 · step 3 link missingPR #214 blocked
NO LEARNING CURVE · 학습 부담 제로
당신이 배울 건
아무것도 없습니다.
AI 에이전트에 한 번만 연동해두고, 평소처럼 프롬프팅하세요. Vooster에 어떤 기능과 명령어가 있는지 하나도 몰라도 됩니다 — 에이전트가 알아서 처리합니다.
평소처럼 한국어로 말합니다
"결제 연동 추가해줘"
복잡한 기획은 에이전트가 알아서 합니다
-
vspec usecase요청을 유스케이스로 구조화 -
vspec lock다른 에이전트의 침범 차단 -
vspec sync코드와 spec 동기화 -
vspec diff코드·spec 어긋남 검증
GET STARTED
내 에이전트가
Spec 전문가가 됩니다.
PM에게 Jira를,
개발자에게 Git을 주는 것과 마찬가지입니다.
같은 에이전트라도 Vooster와 함께라면
훨씬 구체적인 기획을 할 수 있게 됩니다.
- 01 USER
coding agent에 vooster 연결 (프롬프트 붙여넣기)
`npx vspec ai-guide` 가이드대로 이 프로젝트에 vooster를 셋업하고, AGENTS.md 에 "새 기능은 spec 부터" 흐름 적어줘.
- 02 USER
평소처럼 자연어로 요청
💬 Claude Code"로그인 기능 만들어줘"
- 03 AGENT
agent가 spec 구조화 + Lock
💬 agent"UC-013으로 정리했습니다. 이대로 구현할까요?"
- 04 VOOSTER
코드/테스트 링크 검증
UC-013 · links/tests passPR #214 ready
FAQ
시작 전에 자주
묻는 것들.
- 명령어랑 유스케이스 개념을 다 공부해야 쓸 수 있나요?
- 아니요. vspec의 실제 사용자는 사람이 아니라 당신의 AI 에이전트입니다. 명령어 실행도, 유스케이스 작성도 에이전트가 합니다. 당신은 평소처럼 “로그인 만들어줘”라고 말하면, 에이전트가 알아서 spec으로 구조화하고 다음 단계로 이끕니다.
- 어떤 coding agent와 호환되나요?
- CLI 도구라 Claude Code, Cursor, Codex, Aider 등 모든 coding agent와 호환됩니다.
npx vspec ai-guide한 줄로 agent가 vspec 사용법을 셀프 학습합니다. - 내 spec과 코드가 vooster 서버에 올라가나요?
- spec 원본은 항상 당신의 저장소 안의
specs/*.md파일입니다. 클라우드는 동기화·검증용이고, 회사 코드라 부담된다면docker compose로 self-host 할 수 있습니다. - 무료인가요?
- 지금은 모든 기능이 무료입니다. 향후 paid tier를 검토 중이지만, self-host는 계속 무료로 유지합니다.
- spec 쓰는 시간이 오히려 더 걸리지 않나요?
- 아닙니다. agent가 당신의 자연어 요청을 받아 spec으로 자동 구조화합니다. 당신은 평소처럼 채팅으로 “로그인 만들어줘” 하면 끝.