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
2.1 KiB
topic, source_keys
| topic | source_keys | |
|---|---|---|
| compile |
|
Compile
apm compile
Generates per-target output (Claude, Copilot, etc.) from the vendor-neutral .apm/ primitive source tree, per the compilation: block in apm.yml. Run this after any change to .apm/ content or to compilation:/targets: in apm.yml.
Pack
apm pack --dry-run # resolve and print; do not write
apm pack --offline # cached refs only
apm pack --include-prerelease # allow pre-release tags
apm pack -v # per-entry resolution detail
apm pack --marketplace=claude --json # JSON output for CI pipelines
Bundles a producer package into a distributable artifact. Default to --dry-run -v first when packing something for the first time or after a dependency change — resolution errors surface before anything is written.
Run apm audit after compile/pack, not before — audit scans deployed/compiled output, not the source apm.yml manifest; see references/audit.md.
Publish
apm publish --package acme/my-skill --dry-run -v
apm publish --package acme/my-skill
Publishes a producer package (root containing apm.yml, .apm/, and optionally a registries: block) to a registry. Always dry-run with -v first — publishing is not trivially reversible once a version tag is claimed on a registry.
Run
apm run <script> [--param key=value]
Executes a named script defined under scripts: in apm.yml, with --param substituting values into the script's parameters.
Gotchas
claude plugin validate --strictauto-scans every.mdfile directly under a compiled plugin'sagents/directory and treats it as an agent definition requiring frontmatter, independent of any manifest declaration (an empirically observed Claude Code platform behavior, not anapmmechanic). A non-agent.mdfile (notes, provenance record, README) that ends up under.apm/agents/in the source tree will still fail validation once compiled to theclaudetarget. Keep such files outside.apm/agents/(e.g. at the package root), regardless of whatapm.ymldeclares.