ハポソフトの​​ブログへようこそ

AIコーディングアシスタントは​驚異的な​スピードを​約束しますが、​しばしば​プロジェクトの​実際の​アーキテクチャを​無視した​スパゲッティコードを​提供する​ことがあります。​これは​モデルが​独立した​プロンプトに​基づいて​動作する​ため、​複雑な​コードベース全体で​コンテキストを​維持する​ための​構造化された​ワークフローが​欠如している​ことに​起因します。​ Haposoftが​開発した​CafeKitは​Claude Codeに​構造と​説明責任を​もたらす軽量な​ランタイムです。​長い​プロンプトや​手動での​監視に​頼るのではなく、​要件、​コード、​テスト、​ドキュメントが​最初から​最後まで​同期された​状態を​保つ仕様駆動の​ワークフローを​通じて​AIを​ガイドします。​その​結果、​コンテキストの​切り​替えが​少なくなり、​要件の​漏れが​減り、​すべての​リリースに​対する​信頼が​高まる、​より​信頼性の​高い​開発プロセスが​実現します。​ CafeKitとは？​仕様駆動開発の​エンジン CafeKitは​Haposoftが​開発した​軽量な​ランタイムであり、​Claude Codeに​仕様駆動開発​（SDD）を​もたらします。​プロジェクトの​ .claude ディレクトリに​直接インストールする​ことで、​Claudeの​コーディング機能の​上に​構造化された​ワークフローを​追加し、​チームが​コンテキストを​失う​ことなく​要件から​本番環境対応の​コードへと​移行できるようにします。​ CafeKitが​重要である​理由を​理解するには​今日の​AI支援開発が​どのように​行われているかを​見る​価値が​あります。​開発者は​しばしば​プロンプトから​始め、​いく​つかの​コードを​生成し、​いく​つかの​調整を​行い、​次の​タスクへと​移ります。​機能は​動作するかもしれませんが、​要件は​チャット履歴に​埋もれ、​ドキュメントは​古くなり、​最終的な​実装が​元の​意図と​一致しているか​どうかを​完全に​把握している​人は​誰もいません。​ 仕様駆動開発は​仕様を​すべての機能の​起点と​する​ことで​この​問題を​解決します。​コードが​書かれる​前に、​要件、​期待される​動作、​エッジケース、​および​成功基準が​文書化され、​承認されます。​そして、​開発は​その​仕様に​従って​一歩ず​つ​進められ、​実装、​テスト、​ドキュメントが​プロセス全体を​通じて​整合し続けるようにします。​ 続きを​読む：SDDの​記事は​こちら CafeKitは​この​哲学を​AIの​ための​実践的な​ワークフローに​変換する​ツールレイヤーです。​Claudeに​数十の​プロンプトや​プロジェクトルールを​記憶させる​ことに​頼るのではなく、​開発の​すべての​ステージを​ガイドする​一連の​コマンド、​エージェント、​および​自動チェックを​提供します。​機能リクエストは​要件ドキュメントに​なり、​要件は​技術設計に​なり、​設計は​実装が​始まる​前に​検証可能な​タスクに​分解されます。​ この​構造は​AIが​生成した​変更が​複数の​ファイル、​サービス、​または​チームに​またがる​大規模な​プロジェクトで​特に​価値を​発揮します。​品質ゲートを​強制し、​仕様を​コードベースと​同期させ続ける​ことで、​CafeKitは​AI支援開発でしばしば​見られる​「見せかけの​進捗」を​防ぎます。​タスクが​表面的には​完了しているように​見えても、​リグレッションを​引き起こしたり、​既存の​機能を​破壊したり、​元の​要件から​静かに​逸脱したりするのを​防ぎます。​ CafeKitが​AI規律を​自動化する​方​法​（SDD契約の​強制）​ AIが​生成する​コードは​もは​や難しい​部分では​ありません。​本当の​課題は​開発が​進むに​つれて、​コードが​要件、​設計上の​決定、​および​プロジェクト標準に​整合し続ける​ことを​保証する​ことです。​ここで​仕様駆動開発​（SDD）が​価値を​持ち、​CafeKitが​実際に​機能させる​ために​必要な​構造を​提供します。​ なぜAIコーディングワークフローは​崩壊するのか？​ ほとんどの​AIコーディングツールは​できるだけ早く​アウトプットを​生成するように​設計されています。​これは​開発を​加速させる​可能性が​ありますが、​おなじみの​問題も​引き​起こします。​コンテキストが​徐々に​失われていくのです。​ 要件は​チャット履歴に​存在し、​設計上の​決定は​会話中に​散らばり、​ドキュメントは​実装に​追いつけなくなる​ことが​よく​あります。​ これが、​AIを​使用する​際に​多くの​チームが​「仕様の​乖離​（spec drift）」を​経験する​理由です。​機能は​明確な​目標から​始まるかもしれませんが、​複数の​プロンプト、​修正、​および​フォローアップリクエストを​経て、​最終的な​結果が​まだ元の​意図と​一致しているか​どうかを​検証する​ことが​困難に​なります。​プロジェクトが​大きくなればなる​ほど、​この​問題を​管理する​ことは​難しくなります。​ 仕様駆動開発は​仕様を​唯一の​真実の​情報源​（source of truth）と​する​ことで​異なる​アプローチを​取ります。​プロンプトの​履歴に​頼るのではなく、​すべての​要件、​設計上の​決定、​タスク、​および​検証ステップは​承認された​仕様に​紐づけられます。​ Vibe Coding 仕様駆動開発 プロンプトから​始まる​ 承認された​仕様から​始まる​ コンテキストは​チャット履歴に​存在する​ コンテキストは​プロジェクトの​成果物に​存在する​ 小規模な​実験には​高速 複雑な​プロジェクトに​より​スケーラブル ドキュメントは​後で​更新される​ことが​多い​ ドキュメントは​開発と​並行して​進化していく​ 決定の​監査が​困難 すべての​変更は​要件にまで​遡って​追跡可能 CafeKitは​AIを​どのように​軌道に​保つか？​ CafeKitは​Claude Code内で​この​プロセスを​運用化します。​プロジェクトの​ .claude ディレクトリに​インストールされると、​作業が​承認された​仕様に​整合し続ける​ことを​保証するのに​役立つ、​一連の​専門エージェントと​ワークフロールールを​導入します。​ 開発者が​すべての​ステップを​手動で​チェックする​ことに​頼るのではなく、​CafeKitは​ワークフロー全体を​通じて​特定の​責任を​目的に​応じて​構築された​エージェント群に​委任します。​作業を​整合させ続ける​ために​最も​重要な​3つの​エージェントは​以下の​通りです： Tester Agent​（test-runner）​ 事前定義された​テストコマンド、​受け入れ基準、​および​期待される​動作に​対して​実装を​検証します。​ Reviewer Agent​（code-auditor）​ 完了した​作業が​承認された​仕様を​満たし、​プロジェクト標準に​従っているか​どうかを​チェックします。​ Doc-Sync Agent​（docs-keeper）​ 開発の​進行に​合わせて、​ドキュメント、​プロジェクトレコード、​および​仕様を​同期し続けます。​ これらの​チェックは​ワークフロー自体に​組み込まれている​ため、​開発者は​コンテキストを​繰り返し伝えたり、​前提条件を​検証したり、​古い​ドキュメントを​追跡したりする​時間を​減らすことができます。​CCafeKitの​エージェントと​自動チェック​機能が、​開発プロセス全体を​強力に​サポートします。​ コードが​先に​進む前に​何が​起こるのか？​ AIが​生成した​コードは​実際に​出荷​（ship）の​準備が​整うずっと​前に、​完成しているように​見える​ことが​よく​あります。​機能は​クイックレビューでは​動作しているように​見えるかもしれませんが、​エッジケースを​見落としたり、​統合テストに​失敗したり、​ドキュメントが​古いままであったりする​可能性が​あります。​チームが​AIに​より​大きく​依存するようになるに​つれ、​これらの​小さな​ギャップは​より​大きな​メンテナンス問題に​蓄積する​可能性が​あります。​ CafeKitは​コード生成を​ワークフローの​ほんの​1ステップと​して​扱う​ことで​この​問題に​対処します。​タスクが​完了と​みなされる​前に、​実装は​承認された​仕様を​満たし、​必要な​検証チェックに​合格しなければなりません。​ドキュメントの​更新も​プロセスの​一部と​して​強制する​ことができ、​チームは​数週間後に​プロジェクトの​知識を​更新するのではなく、​コードベースと​整合した​状態を​保つことができます。​ 目標は​プロセスの​ために​プロセスを​追加する​ことでは​ありません。​進捗が​生成された​アウトプットではなく、​検証された​成果に​よって​測定される​ワークフローを​作成する​ことです。​これに​より、​チームは​AIが​生成する​ものに​対してより​大きな​信頼を​持つことができ、​作業が​次に​進む前に​必要な​手動での​検証量を​減らすことができます。​ CafeKitワークフロー：Spec to Shipの​6つの​ステップ ほとんどの​AIコーディングセッションは​プロンプトから​始まります。​CafeKitは​仕様から​始まります。​ Claudeに​機能全体を​即興で​推測させるのではなく、​CafeKitは​構造化された​シーケンスを​強制します。​ すべての​ステージは​検証可能な​成果物を​生成し、​コードベースが​スケールしても​コンテキストが​失われないようにします。​ステップ1～5は​既に​実装済みです。​ステップ6​（/hapo:deploy）は​ロードマップ上に​あります。​現時点では​デプロイメントは​ /hapo:devops スキルを​通じて​処理されます。​なお、​/hapo:develop は​すでに​各タスクの​後に​内部品質ゲート​（セルフヒーリングを​伴う​テスト、​仕様レビュー、​コードレビュー）を​実行している​ため、​ステップ3と​4は​QAが​行われる​唯一の​場所ではなく、​より​明示的で​広範な​検証パスである​ことに​注意してください。​ ステージ コマンド 得られる​もの​ Spec /hapo:specs 検証を​伴う​機能契約 Develop /hapo:develop タスクパケットごとの​段階的な​実装 Test /hapo:test 実際の​ビルドシグナルに​よる​検証 Review /hapo:code-review リグレッションおよび​セキュリティチェック Git /hapo:git 安全な​コミットおよび​プッシュワークフロー Deploy /hapo:deploy お使いの​スタックへの​デプロイメントハンドオフ（ロードマップ上）​ ステップ1：/hapo:specs で​機能契約を​作成する​ ここでは​曖昧な​プロダクトアイデアが​厳密な​エンジニアリング契約に​変換されます。​この​コマンドは​機能リクエストを​キャプチャし、​構造化された​スペックワークスペース​（要件、​リサーチ、​設計、​検証可能な​タスクファイル）を、​明示的な​スコープ、​動作、​制約、​および​成功基準とともに​生成します。​ 次に、​/hapo:specs validate を​使用して​スペックを​検証し、​要件が​完全で​あり実装の​準備が​できている​ことを​確認します。​タスクレジストリは​検証ステータスを​追跡し、​すべての​チェックに​合格するまで​AIは​先に​進むことができません。​ ステップ2：/hapo:develop で​一度に​1つの​タスクパケットを​実装する​ スペックステージ中に、​CafeKitは​すでに​承認された​スペックを​アトミックで​独立して​テスト可能な​タスクパケットに​分解しています。​各パケットには​単一の​目的、​明示的な​完了基準、​および​事前定義された​検証コマンドが​あります。​特定の​タスクパケットを​指定して​ /hapo:develop を​実行すると、​Claudeは​その​作業の​正確な​部分だけを​実装します。​それ以上​でも​それ以下でもありません。​これに​より、​コンテキストウィンドウが​いっぱいに​なるに​つれて​AIが​見失うのを​防ぎ、​スコープクリープを​排除し、​AIが​承認された​設計から​逸脱するのを​防ぎます。​ ステップ3：実際の​ビルドおよび​ランタイムシグナルで​検証 /hapo:test 自動品質ゲートを​パスするまで、​実装は​完了とは​みなされません。​/hapo:test を​実行すると、​タスクパケットで​定義された​正確な​検証コマンドが​実行され、​実際の​ビルド出力および​ランタイム動作に​対して​チェックが​行われます。​テストに​失敗したら​どうなるでしょうか？​ワークフローは​即座に​停止します。​AIは​自分の​ミスを​修正し、​先に​進む前に​テストを​再実行しなければなりません。​これに​より、​タスクチェックリスト上では​完了しているように​見えても​実際には​ビルドを​壊していると​いう​「見せかけの​進捗」を​完全に​排除します。​ ステップ4：/hapo:code-review - リグレッションと​セキュリティの​レビュー コードが​メインブランチに​触れる​前に、​CafeKitは​構造化された​レビュープロセスを​強制します。​/hapo:code-review --pending コマンドは​リグレッション、​セキュリティの​脆弱性、​および​アーキテクチャの​不一致を​スキャンする​スペシャリストエージェントを​トリガーします。​これらの​エージェントは​元の​スペックに​対して​実装を​クロスチェックし、​逸脱を​最小限に​抑えます。​レビューの​判定が​肯定的である​場合に​のみ、​作業は​次の​ステージに​進む資格を​得ます。​ ステップ5：/hapo:git - 安全な​コミットと​プッシュ すべての​品質ゲートを​パスすると、​/hapo:git commit コマンドは​クリーンで​検証済みの​コミットを​準備します。​ワークフローの​早い​段階で​更新された​ドキュメントは​コードと​一緒に​コミットされます。​ランタイムは​スペックレジストリと​タスクの​状態が​実際の​実装と​同期している​ことを​保証します。​次に、​/hapo:git push が​作業を​リモートリポジトリに​安全に​転送します。​すべての​コミットは​承認された​スペックと​検証済みの​タスクパケットにまで​遡って​追跡可能です。​ ステップ6：/hapo:deploy - デプロイメントハンドオフに​よる​出荷 最終ステージでは​検証済みの​リリース候補を​お使いの​既存の​デプロイスタックに​ハンドオフします。​Vercel、​AWS、​または​カスタムCI/CDパイプラインを​使用している​場合でも、​/hapo:deploy は​すべての​チェックポイントを​パスした​コードのみが​デプロイメントプロセスに​渡される​ことを​保証します。​ドキュメント、​スペックレジストリ、​および本番コードベースは​常に​整合した​状態に​保たれます。​ CafeKitの​始め方​ CafeKitの​最大の​利点の​一つは​既存の​開発ワークフローに​非常に​簡単に​導入できる​ことです。​フレームワークを​移行したり、​ツールを​置き換えたり、​技術スタックを​刷新したりする​必要は​ありません。​ CafeKitは​Claude Codeと​連携して​動作し、​チームが​すでに​ソフトウェアを​構築している​方​法を​妨げる​ことなく、​仕様駆動開発に​必要な​構造を​追加します。​ CafeKitの​インストール ランタイムを​インストールするには​プロジェクトの​ルートディレクトリに​移動して​次の​コマンドを​実行するだけです： npx @haposoft/cafekit これだけです。​この​1つの​コマンドで、​必要な​スラッシュコマンド、​ワークフローテンプレート、​および​運用ルールを​使用して​ .claude ディレクトリが​プロビジョニングされます。​高度な​設定、​カスタムフック、​および​エッジケースの​処理に​ついて​詳しくは​公式の​「From Zero to CafeKit」​ガイドに​従ってください。​前提条件：Node.js 18以上​および​Claude Codeプロジェクト​（.claude ディレクトリ）。​CafeKitは​ .opencode を​介して​OpenCodeも​サポートしています。​ インストール後、​すぐに​spec-to-shipライフサイクルを​トリガーできます：/hapo:specs → /hapo:develop → /hapo:test → /hapo:code-review → /hapo:git → /hapo:deploy また、​ワークフローには​スペックが​存在する​前に​要件を​探索する​ための​初期ステージコマンドである​ /hapo:question や​ /hapo:brainstorm も​含まれています。​ サポートの​取得 CafeKitは​完全に​スタックに​依存しない​（stack-agnostic）​ため、​Node.jsや​Pythonから​Ruby on Rails、​最新の​フロントエンドフレームワークまで、​すべてを​サポートします。​チームは​分離された​レガシーモジュールや​グリーンフィールドプロジェクトで、​ワークフローを​段階的に​導入できます。​エンジニアリング組織で​大規模な​SDDを​評価しており、​実践的な​実装ガイダンスを​必要と​している​場合は​直接サポートを​利用できます。​CafeKitの​問い​合わせフォームから​技術的な​ウォークスルーを​リクエストするか、​特定の​アーキテクチャに​ついて​議論する​ために​ sale@haposoft.com まで​直接ご連絡ください。​ 結論​：確かな​開発は、​確かな​プロセスから​ 現代の​AIコーディングに​おける​最大の​課題は、もは​やコード生成の​速度では​ありません。​求められているのは、​コンテキストを​維持し、​アーキテクチャとの​整合性を​保ちながら​開発を​進める​ことです。​構造化されていない​プロンプトは、​ロジックの​断片化や​ハルシネーションに​よる​誤った​依存関係を​生み、​結果と​して​技術的負債の​増加に​つながりがちです。​ CafeKitは、​AI支援開発に​構造を​もたらす​ことで、​こうした​課題を​解決します。​AIを​単なる​高性能な​コード補完ツールと​して​使うのではなく、​仕様・実装・テスト・ドキュメントが​一貫して​連携する​開発環境へと​Claude Codeを​進化させます。​ AI支援開発を​試している​段階でも、​チーム全体​へ​安全か​つ着実に​展開したい​場合でも、​CafeKitは​実践的な​スタート地点と​なります。​ 実際の​プロジェクトで​どのように​機能するのか、​ぜひ体験してみませんか。​Haposoftの​デモを​ご予約いただくか、​次回の​機能開発で​CafeKitを​試して、​spec-to-shipワークフローを​ぜひご体感ください。