diff --git a/AGENTS.md b/AGENTS.md
index 1c1b9eb..60efb74 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,2 +1,51 @@
-## Project Description
-This repository contains various materials and resources related to GitHub, including documentation, tutorials, and examples for using GitHub features effectively.
\ No newline at end of file
+## About This Repository
+
+**Last Updated:** October 30, 2025
+
+### Overview
+This repository is a comprehensive collection of materials and resources for GitHub Copilot, designed to help developers maximize their productivity and understand the full capabilities of GitHub's AI-powered coding assistant.
+
+### Purpose
+The github-materials repository serves as:
+- **Learning Resource**: Practical examples demonstrating GitHub Copilot features across multiple programming languages and scenarios
+- **Reference Guide**: Documentation and tutorials for using GitHub Copilot effectively in various development contexts
+- **Best Practices Hub**: Real-world use cases showcasing optimal patterns for AI-assisted development
+- **Feature Showcase**: Live demonstrations of GitHub Copilot's capabilities in IDEs and web interfaces
+
+### Target Audience
+- Developers learning to work with GitHub Copilot
+- Teams implementing AI-assisted development workflows
+- Technical educators and trainers
+- Anyone interested in exploring GitHub Copilot's capabilities
+
+### Repository Structure
+The repository is organized into three main sections:
+
+1. **github-copilot-features** (~28 feature categories)
+   - Core functionalities like code generation, refactoring, and translation
+   - Advanced features including MCP servers, custom extensions, and agents
+   - Specialized tools for vision, web fetching, and Jupyter notebooks
+
+2. **github-copilot-features-status**
+   - IDE feature comparisons and compatibility matrices
+   - Web interface capabilities overview
+
+3. **github-copilot-scenario-roles**
+   - Real-world use cases across different domains
+   - Infrastructure as Code examples
+   - Database operations and UI automation
+   - Figma integration and DALL-E image generation
+
+### Key Features Covered
+- Code generation and completion
+- Multi-language support and translation
+- Code refactoring and optimization
+- Test generation and review
+- Documentation generation
+- Custom instructions and extensions
+- Model Context Protocol (MCP) integration
+- Vision and image processing
+- Web content fetching and search
+
+### Getting Started
+Explore the folders based on your interests or specific needs. Each directory contains practical examples with supporting documentation to help you understand and implement GitHub Copilot features in your own projects.
\ No newline at end of file