moai-workflow-templates

エンタープライズテンプレート管理

コードのボイラープレート、フィードバックテンプレート、プロジェクト最適化ワークフローを統合したテンプレートシステムです。迅速な開発と一貫したパターンの実現を支援します。

クイックリファレンス

主な機能：

• FastAPI、React、Vue、Next.js 用のコードテンプレートライブラリ
• 6 種類の GitHub issue フィードバックテンプレート
• プロジェクトテンプレートの最適化とスマートマージ
• テンプレートのバージョン管理と履歴
• バックアップの検出と復元
• パターンの再利用とカスタマイズ

使用する場面：

• 新しいプロジェクトや機能のスキャフォールディング
• /moai:9-feedback を使用した GitHub issue の作成
• MoAI-ADK の更新後にテンプレート構造を最適化する
• プロジェクトのバックアップから復元する
• テンプレートのバージョンとカスタマイズを管理する
• ボイラープレートコードを生成する

主な機能：

• コードテンプレート：FastAPI、React、Vue、Docker、CI/CD のテンプレート
• フィードバックテンプレート：バグ、機能、改善、リファクタリング、ドキュメント、質問を含む 6 種類の GitHub issue
• テンプレートオプティマイザー：スマートマージ、バックアップ復元、バージョン追跡
• パターンライブラリ：一般的なシナリオ向けの再利用可能なパターン

モジュールへのクイックアクセス：

• コードテンプレートのドキュメント：modules/code-templates.md
• フィードバックテンプレートのドキュメント：modules/feedback-templates.md
• テンプレートオプティマイザーのドキュメント：modules/template-optimizer.md

実装ガイド

機能

• 一般的なアーキテクチャ向けのプロジェクトテンプレート
• ベストプラクティスに基づくボイラープレートコードの生成
• 設定可能なテンプレート変数とカスタマイズ
• React、FastAPI、Spring などの複数のフレームワークに対応
• テストと CI/CD 設定の統合

使用する場面

• 実績のあるアーキテクチャパターンを使って新しいプロジェクトを立ち上げる
• 組織内の複数のプロジェクトで一貫性を確保する
• 適切な構造で新機能を迅速にプロトタイプ化する
• 標準化されたプロジェクト構成で新しい開発者をオンボーディングする
• チームの規約に沿ったマイクロサービスやモジュールを生成する

コアパターン

パターン 1 - テンプレート構造：

テンプレートはディレクトリ階層で整理されています。最上位の templates ディレクトリには、フレームワーク固有のサブディレクトリが含まれます。fastapi-backend などのバックエンドフレームワークのディレクトリには、変数を定義する template.json と、main.py、models サブディレクトリ、tests サブディレクトリを含む src ディレクトリがあります。nextjs-frontend などのフロントエンドフレームワークのディレクトリには、template.json、app ディレクトリ、components ディレクトリがあります。フルスタックテンプレートには、バックエンドとフロントエンドのサブディレクトリが個別に含まれます。

パターン 2 - テンプレート変数：

テンプレート変数は、主に 2 つのセクションからなる JSON 設定ファイルで定義します。variables セクションでは、PROJECT_NAME、AUTHOR、LICENSE、PYTHON_VERSION などのキーと値のペアを定義します。files セクションでは、ファイルパターンを処理モードに対応付けます。substitute として指定されたファイルでは変数が置換され、copy として指定されたファイルは変更せずにコピーされます。

パターン 3 - テンプレート生成：

テンプレート生成プロセスは、次の 5 つの手順で進みます。まず、テンプレートのディレクトリ構造を読み込みます。次に、置換対象として指定されたファイル内の変数を置き換えます。3 番目に、静的ファイルをそのままコピーします。4 番目に、依存関係のインストールや git の初期化などの生成後フックを実行します。最後に、生成されたプロジェクト構造を検証します。

コアパターンの詳細

パターン 1：コードテンプレートのスキャフォールディング

概要：本番環境ですぐに使えるボイラープレートで、プロジェクトを迅速にスキャフォールディングします。

プロジェクトを生成するには、backend/fastapi などの適切なテンプレートを読み込みます。プロジェクト名、認証、データベース、celery などの必要な機能、データベースの種類などのカスタマイズを指定してスキャフォールディングを設定します。スキャフォールディングを実行すると、プロジェクト構造が作成されます。

ライブラリと例の全容については、コードテンプレートモジュールのドキュメントを参照してください。

---

パターン 2：GitHub フィードバックテンプレート

概要：一貫性のある GitHub Issue 作成のための構造化テンプレートです。

6 種類のテンプレート：バグ報告、機能リクエスト、改善、リファクタリング、ドキュメント、質問／ディスカッション。

連携：/moai:9-feedback コマンドによって自動的に起動します。

すべてのテンプレートの種類と使い方については、フィードバックテンプレートのモジュールドキュメントをご覧ください。

---

パターン 3：テンプレートの最適化とスマートマージ

概要：ユーザーのカスタマイズを保持しながら、テンプレートの更新をインテリジェントにマージします。

スマートマージアルゴリズム：3 ウェイマージのプロセスは次のとおりです。まず、バックアップからユーザーのカスタマイズを抽出します。次に、現在のテンプレートから最新のテンプレートのデフォルトを取得します。最後に、適切な優先順位を適用してマージします。template_structure には最新のデフォルトを使用し、user_config ではユーザー設定を保持し、custom_content ではユーザーによる変更を保持します。

ワークフロー全体と例については、テンプレートオプティマイザーのモジュールドキュメントをご覧ください。

---

パターン 4：バックアップの検出と復元

概要：インテリジェントな復元機能を備えた自動バックアップ管理です。

復元プロセス：プロセスは次の 4 つの手順で行います。まず、バックアップ識別子を使用してバックアップメタデータを読み込みます。次に、バックアップの整合性を検証し、破損している場合はエラーを発生させます。3 番目に、検証済みのバックアップからカスタマイズを抽出します。最後に、抽出したカスタマイズを現在のプロジェクトに適用します。

実装の詳細については、テンプレートオプティマイザーモジュールの「復元プロセス」セクションをご覧ください。

---

パターン 5：テンプレートのバージョン管理

概要：テンプレートのバージョンを追跡し、更新履歴を管理します。

バージョン追跡：template_optimization 設定セクションには、last_optimized タイムスタンプ、backup_version 識別子、template_version 番号、および language、team_settings、domains などの項目を含む customizations_preserved リストが格納されます。

実装の詳細については、テンプレートオプティマイザーモジュールの「バージョン追跡」セクションをご覧ください。

---

モジュールリファレンス

コアモジュール

• modules/code-templates.md のコードテンプレート：ボイラープレートライブラリ、スキャフォールドパターン、フレームワークテンプレート
• modules/feedback-templates.md のフィードバックテンプレート：6 種類の GitHub Issue、使用例、ベストプラクティス
• modules/template-optimizer.md のテンプレートオプティマイザー：スマートマージアルゴリズム、バックアップの復元、バージョン管理

モジュールの内容

コードテンプレートには、FastAPI REST API テンプレート、React コンポーネントテンプレート、Docker および CI/CD テンプレート、スキャフォールドパターンを備えたテンプレート変数が含まれます。

フィードバックテンプレートには、バグ報告テンプレート、機能リクエストテンプレート、改善テンプレート、リファクタリングテンプレート、ドキュメントテンプレート、質問テンプレート、および /moai:9-feedback コマンドとの連携が含まれます。

テンプレートオプティマイザーには、6 フェーズの最適化ワークフロー、スマートマージアルゴリズム、バックアップの検出と復元、履歴を含むバージョン追跡が含まれます。

高度なドキュメント

パターンと実装戦略の詳細については、テンプレートライブラリ全体を網羅した「コードテンプレートガイド」、Issue テンプレートのリファレンスである「フィードバックテンプレート」、最適化とマージの戦略を説明する「テンプレートオプティマイザー」をご覧ください。

ベストプラクティス

コア要件

• 一貫性のあるプロジェクト構造にはテンプレートを使用します
• 更新時にユーザーのカスタマイズを保持します
• テンプレートに大きな変更を加える前にバックアップを作成します
• テンプレート構造の規約に従います
• カスタム変更をドキュメント化します
• テンプレートの更新にはスマートマージを使用します
• 設定内でテンプレートのバージョンを追跡します
• 本番環境で使用する前にテンプレートをテストします

品質基準

[HARD] 変更を適用する前に、すべてのテンプレートのデフォルト設定の変更を文書化してください。 理由：テンプレートのデフォルト設定はすべてのプロジェクトの基準となるため、変更を文書化しないと、チーム間で混乱や不整合が生じます。 影響：文書化がないと、チームはデフォルト設定が基準から逸脱している理由を理解できず、保守上の問題や実装の競合につながります。

[HARD] テンプレート最適化ワークフローを実行する前に、バックアップを作成してください。 理由：テンプレートの最適化には構造的な変更が伴い、復元用のクリーンなポイントがないと元に戻すのが難しくなる場合があります。 影響：バックアップがないと、ユーザーによるカスタマイズが永久に失われ、プロジェクト固有の設定を手作業で再構築する必要が生じます。

[HARD] テンプレート更新ワークフロー中に、すべてのマージ競合を解決してください。 理由：未解決の競合があると設定が壊れ、テンプレートが正しく機能しなくなります。 影響：競合を無視すると、実行時エラーや動作の不整合、プロジェクトの不安定化が生じ、緊急の修正が必要になります。

[SOFT] プロジェクト全体でテンプレートパターンの一貫した使用を維持してください。 理由：異なるテンプレートパターンを混在させると認知負荷が増し、コードベースの理解と保守が難しくなります。 影響：パターンに一貫性がないと、コードの予測可能性が下がり、新しいチームメンバーのオンボーディングに時間がかかります。

[HARD] すべてのテンプレート更新を通じて、カスタマイズの履歴を完全に保持してください。 理由：カスタマイズの履歴は、プロジェクト固有の判断を追跡する監査記録となり、以前の状態へのロールバックを可能にします。 影響：履歴が失われると、変更の理由を把握できなくなり、今後の変更について十分な情報に基づいた判断ができなくなります。

[HARD] 本番環境へのデプロイ前に、テストを通じてテンプレートの機能を検証してください。 理由：テストされていないテンプレートには、本番環境で初めて明らかになるエラーが含まれている可能性があり、システム障害につながります。 影響：未テストのテンプレートによる本番環境の障害は、ユーザーに影響するダウンタイムやデータの問題、緊急のロールバックを引き起こします。

[SOFT] 保守性を確保するため、テンプレートの複雑さを妥当な範囲に抑えて設計してください。 理由：テンプレートが過度に複雑だと、問題が発生したときに理解、変更、デバッグするのが難しくなります。 影響：複雑すぎるテンプレートは開発速度を低下させ、カスタマイズ時のエラーの可能性を高めます。

[HARD] 組み込みのバージョン管理システムを使用して、テンプレートのバージョンを追跡してください。 理由：バージョンを追跡すると、テンプレートの進化や互換性を把握でき、更新を調整できます。 影響：バージョンを追跡しないと、チームは利用可能なテンプレート機能を特定できず、プロジェクト間で更新を安全に調整できません。

相性の良い機能

エージェント：

• workflow-project：プロジェクトの初期化
• core-planner：テンプレートの計画
• workflow-spec：SPEC テンプレートの生成

スキル：

• moai-project-config-manager：設定の管理と検証
• moai-cc-configuration：Claude Code 設定の統合
• moai-foundation-specs：SPEC テンプレートの生成
• moai-docs-generation：ドキュメントテンプレートの足場作成
• moai-core-workflow：テンプレート駆動型ワークフロー

コマンド：

• /moai:0-project：テンプレートを使用したプロジェクトの初期化
• /moai:9-feedback：フィードバックテンプレートの選択と課題の作成

ワークフローとの統合

プロジェクト初期化ワークフロー：パターン 1 を使用してコードテンプレートを選択し、プロジェクト構造のひな型を作成してカスタマイズを適用した後、パターン 5 を使用してバージョン追跡を初期化します。

フィードバック送信ワークフロー：/moai:9-feedback コマンドを実行し、パターン 2 を使用して課題の種類を選択し、テンプレートの項目を記入して、GitHub の課題を自動生成します。

テンプレート更新ワークフロー：テンプレートのバージョン変更を検出し、パターン 4 を使用してバックアップを作成し、パターン 3 を使用してスマートマージを実行した後、パターン 5 を使用してバージョン履歴を更新します。

成功指標

• スキャフォールディング時間：新規プロジェクトでは手動の30分に対し、2分
• テンプレート採用率：プロジェクトの95％でテンプレートを使用
• カスタマイズの保持率：更新時にユーザーコンテンツを100％保持
• フィードバックの完全性：GitHub の Issue の95％に必要な情報がすべて記載
• マージ成功率：コンフリクトの99％を自動的に解決

変更履歴

• v3.1.0（2026-01-11）：CLAUDE.md のドキュメント標準に準拠するよう変更し、コードブロックと表を削除
• v3.0.0（2026-01-08）：モジュール式アーキテクチャを採用したメジャーバージョン
• v2.0.0（2025-11-24）：moai-core-code-templates、moai-core-feedback-templates、moai-project-template-optimizer を、5つのコアパターンを備えた単一のスキルに統合
• v1.0.0（2025-11-22）：当初の個別スキル

---

ステータス：本番環境対応（エンタープライズ） モジュール式アーキテクチャ：SKILL.md + 3つのコアモジュール 統合：Plan-Run-Sync ワークフローに最適化 生成元：MoAI-ADK Skill Factory