# Specify 소개

> Specify는 작은 개발팀을 위한 개발문서 자동화 도구입니다. GitHub의 코드 변경과 관련 문서를 연결하고, 근거가 있는 수정안을 준비합니다.

Specify는 코드 변경을 읽고, 고쳐야 할 개발문서를 찾아, 검토할 수 있는 수정안으로 연결합니다. 문서를 직접 쓸 여력이 없는 작은 팀도 GitHub 저장소를 연결하는 것만으로 코드와 함께 움직이는 개발문서를 유지할 수 있습니다.

Specify를 활용하는 방법은 크게 두 가지이며, 팀의 상황에 따라 함께 사용할 수 있습니다.

|  | 문서 자동화 | Specify MCP |
| --- | --- | --- |
| **무엇인가** | GitHub 저장소를 근거로 개발문서를 생성하고, 코드 변경에 맞춰 수정안을 준비하는 워크스페이스 기능 | Claude Code·Codex·Cursor 같은 코딩 에이전트가 팀 워크스페이스의 문서와 맥락을 읽도록 연결하는 MCP 서버 |
| **적합한 용도** | API·아키텍처·온보딩 문서를 코드와 동기화 | 에이전트에 프로젝트 배경을 매번 붙여 넣지 않고 팀 맥락 위에서 작업 |
| **시작하기** | [빠른 시작](/ko/quickstart) | [MCP 개요](/ko/mcp/overview) |

## Specify가 하는 일

<CardGroup cols={3}>
  <Card icon="git" title="코드와 문서 연결">GitHub 저장소와 브랜치를 문서 프로젝트에 연결하고, 코드를 근거로 첫 문서를 생성합니다.</Card>
  <Card icon="pr" title="근거가 있는 수정안">코드가 바뀌면 영향을 받는 문서를 찾아 변경 이유와 수정 전후를 담은 수정안을 준비합니다.</Card>
  <Card icon="message" title="팀 맥락으로 답변">문서·결정·코드 기록을 근거로 "왜 이렇게 만들었는지", "어디에 있는지"에 답합니다.</Card>
</CardGroup>

<Note>
  새 문서 프로젝트는 자동 반영 없이 시작합니다. 모든 변경은 근거와 함께 수정안으로 먼저 도착하며, 이후 반영 방식은 프로젝트 설정과 적용 정책을 따릅니다.
</Note>

## 처음 시작하는 팀을 위한 권장 경로

다음 순서를 따라 워크스페이스 생성부터 팀이 함께 쓰는 개발문서까지 완성해 보세요.

<CardGroup cols={2}>
  <Card icon="rocket" title="워크스페이스 만들기" href="/ko/quickstart" cta="빠른 시작으로 이동">가입하고 워크스페이스를 만든 뒤 GitHub 저장소를 연결합니다.</Card>
  <Card icon="git" title="문서 프로젝트 만들기" href="/ko/guides/doc-projects" cta="가이드 읽기">문서화할 저장소, 문서 종류, 갱신 방식을 선택해 첫 문서를 생성합니다.</Card>
  <Card icon="workflow" title="수정안 검토하기" href="/ko/guides/review-proposals" cta="검토 흐름 보기">코드 변경으로 준비된 수정안의 근거와 반영 범위를 확인합니다.</Card>
  <Card icon="terminal" title="코딩 에이전트 연결하기" href="/ko/mcp/connect" cta="연결 방법 보기">Claude Code나 Codex에서 워크스페이스 문서를 바로 참고하게 합니다.</Card>
</CardGroup>

## 정확한 문서를 만드는 근거

Specify의 AI는 일반 지식으로 문서를 지어내지 않습니다. 쓰기 전에 근거를 검색합니다.

<CardGroup cols={3}>
  <Card icon="search" title="워크스페이스 RAG" href="/ko/knowledge/rag">워크스페이스의 문서, 업로드한 파일, 연결된 자료를 검색해 우리 팀의 사실을 근거로 답하고 씁니다.</Card>
  <Card icon="library" title="표준 문서 라이브러리" href="/ko/knowledge/standards">IEC 62304·ISO 14971 등 표준 조항을 검색해 인용하며, 근거가 없는 내용은 표시합니다.</Card>
  <Card icon="sparkles" title="작업에 맞는 모델" href="/ko/models/choosing">검색·요약은 가벼운 모델로, 문서 작성은 문서 작업에 강한 모델로 고릅니다.</Card>
</CardGroup>

## 주요 활용 사례

- **API·개발 문서** — 엔드포인트, 요청 스키마, 응답 필드가 코드와 어긋나지 않도록 유지합니다. [API 문서 최신화](/ko/guides/api-docs)를 참고하세요.
- **온보딩 문서** — 저장소 구조와 실행 방법을 근거로 새 팀원이 첫날 실행까지 도달할 수 있는 문서를 만듭니다. [온보딩 문서 생성](/ko/guides/onboarding-docs)을 참고하세요.
- **팀 지식 검색** — 문서를 뒤지거나 동료를 붙잡지 않고 팀 맥락을 근거로 답을 얻습니다. [AI에게 질문하기](/ko/guides/ask-ai)를 참고하세요.

## 더 알아보기

<CardGroup cols={3}>
  <Card icon="book" title="화면 둘러보기" href="/ko/workspace/tour">사이드바, 탭, 검색, 인박스 등 화면 구성을 실제 화면으로 익힙니다.</Card>
  <Card icon="shield" title="보안과 데이터" href="/ko/resources/security">데이터 격리와 권한 경계를 확인합니다.</Card>
  <Card icon="help" title="자주 묻는 질문" href="/ko/resources/faq">도입 전에 자주 묻는 질문을 모았습니다.</Card>
</CardGroup>