Skip to content

feat(mcp): teach burrow_deploy the build-and-push flow#155

Merged
incognick merged 1 commit into
mainfrom
v0.7.3-deploy-guidance
Jul 1, 2026
Merged

feat(mcp): teach burrow_deploy the build-and-push flow#155
incognick merged 1 commit into
mainfrom
v0.7.3-deploy-guidance

Conversation

@incognick

Copy link
Copy Markdown
Contributor

What

Enrich the burrow_deploy MCP tool description so an agent knows the full client-side deploy flow and can act on "deploy my app" without hand-holding.

Before, the description said only that the image "must already be pushed to a registry the cluster can pull from" but never told the agent to build and push the image, or to infer the app from the working directory. A user saying "deploy my app" would stall because the agent did not know to build first.

Change

The burrow_deploy description now teaches the full flow:

  • Infer the app name from the working directory (the folder name) unless the user names one.
  • Build a container image from the working directory with the agent's own container tooling (for example docker build) and push it to a registry the cluster can pull from, then deploy by that reference.
  • Do NOT run the burrow CLI to build or deploy — the agent operates through these tools, not the CLI (aligning with the CLI-hardening direction).
  • If the image is already built and pushed, just pass its reference.

The image input field now notes it is the reference of an image the agent has built and pushed to a cluster-pullable registry. All existing guidance is preserved: never code over MCP, config-before-deploy via burrow_config_set, secrets handling, env/context targeting, and the returns.

This is description/guidance only, consistent with the client-side build model (ADR-0008, ADR-0007). No deploy behavior or code paths change.

Checks

task check green, go test ./... green, gofmt clean.

The burrow_deploy tool description told an agent only that the image
must already be pushed to a registry, never that it should build and
push the image itself or infer the app from the working directory. A
user saying "deploy my app" would stall because the agent did not know
to build first.

Enrich the description with the full client-side flow: infer the app
name from the working directory unless named, build the image with the
agent's own container tooling (for example docker build) and push it to
a cluster-pullable registry, then deploy by that reference. It also
states explicitly not to run the burrow CLI to build or deploy, since
the agent operates through these tools rather than the CLI. The image
input field now notes it is the reference of an image the agent has
built and pushed. All existing guidance (never code over MCP,
config-before-deploy, secrets handling, env/context targeting, returns)
is preserved. Description-only; deploy behavior is unchanged.

Signed-off-by: Nicholas Phillips <nsphilli@gmail.com>
@incognick incognick enabled auto-merge July 1, 2026 19:31
@incognick incognick added this pull request to the merge queue Jul 1, 2026
Merged via the queue into main with commit 4c828e0 Jul 1, 2026
5 checks passed
@incognick incognick deleted the v0.7.3-deploy-guidance branch July 1, 2026 19:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant