VTuber事務所「ホロライブプロダクション」を運営するカバー株式会社が、Claude Codeのカスタムスラッシュコマンドを使って仕様書と実装の同期を自動化する仕組みを構築し、その手法を技術ブログ「COVERedge」で公開しました。

エンタメ企業のイメージが強いカバー株式会社ですが、自社プラットフォーム開発においてAIコーディングツールを実践的に活用しています。「仕様書が古くなる」という開発現場の普遍的な課題に対して、どのようなアプローチを取ったのでしょうか。

この記事でわかること

  • カバー株式会社が構築した仕様書自動同期の仕組み
  • Claude Codeのカスタムスラッシュコマンドの実践的な活用例
  • AIに推測させないための仕様書設計の工夫

カバー株式会社の技術ブログ「COVERedge」とは

仕様書の「鮮度」を保つ仕組みを作った話 | COVERedge
もぐもぐ～おかゆ～！🍙 はじめまして。カバー株式会社コマース本部プラットフォーム部でエンジニアをしているKです。 この記事は、認証統合基盤・ホロライブアカウントの仕様書の「鮮度」を保つため、コーディング支援AIを活用して | COVERed…
coveredge.cover-corp.com

カバー株式会社は、ホロライブプロダクション所属VTuberの配信プラットフォームやコマースサービスなど、自社サービスの開発を内製で行っています。「COVERedge」はそのエンジニアチームが運営する技術ブログで、ホロライブアプリの機能開発やインフラ改善などの記事を公開しています。

今回の記事はコマース本部プラットフォーム部のエンジニアが執筆したもので、2026年4月16日に公開されました。

課題：仕様書は必ず腐る

ソフトウェア開発において「仕様書と実装がズレる」のは古くからある問題です。記事では以下の課題が挙げられています。

  • 実装が進むにつれて仕様書が陳腐化する
  • エッジケースの対応やコードレビューの指摘で、実装が仕様書を追い越す
  • テスト段階で仕様と実装の食い違いがコミュニケーション障害を生む
  • 新メンバーのオンボーディング時に「どこまで信用していいかわからない仕様書」が残る

仕様書を書くこと自体は多くのチームが実践しています。問題はその「鮮度」をどう保つかです。

解決策：Claude Codeのカスタムスラッシュコマンドで自動同期

カバー株式会社のチームは、Claude Codeのカスタムスラッシュコマンドを活用して仕様書管理の仕組みを構築しました。

ドキュメント用のリポジトリ構成

仕様書を体系的に管理するため、以下のディレクトリ構成を採用しています。

  • orientation/ — システム理解のための資料
  • specs/ — 機能仕様
  • reference/ — API一覧・影響範囲マップ
  • test-cases/ — テストケース
  • operations/ — 運用資料
  • .claude/ — AI設定ファイル

4つのスラッシュコマンド

仕様書の鮮度を維持するために、以下の4つのカスタムコマンドを実装しています。

  • /sync-spec — 実装コードと仕様書の差分を検出し、仕様書を修正する
  • /check-consistency — 複数の仕様書間の整合性を確認する
  • /create-spec-issues — 検出した不整合をGitHub Issueとして登録する
  • /create-test-cases — 仕様書からテストケースを自動生成する

特に /sync-spec が中核です。実装ファイルを走査して仕様書との差分を検出し、自動で修正するという流れを、コマンド一つで実行します。

工夫：AIに推測させない仕様書の書き方

技術的に興味深いのは「AIの推測を防止する」ための原則です。

記事では「仕様書にAPI名・関数名・処理順序を記述する際は、必ずソースコードを参照すること」というルールをCLAUDE.mdに明記しています。AIが仕様書の曖昧な記述からコードを「推測」して補完してしまうと、実際の実装と乖離した仕様書が生まれます。これを防ぐために、AIに対して常にソースコードの確認を強制する設計です。

もう一つの工夫は「設計決定」ファイルによる意図的な差異の管理です。仕様と実装が異なっていても、それが意図的な判断である場合があります。これを番号付きで管理することで、差分検出時の誤検知を防いでいます。

副次効果：実装側の考慮漏れも発見

仕様書の同期を自動化した結果、当初想定していなかった効果も得られたと記事は述べています。仕様書と実装を突き合わせる過程で、実装側の考慮漏れが見つかるケースがあったとのことです。

仕様書の更新が目的のツールが、実質的にコードレビューの補助としても機能しているわけです。

導入後の変化

記事では以下の3つの改善が報告されています。

  1. 仕様書の更新サイクルが短縮された — 実装と同期するペースで仕様書が更新されるようになった
  2. テスト効率が向上した — 前提条件のズレが減り、テスト工程がスムーズになった
  3. オンボーディングが改善された — 新メンバーがAIに直接質問でき、常に最新の仕様書を参照できるようになった

VTuber事務所の開発力

ホロライブプロダクションといえばVTuberのライブ配信やイベントが注目されがちですが、その裏側では自社プラットフォームの内製開発が進んでいます。COVERedgeの過去記事を見ると、ボイス投稿機能の技術的な取り組みやホロアースのSREによるオブザーバビリティ改善など、本格的なエンジニアリングの記事が並んでいます。

今回の記事の結論として筆者は「AIが力を発揮できる環境設計がエンジニアの重要な役割」と述べています。AIツールをただ導入するのではなく、AIが正しく動ける仕組み（ディレクトリ設計、ルール設定、誤検知防止）を整えることが重要だという指摘です。

Claude Codeのカスタムスラッシュコマンドを使った仕様書管理に興味がある方は、元記事を読んでみてください。