docs: clarify task breakdown guidance in ticket extension prompts (#28)

* docs(ticket): clarify task breakdown guidance in extension prompts

* docs: update changelog

Author: kostyay

CHANGELOG.md

@@ -51,11 +51,18 @@ All notable changes to agent-stuff are documented here.
 
 
 
-## fix/always-push-before-pr
+
+
+
+## docs/improve-task-breakdown-guidance
+
+Enhanced task breakdown guidance in the ticket extension to provide agents with clearer constraints on task granularity (#28). The updated prompts now explicitly define "atomic tasks" as single, narrowly-scoped changes affecting 2-3 files or ~50 lines of code maximum, with concrete examples like individual functions, endpoints, or test files. This change addresses context window limitations by encouraging developers and AI agents to split larger tasks into smaller units, improving task completion rates and reducing incomplete work.
+
+## [1.0.16](https://github.com/kostyay/agent-stuff/pull/27) - 2026-03-06
 
 This release fixes a critical issue where PR creation could fail when the remote branch doesn't exist, by ensuring all commits are pushed before attempting to create a pull request (#27). The push operation now always executes unconditionally before PR creation rather than checking for unpushed commits, making it idempotent and handling edge cases like stale upstream refs after previous PR merges. Additionally, the PR creation command now explicitly specifies the branch head to avoid ambiguity in multi-branch workflows. A minor documentation correction updates the stash extension keyboard shortcut from Ctrl+S to Ctrl+Shift+S to match the actual implementation.
 
-## feat/configurable-simplify-threshold
+## [1.0.16](https://github.com/kostyay/agent-stuff/pull/26) - 2026-03-06
 
 Introduces a configurable auto-simplify threshold and improved change detection for the `/simplify` command (#26). The `/simplify` command now uses per-file diff statistics to track added/removed lines and only triggers auto-proposal when total changes exceed a configurable `minChangedLines` threshold (default: 10), providing finer control over when simplification is suggested. Additionally, two new extensions were added: `/stash` command (Ctrl+S) for temporarily saving editor drafts during quick questions, and `/whoami` command for managing git user identity within sessions—improving workflow ergonomics for context-switching scenarios.
 

pi-extensions/ticket/index.ts

@@ -1166,7 +1166,10 @@ export default function ticketExtension(pi: ExtensionAPI) {
 				"Do not proceed until I confirm you understand correctly.\n\n" +
 				"**Step 2: Plan** — Present a proposed breakdown:\n" +
 				"- One epic with a clear description\n" +
-				"- Atomic tasks (each completable in one session)\n" +
+				"- Tasks broken down as small as possible — each task should be a single, " +
+				"narrowly-scoped change (e.g. one function, one endpoint, one test file, one config change). " +
+				"If a task touches more than 2-3 files or takes more than ~50 lines of code, split it further. " +
+				"Prefer many tiny tasks over fewer large ones — agents run out of context on big tasks.\n" +
 				"- Dependencies between tasks\n" +
 				"- Priority for each task (0=critical, 1=high, 2=normal, 3=low)\n" +
 				"- For each task, draft: description, acceptance criteria, and test criteria\n\n" +