startup-chain-change

name	startup-chain-change
category	primary
description	Modifies the local startup chain including image build, container serve/bootstrap logic, and canonical smoke test behavior. Use when changing `vllm-sr serve` behavior, image selection or pull policy, container startup sequences, local Docker/Make bootstrap, or canonical smoke config.

Startup Chain Change

Trigger

• Change vllm-sr serve, image selection, pull policy, or container startup behavior
• Change canonical local smoke config or agent smoke flow
• Change local Docker or Make bootstrap behavior

Workflow

1. Read environment docs and CLI Docker playbook for startup chain context
2. Modify serve, bootstrap, image selection, or smoke config
3. Run make agent-report ENV=cpu|amd CHANGED_FILES="..." to identify impacted surfaces
4. Run make agent-feature-gate ENV=cpu|amd CHANGED_FILES="..." to validate startup behavior
5. Verify the canonical local serve path works with the default smoke config

Gotchas

• Do not introduce an alternate local serve path; the local image flow remains the canonical local-dev contract.
• A smoke-only green run is not enough when CLI orchestration or image selection semantics changed.

Must Read

• docs/agent/environments.md
• docs/agent/amd-local.md
• docs/agent/playbooks/vllm-sr-cli-docker.md

Standard Commands

• make agent-report ENV=cpu|amd CHANGED_FILES="..."
• make agent-feature-gate ENV=cpu|amd CHANGED_FILES="..."

Acceptance

• The canonical local serve path works with the default smoke config
• Startup-chain changes include local smoke plus relevant CLI or integration coverage