Defame1297
92e7ff26aa
A grill-me session determined plugin-author/marketplace-author are fully superseded by the landed apm-install/apm-workflow/apm-orchestrate artifacts and will be deleted (not adapted) under issue #90, narrowing issue #89 to skill-author/agent-author only; forge stays untouched. ADR-0015 is amended to record this correction plus a three-way content-migration audit. Claude Code platform-constraint facts that lived only in plugin-author/marketplace-author (reserved name prefixes, the ADR-0010 agents/ stray-.md validator gotcha, claude plugin validate as a terminal check, and a removal/re-pack confirm-before-proceeding note) remain true post-conversion and are migrated into apm-workflow's reference docs via kyberforge:skill-author, which also updated the skill's README and sources.md provenance records. Dual-manifest-specific conventions (ADR-0006 parity, CC/Copilot field-placement split) do not carry forward since they no longer apply. ADR: 0015
34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
# 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 |
|