Skip to content

chore(tools): Add git history reading tools#476

Merged
JeanMertz merged 1 commit intomainfrom
prr47
Mar 26, 2026
Merged

chore(tools): Add git history reading tools#476
JeanMertz merged 1 commit intomainfrom
prr47

Conversation

@JeanMertz
Copy link
Copy Markdown
Collaborator

Three new tools power a drill-down workflow for reading git history.

git_log searches commits by message, file paths, date range, and count. git_show returns the full commit message and changed-file stats (without diff content). git_diff_commit produces the actual diff for specified files in a commit, with optional regex grep and 500-line truncation for large outputs.

A new git-reading skill composes all three alongside git_diff and documents the intended workflow: git_log to find commits, git_show to inspect metadata, and git_diff_commit to drill into specific files. The skill is added to both the dev and stager personas.

The stager persona's instructions are significantly revised to actively use history context before deciding what to stage — searching for prior commits that touched the same files, and following established grouping patterns. New change-set cohesion rules cover single-sentence descriptions, tests with their implementation, and dependency updates alongside the code that introduced them.

The git-stage skill is refactored to remove git_diff (now provided by git-reading) and its "Surgical Precision" instructions are tightened.

Three new tools power a drill-down workflow for reading git history.

`git_log` searches commits by message, file paths, date range, and
count. `git_show` returns the full commit message and changed-file stats
(without diff content). `git_diff_commit` produces the actual diff for
specified files in a commit, with optional regex grep and 500-line
truncation for large outputs.

A new `git-reading` skill composes all three alongside `git_diff` and
documents the intended workflow: `git_log` to find commits, `git_show`
to inspect metadata, and `git_diff_commit` to drill into specific files.
The skill is added to both the `dev` and `stager` personas.

The `stager` persona's instructions are significantly revised to
actively use history context before deciding what to stage — searching
for prior commits that touched the same files, and following established
grouping patterns. New change-set cohesion rules cover single-sentence
descriptions, tests with their implementation, and dependency updates
alongside the code that introduced them.

The `git-stage` skill is refactored to remove `git_diff` (now provided
by `git-reading`) and its "Surgical Precision" instructions are
tightened.

Signed-off-by: Jean Mertz <git@jeanmertz.com>
@JeanMertz JeanMertz changed the base branch from prr46 to main March 26, 2026 19:32
@JeanMertz JeanMertz merged commit 9216d46 into main Mar 26, 2026
12 checks passed
@JeanMertz JeanMertz deleted the prr47 branch March 26, 2026 19:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant