diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 00000000..adf26513
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "WareHouse/Gomoku_GitMode_20231025184031"]
+ path = WareHouse/Gomoku_GitMode_20231025184031
+ url = ./WareHouse/Gomoku_GitMode_20231025184031
diff --git a/README.md b/README.md
index c525bf02..5aeb6188 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@
## 🎉 News
-* **September 25th, 2023: The **Git** feature is now available**, enabling the programmer
to utilize GitHub for version control. To enable this feature, simply set ``"git_management"`` to ``"True"`` in ``ChatChainConfig.json``.
+* **September 25th, 2023: The **Git** feature is now available**, enabling the programmer
to utilize GitHub for version control. To enable this feature, simply set ``"git_management"`` to ``"True"`` in ``ChatChainConfig.json``. See [guide](wiki.md#git-mode) and [example](WareHouse/Gomoku_GitMode_20231025184031).
+### Git Mode
+- Simply set ``"git_management"`` to ``"True"`` in ``ChatChainConfig.json`` enables the Git Mode, in which ChatDev will make the generated software folder a git repository and automatically make all commits.
+- Every change made on the code of generated software will create a commit, including:
+ - The initial commit, created after the ``Coding`` phase completed, with a commit message ``Finish Coding``.
+ - Complete ``ArtIntegration`` phase, with a commit message ``Finish Art Integration``.
+ - Complete ``CodeComplete`` phase, with a commit message ``Code Complete #1/2/3 Finished``(if the CodeComplete is executed in three loops).
+ - Complete ``CodeReviewModification`` phase, with a commit message ``Review #1/2/3 Finished``(if the CodeReviewModification is executed in three loops).
+ - Complete ``CodeReviewHuman`` phase, with a commit message ``Human Review #1/2/3 Finished``(if the CodeReviewHuman is executed in three loops).
+ - Complete ``TestModification`` phase, with a commit message ``Test #1/2/3 Finished``(if the TestModification is executed in three loops).
+ - Complete ``ArtIntegration`` phase, with a commit message ``Finish Art Integration``.
+ - All phases completed, with a commit message ``Final Version``.
+- On the terminal and online log UI you can see the git summary at the end of process.
+ -
+ - You can also search ``git Information`` in the log file to see when did commit happen.
+- ⚠️ There are a few things worth noting about Git Mode:
+ - ChatDev is a git project, and we need to create another git project in the generated software folder, so we use ``git submodule`` to make this "git over git" function. A ``.gitmodule`` file will be created.
+ - under the software folder, you can add/commit/push/checkout the software project just like a normal git project, and your commits would not modify the ChatDev git history.
+ - under the ChatDev folder, the new software has been added to the ChatDev as a whole folder.
+ - The generated log file would not be added into the software git project, since the log is closed and moved to the software folder after the final commit. We have to do this because the log should record all the git commits, including the final one. So the git operations must be done before the log finalized. You will always see a log file to be added and committed in the software folder, like:
+ - 
+ - When you perform ``git add .`` under the ChatDev project, There will be information like (taking Gomoku for example):
+ ```commandline
+ Changes to be committed:
+ (use "git restore --staged