From dd71c408c4c8a23578ef0c06a5612e9406dd2003 Mon Sep 17 00:00:00 2001
From: nrslib <38722970+nrslib@users.noreply.github.com>
Date: Mon, 9 Feb 2026 08:15:18 +0900
Subject: [PATCH] =?UTF-8?q?builtin=20config.yaml=20=E3=82=92=20GlobalConfi?=
 =?UTF-8?q?g=20=E3=81=AE=E5=85=A8=E8=A8=AD=E5=AE=9A=E9=A0=85=E7=9B=AE?=
 =?UTF-8?q?=E3=81=AB=E5=90=88=E3=82=8F=E3=81=9B=E3=81=A6=E6=9C=80=E6=96=B0?=
 =?UTF-8?q?=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 builtins/en/config.yaml | 89 ++++++++++++++++++++++++++++++++--------
 builtins/ja/config.yaml | 91 +++++++++++++++++++++++++++++++++--------
 2 files changed, 145 insertions(+), 35 deletions(-)

diff --git a/builtins/en/config.yaml b/builtins/en/config.yaml
index 9299c89..b23915d 100644
--- a/builtins/en/config.yaml
+++ b/builtins/en/config.yaml
@@ -1,34 +1,85 @@
 # TAKT Global Configuration
-# This file contains default settings for takt.
+# Location: ~/.takt/config.yaml
 
-# Language setting (en or ja)
+# ── Basic ──
+
+# Language (en | ja)
 language: en
 
-# Default piece to use when no piece is specified
+# Default piece when no piece is specified
 default_piece: default
 
-# Log level: debug, info, warn, error
+# Log level (debug | info | warn | error)
 log_level: info
 
-# Provider runtime: claude or codex
+# ── Provider & Model ──
+
+# Provider runtime (claude | codex)
 provider: claude
 
-# Builtin pieces (resources/global/{lang}/pieces)
-# enable_builtin_pieces: true
-
 # Default model (optional)
-# Claude: opus, sonnet, haiku, opusplan, default, or full model name
+# Claude: opus, sonnet, haiku
 # Codex: gpt-5.2-codex, gpt-5.1-codex, etc.
 # model: sonnet
 
-# Anthropic API key (optional, overridden by TAKT_ANTHROPIC_API_KEY env var)
-# anthropic_api_key: ""
+# Per-persona provider override (optional)
+# Override provider for specific personas. Others use the global provider.
+# persona_providers:
+#   coder: codex
 
-# OpenAI API key (optional, overridden by TAKT_OPENAI_API_KEY env var)
+# ── API Keys ──
+# Optional. Environment variables take priority:
+#   TAKT_ANTHROPIC_API_KEY, TAKT_OPENAI_API_KEY
+
+# anthropic_api_key: ""
 # openai_api_key: ""
 
-# Pipeline execution settings (optional)
-# Customize branch naming, commit messages, and PR body for pipeline mode (--task).
+# ── Execution ──
+
+# Worktree (shared clone) directory (default: ../{clone-name} relative to project)
+# worktree_dir: ~/takt-worktrees
+
+# Auto-create PR after worktree execution (default: prompt in interactive mode)
+# auto_pr: false
+
+# Prevent macOS idle sleep during execution using caffeinate (default: false)
+# prevent_sleep: false
+
+# ── Parallel Execution (takt run) ──
+
+# Number of tasks to run concurrently (1 = sequential, max: 10)
+# concurrency: 1
+
+# Polling interval in ms for picking up new tasks (100-5000, default: 500)
+# task_poll_interval_ms: 500
+
+# ── Interactive Mode ──
+
+# Number of movement previews shown in interactive mode (0 to disable, max: 10)
+# interactive_preview_movements: 3
+
+# Branch name generation strategy (romaji: fast default | ai: slow)
+# branch_name_strategy: romaji
+
+# ── Output ──
+
+# Notification sounds (default: true)
+# notification_sound: true
+
+# Minimal output for CI - suppress AI output (default: false)
+# minimal_output: false
+
+# ── Builtin Pieces ──
+
+# Enable builtin pieces (default: true)
+# enable_builtin_pieces: true
+
+# Exclude specific builtins from loading
+# disabled_builtins:
+#   - magi
+
+# ── Pipeline Mode (--pipeline) ──
+
 # pipeline:
 #   default_branch_prefix: "takt/"
 #   commit_message_template: "feat: {title} (#{issue})"
@@ -37,10 +88,14 @@ provider: claude
 #     {issue_body}
 #     Closes #{issue}
 
-# Notification sounds (true: enabled, false: disabled, default: true)
-# notification_sound: true
+# ── Preferences ──
+
+# Custom paths for preference files
+# bookmarks_file: ~/.takt/preferences/bookmarks.yaml
+# piece_categories_file: ~/.takt/preferences/piece-categories.yaml
+
+# ── Debug ──
 
-# Debug settings (optional)
 # debug:
 #   enabled: false
 #   log_file: ~/.takt/logs/debug.log
diff --git a/builtins/ja/config.yaml b/builtins/ja/config.yaml
index 4ea789b..2cbf381 100644
--- a/builtins/ja/config.yaml
+++ b/builtins/ja/config.yaml
@@ -1,34 +1,85 @@
 # TAKT グローバル設定
-# takt のデフォルト設定ファイルです。
+# 配置場所: ~/.takt/config.yaml
 
-# 言語設定 (en または ja)
+# ── 基本設定 ──
+
+# 言語 (en | ja)
 language: ja
 
-# デフォルトのピース - 指定がない場合に使用します
+# デフォルトピース（指定なし時に使用）
 default_piece: default
 
-# ログレベル: debug, info, warn, error
+# ログレベル (debug | info | warn | error)
 log_level: info
 
-# プロバイダー: claude または codex
+# ── プロバイダー & モデル ──
+
+# プロバイダー (claude | codex)
 provider: claude
 
-# ビルトインピースの読み込み (resources/global/{lang}/pieces)
-# enable_builtin_pieces: true
-
-# デフォルトモデル (オプション)
-# Claude: opus, sonnet, haiku, opusplan, default, またはフルモデル名
+# デフォルトモデル（オプション）
+# Claude: opus, sonnet, haiku
 # Codex: gpt-5.2-codex, gpt-5.1-codex など
 # model: sonnet
 
-# Anthropic APIキー (オプション、環境変数 TAKT_ANTHROPIC_API_KEY で上書き可能)
-# anthropic_api_key: ""
+# ペルソナ単位のプロバイダー上書き（オプション）
+# 特定ペルソナだけプロバイダーを変更。未指定のペルソナはグローバル設定を使用。
+# persona_providers:
+#   coder: codex
 
-# OpenAI APIキー (オプション、環境変数 TAKT_OPENAI_API_KEY で上書き可能)
+# ── APIキー ──
+# オプション。環境変数が優先:
+#   TAKT_ANTHROPIC_API_KEY, TAKT_OPENAI_API_KEY
+
+# anthropic_api_key: ""
 # openai_api_key: ""
 
-# パイプライン実行設定 (オプション)
-# パイプラインモード (--task) のブランチ名、コミットメッセージ、PRの本文をカスタマイズできます。
+# ── 実行設定 ──
+
+# ワークツリー（shared clone）ディレクトリ（デフォルト: プロジェクトの ../{clone-name}）
+# worktree_dir: ~/takt-worktrees
+
+# ワークツリー実行後に自動PR作成（デフォルト: 対話モードで確認）
+# auto_pr: false
+
+# macOS のアイドルスリープを防止（デフォルト: false）
+# prevent_sleep: false
+
+# ── 並列実行 (takt run) ──
+
+# タスクの同時実行数（1 = 逐次実行、最大: 10）
+# concurrency: 1
+
+# 新規タスクのポーリング間隔 ms（100-5000、デフォルト: 500）
+# task_poll_interval_ms: 500
+
+# ── 対話モード ──
+
+# ムーブメントプレビューの表示数（0 で無効、最大: 10）
+# interactive_preview_movements: 3
+
+# ブランチ名の生成方式（romaji: 高速デフォルト | ai: 低速）
+# branch_name_strategy: romaji
+
+# ── 出力 ──
+
+# 通知音（デフォルト: true）
+# notification_sound: true
+
+# CI 向け最小出力 - AI 出力を抑制（デフォルト: false）
+# minimal_output: false
+
+# ── ビルトインピース ──
+
+# ビルトインピースの有効化（デフォルト: true）
+# enable_builtin_pieces: true
+
+# 特定のビルトインを除外
+# disabled_builtins:
+#   - magi
+
+# ── パイプラインモード (--pipeline) ──
+
 # pipeline:
 #   default_branch_prefix: "takt/"
 #   commit_message_template: "feat: {title} (#{issue})"
@@ -37,10 +88,14 @@ provider: claude
 #     {issue_body}
 #     Closes #{issue}
 
-# 通知音 (true: 有効 / false: 無効、デフォルト: true)
-# notification_sound: true
+# ── プリファレンス ──
+
+# プリファレンスファイルのカスタムパス
+# bookmarks_file: ~/.takt/preferences/bookmarks.yaml
+# piece_categories_file: ~/.takt/preferences/piece-categories.yaml
+
+# ── デバッグ ──
 
-# デバッグ設定 (オプション)
 # debug:
 #   enabled: false
 #   log_file: ~/.takt/logs/debug.log