diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a1ec6a2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# AirDo
+
+**Executor for one scoped task slice**
+
+Version: 0.5.0  
+Author: 14816  
+License: MIT  
+Repository: http://git.airlongdian.fun/admin/airdo.git  
+Homepage: https://airlongdian.fun/plugins/airdo
+
+---
+
+## Description
+
+AirDo is the public execution plugin for one narrow task slice. It can be run directly or launched by AirEng as a fully isolated subagent, auto-routes GUI work into AirXDB, auto-routes blockers into AirDbg, and finalizes one structured result in AirPlan for AirEng to merge.
+
+## Installation
+
+```bash
+# Add the Air marketplace
+claude plugin marketplace add http://git.airlongdian.fun/admin/airplan.git
+
+# Install this plugin
+claude plugin install airdo
+```
+
+## Usage
+
+- `/airdo - Execute one scoped task from AirPlan/todo.md`
+
+For detailed usage, see `commands/airdo.md` in this repository.
+
+## Requirements
+
+- Claude Code CLI or desktop app (latest version recommended)
+- Python 3.8+ (for script-based plugins)
+- Additional dependencies listed in the plugin's skill documentation
+
+## Part of Air Suite
+
+This plugin is part of the [Air workflow suite](http://git.airlongdian.fun/admin/airplan). See the [marketplace README](http://git.airlongdian.fun/admin/airplan) for the full plugin list and installation instructions.
+
+## Support
+
+- Repository: http://git.airlongdian.fun/admin/airdo.git
+- Issues: Open an issue in this repository
+- Homepage: https://airlongdian.fun/plugins/airdo