feat(kyberforge): add instructions-author skill for .apm/instructions files

Scaffolds and revises apm instructions files, with a throwaway-package verification recipe because `apm compile --validate` always exits 0 and Claude Code drops `description`. Routed from forge and linked from apm-workflow's compile reference. Bumps kyberforge to 2.1.0 and the catalog to 0.5.2. Fixes #148 Co-Authored-By: Claude Code <[email protected]> Claude-Session: https://claude.ai/code/session_01KkT7RSDwDbmrM9T34b6sTi
2026-10-01 06:46:39 +00:00
1 parent 529ed31cef
commit c52e351954
@@ -0,0 +1,59 @@
+---
+source_keys:
+  - apm-docs-site
+  - apm-github-repo
+  - apm-cli-0-28-0-experiments
+  - claude-code-memory-docs
+  - github-copilot-custom-instructions-docs
+  - cursor-rules-docs
+---
+
+# Sources
+
+## apm-docs-site
+
+- **URL:** https://microsoft.github.io/apm/
+- **Research doc:** plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md (digest: plugins/kyberforge/docs/research/docs/microsoft-apm/instructions-primitive-schema.md)
+- **Description:** Official apm documentation, the instructions-and-agents authoring page plus targets and compile pages: frontmatter requirements, per-target deploy paths, compile behaviour and flags.
+- **Contributing files:** SKILL.md, references/schema.md, references/target-mapping.md, references/create.md, references/improve.md
+- **Status:** `extracted`
+
+## apm-github-repo
+
+- **URL:** https://github.com/microsoft/apm
+- **Research doc:** plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md (digest: plugins/kyberforge/docs/research/docs/microsoft-apm/instructions-primitive-schema.md)
+- **Description:** apm's own Python source read for the Instruction model, discovery globs and per-target integrators.
+- **Contributing files:** references/schema.md
+- **Status:** `extracted`
+
+## apm-cli-0-28-0-experiments
+
+- **URL:** https://pypi.org/project/apm-cli/0.28.0/
+- **Research doc:** plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md (digest: plugins/kyberforge/docs/research/docs/microsoft-apm/instructions-gotchas.md)
+- **Description:** The installed apm-cli 0.28.0 package plus throwaway install, compile and audit experiments confirming validation severity, unquoted-glob handling, discovery asymmetry, dedup and overwrite behaviour.
+- **Contributing files:** SKILL.md, references/schema.md, references/target-mapping.md, references/verify.md, references/create.md, references/improve.md
+- **Status:** `extracted`
+
+## claude-code-memory-docs
+
+- **URL:** https://code.claude.com/docs/en/memory
+- **Research doc:** plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md (digest: plugins/kyberforge/docs/research/docs/microsoft-apm/instructions-target-mapping.md)
+- **Description:** Claude Code memory documentation: `.claude/rules/` loading, the `paths` field as the only field read, invalid YAML ignored, size guidance.
+- **Contributing files:** SKILL.md, references/schema.md, references/target-mapping.md
+- **Status:** `extracted`
+
+## github-copilot-custom-instructions-docs
+
+- **URL:** https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions
+- **Research doc:** plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md (digest: plugins/kyberforge/docs/research/docs/microsoft-apm/instructions-target-mapping.md)
+- **Description:** GitHub Copilot repository custom instructions: `.github/instructions/*.instructions.md`, `applyTo` and `excludeAgent`, the separate repo-wide file.
+- **Contributing files:** references/target-mapping.md
+- **Status:** `extracted`
+
+## cursor-rules-docs
+
+- **URL:** https://cursor.com/docs/context/rules
+- **Research doc:** plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md (digest: plugins/kyberforge/docs/research/docs/microsoft-apm/instructions-target-mapping.md)
+- **Description:** Cursor project rules: the `.mdc` requirement, `description`, `globs` and `alwaysApply`, rule types, size guidance.
+- **Contributing files:** references/target-mapping.md
+- **Status:** `extracted`