| Metric | Target | Warning | Critical |
You are an expert in React component architecture and maintainability.
## Component Size Limits
| Metric | Target | Warning | Critical |
|--------|--------|---------|----------|
| Lines of code | < 150 | 150-300 | > 300 |
| Imports | < 20 | 20-35 | > 35 |
| useState calls | < 4 | 4-6 | > 6 |
| useEffect calls | < 3 | 3-5 | > 5 |
If exceeded: Stop and suggest decomposition.
## Hook Patterns
### AbortController for async useEffect
```typescript
useEffect(() => {
const controller = new AbortController();
const fetchData = async () => {
try {
const result = await api.getData({ signal: controller.signal });
setData(result);
} catch (err) {
if (!controller.signal.aborted) {
setError(err);
}
}
};
fetchData();
return () => controller.abort();
}, [dependency]);
```
### useWatch over watch()
```typescript
// ✅ Good - reactive, no full re-render
const value = useWatch({ name: 'field', control });
// ❌ Bad - causes full form re-render
const value = methods.watch();
```
### Memoize schemas
```typescript
// ✅ Good
const schema = useMemo(() => yup.object({
field: yup.string().required()
}), []);
// ❌ Bad - recreated every render
const schema = yup.object({ field: yup.string().required() });
```
### No components inside render
```typescript
// ✅ Good - defined outside or memoized
const InfoTrigger = memo(({ onClick }) => (
<button onClick={onClick}>Info</button>
));
// ❌ Bad - recreated every render
const Component = () => {
const Trigger = () => <button>Info</button>; // NEVER
return <Trigger />;
};
```
## File Structure
```
ComponentName/
├── ComponentName.tsx # Logic (< 100 lines)
├── ComponentName.styled.ts # Styles only
├── ComponentName.types.ts # Types/interfaces
├── ComponentName.test.tsx # Tests
└── hooks/
└── useComponentData.ts # Extracted logic
```Comprehensive .cursorrules file for Next.js 15 App Router projects with TypeScript, enforcing server components by default, proper use of "use client" directive, and App Router conventions.
Cursor rules for Python FastAPI projects enforcing async patterns, Pydantic v2 models, dependency injection, and proper error handling.
Rules for consistent React component development with TypeScript interfaces, proper hook patterns, and component composition.
Rules optimizing Cursor Agent mode behavior including multi-file editing context, session management, and autonomous task completion patterns.
Cursor rules for projects using Tailwind CSS with shadcn/ui component library, enforcing consistent utility class usage and component patterns.
Rules for Go backend services enforcing idiomatic Go patterns, proper error handling, and clean architecture conventions.