Wolfvin · Wolfvin · Jul 14, 2026 · Jul 14, 2026
diff --git a/...e!/CodeLens_CodeGraph_Upgrade_Analysis.md → ...ch/CodeLens_CodeGraph_Upgrade_Analysis.md b/...e!/CodeLens_CodeGraph_Upgrade_Analysis.md → ...ch/CodeLens_CodeGraph_Upgrade_Analysis.md
diff --git a/...te!/CodeLens_Opengrep_Upgrade_Analysis.md → ...rch/CodeLens_Opengrep_Upgrade_Analysis.md b/...te!/CodeLens_Opengrep_Upgrade_Analysis.md → ...rch/CodeLens_Opengrep_Upgrade_Analysis.md
diff --git a/update!/CodeLens_UBS_Upgrade_Analysis.md → ...research/CodeLens_UBS_Upgrade_Analysis.md b/update!/CodeLens_UBS_Upgrade_Analysis.md → ...research/CodeLens_UBS_Upgrade_Analysis.md
diff --git a/...e!/CodeLens_Upgrade_Issues_from_Emerge.md → ...ch/CodeLens_Upgrade_Issues_from_Emerge.md b/...e!/CodeLens_Upgrade_Issues_from_Emerge.md → ...ch/CodeLens_Upgrade_Issues_from_Emerge.md
diff --git a/...CodeLens_Upgrade_Issues_from_RepoAudit.md → ...CodeLens_Upgrade_Issues_from_RepoAudit.md b/...CodeLens_Upgrade_Issues_from_RepoAudit.md → ...CodeLens_Upgrade_Issues_from_RepoAudit.md
diff --git a/...!/CodeLens_Upgrade_Issues_from_Semgrep.md → ...h/CodeLens_Upgrade_Issues_from_Semgrep.md b/...!/CodeLens_Upgrade_Issues_from_Semgrep.md → ...h/CodeLens_Upgrade_Issues_from_Semgrep.md
diff --git a/...CodeLens_vs_OpenTaint_Upgrade_Analysis.md → ...CodeLens_vs_OpenTaint_Upgrade_Analysis.md b/...CodeLens_vs_OpenTaint_Upgrade_Analysis.md → ...CodeLens_vs_OpenTaint_Upgrade_Analysis.md
diff --git a/...!/CodeLens_vs_Repomix_Upgrade_Analysis.md → ...h/CodeLens_vs_Repomix_Upgrade_Analysis.md b/...!/CodeLens_vs_Repomix_Upgrade_Analysis.md → ...h/CodeLens_vs_Repomix_Upgrade_Analysis.md
diff --git a/...e!/CodeLens_vs_Serena_Upgrade_Analysis.md → ...ch/CodeLens_vs_Serena_Upgrade_Analysis.md b/...e!/CodeLens_vs_Serena_Upgrade_Analysis.md → ...ch/CodeLens_vs_Serena_Upgrade_Analysis.md
diff --git a/...vs_UnderstandAnything_Upgrade_Analysis.md → ...vs_UnderstandAnything_Upgrade_Analysis.md b/...vs_UnderstandAnything_Upgrade_Analysis.md → ...vs_UnderstandAnything_Upgrade_Analysis.md
diff --git a/docs/research/README.md b/docs/research/README.md
@@ -0,0 +1,26 @@
+# Research & Competitive Analysis
+
+Internal analysis notes comparing CodeLens against other code-intelligence and
+security tools, and brainstorms for potential upgrades. **These are working
+research documents, not product documentation or a roadmap** — they capture
+point-in-time analysis and may reference features, commands, or plans that were
+never built (or were built differently).
+
+For what CodeLens actually does and how to use it, see the top-level
+[README.md](../../README.md), [SKILL.md](../../SKILL.md), and
+[references/agent-integration.md](../../references/agent-integration.md).
+
+## Contents
+
+| File | Compared against |
+|---|---|
+| `CodeLens_vs_Serena_Upgrade_Analysis.md` | Serena (LSP-backed IDE-for-agents) |
+| `CodeLens_vs_Repomix_Upgrade_Analysis.md` | Repomix |
+| `CodeLens_vs_UnderstandAnything_Upgrade_Analysis.md` | UnderstandAnything |
+| `CodeLens_vs_OpenTaint_Upgrade_Analysis.md` | OpenTaint |
+| `CodeLens_CodeGraph_Upgrade_Analysis.md` | Code-graph tooling |
+| `CodeLens_UBS_Upgrade_Analysis.md` | UBS |
+| `CodeLens_Opengrep_Upgrade_Analysis.md` | Opengrep |
+| `CodeLens_Upgrade_Issues_from_Semgrep.md` | Semgrep |
+| `CodeLens_Upgrade_Issues_from_RepoAudit.md` | RepoAudit |
+| `CodeLens_Upgrade_Issues_from_Emerge.md` | Emerge |
diff --git a/references/agent-integration.md b/references/agent-integration.md