lmiranda
74b28170fa
- Remove Wiki.js MCP server entirely - Add wiki, milestone, and dependency tools to Gitea MCP server - Add parallel execution support based on dependency graph - Add mandatory pre-planning validations (org check, labels, docs/changes) - Add CLI blocking rules to all agents (API-only) - Add standardized task naming: [Sprint XX] <type>: <description> - Add branch naming convention: feat/, fix/, debug/ prefixes - Add MR body template without subtasks - Add auto-close issues via commit keywords - Create claude-config-maintainer plugin for CLAUDE.md optimization - Update all sprint commands with new tools and workflows - Update documentation to remove Wiki.js references New MCP tools: - Wiki: list_wiki_pages, get_wiki_page, create_wiki_page, create_lesson, search_lessons - Milestones: list_milestones, get_milestone, create_milestone, update_milestone - Dependencies: list_issue_dependencies, create_issue_dependency, get_execution_order - Validation: validate_repo_org, get_branch_protection, create_label Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
179 lines
3.8 KiB
Markdown
179 lines
3.8 KiB
Markdown
---
|
|
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:
|
|
|
|
```bash
|
|
# Restore from backup
|
|
cp .claude/backups/CLAUDE.md.TIMESTAMP ./CLAUDE.md
|
|
```
|
|
|
|
Or ask:
|
|
```
|
|
Restore CLAUDE.md from the most recent backup
|
|
```
|