diff --git a/README.md b/README.md
new file mode 100644
index 0000000..98f4847
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# AirArc
+
+**Architecture-first planning with built-in parallel review**
+
+Version: 0.3.1  
+Author: 14816  
+License: MIT  
+Repository: http://git.airlongdian.fun/admin/airarc.git  
+Homepage: https://airlongdian.fun/plugins/airarc
+
+---
+
+## Description
+
+AirArc is the architecture mode plugin for the Air workflow suite. It helps you initialize project planning context, produce post-plan parallelization reviews from todo.md, and identify dependency edges, shared-write conflicts, and serialization points before workers run.
+
+## Installation
+
+```bash
+# Add the Air marketplace
+claude plugin marketplace add http://git.airlongdian.fun/admin/airplan.git
+
+# Install this plugin
+claude plugin install airarc
+```
+
+## Usage
+
+- `/airarc - Initialize or inspect architecture planning context`
+
+For detailed usage, see `commands/airarc.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/airarc.git
+- Issues: Open an issue in this repository
+- Homepage: https://airlongdian.fun/plugins/airarc