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
      workflow: 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    Inline task text
  content_file Path to task text file

## 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)
