git-ai-archaeology

git-ai-archaeology

Produces a complete analysis of AI config evolution in a git repository. Finds when each AI configuration file was created, how AI-config commit velocity evolved month by month, which PRs structured the evolution, and identifies maturity phases.

Output: a single file {output_dir}/{slug}-git-archaeology.md

Expected Input

/git-ai-archaeology repo_path=/path/to/repo [output=./talks/slug] [slug=talk-name] [since=2025-01-01]

• repo_path: absolute path to the target git repo (required)
• output: output directory (default: ./talks)
• slug: output filename (default: repo folder name)
• since: analysis start date (default: first repo commit)

Workflow

1. Verify the repo: ensure the path exists and is a git repo
2. Global metrics: total commits, releases, contributors, time period
3. Section 1: First commits: find creation date for key AI-config paths
4. Section 2: Monthly distribution: commits filtered by AI-config keywords
5. Section 3: Major PRs: extract and categorize significant AI-config commits
6. Section 4: CHANGELOG: if CHANGELOG.md exists, extract releases with AI mentions
7. Section 5: Phases: synthesize evolution phases
8. Save the output file

---

Step 1: Verification and Global Metrics

# Verify it's a git repo
git -C {repo_path} rev-parse --git-dir

# Global metrics
git -C {repo_path} log --oneline | wc -l                                    # total commits
git -C {repo_path} tag --sort=version:refname | wc -l                       # total releases
git -C {repo_path} shortlog -sn --no-merges | wc -l                         # contributors
git -C {repo_path} log --pretty=format:"%ad" --date=short | tail -1         # first commit
git -C {repo_path} log --pretty=format:"%ad" --date=short | head -1         # last commit
git -C {repo_path} log --merges --oneline | wc -l                           # merged PRs

---

Step 2: Section 1: First Commits per AI-Config Path