---
name: apm-workflow
description: >
  Use when the user wants to author, scaffold, install, compile, publish, or
  audit an apm package, an apm.yml manifest, or an apm marketplace, or register
  someone else's to consume — even when they do not say "apm"
  explicitly, e.g. "set up the package manifest". Not the apm binary itself or
  an agent runtime -> `apm-install`.
metadata:
  category: apm
  source_keys:
    - context7-microsoft-apm
---

## Gotchas

- MCP server secrets in `apm.yml` (headers, env vars) must use `${VAR}` indirection, never literal values, so they resolve at install or runtime and are never committed.
- `apm experimental enable registries` must run before a `registries:` block or `registry.*` config takes effect anywhere — configure, install or publish. Without it, declaring one silently does nothing: no error, no warning.

## Step 1 — Dispatch

| Invocation | Action | Reference |
|---|---|---|
| `/apm-workflow configure` | Author/edit `apm.yml`; scaffold a new package (`apm plugin init`) | `references/configure.md` |
| `/apm-workflow install` | Resolve/fetch dependencies declared in `apm.yml` (`apm install`, `apm install [PACKAGE_REF]`) | `references/install.md` |
| `/apm-workflow marketplace` | Build a marketplace, register packages into it (local: hand-edit `apm.yml`; remote: `apm marketplace package add`), or register a marketplace as a consumer (`apm marketplace init/check/package add/add`) | `references/marketplace.md` |
| `/apm-workflow compile` | Generate per-target output, bundle, or publish (`apm compile`, `apm pack`, `apm publish`) | `references/compile.md` |
| `/apm-workflow audit` | Validate integrity/policy or wire a CI gate (`apm audit`, `apm audit --ci`) | `references/audit.md` |

Read only the reference file matching the requested action — each is self-contained for its concern, and each carries the traps specific to its flow.

## Step 2 — Execute

Follow the matched reference file's instructions. Report back which `apm` command(s) were run (or drafted, if the user asked for a plan rather than execution) and their outcome.