code-graph-llm 2.1.1 → 2.1.3

package/AGENT_RULES.md

@@ -1,7 +1,7 @@
 # AGENT OPERATIONAL PROTOCOL (STRICT)
 > This protocol is MANDATORY for all LLM agents. Failure to update memory is a failure of the task.
 ## 🧠 THE REFLECTION CYCLE
-Every execution SHOULD follow this cycle:
+Every execution MUST follow this cycle:
 1. **PRE-TASK:** Read \`PROJECT_REFLECTIONS.md\` to identify existing pitfalls.
 2. **EXECUTION:** Monitor for "Learned Moments" (failures, unexpected behaviors, or non-obvious fixes).
 3. **POST-TASK:** If a significant lesson was learned, run \`code-graph reflect <CAT> <LESSON>\`. 

package/README.md

@@ -1,4 +1,4 @@
-# CODE-GRAPH (v2.1.1)
+# CODE-GRAPH (v2.1.3)
 
 A language-agnostic, ultra-compact codebase mapper and **agent memory system** designed specifically for LLM agents. It optimizes context and token usage while enabling agents to learn from their own mistakes across sessions.
 
@@ -68,6 +68,51 @@ The `llm-code-graph.md` file provides a high-level map and structural graph for
 ### 3. Example System Prompt
 > "Before acting, read `llm-code-graph.md`. Follow the protocol in `AGENT_RULES.md`. If you encounter a bug or an environment quirk, use the `code-graph reflect` tool to record the lesson in `PROJECT_REFLECTIONS.md`."
 
+## 🤖 Agent-Specific Integration
+
+Maximize efficiency by pointing your agent directly to the `llm-code-graph.md` and `AGENT_RULES.md` files.
+
+### Roo Code (Cline)
+Add this to your `.clinerules` file:
+```markdown
+Before starting any task:
+1. Read `llm-code-graph.md` for project structure.
+2. Read `AGENT_RULES.md` for operational protocol.
+3. Read `PROJECT_REFLECTIONS.md` for past lessons.
+4. **MANDATORY:** After any fix or learning event, you MUST update `PROJECT_REFLECTIONS.md` using `code-graph reflect`.
+```
+
+### Cursor / Windsurf
+Add to `.cursorrules` or `.windsurfrules`:
+```text
+Always reference `llm-code-graph.md` before editing. You are REQUIRED to follow the "Reflection Cycle" in `AGENT_RULES.md`. If a task involves a non-obvious fix or an environment quirk, you MUST record it in `PROJECT_REFLECTIONS.md` immediately.
+```
+
+### GitHub Copilot
+Add to `.github/copilot-instructions.md`:
+```markdown
+When answering questions about this codebase, prioritize the mapping data in `llm-code-graph.md`. You MUST suggest or perform a reflection entry for `PROJECT_REFLECTIONS.md` after every bug fix or identified pitfall.
+```
+
+### Gemini CLI
+Create a `GEMINI.md` file (if not already using `AGENT_RULES.md`):
+```markdown
+- Always read `llm-code-graph.md` as the primary source of truth.
+- **CRITICAL:** Use `run_shell_command` to execute `code-graph reflect` after any bug fix or discovered quirk. Memory persistence is a mandatory part of every task completion.
+```
+
+### OpenCode / OpenDevin / Aider
+In your project instructions or session startup:
+> "Read `llm-code-graph.md` for a high-level overview. You are FORCED to record any project-specific quirk or non-obvious lesson using `code-graph reflect <CAT> <LESSON>` before finishing a task."
+
+### Codex / GPT-Engineer / AutoGPT
+Add to your project prompt or `prompts.md`:
+> "Use `llm-code-graph.md` to navigate. Strictly adhere to the reflection cycle in `AGENT_RULES.md`. You MUST persist project memory by updating `PROJECT_REFLECTIONS.md` on every failure or learned moment."
+
+### Generic Agent (System Prompt)
+For any other agent, add this to your system instructions:
+> "This project uses `code-graph-llm` for context management. Always consult `llm-code-graph.md`. You ARE REQUIRED to persist new knowledge about the environment or logic using the `code-graph reflect` tool. Failure to update memory is a failure of the task."
+
 ## How it works
 1. **File Scanning:** Recursively walks the directory, ignoring patterns in `.gitignore`.
 2. **Context Extraction:** Scans for classes, functions, and variables while ignoring matches in comments.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-graph-llm",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Compact, language-agnostic codebase mapper for LLM token efficiency.",
   "main": "index.js",
   "bin": {