AddThisFeature

Component Inventory

Keep a searchable record of every component, its variants, its owner, and where it is used.

moderate Components & Primitives

What it adds

A generated, browsable list of the components in the codebase with their variants, owners, usage counts, and lifecycle state.

What your agent is told to do

5
  1. 1

    Derive the inventory from the source rather than from a maintained document. Anything a person has to remember to update is wrong within a month, and a wrong inventory is worse than none because decisions get made from it.

  2. 2

    Record for each entry the variants it accepts, the owner recorded by Shared Component Ownership, the number of usages, and the files that use it. Ownership is defined by that feature; this one only reads and displays it.

  3. 3

    Follow re-exports, wrappers, and renamed imports back to the component that actually renders, so a thin local wrapper does not appear as its own component and hide the real usage count.

  4. 4

    Exclude generated output, vendored code, and third-party sources from the count, and say in the inventory that they were excluded rather than quietly dropping them.

  5. 5

    Do not present the inventory as a one-off report. Regenerate it in the same automated checks that run on every change, and fail the check when the committed inventory no longer matches the source.

Edge cases it handles

7
  • Wrappers, aliases, and re-exports must resolve to the underlying component. Counted naively, a component used through three local wrappers looks like four rarely-used components and survives a cleanup it should not have survived.
  • Generated files, vendored dependencies, and third-party components must be excluded from the inventory, or the list is dominated by code nobody in this codebase can change.
  • Deprecated and experimental entries must be labelled as such in the listing, so someone searching for a component to reuse does not adopt one that is scheduled for removal.
  • The inventory has to be regenerated automatically on every change and checked for drift, because a stale inventory is consulted with the same confidence as a current one.
  • Components reached only through dynamic or data-driven rendering will show zero usages by static analysis, so those call sites need to be recognised or the entry flagged as uncertain rather than reported as unused.
  • Usage counts must distinguish production code from tests, stories, and examples, or a component used nowhere but its own tests appears healthy.
  • The listing needs to be searchable by variant and by owner, not only by name, since the common question is which components already solve a given problem.

Definition of done

9
  • The inventory is generated from source and regenerated by the automated checks on every change.
  • Each entry lists variants, owner, usage count, and the files that use the component.
  • Wrappers, aliases, and re-exports resolve to the component that actually renders.
  • Generated, vendored, and third-party code is excluded, and the exclusion is stated in the listing.
  • Deprecated and experimental components are labelled in the listing.
  • Usage counts separate production usage from tests, stories, and examples.
  • A drifted inventory fails the automated check rather than being silently accepted.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.