diff --git a/docs/housekeeper/crd.md b/docs/housekeeper/crd.md
new file mode 100644
index 0000000000000000000000000000000000000000..99e37ec74a0bee6fcbcc03b70349cce637e7e82c
--- /dev/null
+++ b/docs/housekeeper/crd.md
@@ -0,0 +1,42 @@
+# housekeeper资源定义
+
+```
+apiVersion: housekeeper.io/v1alpha1
+kind: UpgradeOSConfig
+metadata:
+labels:
+app.kubernetes.io/name: upgradeosconfig
+app.kubernetes.io/instance: upgradeosconfig-sample
+app.kubernetes.io/part-of: housekeeper-operator
+app.kubernetes.io/managed-by: kustomize
+app.kubernetes.io/created-by: housekeeper-operator
+name: upgradeosconfig-sample
+spec:
+    os:待升级的os信息
+        image: os镜像，string,required
+        version: os版本，string,required
+   os_maintain_strategy:OS升级的运维策略
+        max_unavailable: 运维策略中同时最多执行os升级的节点数量,int
+        drainer_num:每次驱离数量,int
+        drainer_interval:驱离时间间隔,秒为单位;int64
+        drainer_type:0,串行；1，并行;int
+   pod_drain:pod 的驱逐策略
+        drainer_force: 是否立即驱逐，bool
+        delete_empty_dir_data:是否删除卷上数据，bool
+        drace_period_seconds：Pods 在被强制终止前可以运行的最长时间，秒为单位；int64
+        drainer_timeout:整个驱离超时时间,秒为单位;int64
+   kernel_params:内核参数
+        net_ipv4_tcp_syncookies
+        net_ipv4_ip_forward
+        net_bridge_bridge_nf_call_iptables
+        net_bridge_bridge_nf_call_ip6tables
+        vm_swappiness
+        vm_overcommit_memory
+        fs_file_max
+        net_ipv4_conf_all_rp_filter
+        net_ipv4_conf_default_rp_filter
+        net_ipv4_conf_all_accept_redirects
+        net_ipv4_conf_default_accept_redirects
+        kernel_pid_max
+        vm_max_map_count
+```
\ No newline at end of file
diff --git a/docs/housekeeper/rd.md b/docs/housekeeper/rd.md
new file mode 100644
index 0000000000000000000000000000000000000000..d0e3e44730c779d4c871fc1533d114a86faa2dff
--- /dev/null
+++ b/docs/housekeeper/rd.md
@@ -0,0 +1,22 @@
+# housekeeper
+
+## operator 功能的开发
+```
+1.配置生命周期管理
+2.配置多版本管理
+3.配置下发
+```
+
+## proxy 功能的开发
+```
+1.接收operator下发的数据
+2.传递数据到agent
+3.业务pod的驱离
+```
+
+## agent 功能的开发
+```
+1.接收proxy下发的数据
+2.不可变以原子更新方式进行os升级，升级失败回滚
+3.node采集信息
+```
\ No newline at end of file