첫 단계
Specify는 작은 개발팀을 위한 개발문서 자동화 도구입니다. GitHub의 코드 변경과 관련 문서를 연결하고, 근거가 있는 수정안을 준비합니다.
Specify는 코드 변경을 읽고, 고쳐야 할 개발문서를 찾아, 검토할 수 있는 수정안으로 연결합니다. 문서를 직접 쓸 여력이 없는 작은 팀도 GitHub 저장소를 연결하는 것만으로 코드와 함께 움직이는 개발문서를 유지할 수 있습니다.
Specify를 활용하는 방법은 크게 두 가지이며, 팀의 상황에 따라 함께 사용할 수 있습니다.
| 문서 자동화 | Specify MCP | |
|---|---|---|
| 무엇인가 | GitHub 저장소를 근거로 개발문서를 생성하고, 코드 변경에 맞춰 수정안을 준비하는 워크스페이스 기능 | Claude Code·Codex·Cursor 같은 코딩 에이전트가 팀 워크스페이스의 문서와 맥락을 읽도록 연결하는 MCP 서버 |
| 적합한 용도 | API·아키텍처·온보딩 문서를 코드와 동기화 | 에이전트에 프로젝트 배경을 매번 붙여 넣지 않고 팀 맥락 위에서 작업 |
| 시작하기 | 빠른 시작 | MCP 개요 |
Specify가 하는 일
코드와 문서 연결
GitHub 저장소와 브랜치를 문서 프로젝트에 연결하고, 코드를 근거로 첫 문서를 생성합니다.
근거가 있는 수정안
코드가 바뀌면 영향을 받는 문서를 찾아 변경 이유와 수정 전후를 담은 수정안을 준비합니다.
팀 맥락으로 답변
문서·결정·코드 기록을 근거로 "왜 이렇게 만들었는지", "어디에 있는지"에 답합니다.
새 문서 프로젝트는 자동 반영 없이 시작합니다. 모든 변경은 근거와 함께 수정안으로 먼저 도착하며, 이후 반영 방식은 프로젝트 설정과 적용 정책을 따릅니다.
처음 시작하는 팀을 위한 권장 경로
다음 순서를 따라 워크스페이스 생성부터 팀이 함께 쓰는 개발문서까지 완성해 보세요.
워크스페이스 만들기
가입하고 워크스페이스를 만든 뒤 GitHub 저장소를 연결합니다.
빠른 시작으로 이동문서 프로젝트 만들기문서화할 저장소, 문서 종류, 갱신 방식을 선택해 첫 문서를 생성합니다.
가이드 읽기수정안 검토하기코드 변경으로 준비된 수정안의 근거와 반영 범위를 확인합니다.
검토 흐름 보기코딩 에이전트 연결하기Claude Code나 Codex에서 워크스페이스 문서를 바로 참고하게 합니다.
연결 방법 보기정확한 문서를 만드는 근거
Specify의 AI는 일반 지식으로 문서를 지어내지 않습니다. 쓰기 전에 근거를 검색합니다.
워크스페이스 RAG
워크스페이스의 문서, 업로드한 파일, 연결된 자료를 검색해 우리 팀의 사실을 근거로 답하고 씁니다.
표준 문서 라이브러리IEC 62304·ISO 14971 등 표준 조항을 검색해 인용하며, 근거가 없는 내용은 표시합니다.
작업에 맞는 모델검색·요약은 가벼운 모델로, 문서 작성은 문서 작업에 강한 모델로 고릅니다.
주요 활용 사례
- API·개발 문서 — 엔드포인트, 요청 스키마, 응답 필드가 코드와 어긋나지 않도록 유지합니다. API 문서 최신화를 참고하세요.
- 온보딩 문서 — 저장소 구조와 실행 방법을 근거로 새 팀원이 첫날 실행까지 도달할 수 있는 문서를 만듭니다. 온보딩 문서 생성을 참고하세요.
- 팀 지식 검색 — 문서를 뒤지거나 동료를 붙잡지 않고 팀 맥락을 근거로 답을 얻습니다. AI에게 질문하기를 참고하세요.