leo-claude-mktplace/docs/COMMANDS-CHEATSHEET.md

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	/review		X	Pre-sprint-close code quality review (debug artifacts, security, error handling)
projman	/test		X	Run tests (/test run) or generate tests (/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	/setup		X	Auto-detect mode or use --full, --quick, --sync
projman	SessionStart hook	X		Detects git remote vs .env mismatch, warns to run /setup --sync
projman	/debug		X	Diagnostics (/debug report) or investigate (/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	/clear-cache		X	Clear plugin cache to force fresh configuration reload
projman	/rfc-create		X	Create new RFC from conversation or clarified spec
projman	/rfc-list		X	List all RFCs grouped by status
projman	/rfc-review		X	Submit Draft RFC for review
projman	/rfc-approve		X	Approve RFC in Review status for sprint planning
projman	/rfc-reject		X	Reject RFC with documented reason
git-flow	/commit		X	Create commit with auto-generated conventional message
git-flow	/commit-push		X	Commit and push to remote in one operation
git-flow	/commit-merge		X	Commit current changes, then merge into target branch
git-flow	/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	/initial-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
cmdb-assistant	/initial-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	/ingest		X	Load data from CSV, Parquet, JSON into DataFrame
data-platform	/profile		X	Generate data profiling report with statistics
data-platform	/schema		X	Explore database schemas, tables, columns
data-platform	/explain		X	Explain query execution plan
data-platform	/lineage		X	Show dbt model lineage and dependencies
data-platform	/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	/initial-setup		X	Setup wizard for data-platform MCP servers
data-platform	SessionStart hook	X		Checks PostgreSQL connection (non-blocking warning)
viz-platform	/initial-setup		X	Setup wizard for viz-platform MCP server
viz-platform	/chart		X	Create Plotly charts with theme integration
viz-platform	/dashboard		X	Create dashboard layouts with filters and grids
viz-platform	/theme		X	Apply existing theme to visualizations
viz-platform	/theme-new		X	Create new custom theme with design tokens
viz-platform	/theme-css		X	Export theme as CSS custom properties
viz-platform	/component		X	Inspect DMC component props and validation
viz-platform	/chart-export		X	Export charts to PNG, SVG, PDF via kaleido
viz-platform	/accessibility-check		X	Color blind validation (WCAG contrast ratios)
viz-platform	/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	/initial-setup		X	Setup wizard for contract-validator MCP

---

Plugins by Category

Category	Plugins	Primary Use
Setup	projman, pr-review, cmdb-assistant, data-platform	/setup, /initial-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. /commit                   # Commit with conventional message
7. /sprint-status --diagram  # Check progress with visualization
8. /review                   # Pre-close quality review
9. /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. /commit                   # Auto-generate commit message
4. /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. /test run                 # Verify nothing broke
5. /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. /ingest file.csv          # Load data into DataFrame
2. /profile                  # Generate data profiling report
3. /schema                   # Explore database schemas
4. /lineage model_name       # View dbt model dependencies
5. /run model_name           # Execute dbt models
6. /explain "SELECT ..."     # Analyze query execution plan

Example 7: First-Time Setup (New Machine)

Setting up the marketplace for the first time:

1. /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. /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 /commit over git commit - generates better commit messages following conventions
• Run /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