532b1961a7
- expert/expert-mini/expert-cqrs/expert-cqrs-mini を dual 系にリネーム （「フルスタック」→「フロントエンド＋バックエンド」に説明も修正） - expert-supervisor ペルソナを dual-supervisor にリネーム - passthrough, structural-reform ピースを削除 - default-mini, default-test-first-mini を default に統合 - coding-pitfalls ナレッジの主要項目を coding ポリシーに移動し削除 - implement/plan インストラクションにセルフチェック・コーダー指針を追加 - builtin カタログに不足していた terraform, takt-default 系を追加 - deep-research をカテゴリに追加
115 lines
7.0 KiB
Markdown
115 lines
7.0 KiB
Markdown
# Builtin Catalog
|
|
|
|
[日本語](./builtin-catalog.ja.md)
|
|
|
|
A comprehensive catalog of all builtin pieces and personas included with TAKT.
|
|
|
|
## Recommended Pieces
|
|
|
|
| Piece | Recommended Use |
|
|
|----------|-----------------|
|
|
| `default` | Standard development. Test-first with AI antipattern review and parallel review (architecture + supervisor). plan → write_tests → implement → AI antipattern review → parallel review → complete. |
|
|
| `frontend-mini` | Frontend-focused mini configuration. |
|
|
| `backend-mini` | Backend-focused mini configuration. |
|
|
| `dual-mini` | Frontend + backend mini configuration. |
|
|
|
|
## All Builtin Pieces
|
|
|
|
Organized by category.
|
|
|
|
| Category | Piece | Description |
|
|
|----------|----------|-------------|
|
|
| 🚀 Quick Start | `default` | Standard development. Test-first with AI antipattern review and parallel review (architecture + supervisor). plan → write_tests → implement → AI antipattern review → parallel review → complete. |
|
|
| | `frontend-mini` | Mini frontend piece: plan -> implement -> parallel review (AI antipattern + supervisor) with frontend knowledge injection. |
|
|
| | `backend-mini` | Mini backend piece: plan -> implement -> parallel review (AI antipattern + supervisor) with backend knowledge injection. |
|
|
| | `compound-eye` | Multi-model review: sends the same instruction to Claude and Codex simultaneously, then synthesizes both responses. |
|
|
| ⚡ Mini | `backend-cqrs-mini` | Mini CQRS+ES piece: plan -> implement -> parallel review (AI antipattern + supervisor) with CQRS+ES knowledge injection. |
|
|
| | `dual-mini` | Mini dual piece: plan -> implement -> parallel review (AI antipattern + expert supervisor) with frontend + backend knowledge injection. |
|
|
| | `dual-cqrs-mini` | Mini CQRS+ES dual piece: plan -> implement -> parallel review (AI antipattern + expert supervisor) with CQRS+ES knowledge injection. |
|
|
| 🎨 Frontend | `frontend` | Frontend-specialized development piece with React/Next.js focused reviews and knowledge injection. |
|
|
| ⚙️ Backend | `backend` | Backend-specialized development piece with backend, security, and QA expert reviews. |
|
|
| | `backend-cqrs` | CQRS+ES-specialized backend development piece with CQRS+ES, security, and QA expert reviews. |
|
|
| 🔧 Dual | `dual` | Frontend + backend development piece: architecture, frontend, security, QA reviews with fix loops. |
|
|
| | `dual-cqrs` | Frontend + backend development piece (CQRS+ES specialized): CQRS+ES, frontend, security, QA reviews with fix loops. |
|
|
| 🏗️ Infrastructure | `terraform` | Terraform IaC development piece: plan → implement → parallel review → supervisor validation → fix → complete. |
|
|
| 🔍 Review | `review` | Multi-perspective code review: auto-detects PR/branch/working diff, reviews from 5 parallel perspectives (arch/security/QA/testing/requirements), outputs consolidated results. |
|
|
| 🧪 Testing | `unit-test` | Unit test focused piece: test analysis -> test implementation -> review -> fix. |
|
|
| | `e2e-test` | E2E test focused piece: E2E analysis -> E2E implementation -> review -> fix (Vitest-based E2E flow). |
|
|
| 🎵 TAKT Development | `takt-default` | TAKT development piece: plan → write tests → implement → AI antipattern review → 5-parallel review → fix → supervise → complete. |
|
|
| | `takt-default-team-leader` | TAKT development piece with team leader: plan → write tests → team-leader implement → AI antipattern review → 5-parallel review → fix → supervise → complete. |
|
|
| Others | `research` | Research piece: planner -> digger -> supervisor. Autonomously executes research without asking questions. |
|
|
| | `deep-research` | Deep research piece: plan -> dig -> analyze -> supervise. Discovery-driven investigation that follows emerging questions with multi-perspective analysis. |
|
|
| | `magi` | Deliberation system inspired by Evangelion. Three AI personas (MELCHIOR, BALTHASAR, CASPER) analyze and vote. |
|
|
|
|
Use `takt switch` to switch pieces interactively.
|
|
|
|
## Builtin Personas
|
|
|
|
| Persona | 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 |
|
|
| **frontend-reviewer** | Frontend (React/Next.js) code quality and best practices review |
|
|
| **cqrs-es-reviewer** | CQRS+Event Sourcing architecture and implementation review |
|
|
| **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 |
|
|
| **dual-supervisor** | Multi-review integration validation and release readiness judgment |
|
|
| **research-planner** | Research task planning and scope definition |
|
|
| **research-analyzer** | Research result interpretation and additional investigation planning |
|
|
| **research-digger** | Deep investigation and information gathering |
|
|
| **research-supervisor** | Research quality validation and completeness assessment |
|
|
| **test-planner** | Test strategy analysis and comprehensive test planning |
|
|
| **testing-reviewer** | Testing-focused code review with integration test requirements analysis |
|
|
| **requirements-reviewer** | Requirements specification and compliance review |
|
|
| **terraform-coder** | Terraform IaC implementation |
|
|
| **terraform-reviewer** | Terraform IaC review |
|
|
| **melchior** | MAGI deliberation system: MELCHIOR-1 (scientist perspective) |
|
|
| **balthasar** | MAGI deliberation system: BALTHASAR-2 (mother perspective) |
|
|
| **casper** | MAGI deliberation system: CASPER-3 (woman perspective) |
|
|
| **pr-commenter** | Posts review findings as GitHub PR comments |
|
|
|
|
## Custom Personas
|
|
|
|
Create persona prompts as Markdown files in `~/.takt/personas/`:
|
|
|
|
```markdown
|
|
# ~/.takt/personas/my-reviewer.md
|
|
|
|
You are a code reviewer specialized in security.
|
|
|
|
## Role
|
|
- Check for security vulnerabilities
|
|
- Verify input validation
|
|
- Review authentication logic
|
|
```
|
|
|
|
Reference custom personas from piece YAML via the `personas` section map:
|
|
|
|
```yaml
|
|
personas:
|
|
my-reviewer: ~/.takt/personas/my-reviewer.md
|
|
|
|
movements:
|
|
- name: review
|
|
persona: my-reviewer
|
|
# ...
|
|
```
|
|
|
|
## Per-persona Provider Overrides
|
|
|
|
Use `persona_providers` in `~/.takt/config.yaml` to route specific personas to different providers without duplicating pieces. This allows you to run, for example, coding on Codex while keeping reviewers on Claude.
|
|
|
|
```yaml
|
|
# ~/.takt/config.yaml
|
|
persona_providers:
|
|
coder: codex # Run coder on Codex
|
|
ai-antipattern-reviewer: claude # Keep reviewers on Claude
|
|
```
|
|
|
|
This configuration applies globally to all pieces. Any movement using the specified persona will be routed to the corresponding provider, regardless of which piece is being executed.
|