用途：这是一套 React 组合模式（Composition Patterns）指南，帮助构建灵活、可维护的 React 组件。核心目标是避免布尔属性（boolean prop）泛滥，改用复合组件、状态提升和内部组合，使代码库在规模扩大时更便于人和 AI 智能体协作。
适用时机：重构带有大量布尔属性的组件；构建可复用组件库；设计灵活的组件 API；审查组件架构；使用复合组件或 context provider 时。
规则按优先级分为四类：
- 组件架构（HIGH，前缀 architecture-）：architecture-avoid-boolean-props 建议不要通过新增布尔属性定制行为，而用组合实现；architecture-compound-components 用共享 context 组织复杂组件。
- 状态管理（MEDIUM，前缀 state-）：state-decouple-implementation 让 Provider 成为唯一了解状态如何管理的地方；state-context-interface 定义包含 state、actions、meta 的通用接口以支持依赖注入；state-lift-state 将状态移入 Provider 组件供同级访问。
- 实现模式（MEDIUM，前缀 patterns-）：patterns-explicit-variants 用显式变体组件替代布尔模式；patterns-children-over-render-props 用 children 组合替代 renderX 属性。
- React 19 API（MEDIUM，前缀 react19-）：仅适用于 React 19+，React 18 及更早版本请跳过；react19-no-forwardref 建议不使用 forwardRef，并用 use() 替代 useContext()。
使用方式：阅读各规则文件获取详细说明与代码示例，例如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含：为何重要的简要说明、带解释的错误代码示例、带解释的正确代码示例，以及补充背景与参考。完整指南（所有规则展开）见 AGENTS.md。
限制：React 19 相关规则仅适用于 React 19 及以上版本；资料未提供安装命令、收费方式或平台支持信息。