Steven's Knowledge Base

CC-File-Architecture

4 min read

Claude Code File Architecture Design

framework reference

Home 根目錄 (~/) — VPS 根目錄

~/
├── CLAUDE.md                Home 目錄地圖（唔係規則，係地圖）
├── projects/                所有 client 同開發項目
├── tools/                   MCP server 插件（google_workspace_mcp, social-media-mcp）
├── scripts/                 Shell / Python 自動化腳本
├── bin/                     執行檔（start-tg.sh，被 mcp-watchdog.sh 引用）
├── obsidian-vault/          Obsidian 知識庫
├── quartz/                  Obsidian → 靜態網站生成器
├── lancedb_store/           LanceDB 向量資料庫（記憶系統）
├── chrome-profile/          Playwright 用嘅 Chrome profile
├── archive/                 舊檔案存檔
├── backups/                 系統備份
├── lobster-bridge.js        ⚠️ Active service（port 37778，唔好刪）
├── start-claude.sh          ⚠️ systemd claude-code.service 硬寫死路徑，唔好搬
├── start-claude-cc2.sh      啟動 cc2 session（@Steven_ccc2_bot）
├── package.json             ⚠️ Playwright Node.js 依賴，唔好搬
└── node_modules/            ⚠️ 必須同 package.json 同目錄

全局層 (~/.claude/) — 所有 project 共用

~/.claude/
├── CLAUDE.md          個人偏好、核心規則
├── commands/          /slash 指令
├── skills/            跨客共用技能
├── agents/            共用 agent 定義
├── rules/             模組化規則（telegram.md, n8n.md 等）
├── hooks/             自動化觸發
├── settings.json      permissions / hooks
└── projects/ (auto)   Auto Memory 自動儲存

共 8 項，所有 project 都繼承。

Projects 架構 (~/projects/) — 分兩類

~/projects/
├── clients/                   行銷交付物（AI 生成嘅嘢放呢度）
│   ├── _template/             複製呢個開新客
│   │   ├── CLAUDE.md
│   │   ├── context/           brand.md, audience.md, profile.md
│   │   └── outputs/           copy/, assets/, research/, reports/
│   │
│   └── remarkable-marketing/  Steven 自己係一個客
│       ├── CLAUDE.md
│       ├── context/
│       └── outputs/
│           ├── ads/           廣告文案、campaign 文件
│           ├── copy/          LP、VSL、email sequence
│           ├── social/        社交帖文、content calendar
│           ├── research/      競爭對手、受眾分析
│           └── reports/       績效報告
│
│   （新客：clients/coach-mary/, clients/abc-company/ ...）
│
└── internal/                  開發項目（代碼跑起嚟嘅嘢）
    ├── salesbot-setup/        Salesbot 配置
    ├── ai-agent-course/       課程開發
    ├── auto-video-editor/     影片自動化工具
    ├── webinarkit-mcp/        Webinar MCP
    └── whatsapp-ai/           WhatsApp AI

核心邏輯：

  • clients/ = 行銷工作 + AI 輸出（Steven 自己係 remarkable-marketing）
  • internal/ = 代碼 / 技術項目（唔係 client deliverables）
  • 每個客人有獨立 context/ + outputs/，互不干擾

關鍵設計原則

  • @import 省 token：CLAUDE.md 輕量，context 按需載入
  • mcp-client.json：只開呢個客人需要嘅 MCP，唔係全開
  • Auto Memory：~/.claude/projects/{hash}/memory/MEMORY.md 頭 200 行自動載入
  • LEARNING.md：每個 skill folder 放一個，記錄學習同改進，可由 Claude 自動更新

Skills Folder 結構（brand-voice 為例）

brand-voice/
├── SKILL.md           入口：frontmatter + 主要指令
├── LEARNING.md        累積學習（社區 pattern）
├── templates/         Output 模板（最終係咁樣嘅）
│   └── post-template.md
├── assets/            靜態資源（圖片、config、schema）
│   └── tone-config.json
├── references/        SOP + 例子 + Gotchas（最重要）
│   ├── good-examples.md    好例子（activation +18%）
│   ├── bad-examples.md     唔好點樣（防錯）
│   ├── gotchas.md          踩過嘅坑
│   └── brand-guide.md      品牌 SOP
└── evals/             自訂測試（官方有 evals 概念）
    ├── test-cases.md
    └── baseline-results.md

Graph View

Backlinks