Defame1297/holocron
0
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases 3 Wiki Activity
Files
013b913bd427df04f57e64cdbfa5bea72e94788b
holocron/plugins/kyberforge/skills/apm-workflow/references/sources.md
Defame1297 013b913bd4 docs: correct claims the apm conversion left false 
Documentation asserted things the code no longer did, which is how several of this
round's defects survived three review passes.

- `docs/spec/architecture.md` still described the pre-APM model — "each plugin has a
  `plugin.json` manifest" — when no such file exists. AGENTS.md routes agents here
  for the current structure, so it was live drift, not archive. Also cited ADR-0012
  where ADR-0003 is meant.
- AGENTS.md never said `.apm/` is the sole hand-edited source, while the generated
  mirror is byte-identical with no marker — an agent reading only AGENTS.md would
  edit the mirror and find out at pre-push. It also omitted that `apm` and `jq` are
  now required to push, unlike the `vale` bullet that exists for exactly that reason,
  and understated the pre-push gate. `apm marketplace check` hard-fails offline and
  `--offline` does not help, so the `SKIP=` escape hatch is documented rather than
  new machinery built.
- ADR-0017 carried hardcoded line numbers that drifted twice within one PR, and said
  `mcpServers` reinjection was real-syncs-only where the script's own header says
  both modes. Line numbers dropped rather than corrected.
- ADR-0015 asserted issue #90 was closed. It is open. Reworded to defer to the
  issue's own state rather than depend on someone remembering to close it.
- ADR-0014 said both audit skills pass `--config`; both SKILL.md files say pass none,
  and passing one fails with E100. The ADR was wrong.
- ADR-0007 cross-referenced an archived ADR-0011 whose number was later reused.
  Disambiguated with a note — renumbering a published ADR rewrites an immutable
  record and breaks every existing citation.
- CONTEXT.md claimed `lint-runner` is report-only via a missing `Edit` tool.
  Plugin-scope APM agents cannot express `tools:` (ADR-0016), so it is report-only by
  instruction now; ADR-0016 accepted that regression but CONTEXT.md was not updated.
- Recorded two undocumented consequences of the conversion: `displayName` dropped
  from all six compiled manifests and `owner.email` from the marketplace, and
  `mattpocock-skills` silently version-pinned and manually maintained.
- Wrote the version-bump policy issue #90 specified but never delivered. Its previous
  carrier, `marketplace-author`, was deleted in this PR, leaving the per-package rule
  documented nowhere.
- README fixes: kyberforge listed skills belonging to the `git` plugin and a deleted
  hooks path, `bin` advertised an agents directory it never had, and the docs index
  listed files that do not exist.

Refs: #90

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01X7GvKuJfy2WrdBmUttV4DT
2026-08-14 01:53:26 +00:00

2.6 KiB
Raw Blame History

Sources

context7-microsoft-apm

  • URL: context7:/microsoft/apm
  • Description: Microsoft APM (Agent Package Manager) — open-source dependency manager for AI agent configuration (skills, prompts, instructions, agents, hooks, MCP/LSP deps), applying a declare/lock/install/audit workflow.
  • Research doc: plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md
  • Contributing files: SKILL.md, references/configure.md, references/install.md, references/marketplace.md, references/compile.md, references/audit.md
  • Status: extracted

apm-github-repo

  • URL: https://github.com/microsoft/apm
  • Description: APM's own Python source (src/apm_cli/), read directly for schema and compile-mapping ground truth where Context7's doc snippets were thin. Backs the marketplace output-profile claim (apm_cli/marketplace/output_profiles.py — only claude and codex profiles exist, so there is no native Copilot marketplace output) and the apm pack --check-clean/--check-versions semantics.
  • Research doc: plugins/kyberforge/docs/research/docs/microsoft-apm/sources.md
  • Contributing files: references/marketplace.md
  • Status: extracted

context7-websites-code-claude

  • URL: context7:/websites/code_claude
  • Description: Official Claude Code documentation site indexed by Context7 — marketplace manifest schema (reserved name prefixes), claude plugin validate command behavior. Claude Code platform facts that hold true independent of how the compiled manifest is authored (APM or hand-authored).
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Contributing files: references/marketplace.md, references/audit.md
  • Status: extracted

claude-code-plugins-docs

  • URL: https://code.claude.com/docs/en/plugins
  • Description: Official Claude Code plugin authoring guide — marketplace submission constraints (reserved name prefixes), claude plugin validate behavior and its scope relative to other CI checks.
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Contributing files: references/marketplace.md, references/audit.md
  • Status: extracted

claude-code-subagents-docs

  • URL: https://code.claude.com/docs/en/sub-agents
  • Description: Official Claude Code subagent reference — definition format, all frontmatter fields, scope priority, built-in agents, CLI flags, environment variables, known limitations
  • Research doc: plugins/kyberforge/docs/research/docs/claude-code-plugins/sources.md
  • Contributing files: (none)
  • Status: referenced
Reference in New Issue View Git Blame Copy Permalink