takt/resources/project/tasks/TASK-FORMAT

38 lines
1.2 KiB
Plaintext

TAKT Task File Format
=====================
Tasks placed in this directory (.takt/tasks/) will be processed by TAKT.
## YAML Format (Recommended)
# .takt/tasks/my-task.yaml
task: "Task description"
worktree: true # (optional) true | "/path/to/dir"
branch: "feat/my-feature" # (optional) branch name
workflow: "default" # (optional) workflow name
Fields:
task (required) Task description (string)
worktree (optional) true: create shared clone, "/path": clone at path
branch (optional) Branch name (auto-generated if omitted: takt/{timestamp}-{slug})
workflow (optional) Workflow name (uses current workflow if omitted)
## Markdown Format (Simple)
# .takt/tasks/my-task.md
Entire file content becomes the task description.
Supports multiline. No structured options available.
## Supported Extensions
.yaml, .yml -> YAML format (parsed and validated)
.md -> Markdown format (plain text, backward compatible)
## Commands
takt /add-task Add a task interactively
takt /run-tasks Run all pending tasks
takt /watch Watch and auto-run tasks
takt /list-tasks List task branches (merge/delete)