Answers historical codebase questions using git log, git blame, and .ai memory files.
npx skills add https://github.com/Vimurai/ai-os --skill repo-oracle-vimurai
Please help me install this Agent Skill. Skill: repo-oracle Source: https://github.com/Vimurai/ai-os/tree/main/.claude/skills/repo-oracle Command: npx skills add https://github.com/Vimurai/ai-os --skill repo-oracle-vimurai
git log --follow, git blame, and date-filtered history queries to trace when and why code changed. - Project Memory Search: Greps .ai/LOG.md and .ai/DECISIONS.md to surface recorded decisions and the E-## task that produced a file. - Regression Investigation: Locates the commit that introduced a failing test or bug using targeted history queries. - Use Case: Before refactoring a legacy module, ask why it was implemented a certain way and receive the originating commit hash, date, and decision context. ## Quick Start Ask why a specific file or function works the way it does and request the commit and decision history behind it.High-intent search queries and answers about installing and using this skill.
Search the project's decision records with grep against .ai/LOG.md and .ai/DECISIONS.md for relevant keywords, then run git log --follow on the file to see its change history. This reveals the reasoning and the commit that introduced the behavior.
Use git log --oneline --follow -p on the affected file to see recent changes, or filter by date with git log --since to narrow the window. For test failures, check the history of both the test file and the source file it covers.
Yes, git blame -L start,end on a file shows the author and commit for each line in the given range. This skill uses it to attribute specific lines to their originating commits.
No, it is strictly read-only. It reports findings with commit hash, date, and source, and explicitly does not modify any file based on historical analysis.
The skill caps reads at 3 files per query, prefers grep over full file reads, and asks users to narrow queries if an answer requires more than 60 lines of git log output. It also avoids unscoped git log and node_modules history.
Chachamaru127Record session logs, decisions, and patterns to .claude/memory/ files.
jscott3201Guide safe codebase refactoring with characterization tests and stepwise commits.
sakamoto-family-smileAutomate Spring Boot build, static analysis, tests, security scans, and diff review.
iankikuAnalyzes commits, pull requests, and team discussions to compile a project memory file.