Skip to content

NetFabric/intelligentium / .agents/skills/apm-consumer

apm-consumer

Verified

Manage APM packages as a consumer: install, update, remove agent context (skills, prompts, agents, instructions, MCP/LSP servers). Use when: apm init; apm install packages; apm update / outdated; apm uninstall / prune; private or org packages; local bundles; authentication (GITHUB_APM_PAT); apm run scripts; apm audit; drift detection; governance ramp; apm doctor; troubleshooting install failures; managing apm.yml dependencies; lockfile (apm.lock.yaml) semantics; MCP server wiring; LSP server config. Covers: targets (copilot, claude, cursor, codex, gemini, windsurf, kiro), harness auto-detection, what to commit. DO NOT USE FOR: authoring or publishing packages (use apm-producer); writing apm-policy.yml.

APM Consumer

APM manages AI agent context (skills, prompts, agents, instructions, MCP/LSP servers) with a manifest + lockfile model across all major harnesses. Mental model: npm for agentic context.

Key CLI Commands

CommandWhat It Does
apm initScaffold apm.yml; auto-detects harness targets
apm install <owner>/<repo>[#ref]Add dep; resolve transitive; deploy to harnesses
apm installRestore all deps from apm.lock.yaml
apm install --frozenLockfile-only; fails on drift (CI use)
apm uninstall <pkg>Remove dep and deployed files
apm update [<pkg>]Re-resolve refs; rewrite lockfile
apm outdatedList stale dependencies
apm pruneRemove cached packages not in apm.yml
apm run <name>Execute scripts.<name> from apm.yml
apm audit [--ci]Rehash deployed files; --ci exits non-zero on drift
apm listShow installed packages and versions
apm doctorDiagnose environment and config issues
apm self-updateUpgrade the APM CLI binary

What to Commit

PathCommit?
apm.ymlYes — manifest
apm.lock.yamlYes — pins exact SHAs and content hashes
.github/, .claude/, .cursor/, .agents/, .kiro/, .opencode/, .windsurf/, .gemini/Yes — deployed context; available on clone before apm install
apm_modules/No — cache; auto-gitignored; rebuilt from lockfile

Targets

Auto-detected from harness folder presence. Override with targets: in apm.yml or --target flag. Fallback when nothing detected: copilot.

SlugRoot DirHarness
copilot.github/GitHub Copilot (CLI + IDE)
claude.claude/Claude Code
cursor.cursor/Cursor IDE
codex.codex/ + .agents/Codex CLI
gemini.gemini/Gemini CLI
opencode.opencode/OpenCode
windsurf.windsurf/Windsurf / Cascade
kiro.kiro/Kiro IDE
agent-skills.agents/skills/Harness-neutral skills only

Reference Files

FileLoad When
references/commands.mdFull CLI flags, --target, authentication, private packages, CI drift check
references/manifest-and-lockfile.mdapm.yml full schema, dependency string/object forms, devDependencies, includes
references/mcp-lsp-servers.mdMCP registry vs self-defined servers; LSP object form; env var injection
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall