claudecode-rules-organizing

Extract file-type specific rules from CLAUDE.md into .claude/rules/ with paths frontmatter.

4|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/tomada1114/tomada-claude-plugins --skill claudecode-rules-organizing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claudecode-rules-organizing
Source: https://github.com/tomada1114/tomada-claude-plugins/tree/main/claude-dev-kit/skills/claudecode-rules-organizing
Command: npx skills add https://github.com/tomada1114/tomada-claude-plugins --skill claudecode-rules-organizing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md often grows large with universal and file-type specific rules. This skill consolidates file-type specific guidance into .claude/rules/ and enables dynamic loading via paths frontmatter to optimize context in large projects.

Core Features & Use Cases

  • Extract file-type specific rules from CLAUDE.md into .claude/rules/ with per-file loading triggers.
  • Preserve universal rules in CLAUDE.md while moving only targeted rules to rules/ for on-demand loading.
  • Use case: When CLAUDE.md contains extensive API/frontend/testing rules, load them only when relevant files are opened to reduce startup context.

Quick Start

To start, analyze CLAUDE.md, create a modular rules/ structure under .claude/rules/, and annotate rules with paths frontmatter to enable on-demand loading.

Frequently Asked Questions about claudecode-rules-organizing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce Claude's startup context in large projects?▼

Dynamic loading via paths frontmatter lets you organize file-type specific rules into .claude/rules/ and load them on-demand. Extract targeted rules from CLAUDE.md, structure them by category in .claude/rules/, and annotate with paths frontmatter so rules load only when relevant files are accessed, shrinking initial context.

How do I organize CLAUDE.md rules for modular loading?▼

Separate universal rules that stay in CLAUDE.md from file-type specific rules moved to .claude/rules/. Create subdirectories for API, frontend, testing, and other categories, then add paths frontmatter to each rule file to trigger on-demand loading when those file types are opened.

What's the difference between universal rules and category-specific rules in Claude configuration?▼

Universal rules apply across all files and belong in CLAUDE.md for immediate availability. Category-specific rules target API, frontend, testing, or other file types and should live in .claude/rules/ with paths frontmatter to load selectively, keeping startup context lean.

Can I use dynamic rule loading with large monorepos?▼

Yes. Dynamic loading via paths frontmatter is designed for large projects where selective rule loading optimizes context. Organize rules by file type or domain in .claude/rules/, annotate with paths matching your project structure, and rules load on-demand for relevant files.

How does paths frontmatter enable on-demand rule loading?▼

Paths frontmatter is metadata that specifies which file patterns trigger a rule's load. Annotate each rule file in .claude/rules/ with paths matching your file types—e.g., paths: src/api/**—and the rule loads only when those files are accessed, reducing unnecessary context consumption.

What happens to my existing CLAUDE.md when I move rules to .claude/rules/?▼

Your CLAUDE.md retains universal rules that apply everywhere. Extract only file-type specific guidance into .claude/rules/ with explicit paths, keeping CLAUDE.md lean and focused on project-wide conventions, then both sources load together when relevant.