最初のステップ
GitHubから最初の文書を作成し、設計図をレビューして改善内容をコーディングエージェントにつなげます。
GitHubリポジトリから最初のドキュメントを作り、設計図をレビューして改善内容を残しましょう。生成結果は実際の実装と照合して読みます。
準備するもの
- Specifyアカウントとワークスペース
- Specifyに読み取りを許可したGitHubリポジトリ
- GitHubを接続するワークスペース管理者権限
利用できる機能とプランは公式料金ページをご確認ください。
最初のドキュメントを作る
ワークスペースのホームを開く
ログインして使用するワークスペースを選びます。サイドバーのホームを開きます。


リポジトリを選ぶ
GitHubからドキュメントを作成を選びます。初めての場合はGitHubを接続からアクセスを許可するリポジトリを選びます。接続済みなら一覧が表示されます。


ドキュメント作成を開始する
リポジトリを選び、ドキュメントを作成を押します。デフォルトブランチのコードを読む依頼がチャットで始まります。日本語UIでは日本語の文書を依頼します。
保存された結果を確認する
チャットで進行状況を確認し、生成された文書を開きます。ソースパス、主要機能、制限事項をリポジトリと照合します。エラーや質問があれば同じチャットで続けます。
設計図と改善ドキュメントにつなげる
チャットで次のように依頼してみましょう。
このリポジトリの主要な構成要素と呼び出しフローをアーキテクチャキャンバスにしてください。文書のソースパスを根拠にし、追加確認が必要な接続は質問として残してください。
設計図で意図と異なる部分を見つけたら、根拠と期待する動作を改善ドキュメントに整理します。コーディングエージェントがMCPで読み、実際のコードを修正できます。
コード変更時に更新するには、文書とキャンバスをそれぞれリポジトリに接続してください。作成時にリポジトリを使うことと、自動更新の接続は別です。自動更新は接続されたコンテンツを直接編集するので、完了後に編集履歴を確認します。