lci-git-analysis

Maps lci's git change-analysis code paths and compares its churn and duplicate detection against other tools.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/standardbeagle/lci-cpp --skill lci-git-analysis-standardbeagle
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lci-git-analysis
Source: https://github.com/standardbeagle/lci-cpp/tree/main/.agents/skills/lci-git-analysis
Command: npx skills add https://github.com/standardbeagle/lci-cpp --skill lci-git-analysis-standardbeagle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on lci's git analysis features (git-analyze CLI, MCP git_analysis, code_insight git modes, HTTP /git-analyze), developers need to know which source files implement each surface, what invariants and traps exist in the git parsers, and how lci's change analysis compares to tools like CodeScene or code-maat. ## Core Features & Use Cases - Surface-to-code mapping: Traces every entry point (CLI, MCP, HTTP) to its handler and core implementation in src/git/* (Provider, Analyzer, FrequencyAnalyzer, PatternDetector). - Invariants and traps documentation: Records parser byte layouts pinned to git 2.43, ref-safety screening, hunk scoping rules, determinism guarantees, and known dead code such as the unwired FrequencyCache and PatternDetector. - Product comparison: Contrasts lci's hunk-scoped duplicate detection, churn hotspots, and churn x complexity risk matrix against CodeScene, code-maat, git-of-theseus, hercules, and gitinspector, with honest gaps. - Use Case: You are fixing a bug where git_analysis returns wrong findings on a range scope; use this Skill to locate the Analyzer pipeline, the -U0 hunk scoping logic, and the relevant tests before editing. ## Quick Start Use the lci-git-analysis skill to find where the git_hotspots risk matrix is computed and which tests pin its output.

Frequently Asked Questions about lci-git-analysis

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

FAQPage Schema
How do I run lci git-analyze on a commit range?▼

Run lci git-analyze with -s range and -b HEAD~3 against the repository root. The CLI talks to the lci server over the socket via the /git-analyze endpoint and supports -j for JSON output plus --threshold and -m to bound findings.

How does lci git analysis compare to CodeScene or code-maat?▼

lci scopes findings to changed -U0 hunks and detects duplicates via Jaccard similarity over normalized token sets, while CodeScene and code-maat analyze whole files or git log history. lci lacks temporal coupling, code age, and persisted caching that those tools provide.

Why does git_analysis return available=false?▼

The tool returns available=false when the project root is not a git repository or is an untracked directory nested inside an outer repo. This is an absent precondition signaled with a reason and hint, not an error, and HTTP returns 200 with the same payload.

Why does lci git-analyze report zero files on a dirty tree?▼

The default scope is staged, so a dirty-but-unstaged working tree reports zero changed files. The CLI prints a note pointing at -s wip to analyze the full working tree; MCP and HTTP surfaces print no such note.

What are the limitations of lci churn hotspot analysis?▼

Each hotspot call replays the full git log over the time window because FrequencyCache exists but is never wired in. There is no per-symbol or per-author churn surface, thresholds are compile-time fixed, and the advertised anti_patterns count is dead code that always prints zero.