Bottle Shop End of Trade Web Application

SSOT-RULE-ENGINE-TEMPLATE

Single Source of Truth（SSOT）プロジェクト状態管理、コンテキスト対応のルールエンジン、Model Context Protocol（MCP）統合を組み合わせ、自己組織化して学習する開発環境を実現する、AI 搭載のインテリジェントな開発フレームワークです。

🎯 概要

SSOT-RULE-ENGINE-TEMPLATE は、次の機能を提供して開発ワークフローを変革します。

• 🧠 永続的な AI メモリ：時間とともに成長するナレッジグラフベースのプロジェクト理解
• 📋 一元化された状態管理：すべてのプロジェクト情報に関する単一の信頼できる情報源
• 🎛️ コンテキスト対応の AI 動作：プロジェクトのニーズに適応する動的なルールシステム
• 🔧 高度な AI 機能：推論と分析を強化する専用 MCP サーバー
• 📊 インテリジェントなプロジェクト追跡：進捗の監視とドキュメント作成を自動化
• 📈 高度な分析：リアルタイムのプロジェクト健全性監視とパフォーマンスに関する分析

✨ 主な機能

🏗️ SSOT（単一の信頼できる情報源）システム

• .cursor/CORE/SSOT/ にプロジェクト状態を一元管理
• プロジェクト履歴と進捗を自動追跡
• トリガーシステムによるインテリジェントなワークフローのオーケストレーション
• スナップショット／復元機能によるプロジェクトの移植性

🎯 ルールエンジン

• .mdc ファイルによるコンテキスト対応の AI 動作
• グローバルルールとファイル固有ルールの適用
• ルールの生成とステージングを自動化
• 一貫した開発標準の適用

🚀 MCP 統合

• ナレッジグラフサーバー：エンティティ間の関係に基づく永続的なプロジェクトモデリング
• 逐次的思考サーバー：多段階の推論と問題解決
• ファイルシステムサーバー：強化されたファイルシステム操作と分析

🔄 インテリジェントなワークフロー

• プロジェクトの初期化と分析を自動化
• コードベースの理解とドキュメント作成を効率化
• GitHub への準備とリポジトリの最適化
• 包括的なテストと品質保証

📈 高度な分析システム

• リアルタイムのプロジェクト健全性スコア（0～100）
• ライブビジュアライゼーションを備えたインタラクティブなウェブダッシュボード
• 多次元分析（SSOT、MCP、ルール、プロジェクト構造）
• 優先度に基づく提案を行うインテリジェントな推奨エンジン
• 開発速度の追跡と傾向分析
• システムパフォーマンスの監視と最適化に関する分析

🚀 クイックスタート

前提条件

• Node.js（v16 以降）
• npm または yarn
• AI 機能を備えた Cursor IDE

インストール

新しいプロジェクトの場合

1. Cursor のチャットでプロジェクトを説明し、初期化します。

!!-INIT-.ENGINE-!!

2. MCP サーバーをインストールします。

!!-INSTALL-MCP-!!

3. ナレッジグラフを構築します。

!!-BUILD-KG-!!

既存のプロジェクトの場合

1. 既存のコードベースを分析します。

!!-ADD-.ENGINE-!!

2. MCP サーバーをインストールします。

!!-INSTALL-MCP-!!

3. ナレッジグラフを構築します。

!!-BUILD-KG-!!

🎮 主なコマンド

コマンド	目的	使用するタイミング
!!-INIT-.ENGINE-!!	新しいプロジェクトを初期化します (ダッシュボードを自動起動)	プロジェクトの説明を入力した後
!!-ADD-.ENGINE-!!	既存のプロジェクトに追加します (ダッシュボードを自動起動)	既存のコードベースの場合
!!-INSTALL-MCP-!!	MCP サーバーをインストールします	INIT または ADD の後
!!-BUILD-KG-!!	ナレッジグラフを構築します	MCP のインストール後
!!-LAUNCH-DASHBOARD-!!	ビジュアルルールエンジンを備えた分析ダッシュボードを起動します	いつでも手動でダッシュボードを起動する場合
!!-ANALYZE-PROJECT-!!	包括的なプロジェクト分析を実行します	詳細な健全性スコアを確認する場合
!!-VIEW-DASHBOARD-!!	ブラウザーで分析ダッシュボードを開きます	ダッシュボードにすばやくアクセスする場合
!!-HEALTH-CHECK-!!	システムを簡易評価します	状況をすばやく把握する場合
!!-UPDATE-SSOT-!!	プロジェクト状態を同期します	重要な変更の後
!!-CREATE-PORTABLE-!!	プロジェクトのスナップショットを作成します	バックアップ／転送する場合
!!-LOAD-PORTABLE-!!	プロジェクトのスナップショットを読み込みます	状態を復元する場合
!!-UPDATE-DOCS-!!	ドキュメントを更新します	ドキュメントを同期する場合
!!-PREPARE-GITHUB-!!	GitHub に向けた準備をします	リポジトリをアップロードする前

📁 プロジェクト構成

.cursor/
├── CORE/
│   ├── SSOT/                   # Single Source of Truth files
│   │   ├── .ENGINE             # Central workflow orchestrator
│   │   ├── .INIT               # Project initialization
│   │   ├── .CONTEXT            # High-level overview
│   │   ├── .FACTS              # Technical decisions
│   │   ├── .MEMORY             # Component summaries
│   │   ├── .HISTORY            # Activity log
│   │   ├── .CONTINUE           # Next steps
│   │   └── .PROGRESS           # Task tracking
│   ├── MCP/                    # MCP server implementations
│   │   ├── knowledge-graph/    # Graph database server
│   │   ├── sequentialthinking/ # Reasoning server
│   │   └── filesystem/         # File operations server
│   ├── RULE-ENGINE/            # Generated rules staging
│   ├── MEMORY/                 # Persistent memory storage
│   ├── PROMPTS/                # System prompts
│   ├── ANALYTICS/              # Analytics engine and dashboard
│   │   ├── analytics_engine.py # Project health analysis
│   │   ├── dashboard.py        # Web dashboard with visual rule engine
│   │   ├── startup.py          # Dashboard auto-launch script
│   │   ├── USER-RULES-TEMPLATE.md # Template for easy USER-RULES setup
│   │   └── dashboard/          # Generated dashboard files
│   └── DOCS/                   # Documentation
├── rules/                      # Active rule files
├── mcp.json                    # MCP configuration
└── launch-dashboard.py         # Quick dashboard launcher

🔧 設定

MCP サーバーの設定

このテンプレートには、事前設定済みの MCP サーバーが 3 つ含まれています。

1. Knowledge Graph Server - プロジェクトの永続的なメモリ
2. Sequential Thinking Server - 高度な推論機能
3. Filesystem Server - 強化されたファイル操作

設定はトリガーシステムによって自動的に処理されます。

ルールエンジンの設定

ルールは、フロントマターを含む .mdc ファイルで定義します。

---
description: Rule description
globs: **/*.js, **/*.ts
alwaysApply: false
---

# Rule Content
Your guidelines and instructions...

📊 使用例

Web アプリケーションの開発

# Describe your Flask/Django/Express app, then:
!!-INIT-.ENGINE-!!
!!-INSTALL-MCP-!!
!!-BUILD-KG-!!

既存のコードベースへの統合

# For any existing project:
!!-ADD-.ENGINE-!!
!!-INSTALL-MCP-!!
!!-BUILD-KG-!!

チームでのコラボレーション

# Create portable state for sharing:
!!-CREATE-PORTABLE-!!

# Team member loads state:
!!-LOAD-PORTABLE-!!

プロジェクトの分析とモニタリング

# Quick health assessment:
!!-HEALTH-CHECK-!!

# Comprehensive analysis:
!!-ANALYZE-PROJECT-!!

# Launch interactive dashboard with visual rule engine:
!!-LAUNCH-DASHBOARD-!!

# Open dashboard in browser (if already running):
!!-VIEW-DASHBOARD-!!

# Manual launch options:
python launch-dashboard.py                    # Quick launcher from project root
python .cursor/CORE/ANALYTICS/startup.py     # Direct startup script

ダッシュボードの機能：

• 📊 Analytics Tab：リアルタイムの健全性スコアとプロジェクト指標
• ⚙️ Rule Engine Tab：視覚的なルール管理インターフェース
• 📋 USER-RULES Tab：簡単に設定できるテンプレートのコピー
• 🗂️ SSOT Tab：システム状態のモニタリングとファイルの検査

🎯 メリット

開発者向け

• コンテキストの永続化：AI がセッションをまたいでプロジェクトを記憶します
• インテリジェントな支援：コンテキストを踏まえた提案とコード生成
• ドキュメントの自動化：自動更新されるプロジェクトドキュメント
• 品質保証：一貫したコーディング標準とベストプラクティス

チーム向け

• ナレッジ共有：チームメンバー間でコンテキストを簡単に引き継げます
• オンボーディング：新しい開発者がプロジェクトの構造をすばやく把握できます
• 標準の適用：チーム全体で一貫した開発パターンを維持できます
• 進捗の追跡：包括的なプロジェクト履歴と進捗モニタリング

プロジェクト向け

• 技術的負債の削減：継続的な品質モニタリングと改善
• より良いアーキテクチャ：AI が支援するアーキテクチャ上の意思決定とリファクタリング
• テストの強化：インテリジェントなテスト生成とカバレッジ分析
• ドキュメント：常に最新のプロジェクトドキュメント
• 健全性のモニタリング：リアルタイムのプロジェクト健全性スコアと傾向分析
• パフォーマンスの分析：最適化に向けた実行可能な推奨事項
• ビジュアル分析：プロジェクトを包括的に把握できるインタラクティブなダッシュボード

📈 高度な機能

ナレッジグラフのクエリ

システムは、プロジェクトの包括的なナレッジグラフを構築します。

• エンティティ：ファイル、関数、クラス、モジュール、設定
• 関係：依存関係、呼び出し、実装、包含
• 観測事項：コメント、メトリクス、パターン、意思決定

高度な分析ダッシュボード

リアルタイムのプロジェクトモニタリングと分析：

• 健全性スコア：0〜100 の包括的な尺度によるプロジェクト健全性の評価
• システム分析：SSOT（30%）、MCP（30%）、Rules（25%）、General（15%）の内訳
• インタラクティブな可視化：チャート、グラフ、リアルタイムデータ表示
• インテリジェントな推奨事項：優先度に基づく改善提案
• 開発速度：アクティビティの追跡と生産性指標
• Web インターフェース：自動更新機能を備えたレスポンシブなダッシュボード

# Launch analytics dashboard
cd .cursor/CORE/ANALYTICS
python dashboard.py  # Opens browser automatically

# Generate static reports
python analytics_engine.py  # Creates JSON and Markdown reports

プロジェクトのポータビリティ

プロジェクトの完全なスナップショットを作成、復元できます。

• SSOT の状態を完全に保持
• ナレッジグラフのバックアップと復元
• ルール設定の移行
• 環境をまたいだ互換性

GitHub との統合

リポジトリの準備を自動化します。

• インテリジェントな .gitignore の生成
• ドキュメントの同期
• コード品質チェック
• リリースの準備

🛠️ トラブルシューティング

MCP サーバーの問題

# Check MCP server status
npm run build  # In each MCP server directory

# Restart servers
# Restart Cursor IDE

SSOT の同期

# Update SSOT after major changes
!!-UPDATE-SSOT-!!

# Rebuild Knowledge Graph if needed
!!-BUILD-KG-!!

ルールエンジンの問題

• rules/ ディレクトリ内の .mdc ファイルの構文を確認してください
• グロブパターンが対象のファイルに一致していることを確認してください
• CORE/RULE-ENGINE/ のルールのステージングを確認してください

分析ダッシュボードの問題

# Generate dashboard without starting server
cd .cursor/CORE/ANALYTICS
python dashboard.py --generate-only

# Start dashboard on custom port
python dashboard.py --port 8080 --no-browser

# Run analytics analysis only
python analytics_engine.py

🤝 貢献

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 開発の進捗管理に SSOT システムを使用します
4. !!-UPDATE-DOCS-!! を使用してドキュメントを更新します
5. !!-PREPARE-GITHUB-!! を使用して提出の準備をします
6. プルリクエストを送信します

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

🙏 謝辞

• Model Context Protocol (MCP) - 基盤となるサーバーアーキテクチャに対して
• Cursor AI - 高度な IDE 統合に対して
• Anthropic - 高度な AI 推論機能に対して

📞 サポート

• ドキュメント：DOCS/Comprehensive Documentation.md をご覧ください
• 問題：GitHub Issues から問題を報告してください
• ディスカッション：質問やアイデアには GitHub Discussions をご利用ください

🗺️ ロードマップ

• ビジュアルナレッジグラフエクスプローラー
• 高度な分析とメトリクス
• 人気の開発ツールとの統合
• 多言語サポートの拡充
• クラウドベースのナレッジグラフ同期
• 機械学習ベースのプロジェクト予測
• チームコラボレーション分析
• CI/CD パイプライン統合

---

AI を活用した開発で、今日からよりスマートな構築を始めましょう！ 🚀