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.
75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
---
|
|
# Research sources referenced by this skill
|
|
# Each entry documents where the skill's guidance came from.
|
|
---
|
|
|
|
## 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
|