Talk Stage 2: Research (REX mode only)

Talk Stage 2: Research (REX mode only)

Builds the git proof for a REX talk. Cross-references git history, CHANGELOG, and the Stage 1 summary to produce a verified timeline and velocity analysis.

Automatically skipped in --concept mode. Only runs when the source material is a REX with git repository access.

When to use this skill

• After Stage 1 (Extract) when building a REX talk
• When you have access to the project's git repository
• To verify metrics mentioned in the source material against actual git data

What this skill does

1. Reads the summary: understands the period and themes from Stage 1
2. Git archaeology: extracts velocity metrics (read-only commands only)
3. Changelog analysis: scans releases, features, documented metrics
4. Cross-references: aligns git, CHANGELOG, and summary
5. Builds the timeline: verified dates, not estimated
6. Writes 3 output files

Input

• talks/{YYYY}-{slug}-summary.md (from Stage 1, required)
• repo_path: absolute path to the git repository
• Optional: CHANGELOG path if different from {repo_path}/CHANGELOG.md

Output

Three files:

• talks/{YYYY}-{slug}-git-archaeology.md
• talks/{YYYY}-{slug}-changelog-analysis.md
• talks/{YYYY}-{slug}-timeline.md

Git Commands (read-only only)

# Commits by month
git -C {repo_path} log --pretty=format:"%Y-%m" | sort | uniq -c