From b077d931f8d8571285b592a1dcb86736d11f0c09 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Mon, 20 Apr 2026 00:07:57 +0500 Subject: [PATCH] CLAUDE.md: add rules-loading discipline tip to Workflow Best Practices Records the official docs behavior: .claude/rules/*.md without paths: frontmatter auto-load into every session like CLAUDE.md; with paths: they lazy-load only when Claude touches matching files. Thematically grouped next to the existing 200-line CLAUDE.md rule so context-discipline rules stay adjacent. Co-Authored-By: Claude --- CLAUDE.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CLAUDE.md b/CLAUDE.md index 28f962a..88ee0d0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -92,6 +92,7 @@ When the user asks a Claude Code best practice question, **always search this re From experience with this repository: - Keep CLAUDE.md under 200 lines per file for reliable adherence +- `.claude/rules/*.md` with `paths:` YAML frontmatter are lazy-loaded only when Claude touches matching files; without frontmatter they load into every session like CLAUDE.md - Use commands for workflows instead of standalone agents - Create feature-specific subagents with skills (progressive disclosure) rather than general-purpose agents - Perform manual `/compact` at ~50% context usage