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 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

• tools/agent/docs/environments.md
• tools/agent/docs/amd-local.md
• tools/agent/docs/testing-strategy.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