# Specifyの概要 > Specifyは小規模な開発チームのための開発ドキュメント自動化ツールです。GitHubのコード変更と関連ドキュメントをつなぎ、根拠のある修正案を用意します。 Specifyはコード変更を読み取り、更新すべき開発ドキュメントを見つけて、レビューできる修正案につなげます。ドキュメントを書く余裕のない小さなチームでも、GitHubリポジトリを接続するだけで、コードとともに更新される開発ドキュメントを維持できます。 Specifyの活用方法は大きく2つあり、チームの状況に応じて組み合わせて使えます。 | | ドキュメント自動化 | Specify MCP | | --- | --- | --- | | **概要** | GitHubリポジトリを根拠に開発ドキュメントを生成し、コード変更に合わせて修正案を用意するワークスペース機能 | Claude Code・Codex・Cursorなどのコーディングエージェントが、チームのワークスペースのドキュメントと文脈を読めるようにつなぐMCPサーバー | | **適した用途** | API・アーキテクチャ・オンボーディングのドキュメントをコードと同期 | プロジェクトの背景を毎回エージェントに貼り付けることなく、チームの文脈の上で作業 | | **はじめる** | [クイックスタート](/ja/quickstart) | [MCPの概要](/ja/mcp/overview) | ## Specifyができること GitHubリポジトリとブランチをドキュメントプロジェクトに接続し、コードを根拠に最初のドキュメントを生成します。コードが変わると影響を受けるドキュメントを見つけ、変更理由と修正前後を含む修正案を用意します。ドキュメント・意思決定・コードの記録を根拠に、「なぜこう作ったのか」「どこにあるのか」に答えます。新しいドキュメントプロジェクトは自動反映なしで始まります。すべての変更はまず根拠とともに修正案として届き、その後の反映方法はプロジェクト設定と適用ポリシーに従います。 ## はじめて使うチームへのおすすめの進め方次の順序に沿って、ワークスペースの作成からチームで共有する開発ドキュメントの完成まで進めてみてください。登録してワークスペースを作成し、GitHubリポジトリを接続します。ドキュメント化するリポジトリ、ドキュメント種別、更新方式を選択して最初のドキュメントを生成します。コード変更によって用意された修正案の根拠と反映範囲を確認します。 Claude CodeやCodexから、ワークスペースのドキュメントを直接参照できるようにします。 ## 正確なドキュメントを支える根拠 SpecifyのAIは、一般的な知識だけでドキュメントを作り上げることはありません。書く前に根拠を検索します。ワークスペースのドキュメント、アップロードしたファイル、接続された資料を検索し、自分たちのチームの事実を根拠に回答・作成します。 IEC 62304・ISO 14971などの規格の条項を検索して引用し、根拠のない内容には印を付けます。検索・要約には軽量なモデルを、ドキュメント作成にはドキュメント作業に強いモデルを選びます。 ## 主な活用例 - **API・開発ドキュメント** — エンドポイント、リクエストスキーマ、レスポンスフィールドがコードとずれないように維持します。[APIドキュメントを最新に保つ](/ja/guides/api-docs)を参照してください。 - **オンボーディングドキュメント** — リポジトリの構成と実行方法を根拠に、新しいチームメンバーが初日に実行までたどり着けるドキュメントを作成します。[オンボーディングドキュメントの生成](/ja/guides/onboarding-docs)を参照してください。 - **チームのナレッジ検索** — ドキュメントを探し回ったり同僚を呼び止めたりせずに、チームの文脈を根拠に答えを得られます。[AIに質問する](/ja/guides/ask-ai)を参照してください。 ## さらに詳しくサイドバー、タブ、検索、インボックスなどの画面構成を実際の画面で確認します。データの分離と権限の境界を確認します。導入前によく寄せられる質問をまとめました。