docs: restructure README files with parallel workflow messaging and user path guidance

This commit is contained in:
kaitranntt
2025-11-13 21:59:14 -05:00
parent f4cd32baf0
commit 01cff1114b
3 changed files with 318 additions and 48 deletions
+105 -15
View File
@@ -161,34 +161,124 @@ ccs glmt "推論ステップ付き複雑なアルゴリズムのデバッグ"
## 開発者の日常的な課題
<div align="center">
### **切り替えを停止。調整を開始。**
**セッション制限がフロー状態を殺すべきではありません。**
</div>
開発者は日々多くのサブスクリプションシナリオに直面します:
実装に深く集中しています。コンテキストが読み込まれました。解決策が結晶化しています。<br>
その後: 🔴 _"使用制限に達しました。"_
1. **アカウント分離** - 会社のClaudeアカウント vs 個人Claude → 業務と個人のコンテキストを手動で切り替える必要
2. **レート制限** - Claudeがプロジェクト途中で停止 → 手動で`~/.claude/settings.json`を編集
3. **コスト管理** - 2-3つのProサブスクリプション(月$20 vs Claude Maxの5倍コスト(月$100)→ Pro階層が実用的な上限
4. **モデル選択** - タスクごとに異なるモデルの強みを活用 → 手動切り替え
**モチベーションが失われました。コンテキストが失われました。生産性が崩壊しました。**
**手動コンテキスト切り替えはワークフローを中断します。CCSがシームレスに管理します。**
## **解決策:並列ワークフロー**
<br>
<details>
<summary><strong>❌ 古い方法:</strong> 制限に達した時に切り替える(反応的)</summary>
### 現在のワークフロー:
- **14時:** 機能開発、ゾーン状態
- **15時:** 🔴 使用制限に達した
- **15:05:** 作業停止、`~/.claude/settings.json`を編集
- **15:15:** アカウント切り替え、コンテキストが失われる
- **15:30:** フロー状態に戻ろうと試みる
- **16時:** ついに生産性が回復
- **結果:** 1時間失われ、モチベーションが破壊され、不満が蓄積
</details>
<details open>
<summary><strong>✨ 新しい方法:</strong> 最初から並列で実行(主導的) - <strong>推奨</strong></summary>
### 新しいワークフロー:
- **14時:** **ターミナル1:** `ccs "APIアーキテクチャを計画"` → 戦略的思考(Claude Pro
- **14時:** **ターミナル2:** `ccs glm "エンドポイントを実装"` → コード実行(GLM
- **15時:** まだ開発継続、割れなし
- **16時:** フロー状態達成、生産性急上昇
- **17時:** 機能が完了、コンテキスト維持
- **結果:** ダウムタイムなし、継続的生産性、不満減少
### 💰 **価値提案:**
- **設定:** 既存のClaude Pro + GLM Lite(費用対効果の高い追加)
- **価値:** 1時間/日 × 20労働日 = 20時間/月を回収
- **ROI:** 開発時間は設定コスト以上の価値がある
- **現実:** オーバーヘッドより速く出荷
</details>
## あなたの道を選択
<details>
<summary><strong>予算重視:</strong> GLMのみ</summary>
- **最適:** 費用意識の高い開発、基本的なコード生成
- **使用法:** 費用効果の高いAI支援のために`ccs glm`を直接使用
- **現実:** Claudeアクセスなし、多くのコーディングタスクに対応可能
- **設定:** GLM APIキーのみ、非常に手頃
</details>
<details open>
<summary><strong>✨ 日々の開発に推奨:</strong> 1 Claude Pro + 1 GLM Lite</summary>
- **最適:** 日々のコードデリバリー、真剣な開発作業
- **使用法:** `ccs`で計画 + `ccs glm`で実行(並列ワークフロー)
- **現実:** ほとんどの開発者にとって能力と費用の完璧なバランス
- **価値:** セッション制限に達せず、継続的生産性
</details>
<details>
<summary><strong>パワーユーザー:</strong> 複数のClaude Pro + GLM Pro</summary>
- **最適:** 重い作業量、並行プロジェクト、ソロ開発
- **解放:** セッション・週次制限を決して枯渇させない
- **ワークフロー:** 3+以上のターミナルで専門タスクを同時実行
</details>
<details>
<summary><strong>プライバシー重視:</strong> 仕事/個人の分離</summary>
- **必要時:** 仕事と個人AIコンテキストの厳格な分離
- **設定:** `ccs auth create work` + `ccs auth create personal`
- **注意:** 高度な機能 - ほとんどのユーザーには不要
</details>
---
## 手動切り替えではなくCCSを使う理由は?
<div align="center">
| 機能 | 利益 |
|:--------|:--------|
| **アカウント分離** | 業務と個人を分離 |
| **コスト最適化** | 2-3つのProアカウント vs Max 5倍コスト |
| **即座の切り替え** | 1コマンド、ファイル編集不要 |
| **ゼロダウンタイム** | ワークフロー中断なし |
| **レート制限管理** | 制限時にアカウント切り替え |
| **クロスプラットフォーム** | macOS、Linux、Windows |
**CCSは「午後3時に制限に達したら切り替える」ことではありません。**
## **それは最初から並列で実行することです。**
</div>
### コアな違い
| **手動切り替え** | **CCSオーケストレーション** |
|:---|:---|
| 🔴 制限達成 → 作業停止 → 設定ファイル編集 → 再起動 | ✅ 最初から異なるモデルで複数ターミナルを実行 |
| 😰 コンテキストロスとフロー状態中断 | 😌 コンテキスト維持での継続的生産性 |
| 📝 逐次的タスク処理 | ⚡ 並列ワークフロー(計画 + 実行を同時に) |
| 🛠️ ブロックされた時の反応的問題解決 | 🎯 ブロックを防ぐ主導的ワークフロー設計 |
### CCSが提供するもの
- **ゼロコンテキスト切り替え:** 割れずにフロー状態を維持
- **並列生産性:** 1ターミナルで戦略計画、もう1つでコード実行
- **即座アカウント管理:** 1コマンド切り替え、設定ファイル編集不要
- **仕事と生活の分離:** ログアウトせずにコンテキストを分離
- **クロスプラットフォーム一貫性:** macOS、Linux、Windowsで同じスムーズな体験
<br>
## アーキテクチャ
+107 -17
View File
@@ -157,34 +157,126 @@ ccs glmt "Debug complex algorithm with reasoning steps"
## The Daily Developer Pain Point
<div align="center">
### **STOP Switching. START Orchestrating.**
**Session limits shouldn't kill your flow state.**
</div>
Developers face multiple subscription scenarios daily:
You're deep in implementation. Context loaded. Solution crystallizing.<br>
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**
<br>
<details>
<summary><strong>❌ OLD WAY:</strong> Switch When You Hit Limits (Reactive)</summary>
### 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
</details>
<details open>
<summary><strong>✨ NEW WAY:</strong> Run Parallel From Start (Proactive) - <strong>RECOMMENDED</strong></summary>
### 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
</details>
## Choose Your Path
<details>
<summary><strong>Budget-Focused:</strong> GLM Only</summary>
- **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
</details>
<details open>
<summary><strong>✨ Recommended for Daily Development:</strong> 1 Claude Pro + 1 GLM Lite</summary>
- **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
</details>
<details>
<summary><strong>Power User:</strong> Multiple Claude Pro + GLM Pro</summary>
- **Best for:** Heavy workloads, concurrent projects, solo dev
- **Unlocks:** Never drain session or weekly limits
- **Workflow:** 3+ terminals running specialized tasks simultaneously
</details>
<details>
<summary><strong>Privacy-Focused:</strong> Work/Personal Isolation</summary>
- **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
</details>
---
## Why CCS Instead of Manual Switching?
<div align="center">
| 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.**
</div>
### 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.**
<br>
## Architecture
@@ -322,8 +414,6 @@ ccs --help # Show all commands and options
</details>
<br>
<details>
<summary><h3>Tool Support (v3.5) - EXPERIMENTAL</h3></summary>
+106 -16
View File
@@ -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.**
<div align="center">
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.**
</div>
**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.<br>
Sau đó: 🔴 _"Bạn đã đạt đến giới hạn sử dụng."_
<br>
**Độ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**
<details>
<summary><strong>❌ CÁCH CŨ:</strong> Chuyển đổi khi bạn đạt đến giới hạn (Phản ứng)</summary>
### 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
</details>
<details open>
<summary><strong>✨ CÁCH MỚI:</strong> Chạy song song ngay từ đầu (Chủ động) - <strong>ĐƯỢC KHUYÊN NGHỊ</strong></summary>
### 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
</details>
## Chọn con đường của bạn
<details>
<summary><strong>Tập trung vào ngân sách:</strong> Chỉ GLM</summary>
- **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
</details>
<details open>
<summary><strong>✨ Được khuyên nghị cho phát triển hàng ngày:</strong> 1 Claude Pro + 1 GLM Lite</summary>
- **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
</details>
<details>
<summary><strong>Power User:</strong> Nhiều Claude Pro + GLM Pro</summary>
- **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
</details>
<details>
<summary><strong>Tập trung vào quyền riêng tư:</strong> Cách ly Công việc/Cá nhân</summary>
- **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
</details>
---
## Why CCS Instead of Manual Switching?
<div align="center">
| 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.**
</div>
### 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
<br>
## Architecture