Memory Bank MCP Server

{ "schema": "memory_document_v2", "metadata": { "id": "e6a7b9c8-d1f2-4e30-b957-39c8d4f02a15", "title": "言語テンプレートシステム統合リファクタリング計画", "documentType": "refactoring_plan", "path": "integrated-refactoring-plan.json", "tags": [ "refactoring", "design", "i18n", "templates", "integration" ], "lastModified": "2025-03-22T08:15:22.466Z", "createdAt": "2025-03-22T08:15:22.466Z", "version": 1 }, "content": { "overview": { "title": "言語テンプレートシステム統合リファクタリング計画", "description": "言語テンプレートシステムの調査結果に基づき、現在の問題点を解決し、より拡張性と保守性の高いアーキテクチャに刷新するためのリファクタリング計画", "goals": [ "責任の明確な分離によるクリーンアーキテクチャの実現", "テンプレート形式の処理を柔軟に拡張できる設計への改善", "国際化機能の独立性と拡張性の向上", "テストカバレッジの拡大とバグの削減", "新しい言語サポートの追加を容易にする", "ユーザビリティとデバッグのしやすさの向上" ] }, "analysisResults": { "currentSystem": { "description": "現在の言語テンプレートシステムの調査結果", "supportedLanguages": [ "en", "ja", "zh" ], "keyComponents": [ { "name": "I18nProvider", "path": "src/infrastructure/i18n/I18nProvider.ts", "description": "翻訳キーを指定された言語に翻訳する機能を提供、言語ごとの翻訳ファイルを読み込み、管理、プレースホルダーを実際の値に置き換える機能" }, { "name": "TemplateRenderer", "path": "src/infrastructure/templates/TemplateRenderer.ts", "description": "テンプレートを指定された言語でレンダリングする機能を提供、BaseTemplateとJsonTemplateの両方をサポート、セクションのタイトルやコンテンツを翻訳" }, { "name": "JsonTemplateLoader", "path": "src/infrastructure/templates/JsonTemplateLoader.ts", "description": "JSONテンプレートを読み込む機能を提供、言語に応じたテンプレートの取得、レガシーテンプレート（Markdown）へのフォールバック機能" }, { "name": "ReadRulesUseCase", "path": "src/application/usecases/common/ReadRulesUseCase.ts", "description": "指定された言語のルールを読み込む機能を提供、複数のパスからルールファイルを探索、JSONからMarkdownへの変換機能" }, { "name": "ContextController", "path": "src/interface/controllers/ContextController.ts", "description": "ルールと文脈情報を取得するコントローラー、指定された言語のルールを読み込む、ブランチメモリとグローバルメモリの情報を取得" } ], "templateStructure": { "description": "現在のテンプレート構造の例（rules.json）", "example": { "schema": "template_v1", "metadata": { "id": "rules", "titleKey": "template.title.rules", "descriptionKey": "template.description.rules", "type": "system" }, "content": { "sections": [ { "id": "globalMemoryBank", "titleKey": "template.section.global_memory_bank", "contentKey": "template.content.global_memory_bank", "isOptional": false } ] } } }, "translationStructure": { "description": "現在の翻訳ファイル構造の例（ja.json）", "example": { "language": "ja", "translations": { "template.title.rules": "メモリーバンクのルール", "template.description.rules": "メモリーバンクの使用ルールと構造に関する説明", "template.section.global_memory_bank": "グローバルメモリーバンク", "template.content.global_memory_bank": "プロジェクト全体に関わる共通知識を「グローバルメモリーバンク」として管理します。..." } } }, "renderingProcess": [ "テンプレートファイル（例：rules.json）を読み込む", "指定された言語の翻訳ファイル（例：ja.json）を読み込む", "テンプレート内の翻訳キー（例：template.section.global_memory_bank）を翻訳テキストに置き換える", "プレースホルダーがある場合は、実際の値に置き換える", "レンダリングされたコンテンツを返す" ] }, "identifiedIssues": [ { "id": "issue-01", "area": "アーキテクチャ", "description": "JSONとMarkdownの混在により、テンプレート処理のロジックが複雑化している", "impact": "コードの可読性低下、拡張困難、バグ発生リスクの増加" }, { "id": "issue-02", "area": "国際化", "description": "I18nProviderが単一の責任原則に違反し、複数の役割を持っている", "impact": "新言語追加の複雑化、テスト困難、コード変更時の影響範囲大" }, { "id": "issue-03", "area": "テンプレート処理", "description": "テンプレートローダーとレンダラーの責任分担が不明確", "impact": "機能重複、コード変更時の整合性確保困難" }, { "id": "issue-04", "area": "バリデーション", "description": "テンプレートのバリデーションが不十分", "impact": "ランタイムエラーのリスク増加、デバッグ困難" } ] }, "currentArchitecture": { "description": "現在の言語テンプレートシステムの構成", "components": [ { "name": "JsonTemplateLoader", "path": "src/infrastructure/templates/JsonTemplateLoader.ts", "responsibility": "JSONとMarkdown形式のテンプレート読み込みとレンダリングの橋渡し", "issues": [ "JSONとMarkdownの処理が混在している", "レガシーな実装と新しい実装が混在している", "単一責任の原則に違反している" ] }, { "name": "TemplateRenderer", "path": "src/infrastructure/templates/TemplateRenderer.ts", "responsibility": "テンプレートのマークダウンへの変換", "issues": [ "レンダリングロジックが複雑で拡張しにくい", "テンプレート形式に依存した実装", "国際化処理との結合度が高い" ] }, { "name": "I18nProvider", "path": "src/infrastructure/i18n/I18nProvider.ts", "responsibility": "多言語サポートと翻訳機能の提供", "issues": [ "翻訳ファイルの管理が煩雑", "言語追加時の拡張性に制限がある", "テンプレートシステムとの依存関係が強い" ] }, { "name": "テンプレートスキーマ", "path": "src/schemas/v2/template-schema.ts", "responsibility": "テンプレート構造の定義と検証", "issues": [ "バリデーションが不十分", "エラーメッセージが不明確", "スキーマの拡張性に制限がある" ] } ] }, "newArchitecture": { "description": "リファクタリング後の新しいアーキテクチャ", "layers": [ { "name": "ドメイン層", "components": [ { "name": "Template", "path": "src/domain/templates/Template.ts", "description": "テンプレートのドメインモデル（値オブジェクト）", "responsibility": "テンプレートの構造とビジネスルールを定義" }, { "name": "Section", "path": "src/domain/templates/Section.ts", "description": "テンプレートのセクションを表すドメインモデル", "responsibility": "セクションの構造と操作を定義" }, { "name": "ITemplateRepository", "path": "src/domain/templates/ITemplateRepository.ts", "description": "テンプレートリポジトリのインターフェース", "responsibility": "テンプレートの永続化と取得の抽象化" }, { "name": "Translation", "path": "src/domain/i18n/Translation.ts", "description": "翻訳のドメインモデル", "responsibility": "翻訳キーと翻訳テキストの関連付け" }, { "name": "Language", "path": "src/domain/i18n/Language.ts", "description": "言語のドメインモデル", "responsibility": "サポートされる言語の定義と検証" }, { "name": "II18nRepository", "path": "src/domain/i18n/II18nRepository.ts", "description": "国際化リポジトリのインターフェース", "responsibility": "翻訳データの永続化と取得の抽象化" } ] }, { "name": "アプリケーション層", "components": [ { "name": "TemplateService", "path": "src/application/templates/TemplateService.ts", "description": "テンプレート操作のアプリケーションサービス", "responsibility": "テンプレートのビジネスロジックを実装" }, { "name": "TemplateRenderer", "path": "src/application/templates/TemplateRenderer.ts", "description": "テンプレートレンダリングのアプリケーションサービス", "responsibility": "テンプレートの異なる形式への変換" }, { "name": "I18nService", "path": "src/application/i18n/I18nService.ts", "description": "国際化のアプリケーションサービス", "responsibility": "翻訳と言語操作のビジネスロジックを実装" } ] }, { "name": "インフラストラクチャ層", "components": [ { "name": "FileSystemTemplateRepository", "path": "src/infrastructure/templates/FileSystemTemplateRepository.ts", "description": "ファイルシステムベースのテンプレートリポジトリ実装", "responsibility": "ファイルシステムからのテンプレート読み込みと保存" }, { "name": "TemplateFormatStrategy", "path": "src/infrastructure/templates/strategies/TemplateFormatStrategy.ts", "description": "テンプレート形式の戦略インターフェース", "responsibility": "異なるテンプレート形式の処理を抽象化" }, { "name": "JsonTemplateStrategy", "path": "src/infrastructure/templates/strategies/JsonTemplateStrategy.ts", "description": "JSON形式のテンプレート処理戦略", "responsibility": "JSON形式のテンプレートの読み込みと変換" }, { "name": "MarkdownTemplateStrategy", "path": "src/infrastructure/templates/strategies/MarkdownTemplateStrategy.ts", "description": "Markdown形式のテンプレート処理戦略（レガシーサポート）", "responsibility": "Markdown形式のテンプレートの読み込みと変換" }, { "name": "FileSystemI18nRepository", "path": "src/infrastructure/i18n/FileSystemI18nRepository.ts", "description": "ファイルシステムベースの国際化リポジトリ実装", "responsibility": "ファイルシステムからの翻訳データ読み込みと保存" }, { "name": "TranslationFactory", "path": "src/infrastructure/i18n/TranslationFactory.ts", "description": "翻訳ファクトリー", "responsibility": "言語ごとの翻訳リソースの生成" } ] } ] }, "implementationPhases": [ { "phase": 1, "title": "ドメインモデルの実装", "tasks": [ "テンプレートと関連エンティティのドメインモデルを定義", "国際化のドメインモデルを定義", "リポジトリインターフェースを定義" ], "estimatedEffort": "中", "dependencies": [] }, { "phase": 2, "title": "アプリケーションサービスの実装", "tasks": [ "TemplateServiceの実装", "I18nServiceの実装", "新しいTemplateRendererの実装" ], "estimatedEffort": "中", "dependencies": [ 1 ] }, { "phase": 3, "title": "インフラストラクチャ層の実装", "tasks": [ "テンプレート形式の戦略クラスの実装", "ファイルシステムベースのリポジトリ実装", "TranslationFactoryの実装" ], "estimatedEffort": "大", "dependencies": [ 2 ] }, { "phase": 4, "title": "テストとリファクタリング", "tasks": [ "単体テストの追加", "統合テストの追加", "コードレビューとリファクタリング" ], "estimatedEffort": "中", "dependencies": [ 3 ] }, { "phase": 5, "title": "ドキュメントと移行", "tasks": [ "新しいアーキテクチャのドキュメント作成", "既存のテンプレートの移行", "最終テストと検証" ], "estimatedEffort": "小", "dependencies": [ 4 ] } ], "designPatterns": [ { "name": "戦略パターン（Strategy Pattern）", "context": "テンプレート形式ごとに異なる処理ロジックを柔軟に切り替えるため", "implementation": "TemplateFormatStrategyインターフェースと具体的な実装クラス（JsonTemplateStrategy, MarkdownTemplateStrategy）" }, { "name": "ファクトリーパターン（Factory Pattern）", "context": "言語ごとの翻訳リソースを動的に生成するため", "implementation": "TranslationFactoryクラスによる言語依存のリソース生成" }, { "name": "リポジトリパターン（Repository Pattern）", "context": "データの永続化と取得を抽象化し、ドメインモデルとストレージの分離を図るため", "implementation": "ITemplateRepositoryとII18nRepositoryインターフェースとその実装" }, { "name": "アダプタパターン（Adapter Pattern）", "context": "レガシーなコードと新しいコードの間の互換性を確保するため", "implementation": "レガシーAPIをラップする適応クラスの作成" } ], "testingStrategy": { "unitTesting": { "approach": "モックを活用した単体テスト", "frameworks": [ "Jest" ], "keyAreas": [ "ドメインモデルのビジネスロジック", "アプリケーションサービスのユースケース", "戦略パターンの個々の実装" ] }, "integrationTesting": { "approach": "複数コンポーネントを連携させた統合テスト", "frameworks": [ "Jest" ], "keyAreas": [ "ファイルシステムとの連携", "テンプレート処理の全体フロー", "国際化の全体フロー" ] }, "coverageGoals": { "unitTests": "85%以上", "integrationTests": "70%以上", "totalCoverage": "80%以上" } }, "migrationStrategy": { "approach": "段階的なマイグレーション", "steps": [ "新しいアーキテクチャでの基本実装を完了", "レガシーコードと新しいコードの共存期間を設ける", "アダプタを使用して既存のAPIをサポート", "テンプレートの移行を計画的に実施", "完全移行後にレガシーコードを削除" ], "backwardsCompatibility": { "duration": "6ヶ月間", "approach": "アダプタパターンを使用してレガシーAPIをサポート" } }, "risks": [ { "description": "リファクタリングによる既存機能の互換性問題", "mitigation": "詳細なテストケースの作成と段階的なリリース" }, { "description": "複雑な依存関係による予期せぬ副作用", "mitigation": "依存関係の明確な文書化と綿密なコードレビュー" }, { "description": "リファクタリング期間中のリソース競合", "mitigation": "事前の計画と段階的な実装アプローチ" } ] } }