kenaz 0.3.18 → 0.3.20

package/core/.system/kenaz/README.md

@@ -1,787 +0,0 @@
-# .kenaz - Kenaz AI 主記憶與文檔工具
-
-> **系統級配置** | 路徑：`.kenaz/` | 建立日期：2026-02-11
-
----
-
-## 系統概述
-
-`.kenaz/` 是 Kenaz AI 的**系統級核心配置目錄**，提供跨專案共享的知識庫與文檔管理工具：
-
-**核心組件**：
-```
-┌─────────────────────────────────────────────────────────┐
-│                    .kenaz/ 系統                          │
-│                                                          │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
-│  │  主記憶系統   │  │  文檔工具集   │  │  Cortex 配置 │  │
-│  │ main-memory/ │  │    docs/     │  │ cortex.yaml  │  │
-│  │              │  │              │  │              │  │
-│  │ • 跨專案知識 │  │ • 統一索引   │  │ • RAG 引擎   │  │
-│  │ • 唯讀繼承   │  │ • TypeScript │  │ • 優先級設定 │  │
-│  │ • 結構化索引 │  │ • 搜尋工具   │  │ • 向量權重   │  │
-│  └──────────────┘  └──────────────┘  └──────────────┘  │
-└─────────────────────────────────────────────────────────┘
-```
-
-**與專案記憶的關係**：
-- `.kenaz/main-memory/` — 跨專案共享（唯讀，開發者維護）
-- `.memory/` — 專案專屬（讀寫，Agent 自動生成）
-- 優先級：專案記憶 > 主記憶 > 系統預設
-
----
-
-## 目錄結構
-
-```
-.kenaz/
-├── README.md                 # 本文件（系統級入口）
-├── cortex.yaml               # Cortex RAG 引擎配置
-│
-├── main-memory/              # 主記憶系統（跨專案知識庫）
-│   ├── README.md             # 主記憶系統說明
-│   ├── registry.json         # 記憶索引（26 條記憶）
-│   ├── version.yaml          # 版本與變更日誌
-│   │
-│   ├── knowledge/            # 通用軟體開發知識
-│   │   ├── patterns/         # 設計模式、架構模式
-│   │   ├── solutions/        # 常見問題解決方案
-│   │   └── references/       # 技術參考文檔
-│   │
-│   └── kenaz/                # Kenaz AI 系統專屬知識
-│       ├── system/           # 系統架構與設計
-│       ├── pipeline/         # 開發流程與任務管理
-│       ├── rules/            # 規則系統設計
-│       ├── cortex/           # RAG 引擎與檢索
-│       └── memory-system/    # 記憶系統架構
-│
-└── docs/                     # 統一文檔系統
-    ├── INDEX.md              # 人類可讀總覽（57 個文檔）
-    ├── registry.json         # Agent 用機器索引（7 個系統）
-    ├── schema.json           # JSON Schema 定義
-    │
-    └── tools/                # 文檔工具集（TypeScript）
-        ├── src/
-        │   ├── registry.ts   # 核心邏輯
-        │   ├── search.ts     # 混合搜尋引擎
-        │   ├── cli.ts        # CLI 命令
-        │   └── types.ts      # 型別定義
-        ├── dist/             # 編譯輸出
-        ├── README.md         # 工具使用指南
-        ├── GIT_HOOK_GUIDE.md # Git Hook 自動更新
-        └── RAG_INTEGRATION_GUIDE.md  # RAG 整合指南
-```
-
----
-
-## 主記憶系統 (.kenaz/main-memory/)
-
-### 系統概述
-
-主記憶系統是 Kenaz AI 的**跨專案共享知識庫**，提供：
-
-- ✅ **跨專案知識共享** - 所有 Kenaz AI 專案可存取相同的核心知識
-- ✅ **優先級繼承** - 專案記憶 > 主記憶 > 系統預設
-- ✅ **唯讀設計** - 僅開發者手動更新，避免知識污染
-- ✅ **結構化索引** - `registry.json` 提供完整元數據
-
-### 知識結構（三層架構）
-
-主記憶包含 **26 條記憶**，分為兩大類別：
-
-#### 1. Knowledge（通用知識） - 8 條
-
-| 子類別 | 說明 | 範例 |
-|--------|------|------|
-| **patterns/** | 設計模式、協作模式 | Leader-Worker 協作模式、Scope Path 衝突檢測 |
-| **solutions/** | 常見問題解決方案 | JSON BOM 問題修復、團隊調用標準流程 |
-| **references/** | 技術參考文檔 | PPL 規則參考、API 文檔連結 |
-
-**核心記憶範例**：
-- `K-PAT-001`: JSON BOM 編碼問題模式
-- `K-PAT-002`: Leader-Worker 協作模式
-- `K-PAT-003`: Scope Path 衝突檢測模式
-- `K-SOL-001`: JSON BOM 問題解決方案
-- `K-SOL-002`: 團隊調用標準流程
-
-#### 2. Kenaz（系統專屬知識） - 18 條
-
-| 子類別 | 說明 | 範例 |
-|--------|------|------|
-| **system/** | 系統架構與設計 | 雙軌制任務系統 |
-| **pipeline/** | 開發流程與任務管理 | 任務執行流程、任務粒度標準、Feature ID 系統 |
-| **rules/** | 規則系統設計 | 規則優先級系統、GEN-007 專案自包含原則 |
-| **cortex/** | RAG 引擎與檢索 | RAG 引擎概覽、Cortex 系統架構 |
-| **memory-system/** | 記憶系統架構 | 三層記憶架構設計 |
-
-**核心記憶範例**：
-- `KZ-SYS-001`: 雙軌制任務系統（新系統 vs 舊系統）
-- `KZ-PPL-001`: 任務執行完整流程（12 步開發流程）
-- `KZ-RULE-001`: 規則優先級系統設計
-- `KZ-RULE-002`: GEN-007 專案自包含原則
-- `KZ-CORTEX-001`: Cortex RAG 引擎概覽
-
-### 記憶索引文件
-
-| 文件 | 用途 |
-|------|------|
-| `registry.json` | 完整記憶索引（包含 ID、標題、標籤、路徑、類別） |
-| `version.yaml` | 版本資訊與變更日誌 |
-| `README.md` | 主記憶系統說明 |
-
-### 與 Cortex 整合
-
-主記憶透過 `.kenaz/cortex.yaml` 整合到 Kenaz Cortex RAG 引擎：
-
-```yaml
-# cortex.yaml - 優先級繼承機制
-priority_order:
-  - level: 1
-    name: "專案記憶"
-    path: ".memory/"
-
-  - level: 2
-    name: "主記憶"
-    path: ".kenaz/main-memory/"
-
-  - level: 3
-    name: "系統預設"
-    path: "internal"
-```
-
-**索引權重配置**：
-```yaml
-categories:
-  - path: "kenaz/rules/"
-    weight: 1.0
-    priority: "critical"
-
-  - path: "knowledge/patterns/"
-    weight: 1.0
-    priority: "high"
-
-  - path: "kenaz/cortex/"
-    weight: 0.8
-    priority: "medium"
-```
-
-### 存取控制
-
-- **讀取權限**：所有 Agent、所有開發者
-- **寫入權限**：僅開發者手動更新
-- **理由**：主記憶為穩定的核心知識，避免自動修改導致知識污染
-
-### 更新流程（開發者）
-
-1. 在對應類別目錄建立 Markdown 文件
-2. 撰寫記憶內容（包含標題、標籤、描述、範例）
-3. 更新 `registry.json` 新增索引條目
-4. 更新 `version.yaml` 記錄變更
-5. 建立 Git commit
-
-**範例**：
-```bash
-# 新增通用模式
-touch .kenaz/main-memory/knowledge/patterns/003_new_pattern.md
-
-# 更新索引
-vim .kenaz/main-memory/registry.json
-
-# 記錄變更
-vim .kenaz/main-memory/version.yaml
-
-# 提交
-git add .kenaz/main-memory/
-git commit -m "Add K-PAT-003: New Pattern"
-```
-
----
-
-## 文檔工具系統 (.kenaz/docs/)
-
-### 系統概述
-
-`.kenaz/docs/` 是 Kenaz AI 的 **統一文檔入口系統**，提供：
-
-- ✅ **分散式文檔管理** - 各系統保留自己的 `docs/`，統一註冊到 registry
-- ✅ **雙格式支援** - `INDEX.md`（人類可讀） + `registry.json`（Agent 可用）
-- ✅ **TypeScript 工具集** - `kenaz-docs` CLI + TypeScript API
-- ✅ **RAG 整合** - 自動同步到 Kenaz Cortex
-
-### 架構設計
-
-```
-.kenaz/docs/              # 統一文檔入口（系統級）
-├── registry.json         # Agent 用：機器可讀的索引
-├── INDEX.md              # 人類用：可讀性高的總覽
-├── schema.json           # JSON Schema 定義
-└── tools/                # 文檔工具集（TypeScript）
-    ├── src/
-    │   ├── registry.ts   # 核心邏輯（DocsRegistry 類）
-    │   ├── search.ts     # 混合搜尋引擎（精確匹配 + 索引搜尋）
-    │   ├── field-extractor.ts  # YAML 欄位提取器（extractedFields）
-    │   ├── cli.ts        # CLI 命令（search, list, get, index, validate, stats）
-    │   └── types.ts      # 型別定義
-    └── dist/             # 編譯輸出
-```
-
-### 分散式文檔架構
-
-各系統保留自己的文檔，統一註冊到 `.kenaz/docs/registry.json`：
-
-```
-kenaz-cortex/docs/        # RAG 引擎文檔（14 個文檔）
-dev/pipeline/docs/        # Pipeline 文檔（4 個文檔）
-dashboard/docs/           # Dashboard 文檔（5 個文檔）
-.failure/                 # 失敗學習系統文檔（9 個文檔）
-.rule/                    # 規則系統文檔（17 個文檔）
-```
-
-### 文檔索引統計（截至 2026-02-17）
-
-| 系統 | 文檔數 | 優先級 | 說明 |
-|------|--------|--------|------|
-| **Kenaz Cortex** | 14 | 🔴 critical | RAG engine for semantic code search |
-| **Rule System** | 17 | 🔴 critical | Project rules, coding standards, and guidelines |
-| **Pipeline System** | 4 | 🟠 high | Task management and workflow orchestration |
-| **Failure Learning System** | 9 | 🟠 high | Historical failure patterns and prevention strategies |
-| **Docs System** | 6 | 🟠 high | Unified documentation registry |
-| **Dashboard** | 5 | 🟡 medium | Web UI for project management |
-| **Project Core** | 2 | 🔴 critical | CLAUDE.md and other root-level guides |
-
-**總計**：7 個系統，57 個文檔
-
-### TypeScript 工具集
-
-#### CLI 命令
-
-```bash
-# 安裝與建置
-cd .kenaz/docs/tools
-npm install
-npm run build
-
-# 搜尋文檔
-kenaz-docs search "cortex api"
-kenaz-docs search "authentication" --system=kenaz-cortex --type=api
-
-# 列出所有文檔
-kenaz-docs list
-kenaz-docs list --system=kenaz-cortex
-
-# 獲取文檔內容
-kenaz-docs get kenaz-cortex/docs/README.md
-
-# 重建索引
-kenaz-docs index --rebuild
-
-# 驗證文檔
-kenaz-docs validate
-
-# 查看統計
-kenaz-docs stats
-kenaz-docs stats --by-system --by-type
-
-# 同步到 RAG
-kenaz-docs sync --to-rag
-```
-
-#### TypeScript API
-
-```typescript
-import { DocsRegistry, searchDocs, getDoc } from '.kenaz/docs/tools';
-
-// 載入註冊表
-const registry = DocsRegistry.load();
-
-// 搜尋文檔
-const results = registry.search('cortex api', {
-  system: 'kenaz-cortex',
-  type: 'api'
-});
-
-// 獲取特定文檔
-const doc = registry.getDocument('kenaz-cortex/docs/API_REFERENCE.md');
-
-// 列出所有系統
-const systems = registry.listSystems();
-
-// 統計資訊
-const stats = registry.stats();
-console.log(`總共 ${stats.total_documents} 個文檔`);
-```
-
-### 搜尋引擎設計
-
-**混合搜尋策略**（`search.ts`）：
-
-1. **Phase 1**: 精確 ID 匹配（`extractedFields`）— score=100
-   - 搜尋 `ruleIds: ["GEN-007"]`、`taskIds: ["TASK_001"]`、`agentIds: ["backend_lead"]`
-
-2. **Phase 2**: `searchableContent` 索引搜尋 — score=50
-   - 預建索引（標題 + 描述 + 標籤）
-
-3. **Phase 3**: 全文搜尋 Fallback（可選）— score=20
-   - 未實現，預留給未來擴展
-
-**特殊功能**：
-- **欄位提取器**（`field-extractor.ts`）：自動從 YAML 文檔提取嵌套字段（如 `.rule/` 的 `rules[].id`）
-- **去重與排序**：按 score 排序並去重
-- **最小評分過濾**：`minScore` 參數控制結果品質
-- **結果數量限制**：`limit` 參數控制返回數量
-
-### 文檔類型
-
-| 類型 | 說明 | 範例 |
-|------|------|------|
-| **tutorial** | 快速開始指南 | Quick Start, Installation |
-| **guide** | 深入使用指南 | System Overview, Best Practices |
-| **reference** | 參考文檔 | API Reference, CLI Commands |
-| **api** | API 文檔 | Team API, Cortex API |
-| **example** | 實際範例 | Usage Examples, Code Samples |
-| **troubleshooting** | 故障排除 | Common Issues, FAQ |
-
-### 文檔規範（Frontmatter）
-
-所有 Markdown 文檔應包含 YAML frontmatter：
-
-```markdown
----
-type: guide                    # tutorial|guide|reference|api|example|troubleshooting
-title: 文檔標題
-description: 簡短描述
-tags: [tag1, tag2, tag3]
-audience: all                  # agent|developer|user|all
-language: zh-TW                # 可選
----
-
-# 文檔內容...
-```
-
-### Git Hook 自動更新
-
-`.git/hooks/pre-commit`：
-
-```bash
-#!/bin/bash
-if git diff --cached --name-only | grep -E '\.(md|markdown)$' > /dev/null; then
-    echo "檢測到文檔變更，更新索引..."
-    cd .kenaz/docs/tools && npm run build
-    node dist/cli.js index --auto
-    git add ../../registry.json
-fi
-```
-
-**詳細指南**：`.kenaz/docs/tools/GIT_HOOK_GUIDE.md`
-
-### 與 RAG 整合
-
-```bash
-# 同步所有文檔到 RAG
-kenaz-docs sync --to-rag
-
-# 增量同步（只同步變更）
-kenaz-docs sync --to-rag --incremental
-
-# 強制全量同步
-kenaz-docs sync --to-rag --force
-```
-
-**詳細指南**：`.kenaz/docs/tools/RAG_INTEGRATION_GUIDE.md`
-
----
-
-## Cortex 配置 (cortex.yaml)
-
-### 配置概述
-
-`cortex.yaml` 定義 Kenaz Cortex RAG 引擎的主記憶整合策略。
-
-### 完整配置
-
-```yaml
-version: "1.0.0"
-description: "Kenaz Cortex RAG 引擎配置 - 整合主記憶系統"
-
-# 記憶整合設定
-memory_integration:
-  enabled: true
-  main_memory_path: ".kenaz/main-memory/"
-  registry_file: ".kenaz/main-memory/registry.json"
-
-  # 優先級順序（數字越小優先級越高）
-  priority_order:
-    - level: 1
-      name: "專案記憶"
-      path: ".memory/"
-      description: "當前專案專屬知識"
-
-    - level: 2
-      name: "主記憶"
-      path: ".kenaz/main-memory/"
-      description: "跨專案共享核心知識"
-
-    - level: 3
-      name: "系統預設"
-      path: "internal"
-      description: "Claude Code 內建知識"
-
-# 索引設定
-indexing:
-  include_main_memory: true
-  main_memory_weight: 0.8  # 主記憶權重（相對於專案記憶 1.0）
-
-  # 各類別的權重與優先級
-  categories:
-    - path: "kenaz/rules/"
-      weight: 1.0
-      priority: "critical"
-
-    - path: "knowledge/patterns/"
-      weight: 1.0
-      priority: "high"
-
-    - path: "knowledge/solutions/"
-      weight: 1.0
-      priority: "high"
-
-    - path: "kenaz/pipeline/"
-      weight: 0.9
-      priority: "high"
-
-    - path: "kenaz/cortex/"
-      weight: 0.8
-      priority: "medium"
-
-    - path: "knowledge/references/"
-      weight: 0.7
-      priority: "medium"
-
-# 搜尋設定
-search:
-  enable_main_memory: true
-  max_results_per_source:
-    project_memory: 5
-    main_memory: 3
-
-  result_merging:
-    strategy: "priority_weighted"
-    deduplicate: true
-
-# 查詢接口
-query_interface:
-  methods:
-    - name: "search_memory"
-      scope: ["project", "main", "system"]
-      description: "搜尋所有層級的記憶"
-
-    - name: "search_main_memory"
-      scope: ["main"]
-      description: "僅搜尋主記憶（Kenaz 系統知識）"
-
-    - name: "search_project_memory"
-      scope: ["project"]
-      description: "僅搜尋專案記憶"
-
-# 存取控制
-access_control:
-  read:
-    main_memory: "all_agents"
-    project_memory: "project_agents"
-
-  write:
-    main_memory: "manual_only"
-    project_memory: "agents"
-
-  update_policy:
-    main_memory: "開發者手動更新，避免知識污染"
-    project_memory: "Agent 可自動更新"
-```
-
-### 關鍵配置解讀
-
-#### 優先級繼承
-
-```
-Agent 查詢 Cortex
-    ↓
-1. 專案記憶 (.memory/) - 最高優先級
-    ↓
-2. 主記憶 (.kenaz/main-memory/) - 中等優先級
-    ↓
-3. 系統預設 (Claude Code 內建) - 最低優先級
-```
-
-#### 權重策略
-
-- **kenaz/rules/**（critical）：權重 1.0（最高）
-- **knowledge/patterns/**（high）：權重 1.0
-- **kenaz/pipeline/**（high）：權重 0.9
-- **kenaz/cortex/**（medium）：權重 0.8
-- **knowledge/references/**（medium）：權重 0.7
-
-#### 搜尋結果限制
-
-- 專案記憶最多返回 5 條
-- 主記憶最多返回 3 條
-- 使用 `priority_weighted` 策略合併結果
-- 自動去重
-
----
-
-## Agent 使用指南
-
-### 1. 查詢主記憶（任務開始前）
-
-**目的**：了解 Kenaz AI 系統設計、開發流程、規則系統等核心知識。
-
-```bash
-# 搜尋主記憶（關於規則系統）
-node .kenaz/docs/tools/dist/cli.js search "規則優先級"
-
-# 搜尋主記憶（關於 Pipeline）
-node .kenaz/docs/tools/dist/cli.js search "任務執行流程"
-
-# 搜尋主記憶（關於 Team 系統）
-node .kenaz/docs/tools/dist/cli.js search "Leader-Worker 模式"
-```
-
-**Cortex 接口**（如果可用）：
-```
-cortex_search(query="規則優先級", scope=["main"])
-cortex_search(query="任務執行流程", scope=["main"])
-```
-
-### 2. 查詢文檔系統（開發過程中）
-
-**目的**：查找 API 文檔、操作指南、故障排除。
-
-```bash
-# 搜尋所有文檔
-kenaz-docs search "cortex api"
-
-# 按系統過濾
-kenaz-docs search "authentication" --system=kenaz-cortex
-
-# 按類型過濾
-kenaz-docs search "" --type=api
-
-# 列出特定系統的所有文檔
-kenaz-docs list --system=pipeline-system
-```
-
-### 3. Agent 自動載入策略
-
-Cortex 按以下層級自動載入知識：
-
-```
-Agent 查詢 Cortex
-    ↓
-Layer 1: 規則層（.rule/, CLAUDE.md, .failure/）
-    ↓
-Layer 1.5: 記憶層（.memory/ + .kenaz/main-memory/）
-    ↓
-Layer 2-4: 架構層、智能檢索層、全局驗證層
-```
-
-**智能載入規則**：
-- P0/P1 任務：載入 15-20 條記憶（包含主記憶 3 條）
-- P2/P3 任務：載入 10 條記憶（包含主記憶 2 條）
-- 簡單任務：載入 5 條記憶（包含主記憶 1 條）
-
----
-
-## 與其他系統的關係
-
-### 優先級順序
-
-```
-1. .rule/*               ← 最高優先級（所有人必須遵守的規則）
-2. .kenaz/main-memory/*  ← 中等優先級（跨專案核心知識）
-3. .memory/*             ← 專案優先級（專案專屬經驗）
-4. CLAUDE.md             ← 專案指導（工作流程）
-```
-
-### 與專案記憶的關係
-
-| 層級 | 位置 | 性質 | 維護方式 | 適用範圍 |
-|------|------|------|---------|---------|
-| **主記憶** | `.kenaz/main-memory/` | 唯讀、全局 | 開發者手動更新 | 所有 Kenaz AI 專案 |
-| **專案記憶** | `.memory/` | 讀寫、專案專屬 | Agent 自動生成 + 開發者審查 | 當前專案 |
-
-**查詢規則**：專案記憶優先，主記憶補充。
-
-### 與 Cortex RAG 的關係
-
-- 主記憶作為 **Layer 1.5** 整合到 Cortex
-- 使用 ChromaDB 進行向量存儲
-- 支持語義檢索和混合排名
-- 配置由 `cortex.yaml` 定義
-
----
-
-## 維護指南
-
-### 更新主記憶
-
-1. 在 `.kenaz/main-memory/<category>/<subcategory>/` 建立 Markdown 文件
-2. 撰寫記憶內容（標題、標籤、描述、範例）
-3. 更新 `registry.json` 新增索引條目
-4. 更新 `version.yaml` 記錄變更
-5. 建立 Git commit
-
-### 更新文檔索引
-
-```bash
-# 手動重建索引
-cd .kenaz/docs/tools
-npm run build
-node dist/cli.js index --rebuild
-
-# 驗證索引
-node dist/cli.js validate
-```
-
-### 配置 Git Hook 自動更新
-
-```bash
-# 執行自動配置腳本
-bash .kenaz/docs/tools/GIT_HOOK_GUIDE.md
-```
-
-### 同步到 Cortex RAG
-
-```bash
-# 同步所有文檔
-kenaz-docs sync --to-rag
-
-# 增量同步
-kenaz-docs sync --to-rag --incremental
-```
-
----
-
-## 統計數據（截至 2026-02-17）
-
-### 主記憶系統
-
-```yaml
-main_memory:
-  total_memories: 26
-  knowledge: 8    # 通用軟體開發知識
-  kenaz: 18       # Kenaz AI 系統專屬知識
-
-  by_category:
-    patterns: 4
-    solutions: 3
-    references: 1
-    system: 1
-    pipeline: 4
-    rules: 4
-    cortex: 2
-    memory-system: 1
-```
-
-### 文檔系統
-
-```yaml
-docs_system:
-  total_systems: 7
-  total_documents: 57
-
-  by_system:
-    kenaz-cortex: 14
-    rule-system: 17
-    pipeline-system: 4
-    failure-learning: 9
-    docs-system: 6
-    dashboard: 5
-    project-core: 2
-
-  by_type:
-    guide: 34
-    reference: 17
-    api: 6
-```
-
----
-
-## 相關文檔
-
-### 主記憶系統
-
-| 文檔 | 路徑 | 說明 |
-|------|------|------|
-| **主記憶 README** | `.kenaz/main-memory/README.md` | 主記憶系統完整說明 |
-| **記憶索引** | `.kenaz/main-memory/registry.json` | 26 條記憶的完整索引 |
-| **版本日誌** | `.kenaz/main-memory/version.yaml` | 變更歷史與版本資訊 |
-
-### 文檔工具系統
-
-| 文檔 | 路徑 | 說明 |
-|------|------|------|
-| **文檔總覽** | `.kenaz/docs/INDEX.md` | 人類可讀的文檔索引 |
-| **文檔索引** | `.kenaz/docs/registry.json` | Agent 用機器索引 |
-| **工具使用指南** | `.kenaz/docs/tools/README.md` | CLI 與 TypeScript API 使用說明 |
-| **Git Hook 指南** | `.kenaz/docs/tools/GIT_HOOK_GUIDE.md` | 自動更新索引配置 |
-| **RAG 整合指南** | `.kenaz/docs/tools/RAG_INTEGRATION_GUIDE.md` | Cortex RAG 整合說明 |
-
-### Cortex 配置
-
-| 文檔 | 路徑 | 說明 |
-|------|------|------|
-| **Cortex 配置** | `.kenaz/cortex.yaml` | RAG 引擎配置文件 |
-| **專案記憶指南** | `.system/memory/README.md` | 專案記憶系統說明 |
-| **Cortex 整合指南** | `.memory/CORTEX_GUIDE.md` | Cortex 系統整合指南 |
-
----
-
-## 常見問題（FAQ）
-
-### Q1: 主記憶和專案記憶有什麼區別？
-
-**A**:
-- **主記憶** (`.kenaz/main-memory/`)：跨專案共享，開發者維護，唯讀
-- **專案記憶** (`.memory/`)：專案專屬，Agent 自動生成，讀寫
-
-查詢時專案記憶優先。
-
-### Q2: 如何更新主記憶？
-
-**A**: 主記憶僅開發者手動更新：
-1. 在 `.kenaz/main-memory/` 對應目錄建立 Markdown 文件
-2. 更新 `registry.json` 新增索引條目
-3. 更新 `version.yaml` 記錄變更
-4. 建立 Git commit
-
-### Q3: 文檔工具需要安裝嗎？
-
-**A**: 是，需要安裝 Node.js 依賴：
-```bash
-cd .kenaz/docs/tools
-npm install
-npm run build
-```
-
-### Q4: 如何搜尋文檔？
-
-**A**:
-```bash
-# CLI 方式
-kenaz-docs search "cortex api"
-
-# TypeScript API 方式
-import { searchDocs } from '.kenaz/docs/tools';
-const results = searchDocs('cortex api');
-```
-
-### Q5: Cortex 配置可以修改嗎？
-
-**A**: 可以，但需謹慎：
-- 優先級順序不建議修改（會影響記憶繼承）
-- 權重可以根據專案需求調整
-- 搜尋結果數量可以調整（注意 token 使用）
-
----
-
-*建立日期: 2026-02-11 | 更新: 2026-02-19*