library-sop

What problem does it solve?

This SOP ensures that AI agents verify exports against the actual library surface before generating imports, preventing invalid code and runtime failures.

Core Features & Use Cases

• Mandatory Export Verification Process: read dist/index.d.ts (or lib/motadata-react-library/src/index.ts) to enumerate exports from that file and verify intended imports exist.
• Import Rules and Best Practices: only import from the package root, no deep imports; use type-only imports when appropriate; ensure CSS import uses dist paths.
• Tailwind Preset and Build Guidance: ensure tailwind.config.ts uses library's preset to maintain semantic tokens and styles.
• Form Patterns and Naming Awareness: adhere to correct exports like Form, FormField, FormControl, FormLabel, FormMessage; avoid non-existent items like FormItem.
• Build, Docker, and Dependency Guards: avoid transitive dependencies and follow Docker build steps such as ignore-scripts and copying library.

Quick Start

Read and apply this SOP before importing motadata-react-library to verify exports and enforce safe usage.