src/AGENTS.md

These rules apply to src/**. Follow the repo-root AGENTS.md first, then use this file for code inside the application source tree.

Keep route composition in src/views/, reusable UI in src/components/, shared logic in src/hooks/, and shared app state in src/stores/.
Before adding new state, decide whether it belongs in render, a reusable hook, or a Zustand store. Do not duplicate the same state logic across views.
Use @bitsocial/bitsocial-react-hooks for data access. Do not add data-fetching useEffect calls or effects that only synchronize derived state.
When changing React UI logic, review the changed diff with vercel-react-best-practices and vercel:react-best-practices when available before final verification. Run yarn doctor in addition to build, lint, and type-check. When changing layout or interaction, verify desktop and mobile behavior with playwright-cli.
Prefer extending nearby tests under src/**/__tests__/ when touching already-covered behavior.