Goal: Create and maintain focused, well-organized rule files in .claude/rules/ following Claude Code best practices.
IMPORTANT: Rules should be concise, focused, and organized by topic. Follow the reference documentation structure.
Workflow
Phase 1: Assessment
- •Read reference documentation at
references/project-rules-docs.md - •Analyze existing rules in
.claude/rules/to understand patterns - •Check if rule file exists (update vs create)
- •Determine rule scope (general vs path-specific)
- •Identify appropriate filename and organization
Phase 2: Configuration
- •For updates: read existing file and preserve structure
- •Define rule topic and scope clearly
- •Structure content with clear sections and lists
- •Apply YAML frontmatter for path-specific rules
- •Keep content focused on one topic
Phase 3: Implementation
- •Create new or update existing rule file in
.claude/rules/ - •Use subdirectories for better organization if needed
- •Validate frontmatter syntax for path-specific rules
- •Report completion with file location, scope, and changes made
Rules
- •One topic per rule file (code-style, testing, security)
- •Use descriptive filenames (kebab-case)
- •Path-specific frontmatter only when truly needed
- •For updates: extend sections, remove duplicates, preserve existing content
- •Consult user before major structural changes
Acceptance Criteria
- •Rule file created or updated in
.claude/rules/directory - •Content is focused and well-organized
- •YAML frontmatter valid for path-specific rules
- •Filename is descriptive and follows kebab-case
- •No conflicts with existing rules
- •Report includes file location, scope, and summary of changes