lmiranda
a04a3c7a60
Updated: - docs/COMMANDS-CHEATSHEET.md - command reference table + all workflow examples - docs/CONFIGURATION.md - setup commands + plugin config table - README.md - all plugin command lists - CLAUDE.md - command reference tables Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
300 lines
16 KiB
Markdown
300 lines
16 KiB
Markdown
# Plugin Commands Cheat Sheet
|
|
|
|
Quick reference for all commands in the Leo Claude Marketplace.
|
|
|
|
---
|
|
|
|
## Command Reference Table
|
|
|
|
| Plugin | Command | Auto | Manual | Description |
|
|
|--------|---------|:----:|:------:|-------------|
|
|
| **projman** | `/sprint-plan` | | X | Start sprint planning with AI-guided architecture analysis and issue creation |
|
|
| **projman** | `/sprint-start` | | X | Begin sprint execution with dependency analysis and parallel task coordination (requires approval or `--force`) |
|
|
| **projman** | `/sprint-status` | | X | Check current sprint progress (add `--diagram` for Mermaid visualization) |
|
|
| **projman** | `/pm-review` | | X | Pre-sprint-close code quality review (debug artifacts, security, error handling) |
|
|
| **projman** | `/pm-test` | | X | Run tests (`/pm-test run`) or generate tests (`/pm-test gen <target>`) |
|
|
| **projman** | `/sprint-close` | | X | Complete sprint and capture lessons learned to Gitea Wiki |
|
|
| **projman** | `/labels-sync` | | X | Synchronize label taxonomy from Gitea |
|
|
| **projman** | `/pm-setup` | | X | Auto-detect mode or use `--full`, `--quick`, `--sync`, `--clear-cache` |
|
|
| **projman** | *SessionStart hook* | X | | Detects git remote vs .env mismatch, warns to run `/pm-setup --sync` |
|
|
| **projman** | `/pm-debug` | | X | Diagnostics (`/pm-debug report`) or investigate (`/pm-debug review`) |
|
|
| **projman** | `/suggest-version` | | X | Analyze CHANGELOG and recommend semantic version bump |
|
|
| **projman** | `/proposal-status` | | X | View proposal and implementation hierarchy with status |
|
|
| **projman** | `/rfc` | | X | RFC lifecycle management (`/rfc create\|list\|review\|approve\|reject`) |
|
|
| **git-flow** | `/git-commit` | | X | Create commit with auto-generated conventional message |
|
|
| **git-flow** | `/git-commit-push` | | X | Commit and push to remote in one operation |
|
|
| **git-flow** | `/git-commit-merge` | | X | Commit current changes, then merge into target branch |
|
|
| **git-flow** | `/git-commit-sync` | | X | Full sync: commit, push, and sync with upstream/base branch |
|
|
| **git-flow** | `/branch-start` | | X | Create new feature/fix/chore branch with naming conventions |
|
|
| **git-flow** | `/branch-cleanup` | | X | Remove merged branches locally and optionally on remote |
|
|
| **git-flow** | `/git-status` | | X | Enhanced git status with recommendations |
|
|
| **git-flow** | `/git-config` | | X | Configure git-flow settings for the project |
|
|
| **pr-review** | `/pr-setup` | | X | Setup wizard for pr-review (shares Gitea MCP with projman) |
|
|
| **pr-review** | `/project-init` | | X | Quick project setup for PR reviews |
|
|
| **pr-review** | `/project-sync` | | X | Sync config with git remote after repo move/rename |
|
|
| **pr-review** | *SessionStart hook* | X | | Detects git remote vs .env mismatch |
|
|
| **pr-review** | `/pr-review` | | X | Full multi-agent PR review with confidence scoring |
|
|
| **pr-review** | `/pr-summary` | | X | Quick summary of PR changes |
|
|
| **pr-review** | `/pr-findings` | | X | List and filter review findings by category/severity |
|
|
| **pr-review** | `/pr-diff` | | X | Formatted diff with inline review comments and annotations |
|
|
| **clarity-assist** | `/clarify` | | X | Full 4-D prompt optimization with ND accommodations |
|
|
| **clarity-assist** | `/quick-clarify` | | X | Rapid single-pass clarification for simple requests |
|
|
| **doc-guardian** | `/doc-audit` | | X | Full documentation audit - scans for doc drift |
|
|
| **doc-guardian** | `/doc-sync` | | X | Synchronize pending documentation updates |
|
|
| **doc-guardian** | `/changelog-gen` | | X | Generate changelog from conventional commits |
|
|
| **doc-guardian** | `/doc-coverage` | | X | Documentation coverage metrics by function/class |
|
|
| **doc-guardian** | `/stale-docs` | | X | Flag documentation behind code changes |
|
|
| **doc-guardian** | *PostToolUse hook* | X | | Silently detects doc drift on Write/Edit |
|
|
| **code-sentinel** | `/security-scan` | | X | Full security audit (SQL injection, XSS, secrets, etc.) |
|
|
| **code-sentinel** | `/refactor` | | X | Apply refactoring patterns to improve code |
|
|
| **code-sentinel** | `/refactor-dry` | | X | Preview refactoring without applying changes |
|
|
| **code-sentinel** | *PreToolUse hook* | X | | Scans code before writing; blocks critical issues |
|
|
| **claude-config-maintainer** | `/config-analyze` | | X | Analyze CLAUDE.md for optimization opportunities |
|
|
| **claude-config-maintainer** | `/config-optimize` | | X | Optimize CLAUDE.md structure with preview/backup |
|
|
| **claude-config-maintainer** | `/config-init` | | X | Initialize new CLAUDE.md for a project |
|
|
| **claude-config-maintainer** | `/config-diff` | | X | Track CLAUDE.md changes over time with behavioral impact |
|
|
| **claude-config-maintainer** | `/config-lint` | | X | Lint CLAUDE.md for anti-patterns and best practices |
|
|
| **claude-config-maintainer** | `/config-audit-settings` | | X | Audit settings.local.json permissions (100-point score) |
|
|
| **claude-config-maintainer** | `/config-optimize-settings` | | X | Optimize permissions (profiles, consolidation, dry-run) |
|
|
| **claude-config-maintainer** | `/config-permissions-map` | | X | Visual review layer + permission coverage map |
|
|
| **cmdb-assistant** | `/cmdb-setup` | | X | Setup wizard for NetBox MCP server |
|
|
| **cmdb-assistant** | `/cmdb-search` | | X | Search NetBox for devices, IPs, sites |
|
|
| **cmdb-assistant** | `/cmdb-device` | | X | Manage network devices (create, view, update, delete) |
|
|
| **cmdb-assistant** | `/cmdb-ip` | | X | Manage IP addresses and prefixes |
|
|
| **cmdb-assistant** | `/cmdb-site` | | X | Manage sites, locations, racks, and regions |
|
|
| **cmdb-assistant** | `/cmdb-audit` | | X | Data quality analysis (VMs, devices, naming, roles) |
|
|
| **cmdb-assistant** | `/cmdb-register` | | X | Register current machine into NetBox with running apps |
|
|
| **cmdb-assistant** | `/cmdb-sync` | | X | Sync machine state with NetBox (detect drift, update) |
|
|
| **cmdb-assistant** | `/cmdb-topology` | | X | Infrastructure topology diagrams (rack, network, site views) |
|
|
| **cmdb-assistant** | `/change-audit` | | X | NetBox audit trail queries with filtering |
|
|
| **cmdb-assistant** | `/ip-conflicts` | | X | Detect IP conflicts and overlapping prefixes |
|
|
| **project-hygiene** | *PostToolUse hook* | X | | Removes temp files, warns about unexpected root files |
|
|
| **data-platform** | `/data-ingest` | | X | Load data from CSV, Parquet, JSON into DataFrame |
|
|
| **data-platform** | `/data-profile` | | X | Generate data profiling report with statistics |
|
|
| **data-platform** | `/data-schema` | | X | Explore database schemas, tables, columns |
|
|
| **data-platform** | `/data-explain` | | X | Explain query execution plan |
|
|
| **data-platform** | `/data-lineage` | | X | Show dbt model lineage and dependencies |
|
|
| **data-platform** | `/data-run` | | X | Run dbt models with validation |
|
|
| **data-platform** | `/lineage-viz` | | X | dbt lineage visualization as Mermaid diagrams |
|
|
| **data-platform** | `/dbt-test` | | X | Formatted dbt test runner with summary and failure details |
|
|
| **data-platform** | `/data-quality` | | X | DataFrame quality checks (nulls, duplicates, types, outliers) |
|
|
| **data-platform** | `/data-setup` | | X | Setup wizard for data-platform MCP servers |
|
|
| **data-platform** | *SessionStart hook* | X | | Checks PostgreSQL connection (non-blocking warning) |
|
|
| **viz-platform** | `/viz-setup` | | X | Setup wizard for viz-platform MCP server |
|
|
| **viz-platform** | `/viz-chart` | | X | Create Plotly charts with theme integration |
|
|
| **viz-platform** | `/viz-dashboard` | | X | Create dashboard layouts with filters and grids |
|
|
| **viz-platform** | `/viz-theme` | | X | Apply existing theme to visualizations |
|
|
| **viz-platform** | `/viz-theme-new` | | X | Create new custom theme with design tokens |
|
|
| **viz-platform** | `/viz-theme-css` | | X | Export theme as CSS custom properties |
|
|
| **viz-platform** | `/viz-component` | | X | Inspect DMC component props and validation |
|
|
| **viz-platform** | `/viz-chart-export` | | X | Export charts to PNG, SVG, PDF via kaleido |
|
|
| **viz-platform** | `/accessibility-check` | | X | Color blind validation (WCAG contrast ratios) |
|
|
| **viz-platform** | `/viz-breakpoints` | | X | Configure responsive layout breakpoints |
|
|
| **viz-platform** | `/design-review` | | X | Detailed design system audits |
|
|
| **viz-platform** | `/design-gate` | | X | Binary pass/fail design system validation gates |
|
|
| **viz-platform** | *SessionStart hook* | X | | Checks DMC version (non-blocking warning) |
|
|
| **data-platform** | `/data-review` | | X | Comprehensive data integrity audits |
|
|
| **data-platform** | `/data-gate` | | X | Binary pass/fail data integrity gates |
|
|
| **contract-validator** | `/validate-contracts` | | X | Full marketplace compatibility validation |
|
|
| **contract-validator** | `/check-agent` | | X | Validate single agent definition |
|
|
| **contract-validator** | `/list-interfaces` | | X | Show all plugin interfaces |
|
|
| **contract-validator** | `/dependency-graph` | | X | Mermaid visualization of plugin dependencies |
|
|
| **contract-validator** | `/cv-setup` | | X | Setup wizard for contract-validator MCP |
|
|
|
|
---
|
|
|
|
## Plugins by Category
|
|
|
|
| Category | Plugins | Primary Use |
|
|
|----------|---------|-------------|
|
|
| **Setup** | projman, pr-review, cmdb-assistant, data-platform, viz-platform, contract-validator | `/pm-setup`, `/pr-setup`, `/cmdb-setup`, `/data-setup`, `/viz-setup`, `/cv-setup` |
|
|
| **Task Planning** | projman, clarity-assist | Sprint management, requirement clarification |
|
|
| **Code Quality** | code-sentinel, pr-review | Security scanning, PR reviews |
|
|
| **Documentation** | doc-guardian, claude-config-maintainer | Doc sync, CLAUDE.md maintenance |
|
|
| **Git Operations** | git-flow | Commits, branches, workflow automation |
|
|
| **Infrastructure** | cmdb-assistant | NetBox CMDB management |
|
|
| **Data Engineering** | data-platform | pandas, PostgreSQL, dbt operations |
|
|
| **Visualization** | viz-platform | DMC validation, Plotly charts, theming |
|
|
| **Validation** | contract-validator | Cross-plugin compatibility checks |
|
|
| **Maintenance** | project-hygiene | Automatic cleanup |
|
|
|
|
---
|
|
|
|
## Hook-Based Automation Summary
|
|
|
|
| Plugin | Hook Event | Behavior |
|
|
|--------|------------|----------|
|
|
| **projman** | SessionStart | Checks git remote vs .env; warns if mismatch detected; suggests sprint planning if issues exist |
|
|
| **pr-review** | SessionStart | Checks git remote vs .env; warns if mismatch detected |
|
|
| **doc-guardian** | PostToolUse (Write/Edit) | Tracks documentation drift; auto-updates dependent docs |
|
|
| **code-sentinel** | PreToolUse (Write/Edit) | Scans for security issues; blocks critical vulnerabilities |
|
|
| **project-hygiene** | PostToolUse (Write/Edit) | Cleans temp files, warns about misplaced files |
|
|
| **data-platform** | SessionStart | Checks PostgreSQL connection; non-blocking warning if unavailable |
|
|
| **viz-platform** | SessionStart | Checks DMC version; non-blocking warning if mismatch detected |
|
|
|
|
---
|
|
|
|
## Dev Workflow Examples
|
|
|
|
### Example 0: RFC-Driven Feature Development
|
|
|
|
Full workflow from idea to implementation using RFCs:
|
|
|
|
```
|
|
1. /clarify # Clarify the feature idea
|
|
2. /rfc create # Create RFC from clarified spec
|
|
... refine RFC content ...
|
|
3. /rfc review 0001 # Submit RFC for review
|
|
... review discussion ...
|
|
4. /rfc approve 0001 # Approve RFC for implementation
|
|
5. /sprint-plan # Select approved RFC for sprint
|
|
... implement feature ...
|
|
6. /sprint-close # Complete sprint, RFC marked Implemented
|
|
```
|
|
|
|
### Example 1: Starting a New Feature Sprint
|
|
|
|
A typical workflow for planning and executing a feature sprint:
|
|
|
|
```
|
|
1. /clarify # Clarify requirements if vague
|
|
2. /sprint-plan # Plan the sprint with architecture analysis
|
|
3. /labels-sync # Ensure labels are up-to-date
|
|
4. /sprint-start # Begin execution with dependency ordering
|
|
5. /branch-start feat/... # Create feature branch
|
|
... implement features ...
|
|
6. /git-commit # Commit with conventional message
|
|
7. /sprint-status --diagram # Check progress with visualization
|
|
8. /pm-review # Pre-close quality review
|
|
9. /pm-test run # Verify test coverage
|
|
10. /sprint-close # Capture lessons learned
|
|
```
|
|
|
|
### Example 2: Daily Development Cycle
|
|
|
|
Quick daily workflow with git-flow:
|
|
|
|
```
|
|
1. /git-status # Check current state
|
|
2. /branch-start fix/... # Start bugfix branch
|
|
... make changes ...
|
|
3. /git-commit # Auto-generate commit message
|
|
4. /git-commit-push # Push to remote
|
|
5. /branch-cleanup # Clean merged branches
|
|
```
|
|
|
|
### Example 3: Pull Request Review Workflow
|
|
|
|
Reviewing a PR before merge:
|
|
|
|
```
|
|
1. /pr-summary # Quick overview of changes
|
|
2. /pr-review # Full multi-agent review
|
|
3. /pr-findings # Filter findings by severity
|
|
4. /security-scan # Deep security audit if needed
|
|
```
|
|
|
|
### Example 4: Documentation Maintenance
|
|
|
|
Keeping docs in sync:
|
|
|
|
```
|
|
1. /doc-audit # Scan for documentation drift
|
|
2. /doc-sync # Apply pending updates
|
|
3. /config-analyze # Check CLAUDE.md health
|
|
4. /config-optimize # Optimize if needed
|
|
```
|
|
|
|
### Example 5: Code Refactoring Session
|
|
|
|
Safe refactoring with preview:
|
|
|
|
```
|
|
1. /refactor-dry # Preview opportunities
|
|
2. /security-scan # Baseline security check
|
|
3. /refactor # Apply improvements
|
|
4. /pm-test run # Verify nothing broke
|
|
5. /git-commit # Commit with descriptive message
|
|
```
|
|
|
|
### Example 6: Infrastructure Documentation
|
|
|
|
Managing infrastructure with CMDB:
|
|
|
|
```
|
|
1. /cmdb-search "server" # Find existing devices
|
|
2. /cmdb-device view X # Check device details
|
|
3. /cmdb-ip list # List available IPs
|
|
4. /cmdb-site view Y # Check site info
|
|
```
|
|
|
|
### Example 6b: Data Engineering Workflow
|
|
|
|
Working with data pipelines:
|
|
|
|
```
|
|
1. /data-ingest file.csv # Load data into DataFrame
|
|
2. /data-profile # Generate data profiling report
|
|
3. /data-schema # Explore database schemas
|
|
4. /data-lineage model_name # View dbt model dependencies
|
|
5. /data-run model_name # Execute dbt models
|
|
6. /data-explain "SELECT ..." # Analyze query execution plan
|
|
```
|
|
|
|
### Example 7: First-Time Setup (New Machine)
|
|
|
|
Setting up the marketplace for the first time:
|
|
|
|
```
|
|
1. /pm-setup --full # Full setup: MCP + system config + project
|
|
# → Follow prompts for Gitea URL, org
|
|
# → Add token manually when prompted
|
|
# → Confirm repository name
|
|
2. # Restart Claude Code session
|
|
3. /labels-sync # Sync Gitea labels
|
|
4. /sprint-plan # Plan first sprint
|
|
```
|
|
|
|
### Example 8: New Project Setup (System Already Configured)
|
|
|
|
Adding a new project when system config exists:
|
|
|
|
```
|
|
1. /pm-setup --quick # Quick project setup (auto-detected)
|
|
# → Confirms detected repo name
|
|
# → Creates .env
|
|
2. /labels-sync # Sync Gitea labels
|
|
3. /sprint-plan # Plan first sprint
|
|
```
|
|
|
|
---
|
|
|
|
## Quick Tips
|
|
|
|
- **Hooks run automatically** - doc-guardian and code-sentinel protect you without manual invocation
|
|
- **Use `/git-commit` over `git commit`** - generates better commit messages following conventions
|
|
- **Run `/pm-review` before `/sprint-close`** - catches issues before closing the sprint
|
|
- **Use `/clarify` for vague requests** - especially helpful for complex requirements
|
|
- **`/refactor-dry` is safe** - always preview before applying refactoring changes
|
|
|
|
---
|
|
|
|
## MCP Server Requirements
|
|
|
|
Some plugins require MCP server connectivity:
|
|
|
|
| Plugin | MCP Server | Purpose |
|
|
|--------|------------|---------|
|
|
| projman | Gitea | Issues, PRs, wiki, labels, milestones |
|
|
| pr-review | Gitea | PR operations and reviews |
|
|
| cmdb-assistant | NetBox | Infrastructure CMDB |
|
|
| data-platform | pandas, PostgreSQL, dbt | DataFrames, database queries, dbt builds |
|
|
| viz-platform | viz-platform | DMC validation, charts, layouts, themes, pages |
|
|
| contract-validator | contract-validator | Plugin interface parsing, compatibility validation |
|
|
|
|
Ensure credentials are configured in `~/.config/claude/gitea.env`, `~/.config/claude/netbox.env`, or `~/.config/claude/postgres.env`.
|
|
|
|
---
|
|
|
|
*Last Updated: 2026-02-02*
|