Sample PRD

Index Health & Code Insights

Overview

Provide a read‑only Index Health panel and Code Insights dashboard so teams can trust Corvus evidence and quickly find where to start in the codebase.

Problem Statement

Users can’t tell whether the index is fresh or complete, and Corvus responses feel opaque without visible signals. This leads to distrust, reindexing confusion, and slower onboarding.

User Stories

  • As a developer, I want to see index coverage and last run time so I can trust citations.
  • As a lead, I want a quick “where to start” view so I can triage changes faster.
  • As a user, I want insights without leaving the IDE.

In Scope

  • Index Health panel with coverage %, file counts, last indexed time.
  • Code Insights dashboard: top packages, hotspots, unused imports.
  • Clickable “where to start” file list.

Out of Scope

  • Registry lookups for outdated packages (future).
  • Editable insights (read‑only for now).

Acceptance Criteria

  • Index Health renders with accurate counts and coverage.
  • Insights show top packages and hotspots without blocking the UI.
  • “Where to start” opens files in the editor.

Success Metrics

  • 80% reduction in “tell me a file” responses during code questions.
  • Average onboarding time reduced by 30%.