用途：这是一套 React 组件组合模式指南，帮助开发者构建灵活、可维护的组件，避免通过不断添加布尔属性来定制行为，使代码库在规模扩大时更易被人类和 AI 智能体理解与维护。
适用时机：重构含大量布尔属性的组件、构建可复用组件库、设计灵活的组件 API、评审组件架构，以及使用复合组件或 context provider 时参考。
规则分类（按优先级）：1. 组件架构（HIGH），前缀 architecture-，包括避免布尔属性、用共享 context 组织复杂组件；2. 状态管理（MEDIUM），前缀 state-，包括实现解耦（Provider 是唯一知道状态如何管理的地方）、定义含 state、actions、meta 的通用接口以支持依赖注入、将状态提升到 provider 组件供兄弟组件访问；3. 实现模式（MEDIUM），前缀 patterns-，包括创建显式变体组件而非布尔模式、用 children 组合替代 renderX 属性；4. React 19 API（MEDIUM），前缀 react19-，仅适用于 React 19 及以上，React 18 及更早版本跳过，规则为不使用 forwardRef，用 use() 替代 useContext()。
使用方式：阅读各规则文件获取详细说明与代码示例，例如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含重要性简述、错误代码示例及说明、正确代码示例及说明、补充背景与参考。完整指南见 AGENTS.md。
限制：React 19 相关规则仅适用于 React 19+；资料未提供安装命令、收费方式或平台支持信息。