organizing-conversations-code

v2026.09.25

File layout for the conversations product. Use when adding, moving, renaming, or reviewing files under products/conversations/ — especially frontend components, scenes, helpers, and tests. Conversations React components live in their own folder under products/conversations/frontend/components/, never as loose files in components/ or at the frontend root. Expand this skill as more conversations layout rules land.

GitHub
Install command
npx skhub add posthog/organizing-conversations-code
Markdown
SKILL.md

Organizing conversations code

Conversations-specific layout. Repo-wide UI rules still apply — read writing-ui-components for one-component-per-file, no barrels, and import sweeps. This skill owns where in conversations a file goes.

Use this skill when

  • Creating, moving, or renaming a file under products/conversations/
  • Adding a React component, helper, or test to conversations frontend
  • Reviewing a conversations diff that adds files

Components

Every React component lives in its own folder under products/conversations/frontend/components/. The file is named after the export.

products/conversations/frontend/components/<Name>/<Name>.tsx
products/conversations/frontend/components/<Name>/<Name>.test.tsx   # colocated

Import the file, not the folder:

import { SlaDisplay } from '../../components/SlaDisplay/SlaDisplay'
import { SlaDisplay } from 'products/conversations/frontend/components/SlaDisplay/SlaDisplay'

Do not:

  • Drop a component as a loose file in frontend/components/
  • Put a component at products/conversations/frontend/ (the product frontend root)
  • Add an index.ts barrel so callers can import the folder

A helper that returns props or data — not markup — is not a component. Keep it next to the feature or at products/conversations/frontend/<name>.ts(x) (see clearFilterButtonProps.tsx).

When you move a component, git mv, point every consumer at the new path, and delete the old one. No re-export shim.

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.25

Published

Sep 25, 2026

Category

Uncategorized

License

Not specified

Source path

skills/organizing-conversations-code

Default branch

main

Latest commit

469d177

Tree SHA

6fa3bb9