The existing schema doc covered only Claude and Copilot and called missing description and empty content errors when apm 0.28.0 only warns. Rewrite it with the applyTo grammar and add per-target compile/install mapping and a gotchas doc (unquoted globs, install-vs-compile discovery, dedup and overwrite behaviour), all verified against the apm 0.28.0 binary. Refs: #148 Co-Authored-By: Claude Code <[email protected]> Claude-Session: https://claude.ai/code/session_01KkT7RSDwDbmrM9T34b6sTi