@nahisaho/katashiro 0.1.4 → 0.1.5

package/AGENTS.md

@@ -1,265 +1,345 @@
 # KATASHIRO - AI Coding Agent Guide
 
-> **AI Coding Agent向け**: このファイルはAIエージェント（GitHub Copilot、Claude等）がKATASHIROライブラリを利用するためのガイドです。
+> **AI Coding Agent向け**: このファイルを読み込んだAIエージェントは、ユーザーの課題を解決するためにKATASHIROライブラリの機能を自動的に活用できます。
 
-## 🎯 KATASHIROでできること
+## 🎯 このガイドの目的
 
-KATASHIROは情報収集・分析・生成のためのTypeScriptライブラリです。
-
-| 機能 | 説明 |
-|------|------|
-| **Web収集** | Webスクレイピング、検索、RSSフィード取得 |
-| **テキスト分析** | キーワード抽出、複雑度分析、構造解析 |
-| **エンティティ抽出** | 人名・組織名・地名などの固有表現抽出 |
-| **レポート生成** | Markdown/HTMLレポート、要約、引用生成 |
-| **知識グラフ** | エンティティ・関係の保存・検索・可視化 |
-| **フィードバック学習** | パターン検出、適応的推薦 |
+ユーザーが自然言語で入力した課題に対して、KATASHIROの機能を適切に組み合わせて解決策を提供します。
 
 ---
 
-## 📦 インストール
+## 📋 課題タイプ別の解決アプローチ
 
-\`\`\`bash
-npm install @nahisaho/katashiro
-\`\`\`
+### 課題タイプの判定
+
+ユーザーの入力から以下のタイプを判定してください：
+
+| 課題タイプ | キーワード例 | 使用する機能 |
+|-----------|-------------|-------------|
+| **調査・リサーチ** | 調べて、検索、情報収集、〜について | Collector → Analyzer → Generator |
+| **分析・解析** | 分析して、解析、キーワード、傾向 | Analyzer |
+| **要約・まとめ** | 要約、まとめて、短くして | Generator (SummaryGenerator) |
+| **レポート作成** | レポート、報告書、文書化 | Generator (ReportGenerator) |
+| **データ抽出** | 抽出、取り出して、リストアップ | Analyzer (EntityExtractor) |
+| **知識管理** | 保存、記録、覚えておいて | Knowledge |
+| **比較・評価** | 比較、評価、どちらが | Collector → Analyzer → Generator |
 
 ---
 
-## 🔧 基本的な使い方
+## 🔄 課題解決ワークフロー
+
+### ステップ1: 課題の分析
+
+```typescript
+// ユーザー入力から課題タイプを判定
+function analyzeProblem(userInput: string): ProblemType {
+  const keywords = {
+    research: ['調べ', '検索', '情報', 'について', '知りたい'],
+    analyze: ['分析', '解析', 'キーワード', '傾向', '特徴'],
+    summarize: ['要約', 'まとめ', '短く', '簡潔'],
+    report: ['レポート', '報告', '文書', 'ドキュメント'],
+    extract: ['抽出', '取り出', 'リスト', '一覧'],
+    knowledge: ['保存', '記録', '覚え', '登録'],
+    compare: ['比較', '評価', 'どちら', '違い'],
+  };
+  // キーワードマッチングで判定
+}
+```
+
+### ステップ2: 必要な機能の選択
 
-### インポート
+課題タイプに応じて以下のクラスを使用：
 
-\`\`\`typescript
+```typescript
 import {
-  // Collector - 情報収集
-  WebScraper,
-  WebSearchClient,
-  FeedReader,
-  ApiClient,
+  // 情報収集（URLや検索クエリがある場合）
+  WebScraper,        // URL指定のページ取得
+  WebSearchClient,   // キーワード検索
+  FeedReader,        // RSSフィード
+  ApiClient,         // API呼び出し
   
-  // Analyzer - テキスト分析
-  TextAnalyzer,
-  EntityExtractor,
-  TopicModeler,
+  // テキスト分析（テキストデータがある場合）
+  TextAnalyzer,      // キーワード・複雑度分析
+  EntityExtractor,   // 人名・組織名抽出
+  TopicModeler,      // トピック分類
+  StructureAnalyzer, // 文書構造解析
+  QualityScorer,     // 品質スコアリング
   
-  // Generator - コンテンツ生成
-  ReportGenerator,
-  SummaryGenerator,
-  CitationGenerator,
+  // コンテンツ生成（出力が必要な場合）
+  ReportGenerator,   // レポート生成
+  SummaryGenerator,  // 要約生成
+  CitationGenerator, // 引用生成
+  TemplateEngine,    // テンプレート処理
   
-  // Knowledge - 知識グラフ
-  KnowledgeGraph,
-  GraphQuery,
-  GraphPersistence,
+  // 知識管理（情報を蓄積・検索する場合）
+  KnowledgeGraph,    // グラフ管理
+  GraphQuery,        // 検索
+  GraphPersistence,  // 永続化
   
-  // Core - ユーティリティ
+  // ユーティリティ
   ok, err, isOk, isErr,
 } from '@nahisaho/katashiro';
-\`\`\`
+```
 
 ---
 
-## 📝 ユースケース別コード例
-
-### 1. Webページの取得と分析
+## 📝 課題タイプ別の実装パターン
 
-\`\`\`typescript
-import { WebScraper, TextAnalyzer, EntityExtractor, isOk } from '@nahisaho/katashiro';
+### パターンA: 調査・リサーチ課題
 
-// Webページを取得
-const scraper = new WebScraper();
-const pageResult = await scraper.scrape('https://example.com/article');
+**ユーザー例**: 「〇〇について調べてまとめて」
 
-if (isOk(pageResult)) {
-  const { content, title } = pageResult.value;
+```typescript
+async function solveResearchProblem(topic: string) {
+  // 1. 情報収集
+  const searchClient = new WebSearchClient();
+  const results = await searchClient.search(topic, { maxResults: 10 });
+  
+  // 2. ページ取得
+  const scraper = new WebScraper();
+  const contents: string[] = [];
+  for (const result of results.slice(0, 5)) {
+    const page = await scraper.scrape(result.url);
+    if (isOk(page)) contents.push(page.value.content);
+  }
   
-  // テキスト分析
+  // 3. 分析
   const analyzer = new TextAnalyzer();
-  const analysis = await analyzer.analyze(content);
-  console.log('Keywords:', analysis.keywords);
-  console.log('Complexity:', analysis.complexity);
+  const analyses = await Promise.all(contents.map(c => analyzer.analyze(c)));
   
-  // エンティティ抽出
+  // 4. エンティティ抽出
   const extractor = new EntityExtractor();
-  const entities = await extractor.extract(content);
-  console.log('People:', entities.filter(e => e.type === 'PERSON'));
-  console.log('Organizations:', entities.filter(e => e.type === 'ORGANIZATION'));
+  const allEntities = [];
+  for (const content of contents) {
+    const entities = await extractor.extract(content);
+    allEntities.push(...entities);
+  }
+  
+  // 5. 要約生成
+  const summarizer = new SummaryGenerator();
+  const summary = await summarizer.generate(contents.join('\n\n'), { maxLength: 500 });
+  
+  // 6. レポート生成
+  const reportGen = new ReportGenerator();
+  const report = await reportGen.generate({
+    title: `${topic} 調査レポート`,
+    sections: [
+      { heading: '概要', content: summary },
+      { heading: 'キーワード', content: analyses.flatMap(a => a.keywords).join(', ') },
+      { heading: '関連エンティティ', content: [...new Set(allEntities.map(e => e.text))].join(', ') },
+      { heading: '参考URL', content: results.map(r => `- ${r.url}`).join('\n') },
+    ],
+    format: 'markdown',
+  });
+  
+  return report;
 }
-\`\`\`
-
-### 2. Web検索と情報収集
+```
 
-\`\`\`typescript
-import { WebSearchClient, WebScraper, isOk } from '@nahisaho/katashiro';
+### パターンB: 分析課題
 
-// 検索実行
-const searchClient = new WebSearchClient({ apiKey: process.env.SEARCH_API_KEY });
-const results = await searchClient.search('TypeScript best practices', { maxResults: 5 });
+**ユーザー例**: 「このテキストを分析して特徴を教えて」
 
-// 上位結果のページを取得
-const scraper = new WebScraper();
-for (const result of results) {
-  const page = await scraper.scrape(result.url);
-  if (isOk(page)) {
-    console.log(\`Title: \${page.value.title}\`);
-    console.log(\`Content: \${page.value.content.slice(0, 200)}...\`);
-  }
+```typescript
+async function solveAnalysisProblem(text: string) {
+  // 1. テキスト分析
+  const analyzer = new TextAnalyzer();
+  const analysis = await analyzer.analyze(text);
+  
+  // 2. 構造分析
+  const structAnalyzer = new StructureAnalyzer();
+  const structure = await structAnalyzer.analyze(text);
+  
+  // 3. エンティティ抽出
+  const extractor = new EntityExtractor();
+  const entities = await extractor.extract(text);
+  
+  // 4. 品質スコアリング
+  const scorer = new QualityScorer();
+  const quality = await scorer.score(text);
+  
+  return {
+    keywords: analysis.keywords,
+    complexity: analysis.complexity,
+    sentiment: analysis.sentiment,
+    structure: structure,
+    entities: entities,
+    qualityScore: quality,
+  };
 }
-\`\`\`
+```
 
-### 3. レポート生成
+### パターンC: 要約課題
 
-\`\`\`typescript
-import { ReportGenerator, SummaryGenerator } from '@nahisaho/katashiro';
+**ユーザー例**: 「この長文を300文字でまとめて」
 
-// 要約生成
-const summarizer = new SummaryGenerator();
-const summary = await summarizer.generate(longText, { maxLength: 300 });
+```typescript
+async function solveSummaryProblem(text: string, maxLength: number = 300) {
+  const summarizer = new SummaryGenerator();
+  const summary = await summarizer.generate(text, { 
+    maxLength,
+    style: 'paragraph' // または 'bullets', 'headline'
+  });
+  return summary;
+}
+```
+
+### パターンD: レポート作成課題
+
+**ユーザー例**: 「分析結果をレポートにまとめて」
+
+```typescript
+async function solveReportProblem(data: any, title: string) {
+  const reportGen = new ReportGenerator();
+  const report = await reportGen.generate({
+    title,
+    sections: [
+      { heading: '概要', content: data.summary },
+      { heading: '詳細分析', content: data.details },
+      { heading: '結論', content: data.conclusion },
+    ],
+    format: 'markdown',
+    metadata: { author: 'KATASHIRO', date: new Date().toISOString() },
+  });
+  return report;
+}
+```
 
-// レポート生成
-const reportGen = new ReportGenerator();
-const report = await reportGen.generate({
-  title: '調査レポート',
-  sections: [
-    { heading: '概要', content: summary },
-    { heading: '詳細分析', content: analysisText },
-    { heading: '結論', content: conclusionText },
-  ],
-  format: 'markdown',
-});
+### パターンE: データ抽出課題
 
-console.log(report);
-\`\`\`
+**ユーザー例**: 「この文章から人名と組織名を抽出して」
 
-### 4. 知識グラフの操作
+```typescript
+async function solveExtractionProblem(text: string, types: string[] = ['PERSON', 'ORGANIZATION']) {
+  const extractor = new EntityExtractor();
+  const entities = await extractor.extract(text);
+  
+  const filtered = entities.filter(e => types.includes(e.type));
+  const grouped = types.reduce((acc, type) => {
+    acc[type] = filtered.filter(e => e.type === type).map(e => e.text);
+    return acc;
+  }, {} as Record<string, string[]>);
+  
+  return grouped;
+}
+```
 
-\`\`\`typescript
-import { KnowledgeGraph, GraphQuery, GraphPersistence } from '@nahisaho/katashiro';
+### パターンF: 知識管理課題
 
-// 知識グラフを作成
-const kg = new KnowledgeGraph();
+**ユーザー例**: 「この情報を保存しておいて」「〇〇に関連する情報を探して」
 
-// ノードを追加
-kg.addNode({ id: 'company-1', type: 'Organization', properties: { name: 'TechCorp' } });
-kg.addNode({ id: 'person-1', type: 'Person', properties: { name: '山田太郎' } });
+```typescript
+async function solveKnowledgeProblem(action: 'save' | 'search', data: any) {
+  const kg = new KnowledgeGraph();
+  const persistence = new GraphPersistence();
+  
+  // 既存のグラフを読み込み
+  try {
+    const loaded = await persistence.load('./knowledge-graph.json');
+    Object.assign(kg, loaded);
+  } catch { /* 新規作成 */ }
+  
+  if (action === 'save') {
+    // エンティティを抽出してノード追加
+    const extractor = new EntityExtractor();
+    const entities = await extractor.extract(data.text);
+    
+    for (const entity of entities) {
+      kg.addNode({
+        id: `entity-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+        type: entity.type,
+        properties: { name: entity.text, source: data.source },
+      });
+    }
+    
+    await persistence.save(kg, './knowledge-graph.json');
+    return { saved: entities.length };
+  } else {
+    // 検索
+    const query = new GraphQuery(kg);
+    const results = query.search(data.query);
+    return results;
+  }
+}
+```
 
-// エッジ（関係）を追加
-kg.addEdge({ source: 'person-1', target: 'company-1', type: 'WORKS_FOR' });
+### パターンG: 比較・評価課題
 
-// クエリ実行
-const query = new GraphQuery(kg);
-const employees = query.findByRelation('company-1', 'WORKS_FOR', 'incoming');
+**ユーザー例**: 「AとBを比較して」
 
-// 永続化
-const persistence = new GraphPersistence();
-await persistence.save(kg, './knowledge-graph.json');
+```typescript
+async function solveComparisonProblem(itemA: string, itemB: string) {
+  const searchClient = new WebSearchClient();
+  const scraper = new WebScraper();
+  const analyzer = new TextAnalyzer();
+  
+  // 両方の情報を収集
+  const [resultsA, resultsB] = await Promise.all([
+    searchClient.search(itemA, { maxResults: 5 }),
+    searchClient.search(itemB, { maxResults: 5 }),
+  ]);
+  
+  // 分析
+  const analysisA = await analyzeResults(resultsA, scraper, analyzer);
+  const analysisB = await analyzeResults(resultsB, scraper, analyzer);
+  
+  // 比較レポート生成
+  const reportGen = new ReportGenerator();
+  return reportGen.generate({
+    title: `${itemA} vs ${itemB} 比較レポート`,
+    sections: [
+      { heading: itemA, content: formatAnalysis(analysisA) },
+      { heading: itemB, content: formatAnalysis(analysisB) },
+      { heading: '比較まとめ', content: generateComparison(analysisA, analysisB) },
+    ],
+    format: 'markdown',
+  });
+}
+```
 
-// 読み込み
-const loadedKg = await persistence.load('./knowledge-graph.json');
-\`\`\`
+---
 
-### 5. RSSフィードの購読
+## 🚀 統合ソルバー
 
-\`\`\`typescript
-import { FeedReader, isOk } from '@nahisaho/katashiro';
+ユーザーの課題を自動判定して解決：
 
-const reader = new FeedReader();
-const feed = await reader.read('https://blog.example.com/rss.xml');
+```typescript
+import * as katashiro from '@nahisaho/katashiro';
 
-if (isOk(feed)) {
-  for (const item of feed.value.items) {
-    console.log(\`\${item.title} - \${item.pubDate}\`);
-    console.log(\`  \${item.description}\`);
+async function solveProblem(userInput: string, context?: any) {
+  // 課題タイプを判定
+  const problemType = detectProblemType(userInput);
+  
+  switch (problemType) {
+    case 'research':
+      return solveResearchProblem(extractTopic(userInput));
+    case 'analyze':
+      return solveAnalysisProblem(context?.text || userInput);
+    case 'summarize':
+      return solveSummaryProblem(context?.text || userInput, extractMaxLength(userInput));
+    case 'report':
+      return solveReportProblem(context?.data, extractTitle(userInput));
+    case 'extract':
+      return solveExtractionProblem(context?.text || userInput, extractEntityTypes(userInput));
+    case 'knowledge':
+      return solveKnowledgeProblem(detectKnowledgeAction(userInput), context);
+    case 'compare':
+      const [itemA, itemB] = extractComparisonItems(userInput);
+      return solveComparisonProblem(itemA, itemB);
+    default:
+      // 汎用的なリサーチとして処理
+      return solveResearchProblem(userInput);
   }
 }
-\`\`\`
-
-### 6. 引用生成
-
-\`\`\`typescript
-import { CitationGenerator } from '@nahisaho/katashiro';
-
-const citationGen = new CitationGenerator();
-const citation = citationGen.generate({
-  title: 'TypeScript Best Practices',
-  author: 'John Doe',
-  url: 'https://example.com/article',
-  date: '2026-01-10',
-}, { style: 'APA' });
-
-console.log(citation);
-// Doe, J. (2026). TypeScript Best Practices. Retrieved from https://example.com/article
-\`\`\`
-
----
-
-## 📚 モジュール一覧
-
-### Collector（情報収集）
-
-| クラス | 機能 |
-|--------|------|
-| \`WebScraper\` | Webページのスクレイピング |
-| \`WebSearchClient\` | Web検索API連携 |
-| \`FeedReader\` | RSS/Atomフィード読み込み |
-| \`ApiClient\` | REST API呼び出し |
-| \`MediaExtractor\` | 画像・動画URL抽出 |
-| \`YouTubeTranscript\` | YouTube字幕取得 |
-
-### Analyzer（テキスト分析）
-
-| クラス | 機能 |
-|--------|------|
-| \`TextAnalyzer\` | キーワード・複雑度・感情分析 |
-| \`EntityExtractor\` | 固有表現抽出（人名・組織名・地名） |
-| \`TopicModeler\` | トピック分類 |
-| \`StructureAnalyzer\` | 文書構造解析 |
-| \`RelationAnalyzer\` | エンティティ間関係分析 |
-| \`QualityScorer\` | テキスト品質スコアリング |
-
-### Generator（コンテンツ生成）
-
-| クラス | 機能 |
-|--------|------|
-| \`ReportGenerator\` | Markdown/HTMLレポート生成 |
-| \`SummaryGenerator\` | テキスト要約 |
-| \`CitationGenerator\` | 引用生成（APA/MLA/Chicago） |
-| \`PresentationGenerator\` | プレゼン資料生成 |
-| \`TemplateEngine\` | テンプレートベース生成 |
-| \`ExportService\` | 各種フォーマットへのエクスポート |
-
-### Knowledge（知識グラフ）
-
-| クラス | 機能 |
-|--------|------|
-| \`KnowledgeGraph\` | グラフ構造の管理 |
-| \`GraphQuery\` | グラフ検索・クエリ |
-| \`GraphPersistence\` | JSON/SQLite永続化 |
-| \`GraphSync\` | グラフ同期 |
-| \`GraphVisualization\` | D3.js/Mermaid可視化 |
-
-### Core（ユーティリティ）
-
-| 関数/クラス | 機能 |
-|-------------|------|
-| \`ok()\`, \`err()\` | Result型の生成 |
-| \`isOk()\`, \`isErr()\` | Result型の判定 |
-| \`Logger\` | ログ出力 |
-| \`generateId()\` | ユニークID生成 |
+```
 
 ---
 
-## 🏗️ プロジェクト構造
+## 📦 インストール
 
-\`\`\`
-@nahisaho/katashiro
-├── Collector    # 情報収集モジュール
-├── Analyzer     # テキスト分析モジュール
-├── Generator    # コンテンツ生成モジュール
-├── Knowledge    # 知識グラフモジュール
-├── Feedback     # フィードバック学習モジュール
-└── Core         # ユーティリティ
-\`\`\`
+```bash
+npm install @nahisaho/katashiro
+```
 
 ---
 
@@ -273,4 +353,4 @@ console.log(citation);
 **Project**: KATASHIRO
 **npm**: @nahisaho/katashiro
 **Last Updated**: 2026-01-10
-**Version**: 0.1.3
+**Version**: 0.1.5

package/CLAUDE.md

@@ -1,200 +1,267 @@
-# KATASHIRO - Claude向けガイド
+# KATASHIRO - Claude向け課題解決ガイド
 
-> このファイルはClaude（Claude Code、Claude Desktop等）向けのKATASHIROライブラリ利用ガイドです。
+> このファイルを読み込んだClaudeは、ユーザーの課題を解決するためにKATASHIROライブラリの機能を自動的に活用できます。
 
-## 🎯 概要
+## 🎯 基本動作
 
-KATASHIROは情報収集・分析・生成のためのTypeScriptライブラリです。
-ユーザーからの調査・分析リクエストに対して、適切なモジュールを使用してタスクを実行できます。
+**ユーザーが課題を入力したら、以下の手順で解決してください：**
+
+1. 課題タイプを判定
+2. 適切なKATASHIRO機能を選択
+3. コードを生成して実行
+4. 結果をユーザーに提示
 
 ---
 
-## 📦 インストール
+## 📋 課題タイプ判定表
+
+| ユーザーの言葉 | 課題タイプ | 使用機能 |
+|---------------|-----------|----------|
+| 「〜について調べて」「検索して」「情報を集めて」 | 調査 | WebSearchClient → WebScraper → TextAnalyzer → ReportGenerator |
+| 「このテキストを分析して」「特徴を教えて」 | 分析 | TextAnalyzer + EntityExtractor + StructureAnalyzer |
+| 「要約して」「まとめて」「短くして」 | 要約 | SummaryGenerator |
+| 「レポートを作成して」「報告書にして」 | レポート | ReportGenerator |
+| 「人名を抽出して」「組織名を取り出して」 | 抽出 | EntityExtractor |
+| 「保存して」「覚えておいて」「記録して」 | 保存 | KnowledgeGraph + GraphPersistence |
+| 「〜を探して」「検索して」（保存済みデータ） | 検索 | GraphQuery |
+| 「AとBを比較して」「違いを教えて」 | 比較 | 複合（調査×2 → 分析 → レポート） |
+| 「このURLの内容を取得して」 | 取得 | WebScraper |
+| 「RSSフィードを読んで」 | フィード | FeedReader |
 
-```bash
-npm install @nahisaho/katashiro
+---
+
+## 🔧 機能別クイックリファレンス
+
+### 情報収集
+
+```typescript
+import { WebScraper, WebSearchClient, FeedReader } from '@nahisaho/katashiro';
+
+// URL取得
+const scraper = new WebScraper();
+const page = await scraper.scrape('https://example.com');
+
+// Web検索
+const search = new WebSearchClient();
+const results = await search.search('キーワード', { maxResults: 10 });
+
+// RSSフィード
+const reader = new FeedReader();
+const feed = await reader.read('https://example.com/rss.xml');
 ```
 
----
+### テキスト分析
+
+```typescript
+import { TextAnalyzer, EntityExtractor, TopicModeler, StructureAnalyzer, QualityScorer } from '@nahisaho/katashiro';
+
+// 基本分析
+const analyzer = new TextAnalyzer();
+const { keywords, complexity, sentiment } = await analyzer.analyze(text);
+
+// エンティティ抽出
+const extractor = new EntityExtractor();
+const entities = await extractor.extract(text);
+// entities: [{ type: 'PERSON', text: '山田太郎' }, { type: 'ORGANIZATION', text: '〇〇株式会社' }]
+
+// トピック分析
+const modeler = new TopicModeler();
+const topics = await modeler.model(documents, { numTopics: 5 });
+
+// 構造分析
+const structAnalyzer = new StructureAnalyzer();
+const structure = await structAnalyzer.analyze(text);
 
-## 🔧 モジュール対応表
-
-| ユーザーのリクエスト | 使用するモジュール | クラス |
-|---------------------|-------------------|--------|
-| 「URLの内容を取得して」 | Collector | `WebScraper` |
-| 「〜について検索して」 | Collector | `WebSearchClient` |
-| 「RSSフィードを読んで」 | Collector | `FeedReader` |
-| 「テキストを分析して」 | Analyzer | `TextAnalyzer` |
-| 「人名・組織名を抽出して」 | Analyzer | `EntityExtractor` |
-| 「トピックを分類して」 | Analyzer | `TopicModeler` |
-| 「レポートを作成して」 | Generator | `ReportGenerator` |
-| 「要約して」 | Generator | `SummaryGenerator` |
-| 「引用を生成して」 | Generator | `CitationGenerator` |
-| 「知識グラフに追加して」 | Knowledge | `KnowledgeGraph` |
-| 「関連情報を検索して」 | Knowledge | `GraphQuery` |
+// 品質スコア
+const scorer = new QualityScorer();
+const score = await scorer.score(text);
+```
+
+### コンテンツ生成
+
+```typescript
+import { ReportGenerator, SummaryGenerator, CitationGenerator } from '@nahisaho/katashiro';
+
+// 要約
+const summarizer = new SummaryGenerator();
+const summary = await summarizer.generate(longText, { maxLength: 300, style: 'paragraph' });
+
+// レポート
+const reportGen = new ReportGenerator();
+const report = await reportGen.generate({
+  title: 'タイトル',
+  sections: [
+    { heading: 'セクション1', content: '内容1' },
+    { heading: 'セクション2', content: '内容2' },
+  ],
+  format: 'markdown',
+});
+
+// 引用
+const citationGen = new CitationGenerator();
+const citation = citationGen.generate(source, { style: 'APA' });
+```
+
+### 知識グラフ
+
+```typescript
+import { KnowledgeGraph, GraphQuery, GraphPersistence } from '@nahisaho/katashiro';
+
+const kg = new KnowledgeGraph();
+const persistence = new GraphPersistence();
+const query = new GraphQuery(kg);
+
+// 保存
+kg.addNode({ id: 'node-1', type: 'Person', properties: { name: '山田太郎' } });
+await persistence.save(kg, './knowledge.json');
+
+// 読み込み
+const loaded = await persistence.load('./knowledge.json');
+
+// 検索
+const results = query.findByType('Person');
+```
 
 ---
 
-## 📝 実装パターン
+## 📝 課題解決テンプレート
 
-### パターン1: Webページ取得→分析→レポート
+### テンプレート1: 調査タスク
 
 ```typescript
-import { 
-  WebScraper, 
-  TextAnalyzer, 
-  EntityExtractor,
-  ReportGenerator,
-  isOk 
-} from '@nahisaho/katashiro';
-
-async function analyzeWebPage(url: string) {
-  // 1. Webページ取得
-  const scraper = new WebScraper();
-  const pageResult = await scraper.scrape(url);
+// ユーザー: 「〇〇について調べてまとめて」
+import { WebSearchClient, WebScraper, TextAnalyzer, EntityExtractor, SummaryGenerator, ReportGenerator, isOk } from '@nahisaho/katashiro';
+
+async function research(topic: string) {
+  // 1. 検索
+  const search = new WebSearchClient();
+  const results = await search.search(topic, { maxResults: 10 });
   
-  if (!isOk(pageResult)) {
-    return { error: 'Failed to scrape page' };
+  // 2. ページ取得
+  const scraper = new WebScraper();
+  const contents: string[] = [];
+  for (const r of results.slice(0, 5)) {
+    const page = await scraper.scrape(r.url);
+    if (isOk(page)) contents.push(page.value.content);
   }
   
-  const { content, title } = pageResult.value;
-  
-  // 2. テキスト分析
+  // 3. 分析
   const analyzer = new TextAnalyzer();
-  const analysis = await analyzer.analyze(content);
+  const keywords = new Set<string>();
+  for (const c of contents) {
+    const a = await analyzer.analyze(c);
+    a.keywords.forEach(k => keywords.add(k));
+  }
   
-  // 3. エンティティ抽出
+  // 4. エンティティ抽出
   const extractor = new EntityExtractor();
-  const entities = await extractor.extract(content);
+  const entities = new Set<string>();
+  for (const c of contents) {
+    const e = await extractor.extract(c);
+    e.forEach(ent => entities.add(ent.text));
+  }
+  
+  // 5. 要約
+  const summarizer = new SummaryGenerator();
+  const summary = await summarizer.generate(contents.join('\n\n'), { maxLength: 500 });
   
-  // 4. レポート生成
+  // 6. レポート生成
   const reportGen = new ReportGenerator();
-  const report = await reportGen.generate({
-    title: `Analysis: ${title}`,
+  return reportGen.generate({
+    title: `${topic} 調査レポート`,
     sections: [
-      { heading: 'Summary', content: analysis.summary },
-      { heading: 'Keywords', content: analysis.keywords.join(', ') },
-      { heading: 'Entities', content: entities.map(e => e.text).join(', ') },
+      { heading: '概要', content: summary },
+      { heading: 'キーワード', content: [...keywords].join(', ') },
+      { heading: '関連エンティティ', content: [...entities].join(', ') },
+      { heading: '参考URL', content: results.map(r => `- ${r.url}`).join('\n') },
     ],
     format: 'markdown',
   });
-  
-  return { report, analysis, entities };
 }
 ```
 
-### パターン2: 検索→収集→要約
+### テンプレート2: 分析タスク
 
 ```typescript
-import { 
-  WebSearchClient, 
-  WebScraper, 
-  SummaryGenerator,
-  isOk 
-} from '@nahisaho/katashiro';
-
-async function researchTopic(topic: string) {
-  // 1. 検索
-  const searchClient = new WebSearchClient({ apiKey: process.env.SEARCH_API_KEY });
-  const results = await searchClient.search(topic, { maxResults: 5 });
-  
-  // 2. 上位結果を収集
-  const scraper = new WebScraper();
-  const contents: string[] = [];
+// ユーザー: 「このテキストを分析して」
+import { TextAnalyzer, EntityExtractor, StructureAnalyzer, QualityScorer } from '@nahisaho/katashiro';
+
+async function analyze(text: string) {
+  const [analysis, entities, structure, quality] = await Promise.all([
+    new TextAnalyzer().analyze(text),
+    new EntityExtractor().extract(text),
+    new StructureAnalyzer().analyze(text),
+    new QualityScorer().score(text),
+  ]);
   
-  for (const result of results) {
-    const page = await scraper.scrape(result.url);
-    if (isOk(page)) {
-      contents.push(page.value.content);
-    }
-  }
-  
-  // 3. 全体を要約
-  const summarizer = new SummaryGenerator();
-  const combinedText = contents.join('\n\n---\n\n');
-  const summary = await summarizer.generate(combinedText, { maxLength: 500 });
-  
-  return { summary, sources: results };
+  return {
+    keywords: analysis.keywords,
+    complexity: analysis.complexity,
+    sentiment: analysis.sentiment,
+    entities: entities.map(e => ({ type: e.type, text: e.text })),
+    structure,
+    qualityScore: quality,
+  };
 }
 ```
 
-### パターン3: 知識グラフ構築
+### テンプレート3: 比較タスク
 
 ```typescript
-import { 
-  KnowledgeGraph, 
-  GraphQuery, 
-  GraphPersistence,
-  EntityExtractor 
-} from '@nahisaho/katashiro';
-
-async function buildKnowledgeGraph(texts: string[]) {
-  const kg = new KnowledgeGraph();
-  const extractor = new EntityExtractor();
+// ユーザー: 「AとBを比較して」
+import { WebSearchClient, WebScraper, TextAnalyzer, ReportGenerator, isOk } from '@nahisaho/katashiro';
+
+async function compare(itemA: string, itemB: string) {
+  const search = new WebSearchClient();
+  const scraper = new WebScraper();
+  const analyzer = new TextAnalyzer();
   
-  for (const text of texts) {
-    // エンティティ抽出
-    const entities = await extractor.extract(text);
-    
-    // ノード追加
-    for (const entity of entities) {
-      kg.addNode({
-        id: `entity-${entity.text.toLowerCase().replace(/\s+/g, '-')}`,
-        type: entity.type,
-        properties: { name: entity.text },
-      });
+  async function gatherInfo(item: string) {
+    const results = await search.search(item, { maxResults: 5 });
+    const contents: string[] = [];
+    for (const r of results) {
+      const page = await scraper.scrape(r.url);
+      if (isOk(page)) contents.push(page.value.content);
     }
+    const analysis = await analyzer.analyze(contents.join('\n'));
+    return { item, analysis, sources: results };
   }
   
-  // 永続化
-  const persistence = new GraphPersistence();
-  await persistence.save(kg, './knowledge-graph.json');
-  
-  // クエリ
-  const query = new GraphQuery(kg);
-  const allNodes = query.getAllNodes();
+  const [infoA, infoB] = await Promise.all([gatherInfo(itemA), gatherInfo(itemB)]);
   
-  return { nodeCount: allNodes.length, nodes: allNodes };
+  const reportGen = new ReportGenerator();
+  return reportGen.generate({
+    title: `${itemA} vs ${itemB} 比較`,
+    sections: [
+      { heading: itemA, content: `キーワード: ${infoA.analysis.keywords.join(', ')}` },
+      { heading: itemB, content: `キーワード: ${infoB.analysis.keywords.join(', ')}` },
+      { heading: '比較まとめ', content: '（AIが分析結果を基に比較コメントを生成）' },
+    ],
+    format: 'markdown',
+  });
 }
 ```
 
 ---
 
-## 📚 クラスリファレンス
-
-### Collector
-
-| クラス | メソッド | 説明 |
-|--------|---------|------|
-| `WebScraper` | `scrape(url)` | URLからコンテンツを取得 |
-| `WebSearchClient` | `search(query, options)` | Web検索を実行 |
-| `FeedReader` | `read(url)` | RSS/Atomフィードを読み込み |
-| `ApiClient` | `get(url)`, `post(url, data)` | REST API呼び出し |
+## ⚡ クイックスタート
 
-### Analyzer
-
-| クラス | メソッド | 説明 |
-|--------|---------|------|
-| `TextAnalyzer` | `analyze(text)` | キーワード、複雑度、感情を分析 |
-| `EntityExtractor` | `extract(text)` | 固有表現を抽出 |
-| `TopicModeler` | `model(documents)` | トピックを分類 |
-| `StructureAnalyzer` | `analyze(text)` | 文書構造を解析 |
-
-### Generator
-
-| クラス | メソッド | 説明 |
-|--------|---------|------|
-| `ReportGenerator` | `generate(options)` | レポートを生成 |
-| `SummaryGenerator` | `generate(text, options)` | 要約を生成 |
-| `CitationGenerator` | `generate(source, options)` | 引用を生成 |
-
-### Knowledge
+```bash
+npm install @nahisaho/katashiro
+```
 
-| クラス | メソッド | 説明 |
-|--------|---------|------|
-| `KnowledgeGraph` | `addNode()`, `addEdge()` | グラフを構築 |
-| `GraphQuery` | `find()`, `findByRelation()` | グラフを検索 |
-| `GraphPersistence` | `save()`, `load()` | 永続化 |
+```typescript
+import * as katashiro from '@nahisaho/katashiro';
+
+// すべての機能にアクセス可能
+const { 
+  WebScraper, WebSearchClient, FeedReader,
+  TextAnalyzer, EntityExtractor, TopicModeler,
+  ReportGenerator, SummaryGenerator, CitationGenerator,
+  KnowledgeGraph, GraphQuery, GraphPersistence,
+  isOk, isErr
+} = katashiro;
+```
 
 ---
 
@@ -208,4 +275,4 @@ async function buildKnowledgeGraph(texts: string[]) {
 **Project**: KATASHIRO
 **npm**: @nahisaho/katashiro
 **Last Updated**: 2026-01-10
-**Version**: 0.1.3
+**Version**: 0.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/katashiro",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "KATASHIRO - VS Code Agent Mode向け情報収集・分析・生成システム（オールインワンパッケージ）",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",