holocron/plugins/kyberforge/docs/research/docs/microsoft-apm/examples.md at eada85db99bc763e9da21d81bd897a340bc9d009

Files

Defame1297 1d07d1a76b docs(kyberforge): add Microsoft APM research reference set

Capture Microsoft's Agent Package Manager (APM) — overview, install,
config, CLI reference, registries/marketplace, monorepo shapes,
testing/validation, troubleshooting, and examples — as structured
reference docs under plugins/kyberforge/docs/research/docs/microsoft-apm/.

Lays the groundwork for issue #88 (build agents/skills to execute a
marketplace-to-APM conversion of this repo).

2026-08-10 17:06:07 +00:00

1.8 KiB

Raw Blame History

topic, source_keys

topic

source_keys

examples

context7-microsoft-apm

Producer quickstart

A minimal consumer flow: install a package by owner/name, then compile it to the active harness's format.

apm install your-org/your-project
apm compile

Authoring an agent primitive

Agents are markdown files with YAML frontmatter defining metadata, model constraints, and tool permissions, followed by a prose system-instructions body:

---
name: security-review
description: Reviews diffs for OWASP top-10 issues and missing input validation.
model: gpt-5
tools:
  Read: true
  Grep: true
---

You are a security reviewer. Your job is to inspect the working diff
for...

On-disk package layout

.apm/
  skills/
    my-skill/
      SKILL.md
      scripts/
      references/
      assets/
  prompts/
    review.prompt.md
  instructions/
    style.instructions.md
  agents/
    cli-logging-expert.agent.md
  hooks/
    pre-commit.json

Publish → install round trip

# Producer: package root with apm.yml, .apm/, and (optionally) a registries: block
apm publish --package acme/my-skill --dry-run -v
apm publish --package acme/my-skill

# Consumer: another repo
apm install acme/internal-tools#^1.0.0

Cross-tool / IDE-agnostic install

apm install --target agent-skills

Generates a vendor-neutral skills directory usable across IDEs rather than a single harness-specific output.

Running a script with parameters (Gemini CLI example)

# Run a script from apm.yml, substituting a parameter
apm run start --param service_name=api-gateway

Once a runtime like Gemini CLI is installed via apm runtime setup gemini, it can also be invoked directly for interactive mode (gemini), sandboxed/isolated execution (gemini -s), or with an explicit model (gemini -m gemini-2.5-pro-preview).

1.8 KiB Raw Blame History