From 01cff1114be14110f12a932291243a6aa01037e1 Mon Sep 17 00:00:00 2001 From: kaitranntt Date: Thu, 13 Nov 2025 21:59:14 -0500 Subject: [PATCH] docs: restructure README files with parallel workflow messaging and user path guidance --- README.ja.md | 120 ++++++++++++++++++++++++++++++++++++++++++------- README.md | 124 ++++++++++++++++++++++++++++++++++++++++++++------- README.vi.md | 122 +++++++++++++++++++++++++++++++++++++++++++------- 3 files changed, 318 insertions(+), 48 deletions(-) diff --git a/README.ja.md b/README.ja.md index 819121ae..6f84c920 100644 --- a/README.ja.md +++ b/README.ja.md @@ -161,34 +161,124 @@ ccs glmt "推論ステップ付き複雑なアルゴリズムのデバッグ" ## 開発者の日常的な課題 +
+ +### **切り替えを停止。調整を開始。** + **セッション制限がフロー状態を殺すべきではありません。** +
-開発者は日々多くのサブスクリプションシナリオに直面します： +実装に深く集中しています。コンテキストが読み込まれました。解決策が結晶化しています。
+その後: 🔴 _"使用制限に達しました。"_ -1. **アカウント分離** - 会社のClaudeアカウント vs 個人Claude → 業務と個人のコンテキストを手動で切り替える必要 -2. **レート制限** - Claudeがプロジェクト途中で停止 → 手動で`~/.claude/settings.json`を編集 -3. **コスト管理** - 2-3つのProサブスクリプション（月$20） vs Claude Maxの5倍コスト（月$100）→ Pro階層が実用的な上限 -4. **モデル選択** - タスクごとに異なるモデルの強みを活用 → 手動切り替え +**モチベーションが失われました。コンテキストが失われました。生産性が崩壊しました。** -**手動コンテキスト切り替えはワークフローを中断します。CCSがシームレスに管理します。** +## **解決策：並列ワークフロー** -
+
+❌ 古い方法： 制限に達した時に切り替える（反応的） + +### 現在のワークフロー： +- **14時:** 機能開発、ゾーン状態 +- **15時:** 🔴 使用制限に達した +- **15:05:** 作業停止、`~/.claude/settings.json`を編集 +- **15:15:** アカウント切り替え、コンテキストが失われる +- **15:30:** フロー状態に戻ろうと試みる +- **16時:** ついに生産性が回復 + +- **結果:** 1時間失われ、モチベーションが破壊され、不満が蓄積 + +
+ +
+✨ 新しい方法： 最初から並列で実行（主導的） - 推奨 + +### 新しいワークフロー： +- **14時:** **ターミナル1:** `ccs "APIアーキテクチャを計画"` → 戦略的思考（Claude Pro） +- **14時:** **ターミナル2:** `ccs glm "エンドポイントを実装"` → コード実行（GLM） +- **15時:** まだ開発継続、割れなし +- **16時:** フロー状態達成、生産性急上昇 +- **17時:** 機能が完了、コンテキスト維持 + +- **結果:** ダウムタイムなし、継続的生産性、不満減少 + +### 💰 **価値提案:** +- **設定:** 既存のClaude Pro + GLM Lite（費用対効果の高い追加） +- **価値:** 1時間/日 × 20労働日 = 20時間/月を回収 +- **ROI:** 開発時間は設定コスト以上の価値がある +- **現実:** オーバーヘッドより速く出荷 + +
+ +## あなたの道を選択 + +
+予算重視： GLMのみ + +- **最適:** 費用意識の高い開発、基本的なコード生成 +- **使用法:** 費用効果の高いAI支援のために`ccs glm`を直接使用 +- **現実:** Claudeアクセスなし、多くのコーディングタスクに対応可能 +- **設定:** GLM APIキーのみ、非常に手頃 + +
+ +
+✨ 日々の開発に推奨： 1 Claude Pro + 1 GLM Lite + +- **最適:** 日々のコードデリバリー、真剣な開発作業 +- **使用法:** `ccs`で計画 + `ccs glm`で実行（並列ワークフロー） +- **現実:** ほとんどの開発者にとって能力と費用の完璧なバランス +- **価値:** セッション制限に達せず、継続的生産性 + +
+ +
+パワーユーザー： 複数のClaude Pro + GLM Pro + +- **最適:** 重い作業量、並行プロジェクト、ソロ開発 +- **解放:** セッション・週次制限を決して枯渇させない +- **ワークフロー:** 3+以上のターミナルで専門タスクを同時実行 + +
+ +
+プライバシー重視： 仕事/個人の分離 + +- **必要時:** 仕事と個人AIコンテキストの厳格な分離 +- **設定:** `ccs auth create work` + `ccs auth create personal` +- **注意:** 高度な機能 - ほとんどのユーザーには不要 + +
+ +--- ## 手動切り替えではなくCCSを使う理由は？
-| 機能 | 利益 | -|:--------|:--------| -| **アカウント分離** | 業務と個人を分離 | -| **コスト最適化** | 2-3つのProアカウント vs Max 5倍コスト | -| **即座の切り替え** | 1コマンド、ファイル編集不要 | -| **ゼロダウンタイム** | ワークフロー中断なし | -| **レート制限管理** | 制限時にアカウント切り替え | -| **クロスプラットフォーム** | macOS、Linux、Windows | +**CCSは「午後3時に制限に達したら切り替える」ことではありません。** + +## **それは最初から並列で実行することです。**
+### コアな違い + +| **手動切り替え** | **CCSオーケストレーション** | +|:---|:---| +| 🔴 制限達成 → 作業停止 → 設定ファイル編集 → 再起動 | ✅ 最初から異なるモデルで複数ターミナルを実行 | +| 😰 コンテキストロスとフロー状態中断 | 😌 コンテキスト維持での継続的生産性 | +| 📝 逐次的タスク処理 | ⚡ 並列ワークフロー（計画 + 実行を同時に） | +| 🛠️ ブロックされた時の反応的問題解決 | 🎯 ブロックを防ぐ主導的ワークフロー設計 | + +### CCSが提供するもの + +- **ゼロコンテキスト切り替え:** 割れずにフロー状態を維持 +- **並列生産性:** 1ターミナルで戦略計画、もう1つでコード実行 +- **即座アカウント管理:** 1コマンド切り替え、設定ファイル編集不要 +- **仕事と生活の分離:** ログアウトせずにコンテキストを分離 +- **クロスプラットフォーム一貫性:** macOS、Linux、Windowsで同じスムーズな体験 +
## アーキテクチャ diff --git a/README.md b/README.md index a3d51069..14bae473 100644 --- a/README.md +++ b/README.md @@ -157,34 +157,126 @@ ccs glmt "Debug complex algorithm with reasoning steps" ## The Daily Developer Pain Point +
+ +### **STOP Switching. START Orchestrating.** + **Session limits shouldn't kill your flow state.** +
-Developers face multiple subscription scenarios daily: +You're deep in implementation. Context loaded. Solution crystallizing.
+Then: 🔴 _"You've reached your usage limit."_ -1. **Account Separation** - Company Claude account vs personal Claude → you must manually switch contexts to keep work and personal separate -2. **Rate Limits Hit** - Claude stops mid-project → you manually edit `~/.claude/settings.json` -3. **Cost Management** - 2-3 Pro subscriptions ($20/month each) vs Claude Max at 5x cost ($100/month) → Pro tier is the practical ceiling for most developers -4. **Model Choice** - Different tasks benefit from different model strengths → manual switching +**Momentum gone. Context lost. Productivity crater.** -**Manual context switching breaks your workflow. CCS manages it seamlessly.** +## **The Solution: Parallel Workflows** -
+
+❌ OLD WAY: Switch When You Hit Limits (Reactive) + +### Your Current Workflow: +- **2pm:** Building features, in the zone +- **3pm:** 🔴 Usage limit hit +- **3:05pm:** Stop work, edit `~/.claude/settings.json` +- **3:15pm:** Switch accounts, lose context +- **3:30pm:** Try to get back in flow state +- **4pm:** Finally productive again + +- **Result:** 1 hour lost, momentum destroyed, frustration builds + +
+ +
+✨ NEW WAY: Run Parallel From Start (Proactive) - RECOMMENDED + +### Your New Workflow: +- **2pm:** **Terminal 1:** `ccs "Plan the API architecture"` → Strategic thinking (Claude Pro) +- **2pm:** **Terminal 2:** `ccs glm "Implement the endpoints"` → Code execution (GLM) +- **3pm:** Still shipping, no interruptions +- **4pm:** Flow state achieved, productivity spiking +- **5pm:** Features shipped, context maintained + +- **Result:** Zero downtime, continuous productivity, less frustration + +### 💰 **The Value Proposition:** +- **Setup:** Your existing Claude Pro + GLM Lite (cost-effective add-on) +- **Value:** Save 1 hour/day × 20 workdays = 20 hours/month recovered +- **ROI:** Your development time is worth more than the setup cost +- **Reality:** Shipping faster than the overhead + +
+ +## Choose Your Path + +
+Budget-Focused: GLM Only + +- **Best for:** Cost-conscious development, basic code generation +- **Usage:** Just use `ccs glm` directly for cost-effective AI assistance +- **Reality:** No Claude access, but capable for many coding tasks +- **Setup:** GLM API key only, very affordable + +
+ +
+✨ Recommended for Daily Development: 1 Claude Pro + 1 GLM Lite + +- **Best for:** Daily code delivery, serious development work +- **Usage:** `ccs` for planning + `ccs glm` for execution (parallel workflow) +- **Reality:** Perfect balance of capability and cost for most developers +- **Value:** Never hit session limits, continuous productivity + +
+ +
+Power User: Multiple Claude Pro + GLM Pro + +- **Best for:** Heavy workloads, concurrent projects, solo dev +- **Unlocks:** Never drain session or weekly limits +- **Workflow:** 3+ terminals running specialized tasks simultaneously + +
+ +
+Privacy-Focused: Work/Personal Isolation + +- **When needed:** Strict separation of work and personal AI contexts +- **Setup:** `ccs auth create work` + `ccs auth create personal` +- **Note:** Advanced feature - most users don't need this + +
+ +--- ## Why CCS Instead of Manual Switching?
-| Feature | Benefit | -|:--------|:--------| -| **Account Isolation** | Keep work separate from personal | -| **Cost Optimization** | 2-3 Pro accounts vs Max at 5x cost | -| **Instant Switching** | One command, no file editing | -| **Zero Downtime** | Never interrupt workflow | -| **Rate Limit Management** | Switch accounts when limits hit | -| **Cross-Platform** | macOS, Linux, Windows | +**CCS isn't about "switching when you hit limits at 3pm."** + +## **It's about running in parallel from the start.**
+### The Core Difference + +| **Manual Switching** | **CCS Orchestration** | +|:---|:---| +| 🔴 Hit limits → Stop work → Edit config files → Restart | ✅ Multiple terminals running different models from the start | +| 😰 Context loss and flow state interruption | 😌 Continuous productivity with preserved context | +| 📝 Sequential task handling | ⚡ Parallel workflows (planning + execution simultaneously) | +| 🛠️ Reactive problem solving when blocked | 🎯 Proactive workflow design prevents blocks | + +### What CCS Gives You + +- **Zero Context Switching**: Keep your flow state without interruption +- **Parallel Productivity**: Strategic planning in one terminal, code execution in another +- **Instant Account Management**: One command switches, no config file editing +- **Work-Life Separation**: Isolate contexts without logging out +- **Cross-Platform Consistency**: Same smooth experience on macOS, Linux, Windows + +**Manual context switching breaks workflow. CCS orchestrates seamlessly.** +
## Architecture @@ -322,8 +414,6 @@ ccs --help # Show all commands and options -
-

Tool Support (v3.5) - EXPERIMENTAL

 diff --git a/README.vi.md b/README.vi.md index 15c7ff5f..b07223b2 100644 --- a/README.vi.md +++ b/README.vi.md @@ -161,34 +161,124 @@ ccs glmt "Debug complex algorithm with reasoning steps" ## The Daily Developer Pain Point -**Session limits shouldn't kill your flow state.** +
-Developers face multiple subscription scenarios daily: +### **DỪNG việc chuyển đổi. BẮT ĐẦU điều phối.** -1. **Account Separation** - Company Claude account vs personal Claude → you must manually switch contexts to keep work and personal separate -2. **Rate Limits Hit** - Claude stops mid-project → you manually edit `~/.claude/settings.json` -3. **Cost Management** - 2-3 Pro subscriptions ($20/month each) vs Claude Max at 5x cost ($100/month) → Pro tier is the practical ceiling for most developers -4. **Model Choice** - Different tasks benefit from different model strengths → manual switching +**Giới hạn phiên không nên phá hỏng trạng thái dòng chảy của bạn.** +
-**Manual context switching breaks your workflow. CCS manages it seamlessly.** +Bạn đang sâu trong triển khai. Ngữ cảnh đã tải. Giải pháp đang kết tinh.
+Sau đó: 🔴 _"Bạn đã đạt đến giới hạn sử dụng."_ -
+**Động lực mất đi. Ngữ cảnh mất. Năng suất sụp đổ.** + +## **Giải pháp: Quy trình công việc song song** + +
+❌ CÁCH CŨ: Chuyển đổi khi bạn đạt đến giới hạn (Phản ứng) + +### Quy trình làm việc hiện tại của bạn: +- **2pm:** Xây dựng tính năng, trong vùng +- **3pm:** 🔴 Đạt giới hạn sử dụng +- **3:05pm:** Dừng công việc, chỉnh sửa `~/.claude/settings.json` +- **3:15pm:** Chuyển tài khoản, mất ngữ cảnh +- **3:30pm:** Cố gắng quay lại trạng thái dòng chảy +- **4pm:** Cuối cùng cũng năng suất trở lại + +- **Kết quả:** Mất 1 giờ, động lực bị phá hủy, sự thất vọng tăng lên + +
+ +
+✨ CÁCH MỚI: Chạy song song ngay từ đầu (Chủ động) - ĐƯỢC KHUYÊN NGHỊ + +### Quy trình làm việc mới của bạn: +- **2pm:** **Terminal 1:** `ccs "Lập kế hoạch kiến trúc API"` → Tư duy chiến lược (Claude Pro) +- **2pm:** **Terminal 2:** `ccs glm "Triển khai các điểm cuối API"` → Thực thi mã (GLM) +- **3pm:** Vẫn đang giao hàng, không có gián đoạn +- **4pm:** Đạt trạng thái dòng chảy, năng suất tăng vọt +- **5pm:** Tính năng đã giao hàng, ngữ cảnh được duy trì + +- **Kết quả:** Không có thời gian chết, năng suất liên tục, ít thất vọng hơn + +### 💰 **Giá trị đề xuất:** +- **Thiết lập:** Claude Pro hiện tại của bạn + GLM Lite (add-on hiệu quả về chi phí) +- **Giá trị:** Tiết kiệm 1 giờ/ngày × 20 ngày làm việc = 20 giờ/tháng được phục hồi +- **ROI:** Thời gian phát triển của bạn có giá trị hơn chi phí thiết lập +- **Thực tế:** Giao hàng nhanh hơn chi phí vận hành + +
+ +## Chọn con đường của bạn + +
+Tập trung vào ngân sách: Chỉ GLM + +- **Tốt nhất cho:** Phát triển tiết kiệm chi phí, tạo mã cơ bản +- **Sử dụng:** Chỉ sử dụng `ccs glm` trực tiếp để được trợ giúp AI hiệu quả về chi phí +- **Thực tế:** Không có quyền truy cập Claude, nhưng có khả năng cho nhiều nhiệm vụ mã hóa +- **Thiết lập:** Chỉ cần API key GLM, rất phải chăng + +
+ +
+✨ Được khuyên nghị cho phát triển hàng ngày: 1 Claude Pro + 1 GLM Lite + +- **Tốt nhất cho:** Giao hàng mã hàng ngày, công việc phát triển nghiêm túc +- **Sử dụng:** `ccs` để lập kế hoạch + `ccs glm` để thực thi (quy trình công việc song song) +- **Thực tế:** Cân bằng hoàn hảo giữa khả năng và chi phí cho hầu hết các nhà phát triển +- **Giá trị:** Không bao giờ đạt đến giới hạn phiên, năng suất liên tục + +
+ +
+Power User: Nhiều Claude Pro + GLM Pro + +- **Tốt nhất cho:** Nhiều công việc, dự án đồng thời, solo dev +- **Mở khóa:** Không bao giờ cạn kiệt giới hạn phiên hoặc hàng tuần +- **Quy trình làm việc:** 3+ terminal chạy các nhiệm vụ chuyên biệt đồng thời + +
+ +
+Tập trung vào quyền riêng tư: Cách ly Công việc/Cá nhân + +- **Khi cần:** Cách ly nghiêm ngặt ngữ cảnh AI công việc và cá nhân +- **Thiết lập:** `ccs auth create work` + `ccs auth create personal` +- **Lưu ý:** Tính năng nâng cao - hầu hết người dùng không cần điều này + +
+ +--- ## Why CCS Instead of Manual Switching?
-| Feature | Benefit | -|:--------|:--------| -| **Account Isolation** | Keep work separate from personal | -| **Cost Optimization** | 2-3 Pro accounts vs Max at 5x cost | -| **Instant Switching** | One command, no file editing | -| **Zero Downtime** | Never interrupt workflow | -| **Rate Limit Management** | Switch accounts when limits hit | -| **Cross-Platform** | macOS, Linux, Windows | +**CCS không phải về "chuyển đổi khi bạn đạt đến giới hạn lúc 3pm."** + +## **Nó về việc chạy song song ngay từ đầu.**
+### Sự khác biệt cốt lõi + +| **Chuyển đổi thủ công** | **Điều phối CCS** | +|:---|:---| +| 🔴 Đạt giới hạn → Dừng công việc → Chỉnh sửa tệp cấu hình → Khởi động lại | ✅ Nhiều terminal chạy các mô hình khác nhau ngay từ đầu | +| 😰 Mất ngữ cảnh và gián đoạn trạng thái dòng chảy | 😌 Năng suất liên tục với ngữ cảnh được bảo toàn | +| 📝 Xử lý nhiệm vụ tuần tự | ⚡ Quy trình công việc song song (lập kế hoạch + thực thi đồng thời) | +| 🛠️ Giải quyết vấn đề phản ứng khi bị chặn | 🎯 Thiết kế quy trình công việc chủ động ngăn chặn chặn | + +### CCS mang lại cho bạn + +- **Không chuyển đổi ngữ cảnh:** Duy trì trạng thái dòng chảy của bạn mà không bị gián đoạn +- **Năng suất song song:** Lập kế hoạch chiến lược trong một terminal, thực thi mã trong terminal khác +- **Quản lý tài khoản tức thì:** Một lệnh chuyển đổi, không cần chỉnh sửa tệp cấu hình +- **Cách ly công việc-cuộc sống:** Cách ly ngữ cảnh mà không cần đăng xuất +- **Tính nhất quán đa nền tảng:** Trải nghiệm mượt mà tương tự trên macOS, Linux, Windows +
## Architecture