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