diff options
| author | Paul Buetow <paul@buetow.org> | 2026-03-03 22:28:46 +0200 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-03-03 22:28:46 +0200 |
| commit | 0b1adf6136aa8866ecfbeab844747b24b9bf566e (patch) | |
| tree | 7a96938ac1ecb98010d30258f86f6972351d174f /prompts | |
| parent | 64d3e4664628f00456ab2471e4bbf6f382e606c3 (diff) | |
more on this
Diffstat (limited to 'prompts')
| -rw-r--r-- | prompts/commands/create-tasks.md | 84 | ||||
| -rw-r--r-- | prompts/commands/start-work-on-tasks.md | 56 |
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. |
