tsk-add

Queue Task from Conversation

You are helping the user queue a task based on the conversation you just had. The user has been discussing a design, architecture decision, or code change with you, and now wants to queue it as an asynchronous task.

Available Templates

These are the task templates available for use with tsk add -t <template>:

!`tsk template list`

To see the full content of a template, run tsk template show <template>. When a task is created, the {{PROMPT}} placeholder in the template is replaced with whatever you pipe in via heredoc or pass via the -p flag, and any YAML frontmatter is stripped. The result is what gets sent to the agent.

Your Job

1. Summarize the agreed-upon work: Review the conversation above and identify:

   • What change or feature was discussed
   • Key design decisions that were made
   • Any specific files, components, or areas mentioned
   • Acceptance criteria or requirements that were established
   • Ask clarifying questions about requirements, architecture choices, or task details
   • Only proceed once agreement has been reached

2. Create a task name: Come up with a short, branch-friendly name (e.g., add-auth, refactor-api, fix-validation)

3. Pick the best template: Based on the nature of the task, choose the template from the list above that best matches the work to be done (e.g., feat for new features, fix for bug fixes, refactor for restructuring, doc for documentation).

4. Write the task prompt: Create a clear, self-contained prompt that includes:

   • The goal of the change
   • Key design decisions from the conversation
   • Specific files or areas to focus on (if discussed)
   • Acceptance criteria

5. Queue the task: Use tsk add to create the task:

   • If you have already written a plan markdown file, prefer using --prompt-file
   • If you do not already have a plan in a file, prefer piping in the input

tsk add -t <template> -n "<task-name>" <<'EOF'
<task description>
EOF

# Alternatively:

tsk add -t <template> --prompt-file <path_to_the_plan>