diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4632155
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# AirDbg
+
+**Debug-first repair workflow with evidence**
+
+Version: 0.1.4  
+Author: 14816  
+License: MIT  
+Repository: http://git.airlongdian.fun/admin/airdbg.git  
+Homepage: https://airlongdian.fun/plugins/airdbg
+
+---
+
+## Description
+
+AirDbg guides you through reproducible debugging: load project context, initialize missing AGENTS.md/ADR/C4 docs, discuss symptoms, require AirXDB GUI evidence for every GUI validation, call AirNDB for packet capture when needed, call AirSDB for static analysis when needed, isolate root cause, apply focused fixes, verify behavior, and keep architecture context current.
+
+## Installation
+
+```bash
+# Add the Air marketplace
+claude plugin marketplace add http://git.airlongdian.fun/admin/airplan.git
+
+# Install this plugin
+claude plugin install airdbg
+```
+
+## Usage
+
+- `/airdbg - Enter debug mode and start repair workflow`
+
+For detailed usage, see `commands/airdbg.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/airdbg.git
+- Issues: Open an issue in this repository
+- Homepage: https://airlongdian.fun/plugins/airdbg