@@ -136,6 +136,10 @@ Every development issue MUST include these checkboxes:
 - Old `@aws-rds-postgresql-expert` → `@postgres-specialist`
 - All existing database work delegates to the single new agent
 
+## Context7 - Library Documentation (Mandatory)
+
+All programming agents MUST use Context7 for current library/framework documentation before implementing code. Provides up-to-date docs for 1000+ libraries including React, Python, Rust, Go, Ruby, Rails, and more. Tools: `resolve-library-id` (search library), `get-library-docs` (fetch docs). Rate limit: 10,000 calls/month. See: instructions/context7-library-documentation.md
+
 ## Remory Memory Integration
 All agents integrate with Remory, an advanced memory server that provides:
 - Semantic search with vector embeddings (vs simple text matching)
 
@@ -0,0 +1,62 @@
+# Context7 - Library Documentation MCP
+
+## What Context7 Provides
+
+Context7 is a Model Context Protocol (MCP) server that provides up-to-date documentation for 1000+ libraries and frameworks including:
+- **Languages**: Python, JavaScript/TypeScript, Go, Rust, Ruby, Java, C/C++, and more
+- **Frameworks**: React, Django, Rails, Express, FastAPI, Gin, Actix, and others
+- **Libraries**: Pandas, NumPy, Jest, Vitest, pytest, cargo, and thousands more
+- **Tools**: Build systems, package managers, testing frameworks, and utilities
+
+## When to Use Context7
+
+**Use Context7 BEFORE implementing any code** when working with:
+- Any third-party library or framework
+- New versions of familiar tools
+- API design with current best practices
+- Performance optimization patterns
+- Library selection decisions
+
+## How to Use Context7
+
+Context7 provides two main tools:
+
+### resolve-library-id
+Searches for a library by name and returns its Context7 ID. Use this first to find the library you need.
+
+```
+resolve-library-id: "React"  → Returns Context7 ID for React
+resolve-library-id: "pandas" → Returns Context7 ID for pandas
+resolve-library-id: "pytest" → Returns Context7 ID for pytest
+```
+
+### get-library-docs
+Retrieves current documentation for a specific library using its Context7 ID.
+
+```
+get-library-docs: "<context7-id>" → Returns latest official docs
+```
+
+## Rate Limits
+
+- **Free tier**: 10,000 calls/month
+- **Sufficient for**: Regular development work with ~50-100 calls per day
+- Monitor usage if calling Context7 for every minor decision
+
+## Context7 vs Perplexity
+
+| Tool | Best For | When to Use |
+|------|----------|-------------|
+| **Context7** | Library/framework APIs and official docs | Before implementing with ANY library |
+| **Perplexity** | General research, comparisons, explanations | Understanding concepts, tool comparisons, debugging |
+
+**Example**: Need React docs? → Context7. Need "why use React vs Vue?" → Perplexity.
+
+## Quick Start
+
+1. Search for your library: `resolve-library-id: "libraryname"`
+2. Get its docs: `get-library-docs: "<returned-id>"`
+3. Reference official documentation before coding
+4. Implement with current API knowledge
+
+**Remember**: Always check official docs before making assumptions about library behavior or API changes.