Startup hooks in data-platform and pr-review were checking for venvs at the marketplace path (~/.claude/plugins/marketplaces/.../mcp-servers/) which gets wiped on updates. The actual venvs live in the cache directory (~/.cache/claude-mcp-venvs/) which survives updates. This caused false "MCP venv missing" errors even when venvs existed, wasting hours of debugging time. Fixed hooks now check cache path first, matching the pattern used by run.sh scripts. Also updated docs/CANONICAL-PATHS.md with the correct venv path pattern to prevent future occurrences. Lesson learned: lessons/patterns/startup-hooks-must-check-venv-cache-path-first Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Leo Claude Marketplace - v5.8.0
A collection of Claude Code plugins for project management, infrastructure automation, and development workflows.
Plugins
Development & Project Management
projman
Sprint Planning and Project Management
AI-guided sprint planning with full Gitea integration. Transforms a proven 15-sprint workflow into a distributable plugin.
- Four-agent model: Planner, Orchestrator, Executor, Code Reviewer
- Intelligent label suggestions from 43-label taxonomy
- Lessons learned capture via Gitea Wiki
- Native issue dependencies with parallel execution
- Milestone management for sprint organization
- Branch-aware security (development/staging/production)
- Pre-sprint-close code quality review and test verification
Commands: /sprint-plan, /sprint-start, /sprint-status, /sprint-close, /labels-sync, /setup, /review, /test, /debug, /suggest-version, /proposal-status, /rfc
git-flow NEW in v3.0.0
Git Workflow Automation
Smart git operations with intelligent commit messages and branch management.
- Auto-generated conventional commit messages
- Multiple workflow styles (simple, feature-branch, pr-required, trunk-based)
- Branch naming enforcement
- Merge and cleanup automation
- Protected branch awareness
Commands: /commit, /commit-push, /commit-merge, /commit-sync, /branch-start, /branch-cleanup, /git-status, /git-config
pr-review NEW in v3.0.0
Multi-Agent PR Review
Comprehensive pull request review using specialized agents.
- Multi-agent review: Security, Performance, Maintainability, Tests
- Confidence scoring (only reports HIGH/MEDIUM confidence findings)
- Actionable feedback with suggested fixes
- Gitea integration for automated review submission
Commands: /pr-review, /pr-summary, /pr-findings, /pr-diff, /initial-setup, /project-init, /project-sync
claude-config-maintainer
CLAUDE.md and Settings Optimization
Analyze, optimize, and create CLAUDE.md configuration files. Audit and optimize settings.local.json permissions.
Commands: /analyze, /optimize, /init, /config-diff, /config-lint, /config-audit-settings, /config-optimize-settings, /config-permissions-map
contract-validator NEW in v5.0.0
Cross-Plugin Compatibility Validation
Validate plugin marketplaces for command conflicts, tool overlaps, and broken agent references.
- Interface parsing from plugin README.md files
- Agent extraction from CLAUDE.md definitions
- Pairwise compatibility checks between all plugins
- Data flow validation for agent sequences
- Markdown or JSON reports with actionable suggestions
Commands: /validate-contracts, /check-agent, /list-interfaces, /dependency-graph, /initial-setup
Productivity
clarity-assist NEW in v3.0.0
Prompt Optimization with ND Accommodations
Transform vague requests into clear specifications using structured methodology.
- 4-D methodology: Deconstruct, Diagnose, Develop, Deliver
- ND-friendly question patterns (option-based, chunked)
- Conflict detection and escalation protocols
Commands: /clarify, /quick-clarify
doc-guardian
Documentation Lifecycle Management
Automatic documentation drift detection and synchronization.
Commands: /doc-audit, /doc-sync, /changelog-gen, /doc-coverage, /stale-docs
project-hygiene
Post-Task Cleanup Automation
Hook-based cleanup that runs after Claude completes work.
Security
code-sentinel
Security Scanning & Refactoring
Security vulnerability detection and code refactoring tools.
Commands: /security-scan, /refactor, /refactor-dry
Infrastructure
cmdb-assistant
NetBox CMDB Integration
Full CRUD operations for network infrastructure management directly from Claude Code.
Commands: /initial-setup, /cmdb-search, /cmdb-device, /cmdb-ip, /cmdb-site, /cmdb-audit, /cmdb-register, /cmdb-sync, /cmdb-topology, /change-audit, /ip-conflicts
Data Engineering
data-platform NEW in v4.0.0
pandas, PostgreSQL/PostGIS, and dbt Integration
Comprehensive data engineering toolkit with persistent DataFrame storage.
- 14 pandas tools with Arrow IPC data_ref system
- 10 PostgreSQL/PostGIS tools with connection pooling
- 8 dbt tools with automatic pre-validation
- 100k row limit with chunking support
- Auto-detection of dbt projects
Commands: /ingest, /profile, /schema, /explain, /lineage, /lineage-viz, /run, /dbt-test, /data-quality, /data-review, /data-gate, /initial-setup
Visualization
viz-platform NEW in v4.0.0
Dash Mantine Components Validation and Theming
Visualization toolkit with version-locked component validation and design token theming.
- 3 DMC tools with static JSON registry (prevents prop hallucination)
- 2 Chart tools with Plotly and theme integration
- 5 Layout tools for dashboard composition
- 6 Theme tools with design token system
- 5 Page tools for multi-page app structure
- Dual theme storage: user-level and project-level
Commands: /chart, /chart-export, /dashboard, /theme, /theme-new, /theme-css, /component, /accessibility-check, /breakpoints, /design-review, /design-gate, /initial-setup
Domain Advisory Pattern
The marketplace supports cross-plugin domain advisory integration:
- Domain Detection: projman automatically detects when issues involve specialized domains (frontend/viz, data engineering)
- Acceptance Criteria: Domain-specific acceptance criteria are added to issues during planning
- Execution Gates: Domain validation gates (
/design-gate,/data-gate) run before issue completion - Extensible: New domains can be added by creating advisory agents and gate commands
Current Domains:
| Domain | Plugin | Gate Command |
|---|---|---|
| Visualization | viz-platform | /design-gate |
| Data | data-platform | /data-gate |
MCP Servers
MCP servers are shared at repository root and configured in .mcp.json.
Gitea MCP Server (shared)
Full Gitea API integration for project management.
| Category | Tools |
|---|---|
| Issues | list_issues, get_issue, create_issue, update_issue, add_comment, aggregate_issues |
| Labels | get_labels, suggest_labels, create_label, create_label_smart |
| Wiki | list_wiki_pages, get_wiki_page, create_wiki_page, update_wiki_page, create_lesson, search_lessons |
| Milestones | list_milestones, get_milestone, create_milestone, update_milestone, delete_milestone |
| Dependencies | list_issue_dependencies, create_issue_dependency, remove_issue_dependency, get_execution_order |
| Pull Requests | list_pull_requests, get_pull_request, get_pr_diff, get_pr_comments, create_pr_review, add_pr_comment (NEW in v3.0.0) |
| Validation | validate_repo_org, get_branch_protection |
NetBox MCP Server (shared)
Comprehensive NetBox REST API integration for infrastructure management.
| Module | Coverage |
|---|---|
| DCIM | Sites, Racks, Devices, Interfaces, Cables |
| IPAM | Prefixes, IPs, VLANs, VRFs |
| Circuits | Providers, Circuits, Terminations |
| Virtualization | Clusters, VMs, Interfaces |
| Extras | Tags, Custom Fields, Audit Log |
Data Platform MCP Server (shared) NEW in v4.0.0
pandas, PostgreSQL/PostGIS, and dbt integration for data engineering.
| Category | Tools |
|---|---|
| pandas | read_csv, read_parquet, read_json, to_csv, to_parquet, describe, head, tail, filter, select, groupby, join, list_data, drop_data |
| PostgreSQL | pg_connect, pg_query, pg_execute, pg_tables, pg_columns, pg_schemas |
| PostGIS | st_tables, st_geometry_type, st_srid, st_extent |
| dbt | dbt_parse, dbt_run, dbt_test, dbt_build, dbt_compile, dbt_ls, dbt_docs_generate, dbt_lineage |
Viz Platform MCP Server (shared) NEW in v4.0.0
Dash Mantine Components validation and visualization tools.
| Category | Tools |
|---|---|
| DMC | list_components, get_component_props, validate_component |
| Chart | chart_create, chart_configure_interaction |
| Layout | layout_create, layout_add_filter, layout_set_grid, layout_get, layout_add_section |
| Theme | theme_create, theme_extend, theme_validate, theme_export_css, theme_list, theme_activate |
| Page | page_create, page_add_navbar, page_set_auth, page_list, page_get_app_config |
Contract Validator MCP Server (shared) NEW in v5.0.0
Cross-plugin compatibility validation tools.
| Category | Tools |
|---|---|
| Parse | parse_plugin_interface, parse_claude_md_agents |
| Validation | validate_compatibility, validate_agent_refs, validate_data_flow, validate_workflow_integration |
| Report | generate_compatibility_report, list_issues |
Installation
Prerequisites
- Claude Code installed
- Python 3.10+
- Access to target services (Gitea, NetBox as needed)
Add Marketplace to Claude Code
Option 1 - CLI command (recommended):
/plugin marketplace add https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git
Option 2 - Settings file (for team distribution):
Add to .claude/settings.json in your target project:
{
"extraKnownMarketplaces": {
"leo-claude-mktplace": {
"source": {
"source": "git",
"url": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git"
}
}
}
}
Run Interactive Setup
After installing plugins, run the setup wizard:
/initial-setup
The wizard handles everything:
- Sets up MCP server (Python venv + dependencies)
- Creates system config (
~/.config/claude/gitea.env) - Guides you through adding your API token
- Detects and validates your repository via API
- Creates project config (
.env)
For new projects (when system is already configured):
/project-init
After moving a repository:
/project-sync
See docs/CONFIGURATION.md for manual setup and advanced options.
Verifying Plugin Installation
After installing plugins, the /plugin command may show (no content) - this is normal Claude Code behavior and doesn't indicate an error.
To verify a plugin is installed correctly:
-
Check installed plugins list:
/plugin listLook for
✔ plugin-name · Installed -
Test a plugin command directly:
/git-flow:git-status /projman:sprint-status /clarity-assist:clarifyIf the command executes and shows output, the plugin is working.
-
Check for loading errors:
/plugin listLook for any
Plugin Loading Errorssection - this indicates manifest issues.
Command format: All plugin commands use the format /plugin-name:command-name
| Plugin | Test Command |
|---|---|
| git-flow | /git-flow:git-status |
| projman | /projman:sprint-status |
| pr-review | /pr-review:pr-summary |
| clarity-assist | /clarity-assist:clarify |
| doc-guardian | /doc-guardian:doc-audit |
| code-sentinel | /code-sentinel:security-scan |
| claude-config-maintainer | /claude-config-maintainer:analyze |
| cmdb-assistant | /cmdb-assistant:cmdb-search |
| data-platform | /data-platform:ingest |
| viz-platform | /viz-platform:chart |
| contract-validator | /contract-validator:validate-contracts |
Repository Structure
leo-claude-mktplace/
├── .claude-plugin/ # Marketplace manifest
│ └── marketplace.json
├── mcp-servers/ # SHARED MCP servers (v3.0.0+)
│ ├── gitea/ # Gitea MCP (issues, PRs, wiki)
│ ├── netbox/ # NetBox MCP (CMDB)
│ ├── data-platform/ # Data engineering (pandas, PostgreSQL, dbt)
│ ├── viz-platform/ # Visualization (DMC, Plotly, theming)
│ └── contract-validator/ # Cross-plugin validation (v5.0.0)
├── plugins/ # All plugins
│ ├── projman/ # Sprint management
│ ├── git-flow/ # Git workflow automation
│ ├── pr-review/ # PR review
│ ├── clarity-assist/ # Prompt optimization
│ ├── data-platform/ # Data engineering
│ ├── viz-platform/ # Visualization
│ ├── contract-validator/ # Cross-plugin validation (NEW)
│ ├── claude-config-maintainer/ # CLAUDE.md optimization
│ ├── cmdb-assistant/ # NetBox CMDB integration
│ ├── doc-guardian/ # Documentation drift detection
│ ├── code-sentinel/ # Security scanning
│ └── project-hygiene/ # Cleanup automation
├── docs/ # Documentation
│ ├── CANONICAL-PATHS.md # Path reference
│ └── CONFIGURATION.md # Setup guide
├── scripts/ # Setup scripts
└── CHANGELOG.md # Version history
Documentation
| Document | Description |
|---|---|
| CLAUDE.md | Main project instructions |
| CONFIGURATION.md | Centralized setup guide |
| COMMANDS-CHEATSHEET.md | All commands quick reference |
| UPDATING.md | Update guide for the marketplace |
| CANONICAL-PATHS.md | Authoritative path reference |
| DEBUGGING-CHECKLIST.md | Systematic troubleshooting guide |
| CHANGELOG.md | Version history |
License
MIT License
Support
- Issues: Contact repository maintainer
- Repository:
https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git