code-archaeology

Analyze Git history to reconstruct software evolution without checking out revisions.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/tense-i/tensei-skills --skill code-archaeology-tense-i
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-archaeology
Source: https://github.com/tense-i/tensei-skills/tree/main/code-archaeology
Command: npx skills add https://github.com/tense-i/tensei-skills --skill code-archaeology-tense-i

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill archaeologically reconstructs a software system's evolution from Git history without checking out old revisions, producing long-form narratives and visual timelines that reveal epoch-level changes and key decisions.

Core Features & Use Cases

  • Evolution timeline segmentation and epoch-level storytelling from repository history.
  • Key commits and PRs analysis to surface decisive design decisions and migration paths.
  • Architecture snapshots with Mermaid visualizations to compare phases.
  • Non-checkout archaeology that guides engineers, architects, and product leads through system evolution.

Quick Start

Provide the local repository path (or URL) to analyze and let the engine generate a complete evolution narrative with Mermaid diagrams.

Frequently Asked Questions about code-archaeology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze Git history to reconstruct software architecture evolution?

To analyze Git history for architecture evolution, this Skill processes commit logs to reconstruct epoch-level system changes and key design decisions without checking out old revisions. It outputs long-form narratives and Mermaid visual timelines.

Can I generate architecture documentation and timelines from past Git commits?

Yes, you can generate architecture documentation and timelines from past Git commits. The engine analyzes repository history to segment evolution into epochs, producing structured evidence tagging and Mermaid diagrams for architecture snapshots.

What is the best way to trace key design decisions and migrations in a codebase?

The best way to trace key design decisions and migrations in a codebase is through PR analysis and commit archaeology. This Skill surfaces decisive design paths and migration paths from repository history into a stage-based narrative.

How do I visualize codebase history changes without checking out old revisions?

You visualize codebase history changes without checking out old revisions by analyzing Git metadata directly. This approach generates Mermaid visual outputs and architecture snapshots to compare system phases across different epochs.

Does analyzing repository evolution with this approach require a local clone?

Analyzing repository evolution does not strictly require a local clone, as you can provide a repository URL. However, supplying a local repository path allows the engine to generate a complete evolution narrative efficiently.

What are the limitations of using Git history for code archaeology?

A limitation of using Git history for code archaeology is that analysis relies entirely on commit and PR metadata quality. It reconstructs architectural evolution from historical records without validating runtime behavior or checking out old code.