Add .agents/commands as a search path for tasks (#131)

* Initial plan

* Add .agents/commands as a search path for tasks

Co-authored-by: alexec <1142830+alexec@users.noreply.github.com>

* Update docs to include .agents/commands search path

Co-authored-by: alexec <1142830+alexec@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: alexec <1142830+alexec@users.noreply.github.com>

Author: Copilot

README.md

@@ -28,7 +28,7 @@ This tool is compatible with configuration files from various AI coding agents a
 - **[OpenCode.ai](https://opencode.ai/)**: `.opencode/agent`, `.opencode/command`, `.opencode/rules`
 - **[GitHub Copilot](https://github.com/features/copilot)**: `.github/copilot-instructions.md`, `.github/agents`
 - **[Google Gemini](https://gemini.google.com/)**: `GEMINI.md`, `.gemini/styleguide.md`
-- **Generic AI Agents**: `AGENTS.md`, `.agents/rules`
+- **Generic AI Agents**: `AGENTS.md`, `.agents/rules`, `.agents/commands` (tasks), `.agents/tasks`
 
 The tool automatically discovers and includes rules from these locations in your project, parent directories, and user home directory (`~`).
 
@@ -166,6 +166,9 @@ The tool looks for task and rule files in the following locations, in order of p
 
 **Tasks:**
 - `./.agents/tasks/*.md` (any `.md` file with matching `task_name` in frontmatter)
+- `./.agents/commands/*.md`
+- `./.cursor/commands/*.md`
+- `./.opencode/command/*.md`
 - `~/.agents/tasks/*.md`
 
 **Rules:**

docs/how-to/create-tasks.md

@@ -25,7 +25,7 @@ Please review the code changes with focus on:
 - Security implications
 ```
 
-Save as `.agents/tasks/code-review.md`.
+Save as `.agents/tasks/code-review.md` (or `.agents/commands/code-review.md`).
 
 Use with:
 ```bash

docs/reference/search-paths.md

@@ -20,8 +20,9 @@ All directories (local and remote) are processed via go-getter, which downloads
 Within each directory, task files are searched in the following locations:
 
 1. `.agents/tasks/`
-2. `.cursor/commands/`
-3. `.opencode/command/`
+2. `.agents/commands/`
+3. `.cursor/commands/`
+4. `.opencode/command/`
 
 ### Discovery Rules
 
@@ -115,7 +116,7 @@ The CLI automatically discovers rules from configuration files for these AI codi
 | **OpenCode.ai** | `.opencode/agent/`, `.opencode/command/` (tasks), `.opencode/rules/` |
 | **GitHub Copilot** | `.github/copilot-instructions.md`, `.github/agents/` |
 | **Google Gemini** | `GEMINI.md`, `.gemini/styleguide.md` |
-| **Generic** | `AGENTS.md`, `.agents/rules/` |
+| **Generic** | `AGENTS.md`, `.agents/rules/`, `.agents/commands/` (tasks) |
 
 ## Discovery Behavior
 
@@ -285,7 +286,7 @@ coding-context -s team=backend fix-bug
 - For remote directories, verify the download succeeded (check stderr logs)
 
 **Task not found:**
-- Verify that `.agents/tasks/`, `.cursor/commands/`, or `.opencode/command/` directory exists in one of the search path directories
+- Verify that `.agents/tasks/`, `.agents/commands/`, `.cursor/commands/`, or `.opencode/command/` directory exists in one of the search path directories
 - Check `task_name` field in frontmatter matches the task name you're using
 - Ensure filename has `.md` extension
 - Verify the directory containing the task is in search paths (working directory and home directory are added automatically)

pkg/codingcontext/context_test.go

@@ -303,6 +303,31 @@ func TestFindTaskFile(t *testing.T) {
 			searchPaths: []string{"downloaded"}, // Will be resolved relative to tmpDir
 			wantErr:     false,
 		},
+		{
+			name:     "task file found in .agents/commands directory",
+			taskName: "agents_commands_task",
+			setupFiles: func(t *testing.T, tmpDir string) {
+				taskDir := filepath.Join(tmpDir, ".agents", "commands")
+				createMarkdownFile(t, filepath.Join(taskDir, "agents_commands_task.md"),
+					"",
+					"# Agents Commands Task")
+			},
+			wantErr: false,
+		},
+		{
+			name:     "task file found in downloaded .agents/commands directory",
+			taskName: "agents_commands_remote_task",
+			setupFiles: func(t *testing.T, tmpDir string) {
+				// Create task file in downloaded directory's .agents/commands
+				downloadedDir := filepath.Join(tmpDir, "downloaded")
+				taskDir := filepath.Join(downloadedDir, ".agents", "commands")
+				createMarkdownFile(t, filepath.Join(taskDir, "agents_commands_remote_task.md"),
+					"",
+					"# Agents Commands Remote Task")
+			},
+			searchPaths: []string{"downloaded"}, // Will be resolved relative to tmpDir
+			wantErr:     false,
+		},
 		{
 			name:     "task file found in .opencode/command directory",
 			taskName: "opencode_task",

pkg/codingcontext/paths.go

@@ -37,6 +37,7 @@ func rulePaths(dir string, home bool) []string {
 func taskSearchPaths(dir string) []string {
 	return []string{
 		filepath.Join(dir, ".agents", "tasks"),
+		filepath.Join(dir, ".agents", "commands"),
 		filepath.Join(dir, ".cursor", "commands"),
 		filepath.Join(dir, ".opencode", "command"),
 	}