/aitask-create

Create a new task file with automatic numbering and proper metadata via interactive code agent prompts.

Usage:

/aitask-create

Note: Must be run from the project root directory. See Skills overview for details.

Step-by-Step

The skill guides you through task creation using interactive prompts:

1. Parent selection — Choose standalone or child of existing task
2. Task number — Auto-determined from active, archived, and compressed tasks
3. Metadata — Priority, effort, dependencies (with sibling dependency prompt for child tasks)
4. Task name — Free text with auto-sanitization
5. Definition — Iterative content collection with file reference insertion via Glob search
6. Create & commit — Writes task file with YAML frontmatter and commits to git

Batch Mode

For non-interactive task creation (e.g., scripting or automation), use the underlying script directly with --batch:

./.aitask-scripts/aitask_create.sh --batch --name "task_name" --desc "description" --commit

Run ./.aitask-scripts/aitask_create.sh --help for the full list of flags.

File references and auto-merge:

./.aitask-scripts/aitask_create.sh --batch --commit \
    --name "fix_login" --desc "..." \
    --file-ref "lib/login.py:42-68" \
    --auto-merge

• --file-ref PATH[:N[-M][^N[-M]...]] (repeatable) attaches a structured pointer to source lines in the new task’s file_references frontmatter.
• --auto-merge folds any Ready/Editing task that already references the same path into the new one. The default (--no-auto-merge) warns and skips instead.

See the Creating Tasks from Code workflow guide for the full walkthrough, including the interactive codebrowser n flow.

Workflows

For workflow guides, see Capturing Ideas and Follow-Up Tasks.