From c6b42432d69e2ae6cad167ee7fdd61966923a031 Mon Sep 17 00:00:00 2001
From: CommanderwinSmith027 <emelfemina@gmail.com>
Date: Wed, 22 Apr 2026 20:08:39 +0530
Subject: [PATCH] docs: add Cypher query rules to GitNexus rules section

Adds a Cypher Query Rules subsection under ## GitNexus rules so that
Claude Code and other agents always use the correct CodeRelation
property-based syntax when writing Cypher queries, rather than native
typed relationship syntax which doesn't match the graph schema.

Also bumps version to 1.4.0 and adds a changelog entry.
---
 CLAUDE.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index af4069fcd..f7bb224ac 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,6 +2,7 @@
 <!--
   Metadata: version, last reviewed, scope, model policy, reference docs, changelog.
   Last updated: 2026-03-22
+  | 2026-04-22 | 1.4.0 | Added Cypher query rules under GitNexus rules section. |
 -->
 
 Last reviewed: 2026-04-13
@@ -52,3 +53,12 @@ If always-on instructions grow, load deep conventions via conditional reads (e.g
 ## GitNexus rules
 
 See the `<!-- gitnexus:start --> … <!-- gitnexus:end -->` block in **[AGENTS.md](AGENTS.md)** for the canonical MCP tools, impact analysis rules, and index instructions.
+
+### Cypher Query Rules (Global)
+
+When using the `gitnexus_cypher` tool in ANY project:
+
+- **NEVER** use native relationship syntax like `-[:CALLS]->` or `-[:DEFINES]->`
+- **ALWAYS** use `-[:CodeRelation {type: 'CALLS'}]->` syntax
+- Classes connect to Methods via `HAS_METHOD` (not `DEFINES`)
+- Read `gitnexus://repo/{repo-name}/schema` if unsure about the schema