用途：这是一份 React 组合模式（Composition Patterns）指南，帮助构建灵活、可维护的 React 组件。当组件出现大量布尔属性、需要构建可复用组件库、设计灵活的组件 API 或评审组件架构时使用。它强调通过组合内部结构、复合组件和状态提升来替代布尔属性膨胀，使代码库更利于人和 AI 智能体在规模化时协作。
规则分类按优先级排列：
- 组件架构（高优先级，前缀 architecture-）：architecture-avoid-boolean-props 不要用布尔属性定制行为，改用组合；architecture-compound-components 用共享 context 组织复杂组件。
- 状态管理（中优先级，前缀 state-）：state-decouple-implementation 只有 Provider 知道状态如何管理；state-context-interface 定义包含 state、actions、meta 的通用接口用于依赖注入；state-lift-state 将状态提升到 Provider 组件以便兄弟组件访问。
- 实现模式（中优先级，前缀 patterns-）：patterns-explicit-variants 用显式变体组件替代布尔模式；patterns-children-over-render-props 用 children 做组合而非 renderX 属性。
- React 19 API（中优先级，前缀 react19-）：仅适用于 React 19 及以上，React 18 及更早版本跳过；react19-no-forwardref 不要用 forwardRef，用 use() 替代 useContext()。
使用方式：按需阅读各规则文件获取详细说明与代码示例，例如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含为何重要的简要说明、带解释的错误代码示例、带解释的正确代码示例，以及额外上下文与参考。完整指南见 AGENTS.md。
适用场景：重构含大量布尔属性的组件、构建可复用组件库、设计组件 API、评审组件架构、使用复合组件或 context 提供者。
限制：React 19 API 部分仅适用于 React 19+；资料未提供安装命令、许可、平台支持或其他收费信息。