Defame1297
d6fd9b6770
Addresses 7 verified findings from the /code-review pass on PR #91's APM-conversion changes: - apm-workflow's description omitted install triggers, misrouting "install my apm dependencies" requests to apm-install instead - `apm marketplace check` was listed under both the marketplace and audit dispatch rows, breaking the "one reference file per action" contract; kept under marketplace.md, its real usage-sequence home - ADR-0015 claimed apm-workflow docs are generic/repo-agnostic while marketplace.md cited this repo's AGENTS.md and git-commits/ git-remotes skills by name; stripped the holocron-specific citations (marketplace.md, compile.md) so the claim now holds - plugin-author/marketplace-author are superseded per ADR-0015 with deletion deferred to #90; added deprecation notices pointing to the replacing apm-workflow dispatch actions - apm-orchestrate/gitea-orchestrate/git-orchestrate all instruct dispatch "via Skill" without granting the Skill tool; added it to all three - apm-orchestrate mandated strictly sequential fan-out across independent packages with no shared state; relaxed to permit parallel dispatch, matching this repo's own subagent-parallelization guidance Refs: #91
apm-workflow
Authors, scaffolds, compiles, and audits apm packages and marketplaces.
What it does
Covers the apm.yml lifecycle a session moves through repeatedly: configuring/scaffolding a package manifest, resolving/fetching its declared dependencies, building or registering a marketplace, compiling/packing/publishing a distributable, and validating integrity via apm audit. Dispatches by requested action to one of five reference files, each self-contained for its concern.
Before you start
Requires the apm binary and (for runtime-driven scripts) an agent runtime already installed — use apm-install first if either is missing.
Usage
/apm-workflow configure
/apm-workflow install
/apm-workflow marketplace
/apm-workflow compile
/apm-workflow audit
Files
| File | Purpose |
|---|---|
SKILL.md |
Dispatch table and cross-cutting gotchas |
references/configure.md |
apm.yml schema, apm plugin init, dependency forms, MCP secrets, registries |
references/install.md |
apm install, apm install [PACKAGE_REF], --update, --target agent-skills |
references/marketplace.md |
Building/registering a marketplace, package registration, versioning, Claude Code reserved-name/publish-confirm gotchas |
references/compile.md |
apm compile / pack / publish / run, claude plugin validate agents/ gotcha |
references/audit.md |
apm audit, apm audit --ci, apm marketplace check, CI wiring, frozen installs, claude plugin validate terminal check |
references/sources.md |
Provenance chain — research sources that informed this skill |