用途：这是一套 React 组合模式（Composition Patterns）指南，用于构建灵活、可维护的 React 组件，重点解决布尔属性泛滥问题，通过复合组件、状态提升和内部组合来组织代码，使代码库在规模扩大时更易被人类和 AI 智能体处理。
适用时机：重构含大量布尔属性的组件、构建可复用组件库、设计灵活的组件 API、审查组件架构、使用复合组件或 context provider 时参考。
规则按优先级分为四类：一、组件架构（HIGH），含 architecture-avoid-boolean-props（不要用布尔属性定制行为，改用组合）、architecture-compound-components（用共享 context 组织复杂组件）；二、状态管理（MEDIUM），含 state-decouple-implementation（Provider 是唯一知道状态如何管理的地方）、state-context-interface（定义含 state、actions、meta 的通用接口以支持依赖注入）、state-lift-state（把状态移入 provider 组件供兄弟组件访问）；三、实现模式（MEDIUM），含 patterns-explicit-variants（用显式变体组件替代布尔模式）、patterns-children-over-render-props（用 children 组合替代 renderX 属性）；四、React 19 API（MEDIUM，仅限 React 19+，React 18 及更早版本跳过），含 react19-no-forwardref（不要用 forwardRef，用 use() 替代 useContext()）。
使用方式：阅读各规则文件获取详细说明与代码示例，如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含：为何重要的简要说明、带解释的错误代码示例、带解释的正确代码示例、额外上下文与参考。完整指南见 references/full-guide.md。
限制：React 19 API 部分仅适用于 React 19 及以上版本；资料未提供安装命令、收费或平台信息。