AddThisFeature

Shared Component Ownership

Say who maintains each shared component and how changes to it get reviewed.

moderate Components & Primitives

What it adds

A recorded owner for every shared component, with review rules that scale to how widely the component is used.

What your agent is told to do

5
  1. 1

    Split the components into the ones that belong to the design system and the ones that belong to a single product area, and record the split explicitly. Most codebases have a middle tier that everyone edits and nobody maintains, and that tier is where the inconsistencies come from.

  2. 2

    Attach an owner to each shared component and make the ownership record live next to the code, so it is updated in the same change as the component rather than in a document that goes stale within a quarter.

  3. 3

    Require review by the owner for any change that alters a component's public shape, its accessibility behaviour, or its default appearance. Internal refactors that leave all three untouched do not need it.

  4. 4

    Define where an accessibility problem escalates and how quickly. An unlabelled control or a keyboard trap in a shared component is not a normal queue item, and the route to getting it fixed must be written down before it is needed.

  5. 5

    Do not make ownership a gate with no bypass. Provide a documented path for an urgent production fix that notifies the owner and requires follow-up review, because a rule that blocks incident response gets abandoned entirely the first time it bites.

Edge cases it handles

7
  • Design-system components and product-area components need different rules, and the boundary between them must be recorded. Treating every shared file identically either slows product work or leaves the system unguarded.
  • Changes to a component's public shape, accessibility behaviour, or default appearance need the owner's review, because those are the changes that reach screens the author has never opened.
  • Accessibility defects need a named escalation route and a stated response time. Without one they queue behind feature work and stay in a component rendered on every page.
  • An urgent production fix must be able to ship without waiting for the owner, provided the owner is notified and the change is reviewed afterwards. Ownership that cannot be bypassed under pressure is ownership that gets deleted.
  • An owner who leaves or changes teams must trigger reassignment; an unowned shared component drifts back into the state this feature exists to fix.
  • Ownership must be recorded per component or per directory, not per repository, or every change to anything summons the same small group.
  • The rules apply to the component's tests and documentation as well as its implementation, or the behaviour stays guarded while its description quietly rots.

Definition of done

8
  • Every shared component is classified as design system or product area, and the classification is stored with the code.
  • Each shared component has a recorded owner, and reassignment happens when an owner departs.
  • Changes to public shape, accessibility behaviour, or default appearance require owner review.
  • There is a written escalation route and response expectation for accessibility defects.
  • An urgent fix can ship without the owner present, with notification and follow-up review required.
  • Ownership records cover a component's tests and documentation as well as its implementation.
  • 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.