leo-claude-mktplace/plugins/claude-config-maintainer/commands/optimize.md

description

description
Optimize CLAUDE.md structure and content

Optimize CLAUDE.md

This command automatically optimizes your project's CLAUDE.md file based on best practices and identified issues.

What This Command Does

1. Analyze Current File - Identifies all optimization opportunities
2. Plan Changes - Determines what to restructure, condense, or add
3. Show Preview - Displays before/after comparison
4. Apply Changes - Updates the file with your approval
5. Verify Results - Confirms improvements achieved

Usage

/config-optimize

Or specify specific optimizations:

/config-optimize --condense        # Focus on reducing verbosity
/config-optimize --restructure     # Focus on reorganization
/config-optimize --add-missing     # Focus on adding missing sections

Optimization Actions

Restructure

• Reorder sections by importance
• Group related content together
• Improve header hierarchy
• Add navigation aids

Condense

• Remove redundant explanations
• Convert verbose text to bullet points
• Eliminate duplicate content
• Shorten overly detailed sections

Enhance

• Add missing essential sections
• Improve unclear instructions
• Add helpful examples
• Highlight critical rules

Format

• Standardize header styles
• Fix code block formatting
• Align list formatting
• Improve table layouts

Expected Output

CLAUDE.md Optimization
======================

Current Analysis:
- Score: 72/100
- Lines: 245
- Issues: 4

Planned Optimizations:

1. ADD: Quick Start section (new, ~15 lines)
   + Build command
   + Test command
   + Run command

2. CONDENSE: Testing section (34 → 8 lines)
   Before: Verbose explanation with redundant setup info
   After: Concise command reference with comments

3. REMOVE: Duplicate git workflow (lines 189-200)
   Keeping: Original at lines 102-115

4. FORMAT: Standardize headers
   Changing 12 headers from "## Title:" to "## Title"

Preview Changes? [Y/n] y

--- CLAUDE.md (before)
+++ CLAUDE.md (after)

@@ -1,5 +1,20 @@
 # CLAUDE.md

+## Quick Start
+
+```bash
+# Install dependencies
+pip install -r requirements.txt
+
+# Run tests
+pytest
+
+# Start development server
+python manage.py runserver
+```
+
 ## Project Overview
 ...

[Full diff shown]

Apply these changes? [Y/n] y

Optimization Complete!
- Previous score: 72/100
- New score: 89/100
- Lines reduced: 245 → 198 (-19%)
- Issues resolved: 4/4

Backup saved to: .claude/backups/CLAUDE.md.2025-01-18

Safety Features

Backup Creation

• Automatic backup before changes
• Stored in .claude/backups/
• Easy restoration if needed

Preview Mode

• All changes shown before applying
• Diff format for easy review
• Option to approve/reject

Selective Application

• Can apply individual changes
• Skip specific optimizations
• Iterative refinement

Options

Option	Description
--dry-run	Show changes without applying
--no-backup	Skip backup creation
--aggressive	Maximum condensation
--preserve-comments	Keep all existing comments
--section=NAME	Optimize specific section only

When to Use

Run /config-optimize when:

• Analysis shows score below 70
• File has grown too long
• Structure needs reorganization
• Missing critical sections
• After major refactoring

Best Practices

1. Run analysis first - Understand current state
2. Review preview carefully - Ensure nothing important lost
3. Test after changes - Verify Claude follows instructions
4. Keep backups - Restore if issues arise
5. Iterate - Multiple small optimizations beat one large one

Rollback

If optimization causes issues:

# Restore from backup
cp .claude/backups/CLAUDE.md.TIMESTAMP ./CLAUDE.md

Or ask:

Restore CLAUDE.md from the most recent backup