evolution-arc

Explain repository evolution as a reasoning trace from source order.

3|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/Mikeys-Tech-Lab/poc --skill evolution-arc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolution-arc
Source: https://github.com/Mikeys-Tech-Lab/poc/tree/main/.cursor/skills/evolution-arc
Command: npx skills add https://github.com/Mikeys-Tech-Lab/poc --skill evolution-arc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of not knowing how a workspace’s structure, decisions, and guidance evolved over time—especially when you need an inspectable, rationale-first explanation instead of guessing.

Core Features & Use Cases

  • Guided repo history navigation: Directs you through a curated “source order” of trace surfaces to reconstruct chronology into reasoning.
  • Reasoning-trace storytelling: Prompts a segment-by-segment explanation of what changed, why it changed, the tensions shaping it, what stayed unresolved, and which sources grounded the claims.
  • Register-based delivery: Adapts the voice (Everyday, Orientation, Practitioner) without changing the factual trace, so you can get the right level of detail for your task.

Quick Start

Ask the assistant to run the evolution-arc skill to explain how this workspace got shaped the way it is, using the repo-local trace sources.

Frequently Asked Questions about evolution-arc

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

FAQPage Schema
How do I trace the reasoning and decision rationale behind repository history?

Tracing decision rationale in repository history involves reconstructing chronology into a reasoning trace, explaining what changed and why. It separates observation from inference to provide an inspectable path across guidance and implementation artifacts.

What is the best way to provide ADR context for how a workspace evolved?

Providing ADR context for workspace evolution uses a guided source order to explain decision tensions and unresolved issues. It turns raw timeline events into rationale-first storytelling, grounding claims in traceable repo-local sources.

How do I get a step-by-step explanation of what shaped my current workspace structure?

Getting a step-by-step explanation of workspace structure requires segment-by-segment storytelling of the repo's evolution. It directs you through curated trace surfaces to reconstruct chronology and identify the tensions shaping implementation artifacts.

Can I adapt the technical detail level when explaining repo history to different audiences?

Adapting technical detail for repo history explanations uses register-based delivery to switch between Everyday, Orientation, and Practitioner voices. This changes the level of detail provided without altering the factual reasoning trace.

How are gaps in repo history handled when reconstructing the decision reasoning trace?

Handling gaps in decision reasoning traces requires transparent separation of observed facts from inferred conclusions. The process explicitly identifies missing context and unresolved issues rather than guessing the rationale.

Does tracing workspace evolution support visual diagrams to improve understanding?

Tracing workspace evolution optionally supports Mermaid diagrams to improve understanding of the reasoning trace. These visual aids are applied when they help clarify the chronology and decision tensions shaping the repository.