docs(readme): add upgrade instructions for 0.3.x to 0.4.x

Author: waterbang

README.ja.md

@@ -69,6 +69,23 @@ cccc
 >
 > エラーが発生した場合は、診断と解決を手伝ってください。
 
+### 旧バージョンからのアップグレード
+
+古いバージョンの cccc-pair（例：0.3.x）がインストールされている場合は、先にアンインストールが必要です：
+
+```bash
+# pipx ユーザー
+pipx uninstall cccc-pair
+
+# pip ユーザー
+pip uninstall cccc-pair
+
+# 残留ファイルがある場合は手動で削除
+rm -f ~/.local/bin/cccc ~/.local/bin/ccccd
+```
+
+> **注意**：0.4.x のコマンド構造は 0.3.x と完全に異なります。旧版の `init`、`run`、`bridge` コマンドは `attach`、`daemon`、`mcp` などに置き換えられました。
+
 ### TestPyPI からインストール（推奨）
 
 ```bash

README.md

@@ -69,6 +69,23 @@ Copy this prompt to your AI assistant (Claude, ChatGPT, etc.):
 >
 > If you encounter any errors, please help me diagnose and resolve them.
 
+### Upgrading from older versions
+
+If you have an older version of cccc-pair installed (e.g., 0.3.x), you must uninstall it first:
+
+```bash
+# For pipx users
+pipx uninstall cccc-pair
+
+# For pip users
+pip uninstall cccc-pair
+
+# Remove any leftover binaries if needed
+rm -f ~/.local/bin/cccc ~/.local/bin/ccccd
+```
+
+> **Note**: Version 0.4.x has a completely different command structure from 0.3.x. The old `init`, `run`, `bridge` commands are replaced with `attach`, `daemon`, `mcp`, etc.
+
 ### From TestPyPI (recommended)
 
 ```bash

README.zh-CN.md

@@ -69,6 +69,23 @@ cccc
 >
 > 如果遇到任何错误，请帮我诊断并解决。
 
+### 从旧版本升级
+
+如果你已安装旧版本的 cccc-pair（如 0.3.x），必须先卸载：
+
+```bash
+# pipx 用户
+pipx uninstall cccc-pair
+
+# pip 用户
+pip uninstall cccc-pair
+
+# 如有残留，手动删除
+rm -f ~/.local/bin/cccc ~/.local/bin/ccccd
+```
+
+> **注意**：0.4.x 版本的命令结构与 0.3.x 完全不同。旧版的 `init`、`run`、`bridge` 命令已被 `attach`、`daemon`、`mcp` 等替代。
+
 ### 从 TestPyPI 安装（推荐）
 
 ```bash

docs/guide/faq.md

@@ -10,14 +10,31 @@ Frequently asked questions about CCCC.
 # From TestPyPI (RC version)
 python -m pip install --index-url https://pypi.org/simple \
   --extra-index-url https://test.pypi.org/simple \
-  cccc-pair==0.4.0rc16
+  cccc-pair==0.4.0rc17
 
 # From source
-git clone https://github.com/ChesterRa/cccc
+git clone https://github.com/dweb-channel/cccc
 cd cccc
 pip install -e .
 ```
 
+### How do I upgrade from an older version (0.3.x)?
+
+You must uninstall the old version first:
+
+```bash
+# For pipx users
+pipx uninstall cccc-pair
+
+# For pip users
+pip uninstall cccc-pair
+
+# Remove any leftover binaries
+rm -f ~/.local/bin/cccc ~/.local/bin/ccccd
+```
+
+Then install the new version. Note that 0.4.x has a completely different command structure from 0.3.x.
+
 ### What are the system requirements?
 
 - Python 3.9+

docs/guide/getting-started/index.md

@@ -41,18 +41,37 @@ Both approaches require:
 
 ## Installation
 
+### Upgrading from older versions
+
+If you have an older version of cccc-pair installed (e.g., 0.3.x), you must uninstall it first:
+
+```bash
+# For pipx users
+pipx uninstall cccc-pair
+
+# For pip users
+pip uninstall cccc-pair
+
+# Remove any leftover binaries if needed
+rm -f ~/.local/bin/cccc ~/.local/bin/ccccd
+```
+
+::: warning Version 0.4.x Breaking Changes
+Version 0.4.x has a completely different command structure from 0.3.x. The old `init`, `run`, `bridge` commands are replaced with `attach`, `daemon`, `mcp`, etc.
+:::
+
 ### From TestPyPI (recommended for RC)
 
 ```bash
 python -m pip install --index-url https://pypi.org/simple \
   --extra-index-url https://test.pypi.org/simple \
-  cccc-pair==0.4.0rc16
+  cccc-pair==0.4.0rc17
 ```
 
 ### From Source
 
 ```bash
-git clone https://github.com/ChesterRa/cccc
+git clone https://github.com/dweb-channel/cccc
 cd cccc
 pip install -e .
 ```

docs/vnext/RELEASE.md

@@ -40,5 +40,5 @@ The release workflow is tag-driven (`v*`) and enforces that the git tag matches
 ```bash
 python -m pip install --index-url https://pypi.org/simple \
   --extra-index-url https://test.pypi.org/simple \
-  cccc-pair==0.4.0rc16
+  cccc-pair==0.4.0rc17
 ```