用途：这是一套 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 属性。
使用方式：阅读各规则文件获取详细说明与代码示例，例如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含：为何重要的简要说明、带解释的错误代码示例、带解释的正确代码示例、额外上下文与参考。完整指南见 AGENTS.md。
限制：资料未提供安装命令、依赖版本、平台支持、收费或效果数据，暂未提供。