Reference Module
Trigger: use when the user asks to research another git repository.
Workflow
- Choose target path:
- default to references/<repo-name> - only exception is a user-provided path when the skill is called
- Collect required inputs:
- repository URL (https://... or git@...) - optional branch/tag/commit override
- Confirm behavior for this run:
- default is pinning to the latest available commit at HEAD (or branch HEAD when -b <branch> is used) at add time - explicitly confirm this default with the user every time before running commands
- Add the submodule from this repo root: git submodule add If a branch is specified: git submodule add -b
- Initialize recursively when needed: git submodule update --init --recursive
- If a specific commit or tag is requested, check it out inside the submodule and stage the submodule pointer update.
- Treat submodule contents as read-only for research unless the user explicitly asks for edits.
- Report the outcome:
- submodule path - source URL - checked-out commit SHA