Files
holocron/plugins/git/README.md
Defame1297 025ad4a5af chore: migrate git host from git.dev.rkdr.net to git.rkdr.net
Why
The repo's git host moved from git.dev.rkdr.net to git.rkdr.net. The
`origin` remote was already repointed; this commit brings every
in-repo reference in line so cloning, submodule init, and apm install
all resolve against the new host.

Implementation Notes
- .gitmodules: docs/wiki submodule URL repointed (tests/* submodules
  stay on github.com, untouched).
- Root apm.yml: 7 dependency entries and marketplace.owner.url
  repointed; executables.allow key updated to kyberforge#2.0.1 to
  match kyberforge's bump below (scripts/check-executables-allow-sync.sh
  enforces this pairing).
- Each plugin's apm.yml (bin, core, git, gitea, kyberforge, lint,
  onedev): author.url/homepage/repository repointed. Per this repo's
  apm versioning policy, these fields compile verbatim into
  plugin.json, so each package took a patch version bump alongside
  the URL change.
- Root apm.yml version and marketplace.version bumped 0.5.0 -> 0.5.1
  to match (a marketplace-block field and every listed package's
  version moved).
- apm.lock.yaml regenerated via `apm install`; .claude-plugin/marketplace.json
  regenerated via `apm pack --marketplace=claude` so compiled output
  stays in sync with the manifests.

Impact
docs/adr/0015, 0017, and 0018 intentionally keep the old host in their
issue links and examples — they are historical decision records, not
live config. Verified clean: apm pack --check-clean, apm audit --ci,
check-executables-allow-sync.sh, and pre-commit --all-files all pass.
2026-09-25 13:15:25 +00:00

1.9 KiB

git

Skills and agents for working with a local Git clone over the git wire protocol, and for authoring and running the pre-commit hooks that guard it.

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/git

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 git@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 and zero agents — and Claude Code raises no error while doing it (ADR-0024).

Conventions

Skills here run local git commands through the org's rtk wrapper. When a command is prefixed, when it stays bare, and why some executable commands must stay bare are all decided by ADR-0023 (docs/adr/0023-rtk-prefix-marks-executable-commands-only.md), which is repo-wide and not specific to this plugin. check-rtk-prefix enforces the part of it that is machine-decidable.

Installing this plugin without rtk? Every prefixed command is a plain git invocation with a word in front of it — drop the rtk and it is correct.

Contents

Component Path Description
Skills .apm/skills/ git-commits, git-branches, git-history, git-remotes, git-submodules, git-workflow, git-worktrees, pc-author, pc-run
Agents .apm/agents/ git-orchestrate

.apm/ is the authoring source and the only thing apm deploys (ADR-0024).

Author

Defame1297