From 20c21eab9bbe139d4d8164261641e205d253356e Mon Sep 17 00:00:00 2001 From: Daniel Beer Date: Tue, 3 Mar 2026 23:31:58 +0200 Subject: [PATCH] docs: add rule to prevent content duplication from shared files Add rule #15 to CLAUDE.md requiring all agents to reference shared files instead of duplicating their content in SKILL.md files. This ensures: - Metric definitions stay in shared/metric-standards.md - Table schemas stay in shared/bq-schema.md - Segmentation queries stay in shared/bq-schema.md - Event definitions stay in shared/event-registry.yaml - SKILL.md files remain focused on workflow and agent-specific rules Co-Authored-By: Claude Sonnet 4.5 --- CLAUDE.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 63eef82..9c2bcad 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -54,6 +54,13 @@ Every agent reads from these files. They are the single source of truth — do n - **Heavy Users:** Must include all filters (4+ weeks active, token consumption, etc.) - **Full Segmentation:** Must follow hierarchy (Enterprise → Heavy → Paying → Free) - Copy the entire CTE structure from `bq-schema.md` lines 441-516, do not improvise or simplify +15. **Never duplicate content from shared files in agent SKILL.md files.** Always reference shared files instead of copying their content: + - **Metric definitions** → Reference `shared/metric-standards.md`, don't copy SQL patterns + - **Table schemas** → Reference `shared/bq-schema.md`, don't copy column lists + - **User segmentation** → Reference `shared/bq-schema.md` segmentation queries, don't recreate them + - **Event definitions** → Reference `shared/event-registry.yaml`, don't list events + - Keep SKILL.md focused on workflow steps and agent-specific rules only + - If you find yourself writing detailed tables, SQL patterns, or schema definitions, stop and reference the shared file instead ## MCP Connections