TAKT

TAKT (TAKT Agent Koordination Topology) is a workflow orchestration tool designed specifically for AI coding agents, currently at version v0.37.0. It uses YAML declarative syntax with steps, initial_step, and max_steps to define agent execution sequences, supporting conditional jumps and COMPLETE/ABORT termination states, enabling developers to precisely define structured loops encompassing planning, implementation, review, and fixing.

Core Architecture

• WorkflowEngine as the runtime core driving workflow parsing and execution
• Three-tier configuration override: project-level (.takt/workflows/) > user-level (~/.takt/workflows/) > built-in (builtins/)
• Dual Schema validation (Ajv + Zod) for strong type safety of workflow definitions
• Multi-provider adapter layer: unified integration with Claude Code, Codex, OpenCode, Cursor Agent, GitHub Copilot, etc.
• Modular design: prompt management extracted into faceted-prompting package, config management into traced-config package

Faceted Prompting Mechanism Decomposes prompts into independent facets—persona, policy, knowledge, and instruction—for flexible management and free combination across different workflows, enabling prompt reuse and standardization.

Multi-Agent Collaboration

• Orchestrate agents with different personas and permissions
• Support parallel reviewing (e.g., architecture review + supervisor review running simultaneously)
• Failure routing back to implementer with declarative rule-based result aggregation
• Built-in Architecture, Security, and AI antipattern review criteria

Environment Isolation & Task Management

• Automatic Git worktree creation during task execution to avoid polluting the main branch
• Conversational requirement definition with queueing mechanism; takt run for batch execution
• Direct task import from GitHub/GitLab Issues (e.g., takt add #6)
• NDJSON logging per step for full traceability from task dispatch to PR generation

Standardization & Reuse

• Workflow YAML files support team sharing for consistent quality processes
• Repertoire package mechanism (takt repertoire add) for installing and distributing workflows
• Built-in workflows: default (standard development), frontend-mini, backend-mini, dual-mini
• Workflow management commands: takt workflow init, takt eject, takt workflow doctor

Installation & Quick Start

npm install -g takt
takt          # Start interactive conversation
takt run      # Execute queued tasks
takt add #6   # Import from GitHub Issue
takt list     # View task branches

Configuration (~/.takt/config.yaml):

provider: claude    # claude | claude-sdk | codex | opencode | cursor | copilot
model: sonnet
language: en        # en | ja

Node.js API:

import { WorkflowEngine, loadWorkflow } from 'takt';
const config = loadWorkflow('default', process.cwd());
const engine = new WorkflowEngine(config, process.cwd(), 'My task');
await engine.run();

CI/CD Integration: Official takt-action GitHub Action with --pipeline mode for seamless pipeline integration. Repository includes Dockerfile, docker-compose.yml, and devcontainer configuration. Supports English and Japanese.