# クイックスタート

> ワークスペースを作成し、GitHubリポジトリを接続して最初の開発ドキュメントを生成するまでの流れを説明します。

このガイドでは、ワークスペースを作成し、GitHubリポジトリを接続して最初の開発ドキュメントを生成するまでの流れを説明します。最後まで進めると、コードを根拠に作成されたドキュメントが1つと、以降のコード変更を修正案として受け取る準備ができたドキュメントプロジェクトができあがります。

## 準備するもの

- ドキュメント化するコードがある**GitHubリポジトリ** — 個人リポジトリまたは組織リポジトリ
- 組織リポジトリの場合は、**GitHub組織の管理者による承認**を受けられる状態
- ワークスペースでドキュメントプロジェクトを作成できる**編集者以上の権限**（最初にワークスペースを作成した人はオーナーです）
- **プロ・マックス・チーム・エンタープライズ**プラン — ドキュメントプロジェクトは有料プランの機能です。プロ・チームプランは14日間の無料トライアルで始められます。

<Note>
  無料プランでも、ドキュメント作成、AIチャット、[ワークスペースRAG](/ja/knowledge/rag)は利用できます。まず全体を見てみたい場合は、[画面ツアー](/ja/workspace/tour)から始めてください。
</Note>

## 最初のドキュメントを作成する

<Steps>
  <Step title="登録してワークスペースを作成する">
    [specify.app](https://specify.app/ja)で登録し、ワークスペースを作成します。無料プランはクレジットカードなしで始められます。ドキュメントプロジェクトを使うには、プロ以上のプランに変更します（[料金プラン](/ja/resources/plans)を参照）。
  </Step>
  <Step title="プロジェクトの作成を開く">
    サイドバーの**新規（+）**ボタンを押し、**プロジェクトを作成**を選択します。中央に**ドキュメントプロジェクトの設定**タブが開きます。

    <Screenshot name="new-menu" alt="サイドバーの新規メニューに、プロジェクトを作成、新規ドキュメント、新しいチャット、外部ノードを追加が表示された画面" />
  </Step>
  <Step title="GitHubを接続する">
    ソースのステップで**GitHub を接続**を押し、Specifyが読み取るGitHubアカウントとリポジトリへのアクセスを許可します。

    <Screenshot name="project-wizard-source" alt="ドキュメントプロジェクト作成のソースのステップに、GitHub を接続ボタンがある画面" />

    組織リポジトリは、GitHub組織の管理者がリクエストを承認した後に接続されます。承認が完了したら、同じ画面で再接続を押して完了してください。詳しくは[GitHubの接続](/ja/guides/github)を参照してください。
  </Step>
  <Step title="ソースを選択する">
    **GitHub アカウント**を選び、ドキュメント化する**リポジトリ**と**ブランチ**を選択して、**次へ**を押します。このリポジトリとブランチが、以降のすべてのドキュメントと修正案の根拠になります。
  </Step>
  <Step title="ドキュメント種別を選択する">
    **ドキュメント**のステップで、エージェントが最初に作成するドキュメントスキルを選択します。今回の生成で重視したい点があれば、**今回の生成で重視する点 (任意)**に、ドキュメントの読者、強調したい内容、希望する詳しさを書いてください。たとえば「デプロイ手順を中心に」のように書けます。
  </Step>
  <Step title="更新方式を決める">
    同じステップで**リポジトリの変更を自動反映**をオンにすると、選択したブランチにコードが反映されたときにドキュメントの修正案を用意します。毎回ドキュメント全体を再生成するスキルは自動更新に対応しておらず、必要なときに再生成します。
  </Step>
  <Step title="最初のドキュメントの生成を確認する">
    **ドキュメントN種を作成**を押すと、ドキュメントエージェントが選択したドキュメントを作成します。この画面は閉じてもかまいません。**インボックス**が生成タスクを引き続き追跡し、完了、失敗、再試行のオプションを表示します。
  </Step>
</Steps>

<Tip>
  まずはドキュメント1つから始めてみてください。生成されたドキュメントをチームでレビューした後、同じプロジェクトフォルダに別のガイドやリファレンスを追加で生成できます。
</Tip>

## 生成が完了したら

生成されたページにはソースへのリンクが残るため、以降のリポジトリの変更を正確な根拠とともにレビューできます。次のステップに進みましょう。

<CardGroup cols={2}>
  <Card icon="workflow" title="修正案のレビューと反映" href="/ja/guides/review-proposals">コードが変わったときに届く修正案をレビューする方法です。</Card>
  <Card icon="users" title="チームの招待と権限" href="/ja/workspace/members">チームメンバーを招待し、役割を決めます。</Card>
  <Card icon="terminal" title="コーディングエージェントの接続" href="/ja/mcp/connect">Claude Code・Codexからワークスペースのドキュメントを参照できるようにします。</Card>
  <Card icon="message" title="AIに質問する" href="/ja/guides/ask-ai">生成されたドキュメントとコードの文脈を根拠に質問します。</Card>
</CardGroup>

## トラブルシューティング

| 症状 | 確認すること |
| --- | --- |
| リポジトリの一覧が空になっている | 選択したGitHubアカウントに、Specifyへのアクセスを許可したリポジトリがあるか確認します。組織リポジトリには組織の管理者の承認が必要です。 |
| 無料プランでドキュメントの生成が始まらない | ドキュメントプロジェクトはプロ以上のプランで利用できます。[料金プラン](/ja/resources/plans)を確認してください。 |
| ドキュメントプロジェクトを作成できない | 閲覧者の権限では作成できません。編集権限のあるメンバーに依頼してください。ワークスペースへの書き込みがロックされている場合は、サブスクリプションの状態を確認してください。 |
| 生成に時間がかかる | 画面を閉じてもインボックスがタスクを追跡します。完了したらインボックスで結果を確認できます。 |
| 生成の確認が必要と表示される | プロジェクトは保存されています。表示された理由を確認してから、再試行するかソースを変更してください。 |