Files
holocron/plugins/git/.apm/skills/git-remotes/references/sources.md
Defame1297 38eb0745b7 refactor(git-remotes): retrofit to the ADR-0020 context contract
Description 582 -> 237 chars, body 1217 -> 290 words. The single remotes.md
splits into config, fetch, push, and pull flow files.

Restores the confirm: true token to the force-push gate -- it is the git
plugin's cross-skill contract, gated on by git-orchestrate and git-branches.
Moves push.md's worked example off main, which the skill's own Step 1
refuses, and restores the never-bare---force directive.
2026-08-30 13:10:53 +00:00

2.6 KiB

git-scm-remote-docs

Description: Git SCM official documentation for git remote command — remote configuration, add/remove/rename, URL management, inspection, and housekeeping.

Source: https://git-scm.com/docs/git-remote

  • Research doc: plugins/git/docs/research/docs/git/remotes.md → ## Remote Management (git remote)

Contributing files:

  • references/remote-config.md

git-scm-fetch-docs

Description: Git SCM official documentation for git fetch command — fetching from remotes, tracking branch updates, pruning stale refs, shallow clones, and refspecs.

Source: https://git-scm.com/docs/git-fetch

  • Research doc: plugins/git/docs/research/docs/git/remotes.md → ## Fetching (git fetch)

Contributing files:

  • SKILL.md (Gotchas — prune does not touch tags)
  • references/fetch.md

git-scm-push-docs

Description: Git SCM official documentation for git push command — pushing branches, tags, force-push safety (--force-with-lease, --force-if-includes), refspecs, and multi-remote workflows.

Source: https://git-scm.com/docs/git-push

  • Research doc: plugins/git/docs/research/docs/git/remotes.md → ## Pushing (git push)

Contributing files:

  • SKILL.md (Gotchas — --force-with-lease caveat; Step 1 force-push gate)
  • references/push.md

git-scm-pull-docs

Description: Git SCM official documentation for git pull command — fetch + merge/rebase strategies, divergence resolution (--ff-only, --rebase, merge), config precedence, and pull-specific gotchas.

Source: https://git-scm.com/docs/git-pull

  • Research doc: plugins/git/docs/research/docs/git/remotes.md → ## Pulling (git pull)

Contributing files:

  • SKILL.md (Gotchas — pull default drift)
  • references/pull.md (divergence rule; strategies; config precedence)

context7-git-htmldocs

Description: Context7 MCP library providing current Git documentation and API reference — used for validation of modern Git syntax, behavior, and config semantics. This is a blanket cross-cutting reference and does not map to a single heading in the research doc; it informed terminology and syntax checks across all sections.

Source: Context7 MCP / Git library

  • Research doc: plugins/git/docs/research/docs/git/remotes.md (cross-cutting — no dedicated section)

Contributing files:

  • SKILL.md (all sections)
  • references/remote-config.md
  • references/fetch.md
  • references/push.md
  • references/pull.md