From 16c2df30dbbe61e61c8332852d53d056fdd897cf Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Sat, 11 Apr 2026 22:47:53 +0300 Subject: remove the path --- prompts/skills/agent-task-management/SKILL.md | 32 +++++++++++----------- .../agent-task-management/references/00-context.md | 4 +-- .../references/1-create-task.md | 28 +++++++++---------- .../references/2-start-task.md | 6 ++-- .../references/3-complete-task.md | 10 +++---- .../references/4-annotate-update-task.md | 14 +++++----- .../references/5-review-overview-tasks.md | 16 +++++------ 7 files changed, 55 insertions(+), 55 deletions(-) diff --git a/prompts/skills/agent-task-management/SKILL.md b/prompts/skills/agent-task-management/SKILL.md index d89e44b..cde2e9a 100644 --- a/prompts/skills/agent-task-management/SKILL.md +++ b/prompts/skills/agent-task-management/SKILL.md @@ -1,33 +1,33 @@ --- name: agent-task-management -description: "Manage agent tasks scoped to the current git project using the `~/go/bin/ask` CLI. Use when asked to list, add, start, complete, annotate, or organize tasks for the project. Prefer compaction over starting a new context when beginning a new task. May start work in parallel (e.g. multiple sub-agents on different tasks) as long as agents do not conflict with each other. Triggers on: tasks, todo, task list, pick next task, what's next." +description: "Manage agent tasks scoped to the current git project using the `ask` CLI. Use when asked to list, add, start, complete, annotate, or organize tasks for the project. Prefer compaction over starting a new context when beginning a new task. May start work in parallel (e.g. multiple sub-agents on different tasks) as long as agents do not conflict with each other. Triggers on: tasks, todo, task list, pick next task, what's next." --- # Agent Task Management -Tasks are scoped to the current git repository via the `~/go/bin/ask` CLI. **Load only the files you need** for the current action so the whole skill does not need to be in context. +Tasks are scoped to the current git repository via the `ask` CLI. **Load only the files you need** for the current action so the whole skill does not need to be in context. -The task CLI at `~/go/bin/ask` provides subcommands (`list`, `ready`, `add`, `info`, `start`, `stop`, `done`, `annotate`, `modify`, `tag`, `priority`, `dep`, `delete`, `urgency`) that operate on agent-managed tasks in the current project. It is not a natural-language interface and does not understand skill names. Use normal subcommand syntax only. +The task CLI at `ask` provides subcommands (`list`, `ready`, `add`, `info`, `start`, `stop`, `done`, `annotate`, `modify`, `tag`, `priority`, `dep`, `delete`, `urgency`) that operate on agent-managed tasks in the current project. It is not a natural-language interface and does not understand skill names. Use normal subcommand syntax only. Valid examples: -- `~/go/bin/ask list` -- `~/go/bin/ask ready` -- `~/go/bin/ask add +cli "Add feature X"` # prints `created task ` -- `~/go/bin/ask add +cli depends:0,1 "Add feature X"` -- `~/go/bin/ask info ` -- `~/go/bin/ask start ` -- `~/go/bin/ask annotate "progress note"` -- `~/go/bin/ask done ` +- `ask list` +- `ask ready` +- `ask add +cli "Add feature X"` # prints `created task ` +- `ask add +cli depends:0,1 "Add feature X"` +- `ask info ` +- `ask start ` +- `ask annotate "progress note"` +- `ask done ` Invalid examples: -- `~/go/bin/ask agent-task-management ...` -- `~/go/bin/ask list tasks` -- `~/go/bin/ask show task 298` -- any other natural-language phrasing passed to `~/go/bin/ask` +- `ask agent-task-management ...` +- `ask list tasks` +- `ask show task 298` +- any other natural-language phrasing passed to `ask` -**Alias IDs are the selectors to use for task work.** `~/go/bin/ask add` prints `created task `, and subsequent task commands in this workflow should keep using that alias ID throughout the workflow. +**Alias IDs are the selectors to use for task work.** `ask add` prints `created task `, and subsequent task commands in this workflow should keep using that alias ID throughout the workflow. ## Context and compaction diff --git a/prompts/skills/agent-task-management/references/00-context.md b/prompts/skills/agent-task-management/references/00-context.md index 6d9d008..c0598d8 100644 --- a/prompts/skills/agent-task-management/references/00-context.md +++ b/prompts/skills/agent-task-management/references/00-context.md @@ -6,7 +6,7 @@ Load this with any of the action files (1–5) when working with tasks. It defin ## Rules that apply to all task commands -- **Always use `~/go/bin/ask ` for all task operations.** The task CLI is installed at `~/go/bin/ask` and provides subcommands (`list`, `ready`, `add`, `info`, `start`, `stop`, `done`, `annotate`, `modify`, `tag`, `priority`, `dep`, `delete`, `urgency`) that operate on agent-managed tasks. It is not a natural-language interface and does not understand skill names. -- **Shell note:** Prefer `~/go/bin/ask` (full path) so the correct binary is used regardless of `PATH`. The binary name is `ask` (not a zsh reserved word). +- **Always use `ask ` for all task operations.** The task CLI is installed at `~/go/bin/ask` and provides subcommands (`list`, `ready`, `add`, `info`, `start`, `stop`, `done`, `annotate`, `modify`, `tag`, `priority`, `dep`, `delete`, `urgency`) that operate on agent-managed tasks. It is not a natural-language interface and does not understand skill names. +- **Shell note:** Prefer `ask` (full path) so the correct binary is used regardless of `PATH`. The binary name is `ask` (not a zsh reserved word). - **One task in progress per project.** Do not start a second task while another is started and not completed, unless the user explicitly asks. - **Parallel work via sub-agents** — the agent may spawn sub-agents to work on tasks in parallel if those tasks would not conflict each other. 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 5755475..0d472df 100644 --- a/prompts/skills/agent-task-management/references/1-create-task.md +++ b/prompts/skills/agent-task-management/references/1-create-task.md @@ -9,7 +9,7 @@ Use with `00-context.md`. Project name and global rules apply. New tasks get `+a - **Every task MUST have at least one tag** for sub-project/feature/area (e.g. `+integrationtests`, `+flamegraph`, `+bpf`, `+cli`, `+refactor`, `+bugfix`). - **After creating a task, add annotation** — one with the agent workflow reminder: ``` - ~/go/bin/ask annotate "Agent workflow: load the agent-task-management skill as instructions only, not as a shell command. Use only normal ~/go/bin/ask subcommand syntax. Also load and apply: (1) the best-practices skill for the programming language used in the project, (2) solid-principles. When all tests and sub-agent reviews pass, commit and automatically progress to the next ready task." + ask annotate "Agent workflow: load the agent-task-management skill as instructions only, not as a shell command. Use only normal ~/go/bin/ask subcommand syntax. Also load and apply: (1) the best-practices skill for the programming language used in the project, (2) solid-principles. When all tests and sub-agent reviews pass, commit and automatically progress to the next ready task." ``` - **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. @@ -17,28 +17,28 @@ Use with `00-context.md`. Project name and global rules apply. New tasks get `+a ## Add a task -`~/go/bin/ask add` already injects `project: +agent`, so only add the extra feature tag(s), optional priority, optional `depends:` modifier, and description. +`ask add` already injects `project: +agent`, so only add the extra feature tag(s), optional priority, optional `depends:` modifier, and description. **Each part must be a separate shell argument — never quote tag and description together:** ```bash -~/go/bin/ask add + "Description" -~/go/bin/ask add priority:H + "Description" -~/go/bin/ask add priority:M + "Description" -~/go/bin/ask add + depends:, "Description" +ask add + "Description" +ask add priority:H + "Description" +ask add priority:M + "Description" +ask add + depends:, "Description" ``` Do NOT do this (causes tag/priority to appear in the description instead of being applied): ```bash -~/go/bin/ask add "+ Description" # wrong: tag and desc in one quoted string -~/go/bin/ask add "+ -p M Description" # wrong: everything in one quoted arg +ask add "+ Description" # wrong: tag and desc in one quoted string +ask add "+ -p M Description" # wrong: everything in one quoted arg ``` -`~/go/bin/ask add` prints `created task `. Reuse that alias ID directly for follow-up commands: +`ask add` prints `created task `. Reuse that alias ID directly for follow-up commands: ```bash -id=$(~/go/bin/ask add + "Description" | sed -n 's/^created task //p') -~/go/bin/ask annotate "$id" "Agent workflow: load the agent-task-management skill as instructions only, not as a shell command. Never run ~/go/bin/ask agent-task-management ... or other natural-language ~/go/bin/ask commands. Use only normal ~/go/bin/ask subcommand syntax. 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." +id=$(ask add + "Description" | sed -n 's/^created task //p') +ask annotate "$id" "Agent workflow: load the agent-task-management skill as instructions only, not as a shell command. Never run ~/go/bin/ask agent-task-management ... or other natural-language ~/go/bin/ask commands. Use only normal ~/go/bin/ask subcommand syntax. 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." ``` ## With dependency @@ -46,13 +46,13 @@ id=$(~/go/bin/ask add + "Description" | sed -n 's/^created task //p') Add dependencies inline during task creation: ```bash -id=$(~/go/bin/ask add + depends: "Description" | sed -n 's/^created task //p') +id=$(ask add + depends: "Description" | sed -n 's/^created task //p') ``` Multiple dependencies: ```bash -id=$(~/go/bin/ask add + depends:, "Description" | sed -n 's/^created task //p') +id=$(ask add + depends:, "Description" | sed -n 's/^created task //p') ``` After adding (with or without dependency), run the same annotations using that alias ID directly. @@ -61,6 +61,6 @@ After adding (with or without dependency), run the same annotations using that a - **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:,...` during `~/go/bin/ask add`. +- **Always check for dependencies:** before adding a task, determine if it depends on other tasks in the project; if so, add `depends:,...` during `ask add`. - 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. diff --git a/prompts/skills/agent-task-management/references/2-start-task.md b/prompts/skills/agent-task-management/references/2-start-task.md index 45a67a9..78af213 100644 --- a/prompts/skills/agent-task-management/references/2-start-task.md +++ b/prompts/skills/agent-task-management/references/2-start-task.md @@ -15,7 +15,7 @@ The task itself should already contain references to all required context (added ## Finding a task ```bash -~/go/bin/ask ready | head +ask ready | head ``` ## Mark task as started @@ -23,7 +23,7 @@ The task itself should already contain references to all required context (added When you begin working on a task, **always mark it as started** so current work is visible: ```bash -~/go/bin/ask start +ask start ``` Do this as soon as you start work on the task. @@ -31,6 +31,6 @@ Do this as soon as you start work on the task. ## Conventions - Start each new task with a fresh context; rely on the task's description and annotations for all required context. -- Run `~/go/bin/ask start ` when you start working on the task, not only when listing or completing. +- Run `ask start ` when you start working on the task, not only when listing or completing. - Do not start a second task for the same project while one is already started and not done, unless the user explicitly asks. - When a task is selected via the review/overview step, use the alias ID from the list or task details for subsequent `start` operations. diff --git a/prompts/skills/agent-task-management/references/3-complete-task.md b/prompts/skills/agent-task-management/references/3-complete-task.md index 065613b..42aab17 100644 --- a/prompts/skills/agent-task-management/references/3-complete-task.md +++ b/prompts/skills/agent-task-management/references/3-complete-task.md @@ -45,19 +45,19 @@ If the answer suggests improvements or inconsistencies, address them first. Only 6. Only then: ```bash -~/go/bin/ask done +ask done ``` Use the alias ID from the selection step or current task details when marking the task complete. -7. **Automatically progress to the next task in the list.** After marking the task done, if there are more agent-managed tasks in the project (e.g. `~/go/bin/ask list` shows pending/ready tasks), start the next one: load `00-context.md` and `2-start-task.md`, pick the next task from the list (respecting dependencies and "one task in progress" rule), and begin work on it. Do not stop after completing a task when a next task is available — continue to the next task in the list. +7. **Automatically progress to the next task in the list.** After marking the task done, if there are more agent-managed tasks in the project (e.g. `ask list` shows pending/ready tasks), start the next one: load `00-context.md` and `2-start-task.md`, pick the next task from the list (respecting dependencies and "one task in progress" rule), and begin work on it. Do not stop after completing a task when a next task is available — continue to the next task in the list. ## Conventions - When creating or changing tests, add negative tests (invalid input, errors, failure paths) wherever plausible; the review sub-agent will check for this. - A task is not done until: best practices met, code compiles, all tests pass, negative tests included where plausible, and all first-round review comments are addressed (including coverage and test-quality checks), **and all changes are committed to git**. If code changed after review comments, a second sub-agent review must confirm the updated code. - Before every sub-agent review handoff, do the self-review: "Did it all make sense? Is there a better way?" Fix anything that comes up, then hand off. -- **On completion, commit all changes to git** before running `~/go/bin/ask done `; do not leave uncommitted work when marking a task complete. -- Complete with `~/go/bin/ask done ` only after completion criteria, self-review(s), first review, addressing all comments, and git commit are satisfied. Add a follow-up sub-agent review only when code changed after review comments. +- **On completion, commit all changes to git** before running `ask done `; do not leave uncommitted work when marking a task complete. +- Complete with `ask done ` only after completion criteria, self-review(s), first review, addressing all comments, and git commit are satisfied. Add a follow-up sub-agent review only when code changed after review comments. - When completing a task, note which tasks were unblocked (dependents that became ready), if any. -- **After completing a task, automatically progress to the next task in the list** (when all tests and required sub-agent review(s) pass and the task is done). Start the next ready task from `~/go/bin/ask ready`; do not stop unless no next task is available or the user asks to stop. +- **After completing a task, automatically progress to the next task in the list** (when all tests and required sub-agent review(s) pass and the task is done). Start the next ready task from `ask ready`; do not stop unless no next task is available or the user asks to stop. diff --git a/prompts/skills/agent-task-management/references/4-annotate-update-task.md b/prompts/skills/agent-task-management/references/4-annotate-update-task.md index 6911910..7f0a045 100644 --- a/prompts/skills/agent-task-management/references/4-annotate-update-task.md +++ b/prompts/skills/agent-task-management/references/4-annotate-update-task.md @@ -9,13 +9,13 @@ When working on a task, **always read the full context:** description, summary, View full task (including annotations): ```bash -~/go/bin/ask info +ask info ``` ## Annotate a task ```bash -~/go/bin/ask annotate "Note about progress or context" +ask annotate "Note about progress or context" ``` While making progress, **add annotations** to reflect progress, challenges, or decisions. You may refer to files, documents, or other resources (paths, doc links, snippets) so the task history stays useful for later work and for the pre-completion review. @@ -25,17 +25,17 @@ Whenever you mention another task inside an annotation (for example, as a depend ## Modify a task ```bash -~/go/bin/ask modify + -~/go/bin/ask dep add -~/go/bin/ask modify priority:H +ask modify + +ask dep add +ask modify priority:H ``` -Use the alias ID shown by `~/go/bin/ask list`, `~/go/bin/ask ready`, or `~/go/bin/ask info` when modifying tasks selected earlier or referenced from annotations or other docs. +Use the alias ID shown by `ask list`, `~/go/bin/ask ready`, or `~/go/bin/ask info` when modifying tasks selected earlier or referenced from annotations or other docs. ## Delete a task ```bash -~/go/bin/ask delete +ask delete ``` ## Conventions diff --git a/prompts/skills/agent-task-management/references/5-review-overview-tasks.md b/prompts/skills/agent-task-management/references/5-review-overview-tasks.md index 9045a65..324c640 100644 --- a/prompts/skills/agent-task-management/references/5-review-overview-tasks.md +++ b/prompts/skills/agent-task-management/references/5-review-overview-tasks.md @@ -7,13 +7,13 @@ Use with `00-context.md`. Project name and global rules apply. Only list tasks that have `+agent` (project + tag matching). When listing, order by **priority first, then urgency**: ```bash -~/go/bin/ask list sort:priority-,urgency- +ask list sort:priority-,urgency- ``` By tag (keep `+agent`, same order): ```bash -~/go/bin/ask list + sort:priority-,urgency- +ask list + sort:priority-,urgency- ``` ## Picking what to work on (next task) @@ -23,14 +23,14 @@ By tag (keep `+agent`, same order): **Check already-started tasks first.** Before suggesting or starting a new task: ```bash -~/go/bin/ask list start.any: sort:priority-,urgency- +ask list start.any: sort:priority-,urgency- ``` - If any tasks are already started, **use one of those** (pick by priority, then urgency) — do not start a second task unless the user explicitly asks. - Only if no tasks are in progress, show the next actionable (READY) task, ordered by priority then urgency: ```bash -~/go/bin/ask ready +ask ready ``` Once you have chosen a task from one of these lists, **use its alias ID** from the list output for all subsequent operations and handoffs. When returning or recording the chosen task for another agent or a later step, **include its alias ID**. @@ -38,7 +38,7 @@ Once you have chosen a task from one of these lists, **use its alias ID** from t ## View task details ```bash -~/go/bin/ask info +ask info ``` Always read description, summary, and **all annotations** when working on or reviewing a task. @@ -48,14 +48,14 @@ Always read description, summary, and **all annotations** when working on or rev Dependency tree (all agent tasks): ```bash -~/go/bin/ask list +ask list ``` Blocked vs ready (with `+agent`): ```bash -~/go/bin/ask list +BLOCKED sort:priority-,urgency- -~/go/bin/ask ready +ask list +BLOCKED sort:priority-,urgency- +ask ready ``` ## Conventions -- cgit v1.2.3