diff --git a/README.md b/README.md
index 8a32bc4..057dd35 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,20 @@
-This is open issue repo!~
\ No newline at end of file
+This is open issue repo!~
+
+## Issue guide
+
+Use small, reviewable issues so contributors can understand the request quickly.
+
+For bug reports, include:
+
+- What happened
+- What you expected to happen
+- Steps to reproduce
+- Screenshots or logs when available
+
+For feature requests, include:
+
+- The user problem
+- The expected behavior
+- Clear acceptance criteria
+
+Pull requests should reference the related issue in the description.