diff --git a/github/GithubAgent.md b/github/GithubAgent.md
new file mode 100644
index 00000000000..5adc2f39720
--- /dev/null
+++ b/github/GithubAgent.md
@@ -0,0 +1,22 @@
+# GitHub Agent Documentation
+
+## Overview
+
+This document provides information about proactive agents in the repository, based on available documentation and code exploration.
+
+## Proactive Agents
+
+According to the README.md, the project includes support for proactive agents:
+
+> The system also supports proactive agents that can take initiative to help users with their work. For example, an agent might notice that a user is working on a particular task and offer suggestions or resources that could be helpful.
+
+These proactive agents are designed to:
+- Monitor user activities
+- Provide contextual assistance
+- Offer suggestions without explicit user prompting
+
+## Implementation Notes
+
+- The codebase contains references to proactive agent functionality in various components
+- Agent providers are implemented in the extensions/codestory/src/completions/providers directory
+- Specific GitHub-related agent functionality may be part of the broader proactive agent system
\ No newline at end of file