Add Task

Create a new task file using the taskmd add CLI command.

Instructions

The user's task description is in $ARGUMENTS .

Parse the user's input from $ARGUMENTS to extract:

• The task title (required)

• An optional template name (e.g. "bug", "feature", "chore", or a custom template)

• Any optional flags: --priority , --effort , --tags , --group , --depends-on , --parent , --owner

Choose the group based on the task's domain (pass with --group ):

• cli — CLI commands, Go backend, terminal features

• web — Web frontend, UI, React components

• Omit --group for cross-cutting, infrastructure, documentation, or unclear domain

Run taskmd add with the appropriate flags:

Basic task

taskmd add "Fix the login bug" --group cli

With a template

taskmd add "Login fails on Safari" --template bug --group cli

With extra flags

taskmd add "Dark mode support" --template feature --priority high --tags ui,frontend --group web

Available templates can be listed with taskmd templates list . Built-in templates include bug , feature , and chore . Projects may define custom templates in .taskmd/templates/ .

Fill in the task content: Read the created file and replace placeholder content (HTML comments like <!-- ... --> , TODO , 1. ... ) with real content derived from the user's description in $ARGUMENTS . Fill in:

• The Objective section with a clear description of the goal

• The Tasks section with specific, actionable subtasks

• The Acceptance Criteria with concrete, verifiable criteria

• Any template-specific sections (e.g. "Steps to Reproduce", "Expected Behavior" for bug templates)

Use your understanding of the user's request to write meaningful content — don't leave placeholders.

Validate by running taskmd validate to ensure the task file is valid. If validation fails, fix the issues.

Confirm the created file path and ID to the user.