From 093520ab65dacee7be28d4c504b1e0c05eb7a00e Mon Sep 17 00:00:00 2001
From: nrslib <38722970+nrslib@users.noreply.github.com>
Date: Fri, 6 Feb 2026 14:18:33 +0900
Subject: [PATCH] =?UTF-8?q?README:=20coding=20=E3=83=94=E3=83=BC=E3=82=B9?=
 =?UTF-8?q?=E3=80=81=E6=96=B0=E3=82=A8=E3=83=BC=E3=82=B8=E3=82=A7=E3=83=B3?=
 =?UTF-8?q?=E3=83=88=E3=80=81=E6=9C=AA=E8=A8=98=E8=BC=89=E3=82=B3=E3=83=9E?=
 =?UTF-8?q?=E3=83=B3=E3=83=89=EF=BC=88prompt/reset=20categories/list=20non?=
 =?UTF-8?q?-interactive/eject=20--global=EF=BC=89=E3=82=92=E8=BF=BD?=
 =?UTF-8?q?=E5=8A=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md         | 21 ++++++++++++++++++++-
 docs/README.ja.md | 21 ++++++++++++++++++++-
 2 files changed, 40 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7ecfdf0..a9066cc 100644
--- a/README.md
+++ b/README.md
@@ -190,6 +190,12 @@ takt watch
 ```bash
 # List task branches (merge/delete)
 takt list
+
+# Non-interactive mode (for CI/scripts)
+takt list --non-interactive
+takt list --non-interactive --action diff --branch takt/my-branch
+takt list --non-interactive --action delete --branch takt/my-branch --yes
+takt list --non-interactive --format json
 ```
 
 ### Pipeline Mode (for CI/Automation)
@@ -229,17 +235,26 @@ In pipeline mode, PRs are not created unless `--auto-pr` is specified.
 # Interactively switch pieces
 takt switch
 
-# Copy builtin pieces/agents to ~/.takt/ for customization
+# Copy builtin pieces/agents to project .takt/ for customization
 takt eject
 
+# Copy to ~/.takt/ (global) instead
+takt eject --global
+
 # Clear agent conversation sessions
 takt clear
 
 # Deploy builtin pieces/agents as Claude Code Skill
 takt export-cc
 
+# Preview assembled prompts for each movement and phase
+takt prompt [piece]
+
 # Configure permission mode
 takt config
+
+# Reset piece categories to builtin defaults
+takt reset categories
 ```
 
 ### Recommended Pieces
@@ -394,6 +409,7 @@ TAKT includes multiple builtin pieces:
 | `expert` | Full-stack development piece: architecture, frontend, security, QA reviews with fix loops. |
 | `expert-cqrs` | Full-stack development piece (CQRS+ES specialized): CQRS+ES, frontend, security, QA reviews with fix loops. |
 | `magi` | Deliberation system inspired by Evangelion. Three AI personas (MELCHIOR, BALTHASAR, CASPER) analyze and vote. |
+| `coding` | Lightweight development piece: architect-planner → implement → parallel review (AI antipattern + architecture) → fix. Fast feedback loop without supervisor. |
 | `passthrough` | Thinnest wrapper. Pass task directly to coder as-is. No review. |
 | `review-only` | Read-only code review piece that makes no changes. |
 
@@ -406,10 +422,13 @@ Use `takt switch` to switch pieces.
 | Agent | Description |
 |-------|-------------|
 | **planner** | Task analysis, spec investigation, implementation planning |
+| **architect-planner** | Task analysis and design planning: investigates code, resolves unknowns, creates implementation plans |
 | **coder** | Feature implementation, bug fixing |
 | **ai-antipattern-reviewer** | AI-specific antipattern review (non-existent APIs, incorrect assumptions, scope creep) |
 | **architecture-reviewer** | Architecture and code quality review, spec compliance verification |
+| **qa-reviewer** | Test coverage and quality assurance review |
 | **security-reviewer** | Security vulnerability assessment |
+| **conductor** | Phase 3 judgment specialist: reads reports/responses and outputs status tags |
 | **supervisor** | Final validation, approval |
 
 ## Custom Agents
diff --git a/docs/README.ja.md b/docs/README.ja.md
index eb344f4..654e4e5 100644
--- a/docs/README.ja.md
+++ b/docs/README.ja.md
@@ -186,6 +186,12 @@ takt watch
 ```bash
 # タスクブランチ一覧（マージ・削除）
 takt list
+
+# 非対話モード（CI/スクリプト向け）
+takt list --non-interactive
+takt list --non-interactive --action diff --branch takt/my-branch
+takt list --non-interactive --action delete --branch takt/my-branch --yes
+takt list --non-interactive --format json
 ```
 
 ### パイプラインモード（CI/自動化向け）
@@ -225,17 +231,26 @@ takt --pipeline --task "バグを修正" --quiet
 # ピースを対話的に切り替え
 takt switch
 
-# ビルトインのピース/エージェントを~/.takt/にコピーしてカスタマイズ
+# ビルトインのピース/エージェントをプロジェクト .takt/ にコピーしてカスタマイズ
 takt eject
 
+# ~/.takt/（グローバル）にコピー
+takt eject --global
+
 # エージェントの会話セッションをクリア
 takt clear
 
 # ビルトインピース・エージェントを Claude Code Skill としてデプロイ
 takt export-cc
 
+# 各ムーブメント・フェーズの組み立て済みプロンプトをプレビュー
+takt prompt [piece]
+
 # パーミッションモードを設定
 takt config
+
+# ピースカテゴリをビルトインのデフォルトにリセット
+takt reset categories
 ```
 
 ### おすすめピース
@@ -390,6 +405,7 @@ TAKTには複数のビルトインピースが同梱されています:
 | `expert` | フルスタック開発ピース: アーキテクチャ、フロントエンド、セキュリティ、QA レビューと修正ループ。 |
 | `expert-cqrs` | フルスタック開発ピース（CQRS+ES特化）: CQRS+ES、フロントエンド、セキュリティ、QA レビューと修正ループ。 |
 | `magi` | エヴァンゲリオンにインスパイアされた審議システム。3つの AI ペルソナ（MELCHIOR、BALTHASAR、CASPER）が分析し投票。 |
+| `coding` | 軽量開発ピース: architect-planner → 実装 → 並列レビュー（AI アンチパターン＋アーキテクチャ）→ 修正。スーパーバイザーなしの高速フィードバックループ。 |
 | `passthrough` | 最小構成。タスクをそのまま coder に渡す薄いラッパー。レビューなし。 |
 | `review-only` | 変更を加えない読み取り専用のコードレビューピース。 |
 
@@ -402,10 +418,13 @@ TAKTには複数のビルトインピースが同梱されています:
 | エージェント | 説明 |
 |------------|------|
 | **planner** | タスク分析、仕様調査、実装計画 |
+| **architect-planner** | タスク分析と設計計画: コード調査、不明点の解決、実装計画の作成 |
 | **coder** | 機能の実装、バグ修正 |
 | **ai-antipattern-reviewer** | AI特有のアンチパターンレビュー（存在しないAPI、誤った仮定、スコープクリープ） |
 | **architecture-reviewer** | アーキテクチャとコード品質のレビュー、仕様準拠の検証 |
+| **qa-reviewer** | テストカバレッジと品質保証のレビュー |
 | **security-reviewer** | セキュリティ脆弱性の評価 |
+| **conductor** | Phase 3 判定専用: レポートやレスポンスを読み取り、ステータスタグを出力 |
 | **supervisor** | 最終検証、バリデーション、承認 |
 
 ## カスタムエージェント