lmiranda
9698e8724d
Sprint 4 - Plugin Commands implementation adding 18 new user-facing commands across 8 plugins as part of V5.2.0 Plugin Enhancements. **projman:** - #241: /sprint-diagram - Mermaid visualization of sprint issues **pr-review:** - #242: Confidence threshold config (PR_REVIEW_CONFIDENCE_THRESHOLD) - #243: /pr-diff - Formatted diff with inline review comments **data-platform:** - #244: /data-quality - DataFrame quality checks (nulls, duplicates, outliers) - #245: /lineage-viz - dbt lineage as Mermaid diagrams - #246: /dbt-test - Formatted dbt test runner **viz-platform:** - #247: /chart-export - Export charts to PNG/SVG/PDF via kaleido - #248: /accessibility-check - Color blind validation (WCAG contrast) - #249: /breakpoints - Responsive layout configuration **contract-validator:** - #250: /dependency-graph - Plugin dependency visualization **doc-guardian:** - #251: /changelog-gen - Generate changelog from conventional commits - #252: /doc-coverage - Documentation coverage metrics - #253: /stale-docs - Flag outdated documentation **claude-config-maintainer:** - #254: /config-diff - Track CLAUDE.md changes over time - #255: /config-lint - 31 lint rules for CLAUDE.md best practices **cmdb-assistant:** - #256: /cmdb-topology - Infrastructure topology diagrams - #257: /change-audit - NetBox audit trail queries - #258: /ip-conflicts - Detect IP conflicts and overlaps Closes #241, #242, #243, #244, #245, #246, #247, #248, #249, #250, #251, #252, #253, #254, #255, #256, #257, #258 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
127 lines
3.2 KiB
Markdown
127 lines
3.2 KiB
Markdown
# Claude Config Maintainer
|
|
|
|
A Claude Code plugin for creating and maintaining optimized CLAUDE.md configuration files.
|
|
|
|
## Overview
|
|
|
|
CLAUDE.md files provide instructions to Claude Code when working with a project. This plugin helps you:
|
|
|
|
- **Analyze** existing CLAUDE.md files for improvement opportunities
|
|
- **Optimize** structure, clarity, and conciseness
|
|
- **Initialize** new CLAUDE.md files with project-specific content
|
|
|
|
## Installation
|
|
|
|
This plugin is part of the Leo Claude Marketplace. Install the marketplace and the plugin will be available.
|
|
|
|
## Commands
|
|
|
|
### `/config-analyze`
|
|
Analyze your CLAUDE.md and get a detailed report with scores and recommendations.
|
|
|
|
```
|
|
/config-analyze
|
|
```
|
|
|
|
### `/config-optimize`
|
|
Automatically optimize your CLAUDE.md based on best practices.
|
|
|
|
```
|
|
/config-optimize
|
|
```
|
|
|
|
### `/config-init`
|
|
Create a new CLAUDE.md tailored to your project.
|
|
|
|
```
|
|
/config-init
|
|
```
|
|
|
|
### `/config-diff`
|
|
Show differences between current CLAUDE.md and previous versions.
|
|
|
|
```
|
|
/config-diff # Compare working copy vs last commit
|
|
/config-diff --commit=abc1234 # Compare against specific commit
|
|
/config-diff --from=v1.0 --to=v2.0 # Compare two commits
|
|
/config-diff --section="Critical Rules" # Focus on specific section
|
|
```
|
|
|
|
### `/config-lint`
|
|
Lint CLAUDE.md for common anti-patterns and best practices.
|
|
|
|
```
|
|
/config-lint # Run all lint checks
|
|
/config-lint --fix # Auto-fix fixable issues
|
|
/config-lint --rules=security # Check only security rules
|
|
/config-lint --severity=error # Show only errors
|
|
```
|
|
|
|
**Lint Rule Categories:**
|
|
- **Security (SEC)** - Hardcoded secrets, paths, credentials
|
|
- **Structure (STR)** - Header hierarchy, required sections
|
|
- **Content (CNT)** - Contradictions, duplicates, vague rules
|
|
- **Format (FMT)** - Consistency, code blocks, whitespace
|
|
- **Best Practice (BPR)** - Missing Quick Start, Critical Rules sections
|
|
|
|
## Best Practices
|
|
|
|
A good CLAUDE.md should be:
|
|
|
|
- **Clear** - Easy to understand at a glance
|
|
- **Concise** - No unnecessary content
|
|
- **Complete** - All essential information included
|
|
- **Current** - Up to date with the project
|
|
|
|
### Recommended Structure
|
|
|
|
```markdown
|
|
# CLAUDE.md
|
|
|
|
## Project Overview
|
|
What does this project do?
|
|
|
|
## Quick Start
|
|
Essential build/test/run commands.
|
|
|
|
## Critical Rules
|
|
What must Claude NEVER do?
|
|
|
|
## Architecture (optional)
|
|
Key technical decisions.
|
|
|
|
## Common Operations (optional)
|
|
Frequent tasks and workflows.
|
|
```
|
|
|
|
### Length Guidelines
|
|
|
|
| Project Size | Recommended Lines |
|
|
|-------------|------------------|
|
|
| Small | 50-100 |
|
|
| Medium | 100-200 |
|
|
| Large | 200-400 |
|
|
|
|
## Scoring System
|
|
|
|
The analyzer scores CLAUDE.md files on:
|
|
|
|
- **Structure** (25 pts) - Organization and navigation
|
|
- **Clarity** (25 pts) - Clear, unambiguous instructions
|
|
- **Completeness** (25 pts) - Essential sections present
|
|
- **Conciseness** (25 pts) - Efficient information density
|
|
|
|
Target score: **70+** for effective Claude Code usage.
|
|
|
|
## Tips
|
|
|
|
1. Run `/config-analyze` periodically to maintain quality
|
|
2. Update CLAUDE.md when adding major features
|
|
3. Keep critical rules prominent and clear
|
|
4. Include examples where they add clarity
|
|
5. Remove generic advice that applies to all projects
|
|
|
|
## Contributing
|
|
|
|
This plugin is part of the personal-projects/leo-claude-mktplace repository.
|