最初のステップ
Specifyは小規模な開発チームのための開発ドキュメント自動化ツールです。GitHubのコード変更と関連ドキュメントをつなぎ、根拠のある修正案を用意します。
Specifyはコード変更を読み取り、更新すべき開発ドキュメントを見つけて、レビューできる修正案につなげます。ドキュメントを書く余裕のない小さなチームでも、GitHubリポジトリを接続するだけで、コードとともに更新される開発ドキュメントを維持できます。
Specifyの活用方法は大きく2つあり、チームの状況に応じて組み合わせて使えます。
| ドキュメント自動化 | 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に質問するを参照してください。