49 lines
1.4 KiB
Plaintext
49 lines
1.4 KiB
Plaintext
TAKT Task Directory Format
|
|
==========================
|
|
|
|
`.takt/tasks/` is the task input directory. Each task uses one subdirectory.
|
|
|
|
## Directory Layout (Recommended)
|
|
|
|
.takt/
|
|
tasks/
|
|
20260201-015714-foptng/
|
|
order.md
|
|
schema.sql
|
|
wireframe.png
|
|
|
|
- Directory name should match the report directory slug.
|
|
- `order.md` is required.
|
|
- Other files are optional reference materials.
|
|
|
|
## tasks.yaml Format
|
|
|
|
Store task metadata in `.takt/tasks.yaml`, and point to the task directory with `task_dir`.
|
|
|
|
tasks:
|
|
- name: add-auth-feature
|
|
status: pending
|
|
task_dir: .takt/tasks/20260201-015714-foptng
|
|
piece: default
|
|
created_at: "2026-02-01T01:57:14.000Z"
|
|
started_at: null
|
|
completed_at: null
|
|
|
|
Fields:
|
|
task_dir (recommended) Path to task directory that contains `order.md`
|
|
content (legacy) Inline task text (kept for compatibility)
|
|
content_file (legacy) Path to task text file (kept for compatibility)
|
|
|
|
## Command Behavior
|
|
|
|
- `takt add` creates `.takt/tasks/{slug}/order.md` automatically.
|
|
- `takt run` and `takt watch` read `.takt/tasks.yaml` and resolve `task_dir`.
|
|
- Report output is written to `.takt/runs/{slug}/reports/`.
|
|
|
|
## Commands
|
|
|
|
takt add Add a task and create task directory
|
|
takt run Run all pending tasks in tasks.yaml
|
|
takt watch Watch tasks.yaml and run pending tasks
|
|
takt list List task branches (merge/delete)
|