summaryrefslogtreecommitdiff
path: root/prompts/skills
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-03-25 21:18:39 +0200
committerPaul Buetow <paul@buetow.org>2026-03-25 21:18:39 +0200
commitbd5ee1602b59f39cdacbbcc4f77a370483fc8216 (patch)
tree5f66e76211bad7f5fb6251b27cb730a6870c5cff /prompts/skills
parentca288df6d6be71d8728b9f7947902a8be268fbb3 (diff)
refactor: /work-on-tasks now delegates each task to a fresh sub-agent
- Orchestrator picks tasks, marks them started, and spawns a sub-agent for implementation - Each task runs in a clean context; orchestrator never implements tasks directly - Updated docs to clarify sub-agent delegation and context isolation - Improved task loop and reporting steps - See prompts/commands/work-on-tasks.md for new orchestrator/sub-agent workflow
Diffstat (limited to 'prompts/skills')
-rw-r--r--prompts/skills/agent-task-management/SKILL.md2
-rw-r--r--prompts/skills/agent-task-management/references/2-start-task.md8
2 files changed, 8 insertions, 2 deletions
diff --git a/prompts/skills/agent-task-management/SKILL.md b/prompts/skills/agent-task-management/SKILL.md
index c69dc8e..4035c67 100644
--- a/prompts/skills/agent-task-management/SKILL.md
+++ b/prompts/skills/agent-task-management/SKILL.md
@@ -30,7 +30,7 @@ Invalid examples:
## Context and compaction
-When beginning a new task, **prefer running a compaction** over starting a completely new context. If starting a new context for a new task is not possible, run a compaction instead.
+When beginning a new task, **always use a fresh context** — spawn a sub-agent (if orchestrating via `/work-on-tasks`) or start a new session. Do not carry implementation context from one task to the next; accumulated context causes drift (e.g. hallucinated paths) in long-running models. Compaction is a fallback only when spawning a sub-agent or new session is not possible.
## When to Use
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 d5dbc93..0029a2b 100644
--- a/prompts/skills/agent-task-management/references/2-start-task.md
+++ b/prompts/skills/agent-task-management/references/2-start-task.md
@@ -4,7 +4,13 @@ Use with `00-context.md`. Project name and global rules apply (including one tas
## Start each new task with a fresh context
-Work on each new task **must begin with a fresh context** — e.g. a new session or a sub-agent with no prior conversation. That way the task is executed with clear focus and no carry-over from other work. The task itself should already contain references to all required context (added when the task was created); read the task description and all annotations to get files, docs, and specs before starting.
+Work on each new task **must begin with a fresh context** — a new sub-agent with no prior conversation history. That way the task is executed with clear focus and no carry-over from other work.
+
+**If you are orchestrating via `/work-on-tasks`:** spawn a sub-agent for the implementation. Pass the full task description, all annotations, and the project root path to the sub-agent. Do not implement tasks in the orchestrator's own context.
+
+**If you are starting a single task manually:** begin in a new session or compact first so the context is clean before you start working.
+
+The task itself should already contain references to all required context (added when the task was created); read the task description and all annotations to get files, docs, and specs before starting.
## Finding a task