From 2900d9c81646f442369b4adf0c2fa85afb03ff29 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Mon, 23 Mar 2026 22:56:11 +0200
Subject: Update

---
 prompts/commands/work-on-tasks.md                  |  2 +-
 .../references/1-create-task.md                    | 24 +++++++++++++++++++---
 prompts/skills/auditing-code-quality/SKILL.md      | 17 +++++++++++++--
 3 files changed, 37 insertions(+), 6 deletions(-)

(limited to 'prompts')

diff --git a/prompts/commands/work-on-tasks.md b/prompts/commands/work-on-tasks.md
index 3ef0558..5360148 100644
--- a/prompts/commands/work-on-tasks.md
+++ b/prompts/commands/work-on-tasks.md
@@ -17,7 +17,7 @@
 
 Use the `agent-task-management` skill for this entire workflow.
 
-I want you to automatically execute tasks askwarrior work for the **current git project** from start to finish.
+I want you to automatically execute tasks to work for the **current git project** from start to finish.
 
 1. **Load project-scoped tasks**:
    - Detect the current project from local git context
diff --git a/prompts/skills/agent-task-management/references/1-create-task.md b/prompts/skills/agent-task-management/references/1-create-task.md
index 02d1448..b9ec5e7 100644
--- a/prompts/skills/agent-task-management/references/1-create-task.md
+++ b/prompts/skills/agent-task-management/references/1-create-task.md
@@ -17,10 +17,20 @@ Use with `00-context.md`. Project name and global rules apply. New tasks get `+a
 
 ## Add a task
 
-`ask add` already injects `project:<name> +agent`, so only add the extra feature tag(s) and description:
+`ask add` already injects `project:<name> +agent`, so only add the extra feature tag(s), optional priority, and description.
+
+**Each part must be a separate shell argument — never quote tag and description together:**
 
 ```bash
 ask add +<tag> "Description"
+ask add priority:H +<tag> "Description"
+ask add priority:M +<tag> "Description"
+```
+
+Do NOT do this (causes tag/priority to appear in the description instead of being applied):
+```bash
+ask add "+<tag> Description"           # wrong: tag and desc in one quoted string
+ask add "+<tag> -p M Description"      # wrong: everything in one quoted arg
 ```
 
 Then add the workflow annotation using `uuid:<full-uuid>` as returned by `ask add`:
@@ -31,11 +41,19 @@ ask annotate uuid:<uuid> "Agent workflow: load the agent-task-management skill a
 
 ## With dependency
 
+Add the task first, then set the dependency separately:
+
 ```bash
-ask add +<tag> "Description" dep:add:<uuid>
+uuid=$(ask add +<tag> "Description")
+ask dep add uuid:$uuid <dep-uuid>
 ```
 
-Multiple dependencies: `dep:add:<uuid1> +dep:add:<uuid2>`.
+Multiple dependencies:
+
+```bash
+ask dep add uuid:$uuid <dep-uuid1>
+ask dep add uuid:$uuid <dep-uuid2>
+```
 
 After adding (with or without dependency), run the same annotations using the UUID from `ask info uuid:<uuid>`.
 
diff --git a/prompts/skills/auditing-code-quality/SKILL.md b/prompts/skills/auditing-code-quality/SKILL.md
index 0cedbf6..4e5f700 100644
--- a/prompts/skills/auditing-code-quality/SKILL.md
+++ b/prompts/skills/auditing-code-quality/SKILL.md
@@ -85,5 +85,18 @@ create a task for every HIGH and MEDIUM severity finding. Each task should:
 
 - Have a clear, actionable description (e.g., "Refactor UserService to fix SRP violation").
 - Include the principle, category, and file location in an annotation.
-- Be tagged with `code-quality`.
-- Use priority `H` for HIGH-severity findings and `M` for MEDIUM ones and `L` for LOW ones.
+- Be tagged with `+code-quality` (separate arg, never quoted together with the description).
+- Set priority via the `priority:H`, `priority:M`, or `priority:L` modifier (separate arg).
+
+**Exact command format** — keep each part as a separate argument, never quoted together:
+
+```bash
+ask add priority:H +code-quality "Refactor UserService to fix SRP violation"
+ask add priority:M +code-quality "Fix high cognitive complexity in parser.go"
+```
+
+Do NOT do this (causes tag to land in description):
+```bash
+ask add "+code-quality Fix foo"          # wrong: tag+desc quoted as one arg
+ask add "+code-quality -p M Fix foo"     # wrong: everything in one quoted arg
+```
-- 
cgit v1.2.3