# Local Dev Amd

> Builds Docker images, starts local servers, and runs smoke tests for the AMD/ROCm development environment. Use when validating changes locally on AMD hardware, building AMD container images, or running AMD-specific smoke and E2E tests.

- Skill: `tomevault-io/local-dev-amd` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/local-dev-amd`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/local-dev-amd/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/local-dev-amd

---


# Local Dev AMD

## Trigger

- The primary skill needs `amd-local` build/serve/smoke validation

## Required Surfaces

- `local_smoke`

## Conditional Surfaces

- `local_e2e`

## Stop Conditions

- AMD-local smoke cannot be run or platform image mapping is unavailable

## Workflow

1. Read AMD-local docs and environment config to understand the AMD build setup
2. Build the AMD image with `make agent-dev ENV=amd`
3. Start the local server with `make agent-serve-local ENV=amd`
4. Run smoke tests with `make agent-smoke-local` to validate the build
5. Verify the default AMD smoke config starts successfully without unexpected fallbacks

## Must Read

- [docs/agent/amd-local.md](../../../../docs/agent/amd-local.md)
- [docs/agent/environments.md](../../../../docs/agent/environments.md)
- [deploy/amd/README.md](../../../../deploy/amd/README.md)
- [deploy/recipes/balance.yaml](../../../../deploy/recipes/balance.yaml)

## Standard Commands

- `make agent-dev ENV=amd`
- `make agent-serve-local ENV=amd`
- `make agent-smoke-local`
- `make agent-serve-local ENV=amd AGENT_SERVE_CONFIG=deploy/recipes/balance.yaml`

## Acceptance

- The default AMD smoke config starts successfully
- AMD image/platform behavior does not fall back unexpectedly
- When real AMD model deployment is in scope, the agent uses `deploy/amd/README.md` and `deploy/recipes/balance.yaml` as the primary reference instead of inventing a new ROCm setup path

---
> Source: [Qsqsdac/semantic-router](https://github.com/Qsqsdac/semantic-router) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->