Refactor Agents.md to remove outdated content

Removed outdated examples and sections related to providers, hooks, and core directories. Updated development practices and TypeScript requirements.

Author: fzaninotto

.claude/Agents.md

@@ -17,44 +17,12 @@ React-admin is a comprehensive frontend framework for building B2B and admin app
 
 ### Provider Pattern
 
-React-admin uses adapters called "providers" for external integrations:
-
-```typescript
-// Data Provider - abstracts API calls
-dataProvider.getList('posts', {
-    pagination: { page: 1, perPage: 5 },
-    sort: { field: 'title', order: 'ASC' },
-    filter: { author_id: 12 }
-})
-
-// Auth Provider - handles authentication
-authProvider.checkAuth()
-authProvider.login({ username, password })
-authProvider.getPermissions()
-
-// i18n Provider - manages translations
-i18nProvider.translate('ra.action.save')
-```
+React-admin uses adapters called "providers" for external integrations. 
 
 ### Hook-Based API
 
 All functionality exposed through hooks following React patterns:
 
-```typescript
-// Data hooks
-const { data, isLoading } = useGetList('posts', {
-    pagination: { page: 1, perPage: 10 }
-});
-
-// State management hooks
-const [filters, setFilters] = useFilterState();
-const [page, setPage] = usePaginationState();
-
-// Auth hooks
-const { permissions } = usePermissions();
-const canAccess = useCanAccess({ resource: 'posts', action: 'edit' });
-```
-
 ### Headless Core
 
 The `ra-core` package contains all logic without UI. UI components are in separate packages like `ra-ui-materialui`. This allows:
@@ -97,15 +65,6 @@ react-admin/
 └── scripts/            # Build scripts
 ```
 
-### Key ra-core Directories
-
-- `src/auth/` - Authentication and authorization (54 files)
-- `src/controller/` - CRUD controllers and state management
-- `src/dataProvider/` - Data fetching and caching logic (70 files)
-- `src/form/` - Form handling (31 files)
-- `src/routing/` - Navigation and routing (26 files)
-- `src/i18n/` - Internationalization (30 files)
-
 ### Package Dependencies
 
 - **Core**: React 18.3+, TypeScript 5.8+, lodash 4.17+, inflection 3.0+
@@ -117,12 +76,13 @@ react-admin/
 
 ## Development Practices
 
+**Search for similar functions** before creating a new one. React-admin is a rich framework that already has many building blocks. 
+
 ### TypeScript Requirements
 
 - **Strict mode enabled** - no implicit any
 - **Complete type exports** - all public APIs must be typed
 - **Generic types** for flexibility in data providers and resources
-- **JSDoc comments** for better IDE support
 
 ```typescript
 // GOOD - Properly typed with generics
@@ -156,11 +116,17 @@ export const MyField = ({ source, ...props }) => {
 ```
 
 ### File Organization
+
 - **Feature-based structure** within packages (not type-based)
+- **One file per component** except for components that can't be used in standalone (e.g. `DataTable.Col`)
 - **Co-location** - Tests (`.spec.tsx`) and stories (`.stories.tsx`) next to components
 - **Index exports** - Each directory has an index.ts exporting public API
 - **Flat structure** within features - avoid unnecessary nesting
 
+### JSDoc
+
+Every hook or component must have basic usage described in JSDoc, including a non-trivial example. No need to document all options - IDEs display TypeScript types for that. 
+
 ### Documentation
 
 Every new feature or API change must be documented. The documentation consists of Markdown files located in the `/docs/` directory and built with Jekyll, one file per component or hook.
@@ -210,8 +176,7 @@ make prettier       # Format code
    feat: Add support for custom row actions in Datagrid
    docs: Clarify dataProvider response format
    ```
-
-4. **Documentation**: Update relevant docs for API changes
+4. Use Pull Request Description Template
 
 ### Common Make Commands
 ```bash
@@ -241,6 +206,7 @@ make run-demo       # Run demo application
 - Test with screen readers
 
 ### Browser Support
+
 - Modern browsers only (Chrome, Firefox, Safari, Edge)
 - No IE11 support
 - ES5 compilation target for compatibility
@@ -298,4 +264,4 @@ Kept minimal to critical user paths due to maintenance overhead.
 make lint               # ESLint checks
 make prettier           # Prettier formatting
 make build              # TypeScript type checking
-```
+```