Make using the latest version a mandatory requirement

Author: azzazzel

.agents/PINECONE-go.md

@@ -6,6 +6,8 @@ This guide provides Go-specific patterns, examples, and best practices for the P
 
 ## Installation & Setup
 
+> **⚠️ IMPORTANT**: See [PINECONE.md](./PINECONE.md#-mandatory-always-use-latest-version) for the mandatory requirement to always use the latest version when creating projects.
+
 ### Go Module Installation
 
 ```bash
@@ -44,8 +46,6 @@ go get -u github.com/pinecone-io/go-pinecone/pinecone
 go mod tidy
 ```
 
-> **⚠️ Best Practice**: Always use the latest version of the Pinecone SDK unless the user explicitly requests a specific version. Check the latest version using the methods above and update your installation accordingly.
-
 ### Go Imports
 
 ```go

.agents/PINECONE-java.md

@@ -6,6 +6,8 @@ This guide provides Java-specific patterns, examples, and best practices for the
 
 ## Installation & Setup
 
+> **⚠️ IMPORTANT**: See [PINECONE.md](./PINECONE.md#-mandatory-always-use-latest-version) for the mandatory requirement to always use the latest version when creating projects.
+
 ### Finding the Latest Version
 
 **Check latest version on Maven Central:**
@@ -59,8 +61,6 @@ gradle dependencies | grep pinecone-client
 # Or browse Maven Central directly
 ```
 
-> **⚠️ Best Practice**: Always use the latest version of the Pinecone SDK unless the user explicitly requests a specific version. Check the latest version using the methods above and update your dependency configuration accordingly.
-
 ### Java Imports
 
 ```java

.agents/PINECONE-python.md

@@ -6,6 +6,8 @@ This guide provides Python-specific patterns, examples, and best practices for t
 
 ## Installation & Setup
 
+> **⚠️ IMPORTANT**: See [PINECONE.md](./PINECONE.md#-mandatory-always-use-latest-version) for the mandatory requirement to always use the latest version when creating projects.
+
 ### Current API (2025)
 
 ```python
@@ -43,7 +45,42 @@ pip show pinecone
 pip install --upgrade pinecone
 ```
 
-> **⚠️ Best Practice**: Always use the latest version of the Pinecone SDK unless the user explicitly requests a specific version. Check the latest version using the methods above and update your installation accordingly.
+### Dependency Management
+
+**⚠️ CRITICAL - Package Name**: Always use `pinecone` (NOT `pinecone-client`). The `pinecone-client` package is deprecated and will cause runtime errors.
+
+**requirements.txt:**
+
+```txt
+pinecone
+```
+
+**pyproject.toml (PEP 621):**
+
+```toml
+[project]
+dependencies = ["pinecone"]
+```
+
+**pyproject.toml (Poetry):**
+
+```toml
+[tool.poetry.dependencies]
+pinecone = "^7.0.0"
+```
+
+**setup.py:**
+
+```python
+install_requires=["pinecone"]
+```
+
+**Pipfile (pipenv):**
+
+```toml
+[packages]
+pinecone = "*"
+```
 
 ### Environment Configuration
 

.agents/PINECONE-typescript.md

@@ -6,6 +6,8 @@ This guide provides TypeScript/Node.js-specific patterns, examples, and best pra
 
 ## Installation & Setup
 
+> **⚠️ IMPORTANT**: See [PINECONE.md](./PINECONE.md#-mandatory-always-use-latest-version) for the mandatory requirement to always use the latest version when creating projects.
+
 ### Package Installation
 
 ```bash
@@ -53,8 +55,6 @@ npm update @pinecone-database/pinecone
 yarn upgrade @pinecone-database/pinecone
 ```
 
-> **⚠️ Best Practice**: Always use the latest version of the Pinecone SDK unless the user explicitly requests a specific version. Check the latest version using the methods above and update your installation accordingly.
-
 ### TypeScript Imports
 
 ```typescript

.agents/PINECONE.md

@@ -54,6 +54,16 @@ Determine the primary programming language by checking for these files:
 > - **SDK**: Check package files or use language-specific verification commands
 > - Only prompt for installation when verification shows it's missing
 
+### ⚠️ MANDATORY: Always Use Latest Version
+
+**REQUIREMENT**: When creating new projects or adding Pinecone dependencies, you MUST:
+
+1. **Check the latest version** using language-specific methods (see Installation & Setup sections in language-specific guides)
+2. **Use the latest version** in dependency files (package.json, requirements.txt, go.mod, pom.xml, etc.)
+3. **Only pin to a specific version** if the user explicitly requests it
+
+**DO NOT** use outdated or example version numbers. Always query for the current latest version before generating dependency files. See language-specific guides below for how to check the latest version for each language.
+
 **ALWAYS use the current SDK:**
 
 - **Python**: `pip install pinecone` (not `pinecone-client`)