Files

Defame1297 9ac5340e15 fix(kyberforge): resolve clean-context audit findings on primitive support

primitive-author:
- description excludes read-only review (-> factory-audit)
- validation Gotcha now matches the research: compile never reads
  prompts, install fails only on a bad Copilot hook payload and warns on
  prompt input names and dropped keys
- instruction fold-in into AGENTS.md/CLAUDE.md stated as conditional on
  dedup and --force-instructions
- hook checklist gains the wrapped-shape Must, drops hardlinks, notes
  why executable is stricter than the research, and states the
  separate Copilot-targeted package route instead of a blanket "don't"
- prompt Must 5 keeps the research's Copilot-only-key exception; adds
  model-slug and 250-char Shoulds; descriptions name skills or agents
- placeholder instruction covers both FILL IN and FILL_IN_ tokens

factory-audit: hardlink FAIL scoped to instructions and prompts
(find_hook_files skips symlinks only), with bats cases; prompt-flow
description rubric names skills or agents.

forge: version-bump, apm-routes and sources references updated for the
primitive route.

Refs #94

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KkT7RSDwDbmrM9T34b6sTi

2026-09-28 17:40:12 +00:00

.apm

fix(kyberforge): resolve clean-context audit findings on primitive support

2026-09-28 17:40:12 +00:00

bin

fix(skills): drop references to deleted config and .mcp.json files

2026-09-19 21:17:14 +00:00

docs

docs(kyberforge): complete apm hooks, instructions and prompts research

2026-09-28 16:30:26 +00:00

apm.yml

feat(factory-audit): audit hooks, instructions and prompts

2026-09-28 17:02:04 +00:00

README.md

feat(kyberforge): add primitive-author for apm hooks, instructions and prompts

2026-09-28 17:22:23 +00:00

sources.md

feat(kyberforge): execute plugin-to-apm marketplace conversion

2026-08-12 18:21:24 +00:00

README.md

kyberforge

Skills and agents for creating, maintaining, and managing a Claude Code / Copilot CLI plugin marketplace.

Install

apm is the only supported install path (ADR-0024). Declare this package in the consuming project's apm.yml:

dependencies:
  apm:
    - git: git@git.rkdr.net:Defame1297/holocron.git
      path: plugins/kyberforge

Then:

apm install

The entry above is unpinned and tracks the remote's default branch — add ref: <tag> to pin a release. Registering the catalogue instead (apm marketplace add git@git.rkdr.net:Defame1297/holocron.git --name holocron) gets you the kyberforge@holocron short name, but writes to ~/.apm/marketplaces.json at user scope; the git+path object needs nothing beyond the manifest.

Native plugin installs do not work. This package ships no per-plugin manifest and no flat content directories, so a host that installs it natively gets zero skills, agents and hooks — and Claude Code raises no error while doing it (ADR-0024).

Authoring source lives in .apm/; it is the only content source and the only thing apm install deploys (ADR-0024).

Component	Path	Description
Skills	`.apm/skills/`	Slash commands available after install
Agents	`.apm/agents/*.agent.md`	Role-based agents; one vendor-neutral `.agent.md` per agent (ADR-0016)
Hooks	`.apm/hooks/`	Event-triggered automation — Claude Code only, see below

Hooks are Claude Code-only. apm merges .apm/hooks/*.json into the consuming project's .claude/settings.json at install. Copilot CLI has no default hooks path — agents and skills default to agents/ and skills/, but hooks defaults to nothing (docs/research/docs/github-copilot-plugins/configuration.md:47), so Copilot reads hooks only via an explicit pointer in a plugin manifest — and since ADR-0024 there is no per-plugin manifest to carry one. Copilot therefore loads no hooks from this plugin. Details, including why a pointer was the wrong fix even when a manifest existed, are in docs/hooks.md.

Skills

Skill	Description
`forge`	Grill an unclassified "I want to add something" request, decide whether it's a skill, agent, hook, instruction, prompt, plugin, or marketplace entry, then route to the matching author skill
`skill-author`	Create or improve a skill from scratch, audit findings, or inline feedback
`agent-author`	Author an agent definition file
`primitive-author`	Create or improve an apm hook, instruction or prompt, gated on whether it should be one at all (ADR-0029 for prompts)
`factory-audit`	Audit a skill directory, an agent definition, or an apm hook, instruction or prompt — structure, provider safety, description and body quality, and provenance; produces a findings report. Auto-detects which it was handed (ADR-0025)
`apm-install`	Install or upgrade the apm CLI and set up the agent runtimes it drives (Copilot CLI, Codex, Gemini, generic llm)
`apm-workflow`	Author apm.yml, scaffold an apm package/marketplace, install dependencies, and compile/pack/publish/audit apm content

Pre-commit tooling (pc-author, pc-run) lives in the git plugin, not here.

Author

Defame1297

README.md

kyberforge

Install

Contents

Skills

Author