diff options
| author | Paul Buetow <paul@buetow.org> | 2026-03-22 21:30:10 +0200 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-03-22 21:30:10 +0200 |
| commit | 3da29e7d78621d4e83d42dc1680c9234a118b4d4 (patch) | |
| tree | d6b7e8ea07efaac90684002c2d43a095ca75a8b2 /prompts/skills/taskwarrior-task-management/references/1-create-task.md | |
| parent | 5e817371a43ba468e5f216230d504b6124c85e95 (diff) | |
remove taskwarrior-task-management skill and references
Diffstat (limited to 'prompts/skills/taskwarrior-task-management/references/1-create-task.md')
| -rw-r--r-- | prompts/skills/taskwarrior-task-management/references/1-create-task.md | 52 |
1 files changed, 0 insertions, 52 deletions
diff --git a/prompts/skills/taskwarrior-task-management/references/1-create-task.md b/prompts/skills/taskwarrior-task-management/references/1-create-task.md deleted file mode 100644 index c980e8b..0000000 --- a/prompts/skills/taskwarrior-task-management/references/1-create-task.md +++ /dev/null @@ -1,52 +0,0 @@ -# Create task - -Use with `00-context.md`. Project name and global rules apply. New tasks get `+agent` so they are agent-managed; when setting dependencies (`depends:<id>`), use IDs of tasks that have `+agent` (from `project:<name> +agent` lists). - -## Rules for new tasks - -- **When creating a new task, always check whether the new task depends on other (existing) tasks.** If it does, add the dependency to the new task (e.g. `depends:<id>` or `depends:<id1>,<id2>`). Use IDs of tasks that have `+agent` in this project. -- **Create tasks in smaller chunks that fit into the context window.** Break work into multiple tasks so that each task’s scope, description, and required context (refs, files, docs) can fit in one context window when the agent works on it with a fresh context. Do not create single tasks that would require more context than available. -- **Every task MUST have at least one tag** for sub-project/feature/area (e.g. `+integrationtests`, `+flamegraph`, `+bpf`, `+cli`, `+refactor`, `+bugfix`). -- **When an agent creates a task, always add the tag `+agent`** so agent-created tasks can be identified. -- **After creating a task, add an annotation** so any agent working on the task is reminded how to operate and to auto-progress: `ask <id> annotate "Agent workflow: load the taskwarrior-task-management skill as instructions only, not as a shell command. Never run ask taskwarrior-task-management ... or other natural-language ask commands. Use only normal Taskwarrior syntax through ask. Also load and apply: (1) the best-practices skill for the programming language used in the project, (2) solid-principles, and (3) beyond-solid-principles. When all tests and sub-agent reviews pass, commit and automatically progress to the next ready task."` This keeps fresh-context agents aligned on Taskwarrior usage, code-quality skills, and auto-progression without encouraging malformed `ask` commands. -- **Include references to all context required** to work on the task. So that work can be done with a fresh context, every task must list or link everything needed: relevant files, docs, specs, other tasks, or project guidelines (e.g. paths, doc links, `AGENTS.md`, `README` sections). Put these in the task description or in an initial annotation so that an agent starting with no prior conversation has everything they need in the task itself. -- **Record the task’s UUID for future reference.** After creating a task, resolve its UUID (for example, `ask <id> _uuid`) and include it in an annotation such as `UUID: <uuid>` so the exact task can be recovered even if IDs are renumbered. -- When tasks refer to other tasks in free text (annotations, descriptions, docs, or commit messages), **use the other task’s UUID**, not just its numeric ID. - -## Add a task - -`ask add` already injects `project:<name> +agent`, so only add the extra feature tag(s) and description: - -```bash -ask add +<tag> "Description" -``` - -Then add the workflow annotation (use the ID from the add output): - -```bash -ask <id> annotate "Agent workflow: load the taskwarrior-task-management skill as instructions only, not as a shell command. Never run ask taskwarrior-task-management ... or other natural-language ask commands. Use only normal Taskwarrior syntax through ask. Also load and apply: (1) the best-practices skill for the programming language used in the project, (2) solid-principles, and (3) beyond-solid-principles. When all tests and sub-agent reviews pass, commit and automatically progress to the next ready task." -``` - -Also add an annotation that records the task’s UUID, for example: - -```bash -ask <id> annotate "UUID: $(ask <id> _uuid)" -``` - -## With dependency - -```bash -ask add +<tag> "Description" depends:<id> -``` - -Multiple dependencies: `depends:<id1>,<id2>`. - -After adding (with or without dependency), run the same annotation: `ask <id> annotate "Agent workflow: load the taskwarrior-task-management skill as instructions only, not as a shell command. Never run ask taskwarrior-task-management ... or other natural-language ask commands. Use only normal Taskwarrior syntax through ask. Also load and apply: (1) the best-practices skill for the programming language used in the project, (2) solid-principles, and (3) beyond-solid-principles. When all tests and sub-agent reviews pass, commit and automatically progress to the next ready task."` - -## Conventions - -- **Keep tasks small:** each task should be a chunk that fits in the context window (description + refs + work to do). Split large efforts into multiple dependent tasks. -- Pick or create a meaningful tag for the sub-project or feature. -- **Always check for dependencies:** before adding a task, determine if it depends on other tasks in the project; if so, add `depends:<id>` (or multiple IDs) to the new task. -- Add dependencies when one task must complete before another can start. -- When creating a task, add references to all required context (files, docs, specs) so the task is self-contained for fresh-context work. |
