From 3af30e9e18c0cbd6771c807133098c5c49c55e2b Mon Sep 17 00:00:00 2001
From: nrslib <38722970+nrslib@users.noreply.github.com>
Date: Fri, 20 Feb 2026 19:59:55 +0900
Subject: [PATCH] docs: add sync-with-root menu description to CLI reference

---
 docs/cli-reference.ja.md | 4 +++-
 docs/cli-reference.md    | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/cli-reference.ja.md b/docs/cli-reference.ja.md
index f1646dd..9a91927 100644
--- a/docs/cli-reference.ja.md
+++ b/docs/cli-reference.ja.md
@@ -164,7 +164,7 @@ takt watch
 
 ### takt list
 
-タスクブランチの一覧表示と操作（マージ、削除など）を行います。
+タスクブランチの一覧表示と操作（マージ、削除、ルートとの同期など）を行います。
 
 ```bash
 # タスクブランチの一覧表示（マージ/削除）
@@ -177,6 +177,8 @@ takt list --non-interactive --action delete --branch takt/my-branch --yes
 takt list --non-interactive --format json
 ```
 
+インタラクティブモードでは **Sync with root** を選択でき、ルートリポジトリの HEAD をワークツリーブランチにマージします。コンフリクト発生時は AI が自動解決を試みます。
+
 ### タスクディレクトリワークフロー（作成 / 実行 / 確認）
 
 1. `takt add` を実行し、`.takt/tasks.yaml` に pending レコードが作成されたことを確認。
diff --git a/docs/cli-reference.md b/docs/cli-reference.md
index ff41a22..2902a43 100644
--- a/docs/cli-reference.md
+++ b/docs/cli-reference.md
@@ -164,7 +164,7 @@ takt watch
 
 ### takt list
 
-List task branches and perform actions (merge, delete, etc.).
+List task branches and perform actions (merge, delete, sync with root, etc.).
 
 ```bash
 # List task branches (merge/delete)
@@ -177,6 +177,8 @@ takt list --non-interactive --action delete --branch takt/my-branch --yes
 takt list --non-interactive --format json
 ```
 
+In interactive mode, **Sync with root** merges the root repository HEAD into the worktree branch with AI-assisted conflict resolution.
+
 ### Task Directory Workflow (Create / Run / Verify)
 
 1. Run `takt add` and confirm a pending record is created in `.takt/tasks.yaml`.