skill-git-history-learninglisted

# Git History Learning Use commit history, tags, and notes to learn why changes were made and to onboard faster. **Architecture Decision Record (ADR)**: A document that records key design choices. **Changelog**: A release summary derived from commits and PRs. **Git Notes**: Metadata attached to commits without changing history. Progression: Simple → Intermediate → Advanced examples improve clarity because each step adds context. Reason: Added context makes learning and audits faster. ## When to Use This Skill Use this skill when: - Onboarding new teammates by walking them through curated commit history - Investigating past decisions when a bug or refactor needs context - Building changelogs or release notes from labeled commits and PRs - Training reviewers with real examples from prior PR and commit flows - Capturing lessons from incidents so fixes are easy to trace later - Turning tribal knowledge into shared assets for cross-team reuse ## Related Skills - **`skill-git-commit-practices`** - Commit messages with context - **`skill-git-review-standards`** - Review patterns and checklists - **`skill-github-pr-workflow`** - PR workflow and merge policies --- ## Dependencies - Git 2.30+ - Access to repository history --- ## Core Principles 1. **History is a Library** - Use it for learning, not blame 2. **Why Matters** - Capture decision context 3. **Traceability** - Link commits to issues and PRs 4. **Repeatable Learning** - Make examples reusable 5. **Shared Growth*