Skip to main content

Recipes

Recipes are optional AgentPlane extension packages.

They are different from workflow guides:

  • A recipe has a manifest, version, compatibility metadata, and package assets.
  • A remote recipe is discovered through the signed recipes index.
  • recipes install imports a package into the global cache.
  • recipes add vendors a cached package into the current project under .agentplane/recipes/.
  • Runtime reads project-local vendored recipes, not an agent chat transcript or editor state.

For copy-paste flows with Claude Code, Codex, Cursor, Aider, GitHub Actions, or branch_pr, use Workflow guides.

Current catalog​

The production catalog currently contains one recipe:

  1. Code Map ([email protected])

The catalog is sourced from the agentplane-recipes submodule and projected into docs/recipes-inventory.json by node scripts/generate-recipes-inventory.mjs.

Install and vendor​

List the signed remote catalog:

agentplane recipes list-remote --refresh --yes

Install a recipe into the global cache:

agentplane recipes install code-map --refresh --yes
agentplane recipes list
agentplane recipes info code-map

Vendor the cached recipe into a project:

agentplane recipes add code-map
agentplane recipes active
agentplane recipes explain code-map

During project initialization, use --recipes only for recipes already available to the init flow:

agentplane init --recipes code-map

Runtime model​

After vendoring, AgentPlane uses:

  • .agentplane/recipes/registry.json as the project authority;
  • .agentplane/recipes/packages/<recipe-id>/ for the vendored package;
  • .agentplane/generated/overlay-bundle.json for derived overlay data;
  • .agentplane/generated/recipe-assets.json for recipe asset projection;
  • .agentplane/generated/prompt-graph.json for compiled prompt-module output.

Deleting the global recipe cache does not remove recipes already vendored into a project.

Safety model​

Recipes are executable extensions. Review the manifest and package contents before installing.

The default remote index is verified with AgentPlane's trusted recipes index keys before cached catalog data is trusted. See Recipes safety and repository ADR docs/adr/0009-recipes-index-signing-algorithm-policy.md for signing and key handling.

Developer docs​