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
projman	/sprint-status		X	Check current sprint progress and identify blockers
projman	/review		X	Pre-sprint-close code quality review (debug artifacts, security, error handling)
projman	/test-check		X	Run tests and verify coverage before sprint close
projman	/sprint-close		X	Complete sprint and capture lessons learned to Gitea Wiki
projman	/labels-sync		X	Synchronize label taxonomy from Gitea
projman	/initial-setup		X	Full setup wizard: MCP server + system config + project config
projman	/project-init		X	Quick project setup (assumes system config exists)
projman	/project-sync		X	Sync config with git remote after repo move/rename
projman	SessionStart hook	X		Detects git remote vs .env mismatch, warns to run /project-sync
projman	/test-gen		X	Generate comprehensive tests for specified code
projman	/debug-report		X	Run diagnostics and create structured issue in marketplace
projman	/debug-review		X	Investigate diagnostic issues and propose fixes with approval gates
projman	/suggest-version		X	Analyze CHANGELOG and recommend semantic version bump
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
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	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
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
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	/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	SessionStart hook	X		Checks DMC version (non-blocking warning)

---

Plugins by Category

Category	Plugins	Primary Use
Setup	projman, pr-review, cmdb-assistant, data-platform	/initial-setup, /project-init
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
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 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            # Check progress mid-sprint
8. /review                   # Pre-close quality review
9. /test-check               # 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-check               # 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. /initial-setup            # 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. /project-init             # Quick project setup
   # → 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

Ensure credentials are configured in ~/.config/claude/gitea.env, ~/.config/claude/netbox.env, or ~/.config/claude/postgres.env.

---

Last Updated: 2026-01-26