core-principles

This skill serves as the authoritative source of truth for architectural principles and development standards within a React 19 SPA ecosystem. It is designed for software engineers and autonomous agents to ensure high-quality codebases by enforcing consistent project structure, rigorous data-fetching patterns, and modern tooling practices. By maintaining a clear contract for feature development, it prevents architectural drift and simplifies the onboarding process for teams working with Vite, TypeScript, Biome, and the TanStack ecosystem.

• Standardizes project organization, separating application shells, routing logic, pure UI components, and domain-specific feature hooks.

• Defines strict agent execution rules, including mandatory API spec synchronization using Apidog MCP and optimized data access patterns via TanStack Query.

• Promotes compiler-friendly development practices for React 19, including auto-memoization, pure component design, and modern server mutation strategies.

• Ensures quality through comprehensive testing requirements, emphasizing React Testing Library, Vitest, and network mocking with MSW.

• Provides a clear 'Done' checklist to standardize pull request readiness and code quality before committing changes.

• Utilize when initializing new features or modules to align with the pre-defined folder structure and service layering requirements.

• Refer to the authoritative sources section for documentation regarding React 19, Vite, Biome, and TanStack integration patterns.

• Always invoke the Apidog MCP integration as the primary source for API type generation to maintain type safety between the backend specification and the frontend client.

• Apply the 'use no memo' directive only when explicitly required by compiler constraints, prioritizing standard React 19 auto-memoization features first.

• Ensure all new routes are implemented within the TanStack Router file-based system, incorporating prefetch loaders to optimize navigation performance.