- factory-audit: hook events judged per deployed target after apm's rename (Claude/Copilot event sets FAIL, others SUGGESTION); Claude plugin layouts accepted as hook sources; interpreter options and sh -c strings checked; bats 378 -> 386 - primitive-author: Must 4/5 match the audit; reference hand-back points at the right steps; Step 4.2 --target all fallback - skill-author: new-skill.sh repair only on the template marker line, so complete skills stay a no-op; provenance and calibration text - forge: restore "already named" qualifier; drop false HITL claim - apm-workflow: token example uses an env var - docs/hooks.md: the apm-hooks.json sidecar is committed, not ignored Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KkT7RSDwDbmrM9T34b6sTi
docs/
Plugin documentation. Not read automatically by Claude Code or GitHub Copilot CLI — reference specific files from skill bodies or agent prompts as needed.
| Path | Purpose |
|---|---|
hooks.md |
Where this plugin's hooks are authored (.apm/hooks/), what apm deploys them into (.claude/settings.json), and the Claude Code and Copilot CLI schemas |
Everything else under this directory is research material.
research/
Upstream reference material gathered during skill authoring. Not shipped with the plugin — used at development time only.
| Path | Purpose |
|---|---|
research/docs/agentskillsio/ |
agentskills.io spec, skill authoring, description optimization, eval design, scripts |
research/docs/claude-code-plugins/ |
Claude Code plugin and marketplace manifests, plugin directory layout, agent definition format, claude plugin validate behaviour |
research/docs/github-copilot-plugins/ |
Copilot CLI plugin manifest and marketplace format, agent definition format, Copilot extensions and SDK |
research/docs/microsoft-apm/ |
apm CLI reference, apm.yml schema, primitive schemas (agent, prompt, instructions, hooks), monorepo repo shapes, marketplace/registries, packing and releasing |
research/examples/skill-write/ |
Upstream skill examples reviewed when authoring skill-author and the audit skill, now factory-audit (ADR-0025) |
AGENTS.md research moved to plugins/core/docs/research/docs/agentsmd/ when the AGENTS.md skills landed in the core plugin (ADR-0012) — it is no longer part of kyberforge's provenance chain.