Add Task
Create a new task file under ./tasks/ following the taskmd specification.
Instructions
The user's task description is in $ARGUMENTS.
- •Read the specification at
docs/taskmd_specification.md(ordocs/TASKMD_SPEC.md) for the correct format - •Determine the next task ID by scanning existing files:
- •Run
Globfortasks/**/*.mdto find all task files - •Extract numeric IDs from filenames (pattern:
NNN-description.md) - •Pick the next sequential ID, zero-padded to 3 digits
- •Run
- •Choose the subdirectory based on the task's domain:
- •
tasks/cli/— CLI commands, Go backend, terminal features - •
tasks/web/— Web frontend, UI, React components - •
tasks/(root) — Cross-cutting, infrastructure, documentation, or unclear domain
- •
- •Create the task file named
<NNN>-<slug>.mdwith:
yaml
--- id: "<NNN>" title: "<title from user>" status: pending priority: medium effort: medium tags: [] created: <today's date YYYY-MM-DD> ---
Followed by a markdown body with:
- •An H1 heading matching the title
- •An
## Objectivesection describing the goal - •A
## Taskssection with a checkbox list of subtasks - •An
## Acceptance Criteriasection
- •Confirm the created file path and ID to the user