talk-stage2-research

# 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) ```bash # Commits by month git -C {repo_path} log --pretty=format:"%Y-%m" | sort | uniq -c # Commits by contributor git -C {repo_path} shortlog -sn --no-merges # First and last date git -C...