summaryrefslogtreecommitdiff
path: root/prompts
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-03-03 22:28:46 +0200
committerPaul Buetow <paul@buetow.org>2026-03-03 22:28:46 +0200
commit0b1adf6136aa8866ecfbeab844747b24b9bf566e (patch)
tree7a96938ac1ecb98010d30258f86f6972351d174f /prompts
parent64d3e4664628f00456ab2471e4bbf6f382e606c3 (diff)
more on this
Diffstat (limited to 'prompts')
-rw-r--r--prompts/commands/create-tasks.md84
-rw-r--r--prompts/commands/start-work-on-tasks.md56
2 files changed, 140 insertions, 0 deletions
diff --git a/prompts/commands/create-tasks.md b/prompts/commands/create-tasks.md
new file mode 100644
index 0000000..1292f12
--- /dev/null
+++ b/prompts/commands/create-tasks.md
@@ -0,0 +1,84 @@
+ # /create-tasks
+
+ **Description:**
+ Generate a comprehensive, written execution plan for a goal, save that plan to disk, and then create Taskwarrior tasks for all the steps involved. Each task should be small but self-contained and should link back to the overall plan.
+
+ ---
+
+ ## Parameters / Usage
+
+ Invoke `/create-tasks` followed by a concise description of the goal or project you want to execute.
+
+ - **Input**: A natural language description of what you want to achieve (e.g., "Set up continuous deployment for this repo", "Write and publish a blog post about X").
+ - **Assumptions**: If information is missing but reasonably inferable, make sensible assumptions rather than asking lots of questions. Only ask questions if a decision is truly blocking.
+
+ Example invocations:
+
+ - `/create-tasks Set up GitHub Actions CI for this repo`
+ - `/create-tasks Refactor the authentication module and add tests`
+
+ ---
+
+## Prompt
+
+Use the `taskwarrior-task-management` skill for this entire workflow.
+
+You are an assistant that, when invoked via `/create-tasks`, turns a high-level goal into a concrete written plan and corresponding Taskwarrior tasks.
+
+ Follow this process carefully:
+
+ 1. **Understand the goal**
+ - Read the user’s request and infer:
+ - The overall objective
+ - The likely scope and constraints
+ - Any obvious sub-areas of work (e.g., "planning", "implementation", "testing", "documentation")
+ - If something is truly blocking (e.g., you must know the deployment provider), ask **one concise clarification question**. Otherwise, proceed with reasonable assumptions and clearly note them in the plan.
+
+ 2. **Create a comprehensive written plan**
+ - Produce a clear, structured plan in markdown, including:
+ - A short summary of the goal
+ - Assumptions and constraints
+ - High-level phases
+ - A numbered list of concrete steps for each phase
+ - Steps should be:
+ - Small but self-contained (each step is actionable and can be done in a focused work session)
+ - Ordered logically with explicit dependencies
+ - Choose a reasonable file path for the plan within the current project or notes context. Prefer something like:
+ - `plan.md`, `PLAN.md`, or `plans/<short-name>-plan.md`
+ - Write the plan to disk at that path (creating directories as needed).
+ - At the top of the plan file, include:
+ - The project/goal title
+ - The date
+ - The filesystem path of this plan (for easy linking from tasks).
+
+ 3. **Derive Taskwarrior tasks from the plan**
+ - Parse the numbered steps in the plan.
+ - For each step that represents a distinct unit of work, create a Taskwarrior task.
+ - Design tasks so that:
+ - Each task is small but self-contained.
+ - Tasks that logically depend on others come later and (if appropriate) mention their dependency in the description or annotation.
+ - For each task:
+ - Use a concise, verb-first description (e.g., "Configure GitHub Actions workflow for tests").
+ - Add meaningful tags (e.g., project name, area like `dev`, `docs`, `infra`).
+ - Set a `project` field in Taskwarrior that reflects the goal (e.g., `timr.ci`, `blog.post_x`).
+ - Add an annotation that links back to the plan file path, for example:
+ `"See overall plan: <relative/or/absolute/path/to/plan.md>"`.
+ - Use the appropriate tooling/commands to create the tasks (e.g., `task add ...`) in the user’s Taskwarrior setup.
+
+ 4. **Keep steps and tasks small but self-contained**
+ - Prefer more, smaller tasks over fewer, very large tasks, as long as each:
+ - Has a clear outcome
+ - Can be completed in a focused sitting
+ - Avoid microscopic tasks that don’t stand alone (e.g., "open editor").
+
+ 5. **Summarize to the user**
+ - After writing the plan and creating the tasks:
+ - Show the plan file path.
+ - List the Taskwarrior tasks you just created, including:
+ - Description
+ - Project
+ - Tags
+ - The annotation containing the link to the plan
+ - Keep the summary concise but clear enough that the user can immediately see what was created.
+
+ Always prioritize actually writing the plan to disk and creating real Taskwarrior tasks, not just describing what you would do.
diff --git a/prompts/commands/start-work-on-tasks.md b/prompts/commands/start-work-on-tasks.md
new file mode 100644
index 0000000..2099300
--- /dev/null
+++ b/prompts/commands/start-work-on-tasks.md
@@ -0,0 +1,56 @@
+# /start-work-on-tasks
+
+**Description:** Automatically work through Taskwarrior tasks for the current git project using the `taskwarrior-task-management` skill. The command selects the best pending task, starts it, executes it, completes it, and then auto-progresses to the next task until no actionable tasks remain.
+
+**Parameters:**
+- strategy (optional): How to choose tasks when multiple are available (e.g., "highest-impact", "priority", "due-date", "quick-win")
+- max_tasks (optional): Safety limit for how many tasks to process in one run
+
+**Example usage:**
+- `/start-work-on-tasks`
+- `/start-work-on-tasks highest-impact`
+- `/start-work-on-tasks priority 5`
+
+---
+
+## Prompt
+
+Use the `taskwarrior-task-management` skill for this entire workflow.
+
+I want you to automatically execute Taskwarrior work for the **current git project** from start to finish.
+
+1. **Load project-scoped tasks**:
+ - Detect the current project from local git context
+ - List pending Taskwarrior tasks for that project
+ - Ignore completed/deleted tasks and non-actionable blocked items
+
+2. **Pick the next task** (default strategy: `{{strategy|highest-impact}}`):
+ - Choose one actionable task based on impact, urgency, and clarity
+ - If two tasks are equivalent, prefer the one that unblocks other work
+
+3. **Start and execute it**:
+ - Mark the task as started
+ - Perform the implementation work needed to complete it
+ - Keep updates concise and action-focused while working
+
+4. **Close and record**:
+ - Mark the task complete when done
+ - Add a brief annotation summarizing what was delivered
+
+5. **Auto-progress loop**:
+ - Immediately return to step 1 and select the next pending task
+ - Continue until:
+ - no actionable project tasks remain, or
+ - `{{max_tasks}}` is reached (if provided), or
+ - a hard blocker is encountered
+
+6. **Final report**:
+ - List completed task IDs/titles
+ - List any skipped/blocked tasks with reasons
+ - State what remains pending for the project
+
+Important behavior requirements:
+- Do not ask me to pick a task unless there is a true ambiguity or risk.
+- Default to autonomous execution.
+- Keep task scope tied to the current project.
+- After each completion, automatically move to the next task.