feat(goose): map commands to recipes and subagents to sub-recipes

Goose recipes are reusable YAML workflow files discovered in .goose/recipes/
(project) and ~/.config/goose/recipes/ (global). Add two adapters:

- GooseCommand: commands -> top-level recipes (.goose/recipes/<name>.yaml).
  The command body becomes the recipe `prompt`.
- GooseSubagent: subagents -> sub-recipes (.goose/recipes/subagents/<name>.yaml),
  referenced from a parent recipe's `sub_recipes` by relative path. The subagent
  body becomes the recipe `instructions`.

Recipes require version/title/description plus instructions|prompt; title
defaults to the file name and description to the rulesync description (falling
back to title), version to 1.0.0. Any other recipe field (parameters,
extensions, sub_recipes, …) round-trips through the rulesync `goose` section.

Subagents live in the `subagents/` subdirectory so the command-recipe and
subagent-recipe file sets stay disjoint (the command importer scans
.goose/recipes/*.yaml non-recursively), preventing import/orphan-deletion
cross-over. Register goose in the commands and subagents processors (both
project + global), add gitignore entries, README/docs matrix updates, and
unit + E2E happy-path coverage.

Refs #1823 (Goose recipes/sub-recipes; skills still tracked by #1115)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: cm-dyoshikawa

.gitignore

@@ -285,6 +285,8 @@ rulesync.local.jsonc
 **/.goosehints
 **/.goose/
 **/.gooseignore
+**/.goose/recipes/
+**/.goose/recipes/subagents/
 **/.agents/plugins/
 **/.github/copilot-instructions.md
 **/.github/instructions/

README.md

@@ -80,7 +80,7 @@ The tables below show whether each tool supports a given feature (✅ = supporte
 | Claude Code            |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |
 | Codex CLI              |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |
 | Gemini CLI ⚠️          |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |
-| Goose                  |  ✅   |   ✅   | ✅  |          |           |        |  ✅   |             |
+| Goose                  |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |        |  ✅   |             |
 | GitHub Copilot         |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |             |
 | GitHub Copilot CLI     |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |             |
 | Cursor                 |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |

docs/reference/file-formats.md

@@ -571,6 +571,15 @@ env_vars = ["OPENAI_API_KEY", "OPENROUTER_API_KEY", "GEMINI_API_KEY"]
 
 Goose configures MCP servers as **extensions** in the shared user config `~/.config/goose/config.yaml`, which is **global only** (Goose has no project-scoped MCP location), so they are generated with `--global`. The schema is non-standard, so Rulesync maps canonical MCP fields to Goose's: `command` → `cmd` (an array `command` folds its tail into `args`), `env` → `envs`, `url`/`httpUrl` → `uri`, and `disabled: true` → `enabled: false`. The `type` is derived — `command` ⇒ `stdio`, a remote `url` ⇒ `streamable_http` (or `sse` when the canonical `type` is `sse`). Each extension also carries its own `name`. Generation merges the `extensions:` block into the existing `config.yaml`, preserving other Goose settings (model, provider, ...), and the file is never deleted. See the [Goose extensions docs](https://block.github.io/goose/docs/getting-started/using-extensions/).
 
+### Goose-specific: commands and subagents as recipes
+
+Goose [recipes](https://block.github.io/goose/docs/guides/recipes/recipe-reference/) are reusable YAML workflow files (`version`, `title`, `description`, plus at least one of `instructions` / `prompt`, and optional `extensions`, `parameters`, `sub_recipes`, …). Rulesync maps:
+
+- **commands → top-level recipes** at `.goose/recipes/<name>.yaml` (project) and `~/.config/goose/recipes/<name>.yaml` (global). The command body becomes the recipe `prompt`.
+- **subagents → sub-recipes** at `.goose/recipes/subagents/<name>.yaml` (project) and `~/.config/goose/recipes/subagents/<name>.yaml` (global), referenced from a parent recipe's `sub_recipes` list by relative `path`. The subagent body becomes the recipe `instructions`.
+
+Subagents live in the `subagents/` subdirectory so the command-recipe and subagent-recipe file sets stay disjoint (import and orphan deletion never cross over). `title` defaults to the file name and `description` to the rulesync `description` (falling back to `title`) since recipes require both; `version` defaults to `1.0.0`. Any other recipe field round-trips through the rulesync `goose` section of a command/subagent.
+
 ## `.rulesync/.aiignore` or `.rulesyncignore`
 
 Rulesync supports a single ignore list that can live in either location below:

docs/reference/supported-tools.md

@@ -12,7 +12,7 @@ Rulesync supports both **generation** and **import** for All of the major AI cod
 | Gemini CLI ⚠️          | geminicli       | ✅ 🌏 |   ✅   |  ✅ 🌏   |  ✅ 🌏   |    ✅     | ✅ 🌏  | ✅ 🌏 |    ✅ 🌏    |
 | GitHub Copilot         | copilot         | ✅ 🌏 |        |    ✅    |    ✅    |    ✅     |   ✅   |  ✅   |             |
 | GitHub Copilot CLI     | copilotcli      | ✅ 🌏 |        |  ✅ 🌏   |          |   ✅ 🌏   | ✅ 🌏  | ✅ 🌏 |             |
-| Goose                  | goose           | ✅ 🌏 |   ✅   |    🌏    |          |           |        | ✅ 🌏 |             |
+| Goose                  | goose           | ✅ 🌏 |   ✅   |    🌏    |  ✅ 🌏   |   ✅ 🌏   |        | ✅ 🌏 |             |
 | Cursor                 | cursor          |  ✅   |   ✅   |  ✅ 🌏   |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  | ✅ 🌏 |    ✅ 🌏    |
 | deepagents-cli         | deepagents      | ✅ 🌏 |        |  ✅ 🌏   |          |   ✅ 🌏   | ✅ 🌏  |  🌏   |             |
 | Factory Droid          | factorydroid    | ✅ 🌏 |        |  ✅ 🌏   |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  | ✅ 🌏 |    ✅ 🌏    |

skills/rulesync/file-formats.md

@@ -571,6 +571,15 @@ env_vars = ["OPENAI_API_KEY", "OPENROUTER_API_KEY", "GEMINI_API_KEY"]
 
 Goose configures MCP servers as **extensions** in the shared user config `~/.config/goose/config.yaml`, which is **global only** (Goose has no project-scoped MCP location), so they are generated with `--global`. The schema is non-standard, so Rulesync maps canonical MCP fields to Goose's: `command` → `cmd` (an array `command` folds its tail into `args`), `env` → `envs`, `url`/`httpUrl` → `uri`, and `disabled: true` → `enabled: false`. The `type` is derived — `command` ⇒ `stdio`, a remote `url` ⇒ `streamable_http` (or `sse` when the canonical `type` is `sse`). Each extension also carries its own `name`. Generation merges the `extensions:` block into the existing `config.yaml`, preserving other Goose settings (model, provider, ...), and the file is never deleted. See the [Goose extensions docs](https://block.github.io/goose/docs/getting-started/using-extensions/).
 
+### Goose-specific: commands and subagents as recipes
+
+Goose [recipes](https://block.github.io/goose/docs/guides/recipes/recipe-reference/) are reusable YAML workflow files (`version`, `title`, `description`, plus at least one of `instructions` / `prompt`, and optional `extensions`, `parameters`, `sub_recipes`, …). Rulesync maps:
+
+- **commands → top-level recipes** at `.goose/recipes/<name>.yaml` (project) and `~/.config/goose/recipes/<name>.yaml` (global). The command body becomes the recipe `prompt`.
+- **subagents → sub-recipes** at `.goose/recipes/subagents/<name>.yaml` (project) and `~/.config/goose/recipes/subagents/<name>.yaml` (global), referenced from a parent recipe's `sub_recipes` list by relative `path`. The subagent body becomes the recipe `instructions`.
+
+Subagents live in the `subagents/` subdirectory so the command-recipe and subagent-recipe file sets stay disjoint (import and orphan deletion never cross over). `title` defaults to the file name and `description` to the rulesync `description` (falling back to `title`) since recipes require both; `version` defaults to `1.0.0`. Any other recipe field round-trips through the rulesync `goose` section of a command/subagent.
+
 ## `.rulesync/.aiignore` or `.rulesyncignore`
 
 Rulesync supports a single ignore list that can live in either location below:

skills/rulesync/supported-tools.md

@@ -12,7 +12,7 @@ Rulesync supports both **generation** and **import** for All of the major AI cod
 | Gemini CLI ⚠️          | geminicli       | ✅ 🌏 |   ✅   |  ✅ 🌏   |  ✅ 🌏   |    ✅     | ✅ 🌏  | ✅ 🌏 |    ✅ 🌏    |
 | GitHub Copilot         | copilot         | ✅ 🌏 |        |    ✅    |    ✅    |    ✅     |   ✅   |  ✅   |             |
 | GitHub Copilot CLI     | copilotcli      | ✅ 🌏 |        |  ✅ 🌏   |          |   ✅ 🌏   | ✅ 🌏  | ✅ 🌏 |             |
-| Goose                  | goose           | ✅ 🌏 |   ✅   |    🌏    |          |           |        | ✅ 🌏 |             |
+| Goose                  | goose           | ✅ 🌏 |   ✅   |    🌏    |  ✅ 🌏   |   ✅ 🌏   |        | ✅ 🌏 |             |
 | Cursor                 | cursor          |  ✅   |   ✅   |  ✅ 🌏   |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  | ✅ 🌏 |    ✅ 🌏    |
 | deepagents-cli         | deepagents      | ✅ 🌏 |        |  ✅ 🌏   |          |   ✅ 🌏   | ✅ 🌏  |  🌏   |             |
 | Factory Droid          | factorydroid    | ✅ 🌏 |        |  ✅ 🌏   |  ✅ 🌏   |   ✅ 🌏   | ✅ 🌏  | ✅ 🌏 |    ✅ 🌏    |

src/cli/commands/gitignore-entries.ts

@@ -235,6 +235,12 @@ export const GITIGNORE_ENTRY_REGISTRY: ReadonlyArray<GitignoreEntryTag> = [
   { target: "goose", feature: "rules", entry: "**/.goosehints" },
   { target: "goose", feature: "rules", entry: "**/.goose/" },
   { target: "goose", feature: "ignore", entry: "**/.gooseignore" },
+  // Goose recipes: commands map to top-level recipes (`.goose/recipes/*.yaml`)
+  // and subagents to sub-recipes (`.goose/recipes/subagents/*.yaml`). These are
+  // already covered by the broad `**/.goose/` rules entry above, but tagging
+  // them per-feature keeps coverage correct under feature-filtered gitignore.
+  { target: "goose", feature: "commands", entry: "**/.goose/recipes/" },
+  { target: "goose", feature: "subagents", entry: "**/.goose/recipes/subagents/" },
   // Goose lifecycle hooks plugin (.agents/plugins/<name>/hooks/hooks.json)
   { target: "goose", feature: "hooks", entry: "**/.agents/plugins/" },
   // Goose reads MCP "extensions" only from the global user config

src/constants/goose-paths.ts

@@ -7,3 +7,18 @@ export const GOOSE_IGNORE_FILE_NAME = ".gooseignore";
 export const GOOSE_MCP_FILE_NAME = "config.yaml";
 export const GOOSE_HOOKS_DIR_PATH = join(".agents", "plugins", "rulesync", "hooks");
 export const GOOSE_HOOKS_FILE_NAME = "hooks.json";
+
+// Recipes are reusable YAML workflow files. Goose discovers project recipes in
+// `./.goose/recipes/` and global recipes in `~/.config/goose/recipes/`.
+// rulesync maps commands → top-level recipes (here) and subagents → sub-recipe
+// files under the `subagents/` subdirectory (referenced from a parent recipe via
+// a relative `path`). Keeping subagents in a subdirectory makes the command and
+// subagent file sets disjoint so import/orphan-deletion never cross over.
+// @see https://block.github.io/goose/docs/guides/recipes/recipe-reference/
+export const GOOSE_RECIPES_DIR_PATH = join(GOOSE_DIR, "recipes");
+export const GOOSE_GLOBAL_RECIPES_DIR_PATH = join(GOOSE_GLOBAL_DIR, "recipes");
+export const GOOSE_RECIPES_SUBAGENTS_DIR_PATH = join(GOOSE_RECIPES_DIR_PATH, "subagents");
+export const GOOSE_GLOBAL_RECIPES_SUBAGENTS_DIR_PATH = join(
+  GOOSE_GLOBAL_RECIPES_DIR_PATH,
+  "subagents",
+);

src/e2e/e2e-commands.spec.ts

@@ -32,6 +32,7 @@ describe("E2E: commands", () => {
     { target: "pi", outputPath: join(".pi", "prompts", "review-pr.md") },
     { target: "devin", outputPath: join(".devin", "workflows", "review-pr.md") },
     { target: "factorydroid", outputPath: join(".factory", "commands", "review-pr.md") },
+    { target: "goose", outputPath: join(".goose", "recipes", "review-pr.yaml") },
   ])("should generate $target commands", async ({ target, outputPath }) => {
     const testDir = getTestDir();
 
@@ -100,6 +101,7 @@ Check the PR diff and provide feedback.
     { target: "pi", orphanPath: join(".pi", "prompts", "orphan.md") },
     { target: "devin", orphanPath: join(".devin", "workflows", "orphan.md") },
     { target: "factorydroid", orphanPath: join(".factory", "commands", "orphan.md") },
+    { target: "goose", orphanPath: join(".goose", "recipes", "orphan.yaml") },
   ])(
     "should fail in check mode when delete would remove an orphan $target command file",
     async ({ target, orphanPath }) => {
@@ -160,6 +162,25 @@ describe("E2E: commands (import)", () => {
     );
     expect(importedContent).toContain("Review the PR diff and provide feedback.");
   });
+
+  it("should import goose commands (recipe YAML)", async () => {
+    const testDir = getTestDir();
+
+    const recipeContent = [
+      "version: 1.0.0",
+      "title: review-pr",
+      "description: Review a pull request",
+      "prompt: Review the PR diff and provide feedback.",
+    ].join("\n");
+    await writeFileContent(join(testDir, ".goose", "recipes", "review-pr.yaml"), recipeContent);
+
+    await runImport({ target: "goose", features: "commands" });
+
+    const importedContent = await readFileContent(
+      join(testDir, RULESYNC_COMMANDS_RELATIVE_DIR_PATH, "review-pr.md"),
+    );
+    expect(importedContent).toContain("Review the PR diff and provide feedback.");
+  });
 });
 
 describe("E2E: commands (global mode)", () => {
@@ -189,6 +210,7 @@ describe("E2E: commands (global mode)", () => {
       outputPath: join(".codeium", "windsurf", "global_workflows", "review-pr.md"),
     },
     { target: "factorydroid", outputPath: join(".factory", "commands", "review-pr.md") },
+    { target: "goose", outputPath: join(".config", "goose", "recipes", "review-pr.yaml") },
   ])("should generate $target commands in home directory", async ({ target, outputPath }) => {
     const projectDir = getProjectDir();
     const homeDir = getHomeDir();

src/e2e/e2e-subagents.spec.ts

@@ -71,6 +71,10 @@ describe("E2E: subagents", () => {
       target: "vibe",
       outputPath: join(".vibe", "agents", "planner.toml"),
     },
+    {
+      target: "goose",
+      outputPath: join(".goose", "recipes", "subagents", "planner.yaml"),
+    },
   ])("should generate $target subagents", async ({ target, outputPath }) => {
     const testDir = getTestDir();
 
@@ -222,6 +226,7 @@ You are a subagent-only helper.
     { target: "factorydroid", orphanPath: join(".factory", "droids", "orphan.md") },
     { target: "cline", orphanPath: join(".cline", "agents", "orphan.yaml") },
     { target: "vibe", orphanPath: join(".vibe", "agents", "orphan.toml") },
+    { target: "goose", orphanPath: join(".goose", "recipes", "subagents", "orphan.yaml") },
   ])(
     "should fail in check mode when delete would remove an orphan $target subagent file",
     async ({ target, orphanPath }) => {
@@ -306,6 +311,28 @@ Break down tasks into steps.
     expect(importedContent).toContain("planner");
   });
 
+  it("should import goose subagents (sub-recipe YAML)", async () => {
+    const testDir = getTestDir();
+
+    const recipeContent = [
+      "version: 1.0.0",
+      "title: planner",
+      "description: Plans tasks",
+      "instructions: Break down tasks into steps.",
+    ].join("\n");
+    await writeFileContent(
+      join(testDir, ".goose", "recipes", "subagents", "planner.yaml"),
+      recipeContent,
+    );
+
+    await runImport({ target: "goose", features: "subagents" });
+
+    const importedContent = await readFileContent(
+      join(testDir, RULESYNC_SUBAGENTS_RELATIVE_DIR_PATH, "planner.md"),
+    );
+    expect(importedContent).toContain("planner");
+  });
+
   it("should import kiro subagents (JSON format)", async () => {
     const testDir = getTestDir();
 
@@ -366,6 +393,10 @@ describe("E2E: subagents (global mode)", () => {
       outputPath: join(".deepagents", "deepagents", "agents", "planner", "AGENTS.md"),
     },
     { target: "vibe", outputPath: join(".vibe", "agents", "planner.toml") },
+    {
+      target: "goose",
+      outputPath: join(".config", "goose", "recipes", "subagents", "planner.yaml"),
+    },
   ])("should generate $target subagents in home directory", async ({ target, outputPath }) => {
     const projectDir = getProjectDir();
     const homeDir = getHomeDir();