From 0a0ea5a3fec6eae0a4b300918a9a8fc06fcc786f Mon Sep 17 00:00:00 2001
From: Ben Sima <ben@bsima.me>
Date: Thu, 20 Nov 2025 13:35:54 -0500
Subject: Fix docopt flag ordering issue by using [options]

- Changed 'task list' usage from explicit flags to [options] -
Allows flags to be specified in any order (fixes t-10KNtTF) - All
combinations now work: --namespace --status, --status --namespace, etc.
- Updated AGENTS.md examples to use correct status argument format -
All tests passing (28/28)
---
 AGENTS.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

(limited to 'AGENTS.md')

diff --git a/AGENTS.md b/AGENTS.md
index d19ecf5..b668758 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -37,13 +37,13 @@ task init --quiet  # Non-interactive initialization
 task ready --json
 
 # 2. Claim a task
-task update <id> --status in_progress --json
+task update <id> in-progress --json
 
 # 3. During work: create discovered issues
 task create "Fix type error found" --discovered-from=<current-id> --json
 
 # 4. Complete the task
-task update <id> --status done --json
+task update <id> done --json
 
 # 5. End of session: sync to git (local commit only)
 task sync
@@ -202,7 +202,7 @@ The `--namespace` option associates the task with a specific namespace in the mo
 
 ### List Tasks
 ```bash
-task list [--type=<type>] [--parent=<id>] [--status=<status>] [--namespace=<ns>]
+task list [options]  # Flags can be in any order
 ```
 
 Examples:
-- 
cgit v1.2.3