# Getting Started

Claude Knowledge Catalystの詳細なセットアップガイドです。プロンプトエンジニアリングの基礎から実際の運用まで、段階的に学習できます。

## What is Claude Knowledge Catalyst?

Claude Knowledge Catalyst (CKC) は、Claude Codeとの開発プロセスで生まれる知見を自動的に構造化し、Obsidianとの深層統合により長期的な知識資産として蓄積・活用するための包括的なプラットフォームです。

### 主要な特徴

- **🔄 自動同期システム**: `.claude/` ディレクトリの変更をリアルタイム監視・同期
- **🏷️ インテリジェントメタデータ**: プロジェクト検出、タグ推論、文脈解析による自動抽出
- **📝 テンプレートシステム**: プロンプト、コード、概念、ログの知識タイプ別テンプレート
- **🎯 Obsidian深層統合**: 構造化ボルト、双方向リンク、グラフビュー活用

## インストールと初期設定

### 1. 前提条件

Claude Knowledge Catalystを使い始める前に、以下をインストールしてください：

- **Python 3.11+**: [Pythonをダウンロード](https://www.python.org/downloads/)
- **uv**: モダンなPythonパッケージマネージャー・プロジェクトマネージャー
  - **インストール**: [公式uvインストールガイド](https://docs.astral.sh/uv/getting-started/installation/)に従ってください
  - **クイックインストール**: `curl -LsSf https://astral.sh/uv/install.sh | sh` (Unix/macOS) または `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"` (Windows)

### 2. 仮想環境のセットアップ

```bash
# 仮想環境を作成
uv venv

# 仮想環境を有効化
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows
```

### 3. CKCのインストール

```bash
# PyPIからuv pipを使用してインストール（推奨）
uv pip install claude-knowledge-catalyst

# またはuv addを使用（Pythonプロジェクトの場合）
uv add claude-knowledge-catalyst

# またはpipを使用
pip install claude-knowledge-catalyst

# プロジェクトディレクトリで初期化
cd your-project
uv run ckc init
```

#### 開発版のインストール

```bash
# リポジトリをクローン
git clone https://github.com/drillan/claude-knowledge-catalyst.git
cd claude-knowledge-catalyst

# 仮想環境を作成（プロジェクト内）
uv venv

# 仮想環境を有効化
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# 開発依存関係をインストール
uv sync --dev

# 初期化
uv run ckc init
```

### 3. 設定ファイルのカスタマイズ

生成された `.ckc/config.yaml` を編集して、あなたの環境に合わせて設定します：

```yaml
# Obsidianボルトのパス
obsidian_vault_path: "~/Documents/MyVault"

# 同期の詳細設定
sync:
  auto_sync: true
  watch_directories: [".claude"]

# メタデータ設定
metadata:
  auto_extract: true
  tag_inference: true
```

## 基本的なワークフロー

### ステップ1: プロジェクト初期化

新しいプロジェクトでCKCを使用する場合：

```bash
cd your-new-project
uv run ckc init
```

### ステップ2: Claude Codeでの開発

通常通りClaude Codeで開発を進めます。`.claude/` ディレクトリに作成されるファイルが自動的に監視されます。

### ステップ3: 自動同期の確認

```bash
# 同期状況を確認
uv run ckc status

# 手動同期（必要に応じて）
uv run ckc sync
```

## Next Steps

- [Core Concepts](../user-guide/core-concepts.md) - CKCの中核概念を理解
- **Best Practices** - 効果的な使用方法（準備中）