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.
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
# 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`:
|
|
|
|
```yaml
|
|
dependencies:
|
|
apm:
|
|
- git: git@git.rkdr.net:Defame1297/holocron.git
|
|
path: plugins/git
|
|
```
|
|
|
|
Then:
|
|
|
|
```bash
|
|
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
|