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** | 最終検証、バリデーション、承認 | ## カスタムエージェント