Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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. |

Expand All @@ -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
Expand Down
21 changes: 20 additions & 1 deletion docs/README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/自動化向け)
Expand Down Expand Up @@ -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
```

### おすすめピース
Expand Down Expand Up @@ -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` | 変更を加えない読み取り専用のコードレビューピース。 |

Expand All @@ -402,10 +418,13 @@ TAKTには複数のビルトインピースが同梱されています:
| エージェント | 説明 |
|------------|------|
| **planner** | タスク分析、仕様調査、実装計画 |
| **architect-planner** | タスク分析と設計計画: コード調査、不明点の解決、実装計画の作成 |
| **coder** | 機能の実装、バグ修正 |
| **ai-antipattern-reviewer** | AI特有のアンチパターンレビュー(存在しないAPI、誤った仮定、スコープクリープ) |
| **architecture-reviewer** | アーキテクチャとコード品質のレビュー、仕様準拠の検証 |
| **qa-reviewer** | テストカバレッジと品質保証のレビュー |
| **security-reviewer** | セキュリティ脆弱性の評価 |
| **conductor** | Phase 3 判定専用: レポートやレスポンスを読み取り、ステータスタグを出力 |
| **supervisor** | 最終検証、バリデーション、承認 |

## カスタムエージェント
Expand Down