takt 0.4.1 → 0.5.1

package/README.md

@@ -4,22 +4,32 @@
 
 **T**ask **A**gent **K**oordination **T**ool - A governance-first orchestrator for running coding agents safely and responsibly
 
-TAKT coordinates AI agents like Claude Code and Codex according to your organization's rules and workflows. It clarifies who is responsible, what is permitted, and how to recover from failures, while automating complex development tasks.
+TAKT coordinates AI agents like Claude Code and Codex according to your organization's rules and pieces. It clarifies who is responsible, what is permitted, and how to recover from failures, while automating complex development tasks.
 
 TAKT is built with TAKT itself (dogfooding).
 
+## Metaphor
+
+TAKT uses a music metaphor to describe orchestration:
+
+- **Piece**: A task execution definition (what to do and how agents coordinate)
+- **Movement**: A step inside a piece (a single stage in the flow)
+- **Orchestration**: The engine that coordinates agents across movements
+
+You can read every term as standard workflow language (piece = workflow, movement = step), but the metaphor is used to keep the system conceptually consistent.
+
 ## TAKT is For Teams That Need
 
-- **Want to integrate AI into CI/CD but fear runaway execution** — Clarify control scope with workflow definitions
+- **Want to integrate AI into CI/CD but fear runaway execution** — Clarify control scope with piece definitions
 - **Want automated PR generation but need audit logs** — Record and track all execution history
-- **Want to use multiple AI models but manage them uniformly** — Control Claude/Codex/Mock with the same workflow
+- **Want to use multiple AI models but manage them uniformly** — Control Claude/Codex/Mock with the same piece
 - **Want to reproduce and debug agent failures** — Maintain complete history with session logs and reports
 
 ## What TAKT is NOT
 
 - **Not an autonomous engineer** — TAKT doesn't complete implementations itself; it governs and coordinates multiple agents
-- **Not competing with Claude Code Swarm** — While leveraging Swarm's execution power, TAKT provides "operational guardrails" such as workflow definitions, permission controls, and audit logs
-- **Not just a workflow engine** — TAKT is designed to address AI-specific challenges (non-determinism, accountability, audit requirements, and reproducibility)
+- **Not competing with Claude Code Swarm** — While leveraging Swarm's execution power, TAKT provides "operational guardrails" such as piece definitions, permission controls, and audit logs
+- **Not just a piece engine** — TAKT is designed to address AI-specific challenges (non-determinism, accountability, audit requirements, and reproducibility)
 
 ## Requirements
 
@@ -71,17 +81,17 @@ takt hello
 **Note:** If you specify a string with spaces, Issue reference (`#6`), or `--task` / `--issue` options, interactive mode will be skipped and the task will be executed directly.
 
 **Flow:**
-1. Select workflow
+1. Select piece
 2. Refine task content through conversation with AI
 3. Finalize task instructions with `/go` (you can also add additional instructions like `/go additional instructions`)
-4. Execute (create worktree, run workflow, create PR)
+4. Execute (create worktree, run piece, create PR)
 
 #### Execution Example
 
 ```
 $ takt
 
-Select workflow:
+Select piece:
   ❯ 🎼 default (current)
     📁 Development/
     📁 Research/
@@ -110,7 +120,7 @@ Proceed with these task instructions? (Y/n) y
 
 ? Create worktree? (Y/n) y
 
-[Workflow execution starts...]
+[Piece execution starts...]
 ```
 
 ### Direct Task Execution
@@ -124,8 +134,8 @@ takt "Add login feature"
 # Specify task content with --task option
 takt --task "Fix bug"
 
-# Specify workflow
-takt "Add authentication" --workflow expert
+# Specify piece
+takt "Add authentication" --piece expert
 
 # Auto-create PR
 takt "Fix bug" --auto-pr
@@ -140,8 +150,8 @@ You can execute GitHub Issues directly as tasks. Issue title, body, labels, and
 takt #6
 takt --issue 6
 
-# Issue + workflow specification
-takt #6 --workflow expert
+# Issue + piece specification
+takt #6 --piece expert
 
 # Issue + auto-create PR
 takt #6 --auto-pr
@@ -186,7 +196,7 @@ takt list
 
 ### Pipeline Mode (for CI/Automation)
 
-Specifying `--pipeline` enables non-interactive pipeline mode. Automatically creates branch → runs workflow → commits & pushes. Suitable for CI/CD automation.
+Specifying `--pipeline` enables non-interactive pipeline mode. Automatically creates branch → runs piece → commits & pushes. Suitable for CI/CD automation.
 
 ```bash
 # Execute task in pipeline mode
@@ -198,13 +208,13 @@ takt --pipeline --task "Fix bug" --auto-pr
 # Link issue information
 takt --pipeline --issue 99 --auto-pr
 
-# Specify workflow and branch
+# Specify piece and branch
 takt --pipeline --task "Fix bug" -w magi -b feat/fix-bug
 
 # Specify repository (for PR creation)
 takt --pipeline --task "Fix bug" --auto-pr --repo owner/repo
 
-# Workflow execution only (skip branch creation, commit, push)
+# Piece execution only (skip branch creation, commit, push)
 takt --pipeline --task "Fix bug" --skip-git
 
 # Minimal output mode (for CI)
@@ -218,10 +228,10 @@ In pipeline mode, PRs are not created unless `--auto-pr` is specified.
 ### Other Commands
 
 ```bash
-# Interactively switch workflows
+# Interactively switch pieces
 takt switch
 
-# Copy builtin workflows/agents to ~/.takt/ for customization
+# Copy builtin pieces/agents to ~/.takt/ for customization
 takt eject
 
 # Clear agent conversation sessions
@@ -231,13 +241,13 @@ takt clear
 takt config
 ```
 
-### Recommended Workflows
+### Recommended Pieces
 
-| Workflow | Recommended Use |
+| Piece | Recommended Use |
 |----------|-----------------|
 | `default` | Serious development tasks. Used for TAKT's own development. Multi-stage review with parallel reviews (architect + security). |
-| `minimal` | Simple fixes and straightforward tasks. Minimal workflow with basic review. |
-| `review-fix-minimal` | Review & fix workflow. Specialized for iterative improvement based on review feedback. |
+| `minimal` | Simple fixes and straightforward tasks. Minimal piece with basic review. |
+| `review-fix-minimal` | Review & fix piece. Specialized for iterative improvement based on review feedback. |
 | `research` | Investigation and research. Autonomously executes research without asking questions. |
 
 ### Main Options
@@ -247,23 +257,23 @@ takt config
 | `--pipeline` | **Enable pipeline (non-interactive) mode** — Required for CI/automation |
 | `-t, --task <text>` | Task content (alternative to GitHub Issue) |
 | `-i, --issue <N>` | GitHub issue number (same as `#N` in interactive mode) |
-| `-w, --workflow <name or path>` | Workflow name or path to workflow YAML file |
+| `-w, --piece <name or path>` | Piece name or path to piece YAML file |
 | `-b, --branch <name>` | Specify branch name (auto-generated if omitted) |
 | `--auto-pr` | Create PR (interactive: skip confirmation, pipeline: enable PR) |
-| `--skip-git` | Skip branch creation, commit, and push (pipeline mode, workflow-only) |
+| `--skip-git` | Skip branch creation, commit, and push (pipeline mode, piece-only) |
 | `--repo <owner/repo>` | Specify repository (for PR creation) |
 | `--create-worktree <yes\|no>` | Skip worktree confirmation prompt |
 | `-q, --quiet` | Minimal output mode: suppress AI output (for CI) |
 | `--provider <name>` | Override agent provider (claude\|codex\|mock) |
 | `--model <name>` | Override agent model |
 
-## Workflows
+## Pieces
 
-TAKT uses YAML-based workflow definitions and rule-based routing. Builtin workflows are embedded in the package, with user workflows in `~/.takt/workflows/` taking priority. Use `takt eject` to copy builtins to `~/.takt/` for customization.
+TAKT uses YAML-based piece definitions and rule-based routing. Builtin pieces are embedded in the package, with user pieces in `~/.takt/pieces/` taking priority. Use `takt eject` to copy builtins to `~/.takt/` for customization.
 
-> **Note (v0.4.0)**: Internal terminology has changed from "step" to "movement" for workflow components. User-facing workflow files remain compatible, but if you customize workflows, you may see `movements:` instead of `steps:` in YAML files. The functionality remains the same.
+> **Note (v0.4.0)**: Internal terminology has changed from "step" to "movement" for piece components. User-facing piece files remain compatible, but if you customize pieces, you may see `movements:` instead of `steps:` in YAML files. The functionality remains the same.
 
-### Workflow Example
+### Piece Example
 
 ```yaml
 name: default
@@ -370,22 +380,22 @@ Execute sub-movements in parallel within a movement and evaluate with aggregate
 | AI judge | `ai("condition text")` | AI evaluates condition against agent output |
 | Aggregate | `all("X")` / `any("X")` | Aggregates parallel sub-movement matched conditions |
 
-## Builtin Workflows
+## Builtin Pieces
 
-TAKT includes multiple builtin workflows:
+TAKT includes multiple builtin pieces:
 
-| Workflow | Description |
+| Piece | Description |
 |----------|-------------|
-| `default` | Full development workflow: plan → architecture design → implement → AI review → parallel review (architect + security) → supervisor approval. Includes fix loops at each review stage. |
-| `minimal` | Quick workflow: plan → implement → review → supervisor. Minimal steps for fast iteration. |
-| `review-fix-minimal` | Review-focused workflow: review → fix → supervisor. For iterative improvement based on review feedback. |
-| `research` | Research workflow: planner → digger → supervisor. Autonomously executes research without asking questions. |
-| `expert` | Full-stack development workflow: architecture, frontend, security, QA reviews with fix loops. |
-| `expert-cqrs` | Full-stack development workflow (CQRS+ES specialized): CQRS+ES, frontend, security, QA reviews with fix loops. |
+| `default` | Full development piece: plan → architecture design → implement → AI review → parallel review (architect + security) → supervisor approval. Includes fix loops at each review stage. |
+| `minimal` | Quick piece: plan → implement → review → supervisor. Minimal steps for fast iteration. |
+| `review-fix-minimal` | Review-focused piece: review → fix → supervisor. For iterative improvement based on review feedback. |
+| `research` | Research piece: planner → digger → supervisor. Autonomously executes research without asking questions. |
+| `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. |
-| `review-only` | Read-only code review workflow that makes no changes. |
+| `review-only` | Read-only code review piece that makes no changes. |
 
-Use `takt switch` to switch workflows.
+Use `takt switch` to switch pieces.
 
 ## Builtin Agents
 
@@ -415,7 +425,7 @@ You are a code reviewer specialized in security.
 
 ## Model Selection
 
-The `model` field (in workflow movements, agent config, or global config) is passed directly to the provider (Claude Code CLI / Codex SDK). TAKT does not resolve model aliases.
+The `model` field (in piece movements, agent config, or global config) is passed directly to the provider (Claude Code CLI / Codex SDK). TAKT does not resolve model aliases.
 
 ### Claude Code
 
@@ -429,14 +439,14 @@ The model string is passed to the Codex SDK. If unspecified, defaults to `codex`
 
 ```
 ~/.takt/                    # Global configuration directory
-├── config.yaml             # Global config (provider, model, workflow, etc.)
-├── workflows/              # User workflow definitions (override builtins)
+├── config.yaml             # Global config (provider, model, piece, etc.)
+├── pieces/              # User piece definitions (override builtins)
 │   └── custom.yaml
 └── agents/                 # User agent prompt files (.md)
     └── my-agent.md
 
 .takt/                      # Project-level configuration
-├── config.yaml             # Project config (current workflow, etc.)
+├── config.yaml             # Project config (current piece, etc.)
 ├── tasks/                  # Pending task files (.yaml, .md)
 ├── completed/              # Completed tasks and reports
 ├── reports/                # Execution reports (auto-generated)
@@ -444,7 +454,7 @@ The model string is passed to the Codex SDK. If unspecified, defaults to `codex`
 └── logs/                   # NDJSON format session logs
     ├── latest.json         # Pointer to current/latest session
     ├── previous.json       # Pointer to previous session
-    └── {sessionId}.jsonl   # NDJSON session log per workflow execution
+    └── {sessionId}.jsonl   # NDJSON session log per piece execution
 ```
 
 Builtin resources are embedded in the npm package (`dist/resources/`). User files in `~/.takt/` take priority.
@@ -456,7 +466,7 @@ Configure default provider and model in `~/.takt/config.yaml`:
 ```yaml
 # ~/.takt/config.yaml
 language: en
-default_workflow: default
+default_piece: default
 log_level: info
 provider: claude         # Default provider: claude or codex
 model: sonnet            # Default model (optional)
@@ -466,9 +476,6 @@ model: sonnet            # Default model (optional)
 anthropic_api_key: sk-ant-...  # For Claude (Anthropic)
 # openai_api_key: sk-...       # For Codex (OpenAI)
 
-trusted_directories:
-  - /path/to/trusted/dir
-
 # Pipeline execution configuration (optional)
 # Customize branch names, commit messages, and PR body.
 # pipeline:
@@ -480,6 +487,8 @@ trusted_directories:
 #     Closes #{issue}
 ```
 
+**Note:** The Codex SDK requires running inside a Git repository. `--skip-git-repo-check` is only available in the Codex CLI.
+
 **API Key Configuration Methods:**
 
 1. **Set via environment variables**:
@@ -505,10 +514,10 @@ Priority: Environment variables > `config.yaml` settings
 | `{title}` | Commit message | Issue title |
 | `{issue}` | Commit message, PR body | Issue number |
 | `{issue_body}` | PR body | Issue body |
-| `{report}` | PR body | Workflow execution report |
+| `{report}` | PR body | Piece execution report |
 
 **Model Resolution Priority:**
-1. Workflow movement `model` (highest priority)
+1. Piece movement `model` (highest priority)
 2. Custom agent `model`
 3. Global config `model`
 4. Provider default (Claude: sonnet, Codex: codex)
@@ -519,14 +528,14 @@ Priority: Environment variables > `config.yaml` settings
 
 TAKT supports batch processing with task files in `.takt/tasks/`. Both `.yaml`/`.yml` and `.md` file formats are supported.
 
-**YAML format** (recommended, supports worktree/branch/workflow options):
+**YAML format** (recommended, supports worktree/branch/piece options):
 
 ```yaml
 # .takt/tasks/add-auth.yaml
 task: "Add authentication feature"
 worktree: true                  # Execute in isolated shared clone
 branch: "feat/add-auth"         # Branch name (auto-generated if omitted)
-workflow: "default"             # Workflow specification (uses current if omitted)
+piece: "default"             # Piece specification (uses current if omitted)
 ```
 
 **Markdown format** (simple, backward compatible):
@@ -561,25 +570,25 @@ TAKT writes session logs in NDJSON (`.jsonl`) format to `.takt/logs/`. Each reco
 
 - `.takt/logs/latest.json` - Pointer to current (or latest) session
 - `.takt/logs/previous.json` - Pointer to previous session
-- `.takt/logs/{sessionId}.jsonl` - NDJSON session log per workflow execution
+- `.takt/logs/{sessionId}.jsonl` - NDJSON session log per piece execution
 
-Record types: `workflow_start`, `step_start`, `step_complete`, `workflow_complete`, `workflow_abort`
+Record types: `piece_start`, `step_start`, `step_complete`, `piece_complete`, `piece_abort`
 
 Agents can read `previous.json` to inherit context from the previous execution. Session continuation is automatic — just run `takt "task"` to continue from the previous session.
 
-### Adding Custom Workflows
+### Adding Custom Pieces
 
-Add YAML files to `~/.takt/workflows/` or customize builtins with `takt eject`:
+Add YAML files to `~/.takt/pieces/` or customize builtins with `takt eject`:
 
 ```bash
-# Copy default workflow to ~/.takt/workflows/ and edit
+# Copy default piece to ~/.takt/pieces/ and edit
 takt eject default
 ```
 
 ```yaml
-# ~/.takt/workflows/my-workflow.yaml
-name: my-workflow
-description: Custom workflow
+# ~/.takt/pieces/my-piece.yaml
+name: my-piece
+description: Custom piece
 max_iterations: 5
 initial_movement: analyze
 
@@ -609,10 +618,10 @@ movements:
 
 ### Specifying Agents by Path
 
-In workflow definitions, specify agents using file paths:
+In piece definitions, specify agents using file paths:
 
 ```yaml
-# Relative path from workflow file
+# Relative path from piece file
 agent: ../agents/default/coder.md
 
 # Home directory
@@ -622,24 +631,24 @@ agent: ~/.takt/agents/default/coder.md
 agent: /path/to/custom/agent.md
 ```
 
-### Workflow Variables
+### Piece Variables
 
 Variables available in `instruction_template`:
 
 | Variable | Description |
 |----------|-------------|
 | `{task}` | Original user request (auto-injected if not in template) |
-| `{iteration}` | Workflow-wide turn count (total steps executed) |
+| `{iteration}` | Piece-wide turn count (total steps executed) |
 | `{max_iterations}` | Maximum iteration count |
 | `{movement_iteration}` | Per-movement iteration count (times this movement has been executed) |
 | `{previous_response}` | Output from previous movement (auto-injected if not in template) |
-| `{user_inputs}` | Additional user inputs during workflow (auto-injected if not in template) |
+| `{user_inputs}` | Additional user inputs during piece (auto-injected if not in template) |
 | `{report_dir}` | Report directory path (e.g., `.takt/reports/20250126-143052-task-summary`) |
 | `{report:filename}` | Expands to `{report_dir}/filename` (e.g., `{report:00-plan.md}`) |
 
-### Workflow Design
+### Piece Design
 
-Elements needed for each workflow movement:
+Elements needed for each piece movement:
 
 **1. Agent** - Markdown file containing system prompt:
 
@@ -675,13 +684,13 @@ Special `next` values: `COMPLETE` (success), `ABORT` (failure)
 ## API Usage Example
 
 ```typescript
-import { WorkflowEngine, loadWorkflow } from 'takt';  // npm install takt
+import { PieceEngine, loadPiece } from 'takt';  // npm install takt
 
-const config = loadWorkflow('default');
+const config = loadPiece('default');
 if (!config) {
-  throw new Error('Workflow not found');
+  throw new Error('Piece not found');
 }
-const engine = new WorkflowEngine(config, process.cwd(), 'My task');
+const engine = new PieceEngine(config, process.cwd(), 'My task');
 
 engine.on('step:complete', (step, response) => {
   console.log(`${step.name}: ${response.status}`);
@@ -700,7 +709,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md) for details.
 
 TAKT provides a GitHub Action for automating PR reviews and task execution. See [takt-action](https://github.com/nrslib/takt-action) for details.
 
-**Workflow example** (see [.github/workflows/takt-action.yml](../.github/workflows/takt-action.yml) in this repository):
+**Piece example** (see [.github/workflows/takt-action.yml](../.github/workflows/takt-action.yml) in this repository):
 
 ```yaml
 name: TAKT
@@ -755,7 +764,7 @@ export TAKT_OPENAI_API_KEY=sk-...
 
 ## Documentation
 
-- [Workflow Guide](./docs/workflows.md) - Creating and customizing workflows
+- [Piece Guide](./docs/pieces.md) - Creating and customizing pieces
 - [Agent Guide](./docs/agents.md) - Configuring custom agents
 - [Changelog](../CHANGELOG.md) - Version history
 - [Security Policy](../SECURITY.md) - Vulnerability reporting

package/bin/takt

@@ -9,7 +9,7 @@
  * - npm exec takt
  */
 
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { dirname, join } from 'node:path';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -19,7 +19,8 @@ const __dirname = dirname(__filename);
 const cliPath = join(__dirname, '..', 'dist', 'app', 'cli', 'index.js');
 
 try {
-  await import(cliPath);
+  const cliUrl = pathToFileURL(cliPath).href;
+  await import(cliUrl);
 } catch (err) {
   console.error('Failed to load TAKT CLI. Have you run "npm run build"?');
   console.error(err.message);

package/dist/agents/types.d.ts

@@ -16,7 +16,7 @@ export interface RunAgentOptions {
     allowedTools?: string[];
     /** Maximum number of agentic turns */
     maxTurns?: number;
-    /** Permission mode for tool execution (from workflow step) */
+    /** Permission mode for tool execution (from piece step) */
     permissionMode?: PermissionMode;
     onStream?: StreamCallback;
     onPermissionRequest?: PermissionHandler;

package/dist/agents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACvC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACvC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB"}

package/dist/app/cli/commands.js

@@ -3,10 +3,10 @@
  *
  * Registers all named subcommands (run, watch, add, list, switch, clear, eject, config, prompt).
  */
-import { clearAgentSessions, getCurrentWorkflow } from '../../infra/config/index.js';
+import { clearAgentSessions, getCurrentPiece } from '../../infra/config/index.js';
 import { success } from '../../shared/ui/index.js';
 import { runAllTasks, addTask, watchTasks, listTasks } from '../../features/tasks/index.js';
-import { switchWorkflow, switchConfig, ejectBuiltin } from '../../features/config/index.js';
+import { switchPiece, switchConfig, ejectBuiltin } from '../../features/config/index.js';
 import { previewPrompts } from '../../features/prompt/index.js';
 import { program, resolvedCwd } from './program.js';
 import { resolveAgentOverrides } from './helpers.js';
@@ -14,8 +14,8 @@ program
     .command('run')
     .description('Run all pending tasks from .takt/tasks/')
     .action(async () => {
-    const workflow = getCurrentWorkflow(resolvedCwd);
-    await runAllTasks(resolvedCwd, workflow, resolveAgentOverrides(program));
+    const piece = getCurrentPiece(resolvedCwd);
+    await runAllTasks(resolvedCwd, piece, resolveAgentOverrides(program));
 });
 program
     .command('watch')
@@ -38,10 +38,10 @@ program
 });
 program
     .command('switch')
-    .description('Switch workflow interactively')
-    .argument('[workflow]', 'Workflow name')
-    .action(async (workflow) => {
-    await switchWorkflow(resolvedCwd, workflow);
+    .description('Switch piece interactively')
+    .argument('[piece]', 'Piece name')
+    .action(async (piece) => {
+    await switchPiece(resolvedCwd, piece);
 });
 program
     .command('clear')
@@ -52,7 +52,7 @@ program
 });
 program
     .command('eject')
-    .description('Copy builtin workflow/agents to ~/.takt/ for customization')
+    .description('Copy builtin piece/agents to ~/.takt/ for customization')
     .argument('[name]', 'Specific builtin to eject')
     .action(async (name) => {
     await ejectBuiltin(name);
@@ -67,8 +67,8 @@ program
 program
     .command('prompt')
     .description('Preview assembled prompts for each movement and phase')
-    .argument('[workflow]', 'Workflow name or path (defaults to current)')
-    .action(async (workflow) => {
-    await previewPrompts(resolvedCwd, workflow);
+    .argument('[piece]', 'Piece name or path (defaults to current)')
+    .action(async (piece) => {
+    await previewPrompts(resolvedCwd, piece);
 });
 //# sourceMappingURL=commands.js.map

package/dist/app/cli/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/app/cli/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/app/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/app/cli/program.js

@@ -27,7 +27,7 @@ program
 // --- Global options ---
 program
     .option('-i, --issue <number>', 'GitHub issue number (equivalent to #N)', (val) => parseInt(val, 10))
-    .option('-w, --workflow <name>', 'Workflow name or path to workflow file')
+    .option('-w, --piece <name>', 'Piece name or path to piece file')
     .option('-b, --branch <name>', 'Branch name (auto-generated if omitted)')
     .option('--auto-pr', 'Create PR after successful execution')
     .option('--repo <owner/repo>', 'Repository (defaults to current)')

package/dist/app/cli/program.js.map

@@ -1 +1 @@
-{"version":3,"file":"program.js","sourceRoot":"","sources":["../../../src/app/cli/program.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../../src/app/cli/program.ts"],"names":[],"mappings":"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"}

package/dist/app/cli/routing.js

@@ -7,11 +7,11 @@
 import { info, error } from '../../shared/ui/index.js';
 import { getErrorMessage } from '../../shared/utils/index.js';
 import { resolveIssueTask, isIssueReference } from '../../infra/github/index.js';
-import { selectAndExecuteTask, determineWorkflow } from '../../features/tasks/index.js';
+import { selectAndExecuteTask, determinePiece } from '../../features/tasks/index.js';
 import { executePipeline } from '../../features/pipeline/index.js';
 import { interactiveMode } from '../../features/interactive/index.js';
-import { getWorkflowDescription } from '../../infra/config/index.js';
-import { DEFAULT_WORKFLOW_NAME } from '../../shared/constants.js';
+import { getPieceDescription } from '../../infra/config/index.js';
+import { DEFAULT_PIECE_NAME } from '../../shared/constants.js';
 import { program, resolvedCwd, pipelineMode } from './program.js';
 import { resolveAgentOverrides, parseCreateWorktreeOption, isDirectTask } from './helpers.js';
 program
@@ -23,7 +23,7 @@ program
     const selectOptions = {
         autoPr: opts.autoPr === true,
         repo: opts.repo,
-        workflow: opts.workflow,
+        piece: opts.piece,
         createWorktree: createWorktreeOverride,
     };
     // --- Pipeline mode (non-interactive): triggered by --pipeline ---
@@ -31,7 +31,7 @@ program
         const exitCode = await executePipeline({
             issueNumber: opts.issue,
             task: opts.task,
-            workflow: opts.workflow ?? DEFAULT_WORKFLOW_NAME,
+            piece: opts.piece ?? DEFAULT_PIECE_NAME,
             branch: opts.branch,
             autoPr: opts.autoPr === true,
             repo: opts.repo,
@@ -81,18 +81,18 @@ program
         return;
     }
     // Short single word or no task → interactive mode (with optional initial input)
-    const workflowId = await determineWorkflow(resolvedCwd, selectOptions.workflow);
-    if (workflowId === null) {
+    const pieceId = await determinePiece(resolvedCwd, selectOptions.piece);
+    if (pieceId === null) {
         info('Cancelled');
         return;
     }
-    const workflowContext = getWorkflowDescription(workflowId, resolvedCwd);
-    const result = await interactiveMode(resolvedCwd, task, workflowContext);
+    const pieceContext = getPieceDescription(pieceId, resolvedCwd);
+    const result = await interactiveMode(resolvedCwd, task, pieceContext);
     if (!result.confirmed) {
         return;
     }
     selectOptions.interactiveUserInput = true;
-    selectOptions.workflow = workflowId;
+    selectOptions.piece = pieceId;
     selectOptions.interactiveMetadata = { confirmed: result.confirmed, task: result.task };
     await selectAndExecuteTask(resolvedCwd, result.task, selectOptions, agentOverrides);
 });

package/dist/app/cli/routing.js.map

@@ -1 +1 @@
-{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../src/app/cli/routing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../src/app/cli/routing.ts"],"names":[],"mappings":"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"}

package/dist/core/models/config.js

@@ -2,9 +2,9 @@ import { TaktConfigSchema } from './schemas.js';
 export { TaktConfigSchema };
 export const DEFAULT_CONFIG = {
     defaultModel: 'sonnet',
-    defaultWorkflow: 'default',
+    defaultPiece: 'default',
     agentDirs: [],
-    workflowDirs: [],
+    pieceDirs: [],
     claude: {
         command: 'claude',
         timeout: 300000,

package/dist/core/models/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/models/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAI5B,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,SAAS;IAC1B,SAAS,EAAE,EAAE;IACb,YAAY,EAAE,EAAE;IAChB,MAAM,EAAE;QACN,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,MAAM;KAChB;CACF,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/models/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAI5B,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,YAAY,EAAE,QAAQ;IACtB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,MAAM,EAAE;QACN,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,MAAM;KAChB;CACF,CAAC"}