1 files changed, 5 insertions, 2 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 9450a0a..dde7e67 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,15 +14,18 @@ The task manager is a dependency-aware issue tracker inspired by beads. It uses:
 
 ### Create a Task
 ```bash
-task create "<title>" <project> [--deps=<ids>]
+task create "<title>" <project> [--deps=<ids>] [--namespace=<ns>]
 ```
 
 Examples:
 ```bash
 task create "Add authentication" auth-system
-task create "Write tests" auth-system --deps=t-20241108120000
+task create "Write tests" auth-system --deps=t-a1b2c3
+task create "Fix type errors" task-manager --namespace="Omni/Task"
 ```
 
+The `--namespace` option associates the task with a specific namespace in the monorepo (e.g., `Omni/Task`, `Biz/Cloud`). This helps organize tasks by the code they relate to.
+
 ### List Tasks
 ```bash
 task list [--project=<project>]