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.