personal-projects/leo-claude-mktplace
Template
0
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

development #448

Merged
lmiranda merged 10 commits from development into main 2026-02-07 21:46:33 +00:00
Conversation 0 Commits 10 Files Changed 379 +239 -543
8 changed files with 239 additions and 543 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 97362576dc - Show all commits

2
.claude-plugin/marketplace.json
View File

@@ -6,7 +6,7 @@
}, },
"metadata": { "metadata": {
"description": "Project management plugins with Gitea and NetBox integrations", "description": "Project management plugins with Gitea and NetBox integrations",
"version": "9.1.0" "version": "9.1.1"
}, },
"plugins": [ "plugins": [
{ {

12
CHANGELOG.md
View File

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased] ## [Unreleased]
## [9.1.1] - 2026-02-07
### Changed
- README.md fully rewritten — clean structure with plugins grouped by domain, accurate structure tree, all 10 scripts, all 7 docs
- CLAUDE.md structure tree updated to match README (was showing only 12 plugins, 3 scripts, 2 docs)
- doc-guardian `/doc sync` and `sync-workflow.md` updated to remove stale `.doc-guardian-queue` references (queue file deleted in v8.1.0)
### Removed
- `scripts/check-venv.sh` — dead code designed for SessionStart hooks that were never implemented; functionality covered by `setup-venvs.sh`
## [9.1.0] - 2026-02-07 ## [9.1.0] - 2026-02-07
### Added ### Added

93
CLAUDE.md
View File

@@ -154,7 +154,7 @@ When user says "fix the sprint plan command", edit the SOURCE code.
## Project Overview ## Project Overview
**Repository:** leo-claude-mktplace **Repository:** leo-claude-mktplace
**Version:** 9.1.0 **Version:** 9.1.1
**Status:** Production Ready **Status:** Production Ready
A plugin marketplace for Claude Code containing: A plugin marketplace for Claude Code containing:
@@ -231,55 +231,66 @@ These commands are being developed but don't apply to this project's workflow:
``` ```
leo-claude-mktplace/ leo-claude-mktplace/
├── .claude-plugin/ ├── .claude-plugin/ # Marketplace manifest
│ └── marketplace.json # Marketplace manifest │ ├── marketplace.json
│ ├── marketplace-lean.json # Lean profile (6 core plugins)
│ └── marketplace-full.json # Full profile (all plugins)
├── .mcp.json # MCP server configuration (all servers) ├── .mcp.json # MCP server configuration (all servers)
├── mcp-servers/ # SHARED MCP servers ├── mcp-servers/ # SHARED MCP servers
│ ├── gitea/ # Gitea MCP (issues, PRs, wiki) │ ├── gitea/ # Gitea (issues, PRs, wiki)
│ ├── netbox/ # NetBox MCP (CMDB) │ ├── netbox/ # NetBox (DCIM, IPAM)
│ ├── data-platform/ # pandas, PostgreSQL, dbt │ ├── data-platform/ # pandas, PostgreSQL, dbt
│ ├── viz-platform/ # DMC validation, charts, themes │ ├── viz-platform/ # DMC, Plotly, theming
│ └── contract-validator/ # Plugin compatibility validation │ └── contract-validator/ # Plugin compatibility validation
├── plugins/ ├── plugins/ # All plugins (20 total)
│ ├── projman/ # Sprint management │ ├── projman/ # [core] Sprint management
│ │ ├── .claude-plugin/plugin.json │ │ ├── .claude-plugin/plugin.json
│ │ ├── commands/ # 19 commands │ │ ├── commands/ # 19 commands
│ │ ├── agents/ # 4 agents │ │ ├── agents/ # 4 agents
│ │ └── skills/ # 23 reusable skill files │ │ └── skills/ # 23 reusable skill files
│ ├── git-flow/ # Git workflow automation │ ├── git-flow/ # [core] Git workflow automation
│ │ ├── .claude-plugin/plugin.json │ ├── pr-review/ # [core] PR review
│ │ ├── commands/ # 5 commands │ ├── clarity-assist/ # [core] Prompt optimization
│ │ └── agents/ │ ├── doc-guardian/ # [core] Documentation drift detection
│ ├── pr-review/ # Multi-agent PR review │ ├── code-sentinel/ # [core] Security scanning
│ │ ├── .claude-plugin/plugin.json │ ├── claude-config-maintainer/ # [core] CLAUDE.md optimization
│ │ ├── commands/ # 8 commands │ ├── contract-validator/ # [core] Cross-plugin validation
│ │ └── agents/ # 5 agents │ ├── project-hygiene/ # [core] Manual cleanup checks
│ ├── clarity-assist/ # Prompt optimization │ ├── cmdb-assistant/ # [ops] NetBox CMDB integration
│ │ ├── .claude-plugin/plugin.json │ ├── data-platform/ # [data] Data engineering
│ │ ├── commands/ # 2 commands │ ├── viz-platform/ # [data] Visualization
│ │ └── agents/ │ ├── data-seed/ # [data] Test data generation (scaffold)
│ ├── data-platform/ # Data engineering │ ├── saas-api-platform/ # [saas] API scaffolding (scaffold)
│ │ ├── .claude-plugin/plugin.json │ ├── saas-db-migrate/ # [saas] DB migrations (scaffold)
│ │ ├── commands/ # 7 commands │ ├── saas-react-platform/ # [saas] React toolkit (scaffold)
│ │ └── agents/ # 2 agents │ ├── saas-test-pilot/ # [saas] Test automation (scaffold)
│ ├── viz-platform/ # Visualization │ ├── ops-release-manager/ # [ops] Release management (scaffold)
│ │ ├── .claude-plugin/plugin.json │ ├── ops-deploy-pipeline/ # [ops] Deployment pipeline (scaffold)
│ │ ├── commands/ # 7 commands │ └── debug-mcp/ # [debug] MCP debugging (scaffold)
│ │ └── agents/ # 3 agents ├── scripts/ # Setup and maintenance
│ ├── doc-guardian/ # Documentation drift detection │ ├── setup.sh # Initial setup (create venvs, config)
│ ├── code-sentinel/ # Security scanning & refactoring │ ├── post-update.sh # Post-update (clear cache, changelog)
│ ├── claude-config-maintainer/ │ ├── setup-venvs.sh # MCP server venv management (cache-based)
│ ├── cmdb-assistant/
│ ├── contract-validator/
│ └── project-hygiene/
├── scripts/
│ ├── setup.sh, post-update.sh
│ ├── validate-marketplace.sh # Marketplace compliance validation │ ├── validate-marketplace.sh # Marketplace compliance validation
│ ├── verify-hooks.sh # Verify all hooks are command type │ ├── verify-hooks.sh # Hook inventory verification
│ └── check-venv.sh # Check MCP server venvs exist │ ├── release.sh # Release automation with version bumping
└── docs/ │ ├── claude-launch.sh # Profile-based launcher
├── CANONICAL-PATHS.md # Single source of truth for paths │ ├── install-plugin.sh # Install plugin to consumer project
└── CONFIGURATION.md # Centralized configuration guide │ ├── list-installed.sh # Show installed plugins in a project
│ └── uninstall-plugin.sh # Remove plugin from consumer project
├── docs/ # Documentation
│ ├── ARCHITECTURE.md # System architecture & plugin reference
│ ├── CANONICAL-PATHS.md # Authoritative path reference
│ ├── COMMANDS-CHEATSHEET.md # All commands quick reference
│ ├── CONFIGURATION.md # Centralized setup guide
│ ├── DEBUGGING-CHECKLIST.md # Systematic troubleshooting guide
│ ├── MIGRATION-v9.md # v8.x to v9.0.0 migration guide
│ └── UPDATING.md # Update guide
├── CLAUDE.md # Project instructions for Claude Code
├── README.md
├── CHANGELOG.md
├── LICENSE
└── .gitignore
``` ```
## Architecture ## Architecture

593
README.md
View File

@@ -1,10 +1,57 @@
# Leo Claude Marketplace - v9.1.0 # Leo Claude Marketplace — v9.1.1
A collection of Claude Code plugins for project management, infrastructure automation, and development workflows. A plugin marketplace for Claude Code providing sprint management, code review, security scanning, infrastructure automation, and development workflow tools. 20 plugins across 5 domains, backed by 5 shared MCP servers.
## Plugins
### Core (9 plugins — v9.0.1)
| Plugin | Description |
|--------|-------------|
| `projman` | Sprint planning and project management with Gitea integration |
| `git-flow` | Git workflow automation with intelligent commit messages and branch management |
| `pr-review` | Multi-agent pull request review with confidence scoring |
| `code-sentinel` | Security scanning and code refactoring tools |
| `doc-guardian` | Documentation drift detection and synchronization |
| `clarity-assist` | Prompt optimization with ND-friendly accommodations |
| `contract-validator` | Cross-plugin compatibility validation and agent verification |
| `claude-config-maintainer` | CLAUDE.md and settings.local.json optimization |
| `project-hygiene` | Manual project file cleanup checks |
### Data (3 plugins)
| Plugin | Version | Description |
|--------|---------|-------------|
| `data-platform` | 9.0.1 | pandas, PostgreSQL/PostGIS, and dbt integration |
| `viz-platform` | 9.0.1 | Dash Mantine Components validation, Plotly charts, and theming |
| `data-seed` | 0.1.0 — scaffold | Test data generation and database seeding |
### Ops (3 plugins)
| Plugin | Version | Description |
|--------|---------|-------------|
| `cmdb-assistant` | 9.0.1 | NetBox CMDB integration with data quality validation |
| `ops-release-manager` | 0.1.0 — scaffold | Release management with SemVer and changelog automation |
| `ops-deploy-pipeline` | 0.1.0 — scaffold | Deployment pipeline for Docker Compose and systemd |
### SaaS (4 plugins — v0.1.0 scaffolds)
| Plugin | Description |
|--------|-------------|
| `saas-api-platform` | REST/GraphQL API scaffolding for FastAPI and Express |
| `saas-db-migrate` | Database migration management for Alembic, Prisma, raw SQL |
| `saas-react-platform` | React frontend toolkit for Next.js and Vite |
| `saas-test-pilot` | Test automation for pytest, Jest, Vitest, Playwright |
### Debug (1 plugin — v0.1.0 scaffold)
| Plugin | Description |
|--------|-------------|
| `debug-mcp` | MCP server debugging, inspection, and development toolkit |
## Quick Start ## Quick Start
Use the launcher script to load only the plugins you need, reducing token overhead from ~22K to ~4-6K tokens: ### Launch with profiles
```bash ```bash
./scripts/claude-launch.sh [profile] [extra-args...] ./scripts/claude-launch.sh [profile] [extra-args...]
@@ -16,337 +63,98 @@ Use the launcher script to load only the plugins you need, reducing token overhe
| `review` | pr-review, code-sentinel | Lightweight code review | | `review` | pr-review, code-sentinel | Lightweight code review |
| `data` | data-platform, viz-platform | Data engineering and visualization | | `data` | data-platform, viz-platform | Data engineering and visualization |
| `infra` | cmdb-assistant | Infrastructure/CMDB management | | `infra` | cmdb-assistant | Infrastructure/CMDB management |
| `full` | All 20 plugins via marketplace.json | When you need everything | | `full` | All 20 plugins | When you need everything |
**Examples:**
```bash ```bash
./scripts/claude-launch.sh # Default sprint profile ./scripts/claude-launch.sh # Default sprint profile
./scripts/claude-launch.sh data --model opus # Data profile with Opus ./scripts/claude-launch.sh data --model opus # Data profile with Opus
./scripts/claude-launch.sh full # Load all plugins ./scripts/claude-launch.sh full # Load all plugins
``` ```
The script enables `ENABLE_TOOL_SEARCH=true` for MCP lazy loading. ### Common commands
## Plugins ```bash
/sprint plan # Plan a sprint with architecture analysis
### Development & Project Management /sprint start # Begin sprint execution
/gitflow commit --push # Commit with auto-generated message and push
#### [projman](./plugins/projman) /pr review # Full multi-agent PR review
**Sprint Planning and Project Management** /sentinel scan # Security audit
/doc audit # Check for documentation drift
AI-guided sprint planning with full Gitea integration. Transforms a proven 15-sprint workflow into a distributable plugin. /cv status # Marketplace health check
```
- Four-agent model: Planner, Orchestrator, Executor, Code Reviewer
- Plan-then-batch execution: skills loaded once per phase, API calls batched for ~80% token savings ## Repository Structure
- Intelligent label suggestions from 43-label taxonomy
- Lessons learned capture via Gitea Wiki ```
- Native issue dependencies with parallel execution leo-claude-mktplace/
- Milestone management for sprint organization ├── .claude-plugin/ # Marketplace manifest
- Branch-aware security (development/staging/production) │ ├── marketplace.json
- Pre-sprint-close code quality review and test verification │ ├── marketplace-lean.json # Lean profile (6 core plugins)
│ └── marketplace-full.json # Full profile (all plugins)
**Commands:** `/sprint plan`, `/sprint start`, `/sprint status`, `/sprint close`, `/sprint review`, `/sprint test`, `/labels sync`, `/projman setup`, `/projman debug`, `/projman suggest-version`, `/projman proposal-status`, `/rfc create`, `/rfc list`, `/rfc review`, `/rfc approve`, `/rfc reject`, `/project initiation`, `/project plan`, `/project status`, `/project close`, `/adr create`, `/adr list`, `/adr update`, `/adr supersede` ├── mcp-servers/ # Shared MCP servers
│ ├── gitea/ # Gitea (issues, PRs, wiki)
#### [git-flow](./plugins/git-flow) │ ├── netbox/ # NetBox (DCIM, IPAM)
**Git Workflow Automation** │ ├── data-platform/ # pandas, PostgreSQL, dbt
│ ├── viz-platform/ # DMC, Plotly, theming
Smart git operations with intelligent commit messages and branch management. │ └── contract-validator/ # Plugin compatibility validation
├── plugins/ # All plugins (20 total)
- Auto-generated conventional commit messages │ ├── projman/ # [core] Sprint management
- Multiple workflow styles (simple, feature-branch, pr-required, trunk-based) │ ├── git-flow/ # [core] Git workflow automation
- Branch naming enforcement │ ├── pr-review/ # [core] PR review
- Merge and cleanup automation │ ├── clarity-assist/ # [core] Prompt optimization
- Protected branch awareness │ ├── doc-guardian/ # [core] Documentation drift detection
│ ├── code-sentinel/ # [core] Security scanning
**Commands:** `/gitflow commit` (with `--push`, `--merge`, `--sync` flags), `/gitflow branch-start`, `/gitflow branch-cleanup`, `/gitflow status`, `/gitflow config` │ ├── claude-config-maintainer/ # [core] CLAUDE.md optimization
│ ├── contract-validator/ # [core] Cross-plugin validation
#### [pr-review](./plugins/pr-review) │ ├── project-hygiene/ # [core] Manual cleanup checks
**Multi-Agent PR Review** │ ├── cmdb-assistant/ # [ops] NetBox CMDB integration
│ ├── data-platform/ # [data] Data engineering
Comprehensive pull request review using specialized agents. │ ├── viz-platform/ # [data] Visualization
│ ├── data-seed/ # [data] Test data generation (scaffold)
- Multi-agent review: Security, Performance, Maintainability, Tests │ ├── saas-api-platform/ # [saas] API scaffolding (scaffold)
- Confidence scoring (only reports HIGH/MEDIUM confidence findings) │ ├── saas-db-migrate/ # [saas] DB migrations (scaffold)
- Actionable feedback with suggested fixes │ ├── saas-react-platform/ # [saas] React toolkit (scaffold)
- Gitea integration for automated review submission │ ├── saas-test-pilot/ # [saas] Test automation (scaffold)
│ ├── ops-release-manager/ # [ops] Release management (scaffold)
**Commands:** `/pr review`, `/pr summary`, `/pr findings`, `/pr diff`, `/pr setup`, `/pr init`, `/pr sync` │ ├── ops-deploy-pipeline/ # [ops] Deployment pipeline (scaffold)
│ └── debug-mcp/ # [debug] MCP debugging (scaffold)
#### [claude-config-maintainer](./plugins/claude-config-maintainer) ├── scripts/ # Setup and maintenance
**CLAUDE.md and Settings Optimization** │ ├── setup.sh # Initial setup (create venvs, config)
│ ├── post-update.sh # Post-update (clear cache, changelog)
Analyze, optimize, and create CLAUDE.md configuration files. Audit and optimize settings.local.json permissions. │ ├── setup-venvs.sh # MCP server venv management (cache-based)
│ ├── validate-marketplace.sh # Marketplace compliance validation
**Commands:** `/claude-config analyze`, `/claude-config optimize`, `/claude-config init`, `/claude-config diff`, `/claude-config lint`, `/claude-config audit-settings`, `/claude-config optimize-settings`, `/claude-config permissions-map` │ ├── verify-hooks.sh # Hook inventory verification
│ ├── release.sh # Release automation with version bumping
#### [contract-validator](./plugins/contract-validator) │ ├── claude-launch.sh # Profile-based launcher
**Cross-Plugin Compatibility Validation** │ ├── install-plugin.sh # Install plugin to consumer project
│ ├── list-installed.sh # Show installed plugins in a project
Validate plugin marketplaces for command conflicts, tool overlaps, and broken agent references. │ └── uninstall-plugin.sh # Remove plugin from consumer project
├── docs/ # Documentation
- Interface parsing from plugin README.md files │ ├── ARCHITECTURE.md # System architecture & plugin reference
- Agent extraction from CLAUDE.md definitions │ ├── CANONICAL-PATHS.md # Authoritative path reference
- Pairwise compatibility checks between all plugins │ ├── COMMANDS-CHEATSHEET.md # All commands quick reference
- Data flow validation for agent sequences │ ├── CONFIGURATION.md # Centralized setup guide
- Markdown or JSON reports with actionable suggestions │ ├── DEBUGGING-CHECKLIST.md # Systematic troubleshooting guide
│ ├── MIGRATION-v9.md # v8.x to v9.0.0 migration guide
**Commands:** `/cv validate`, `/cv check-agent`, `/cv list-interfaces`, `/cv dependency-graph`, `/cv setup` │ └── UPDATING.md # Update guide
├── CLAUDE.md # Project instructions for Claude Code
### Productivity ├── README.md
├── CHANGELOG.md
#### [clarity-assist](./plugins/clarity-assist) ├── LICENSE
**Prompt Optimization with ND Accommodations** └── .gitignore
```
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:** `/clarity clarify`, `/clarity quick-clarify`
#### [doc-guardian](./plugins/doc-guardian)
**Documentation Lifecycle Management**
Automatic documentation drift detection and synchronization.
**Commands:** `/doc audit`, `/doc sync`, `/doc changelog-gen`, `/doc coverage`, `/doc stale-docs`
#### [project-hygiene](./plugins/project-hygiene)
**Manual Project Hygiene Checks**
Project file organization and cleanup checks — temp files, misplaced files, empty dirs, debug artifacts.
**Commands:** `/hygiene check` (with `--fix` flag for auto-fix)
### Security
#### [code-sentinel](./plugins/code-sentinel)
**Security Scanning & Refactoring**
Security vulnerability detection and code refactoring tools.
**Commands:** `/sentinel scan`, `/sentinel refactor`, `/sentinel refactor-dry`
### Infrastructure
#### [cmdb-assistant](./plugins/cmdb-assistant)
**NetBox CMDB Integration**
Full CRUD operations for network infrastructure management directly from Claude Code.
**Commands:** `/cmdb setup`, `/cmdb search`, `/cmdb device`, `/cmdb ip`, `/cmdb site`, `/cmdb audit`, `/cmdb register`, `/cmdb sync`, `/cmdb topology`, `/cmdb change-audit`, `/cmdb ip-conflicts`
### Data Engineering
#### [data-platform](./plugins/data-platform)
**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:** `/data ingest`, `/data profile`, `/data schema`, `/data explain`, `/data lineage`, `/data lineage-viz`, `/data run`, `/data dbt-test`, `/data quality`, `/data review`, `/data gate`, `/data setup`
### Visualization
#### [viz-platform](./plugins/viz-platform)
**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:** `/viz chart`, `/viz chart-export`, `/viz dashboard`, `/viz theme`, `/viz theme-new`, `/viz theme-css`, `/viz component`, `/viz accessibility-check`, `/viz breakpoints`, `/viz design-review`, `/viz design-gate`, `/viz setup`
#### [data-seed](./plugins/data-seed)
**Test Data Generation and Database Seeding**
Relationship-aware test data generation with reusable seed profiles.
- Schema inference from existing databases
- Faker-based data generation with locale support
- Foreign key relationship resolution
- Reusable seed profiles for consistent test environments
**Commands:** `/seed setup`, `/seed generate`, `/seed profile`, `/seed validate`, `/seed apply`
### SaaS Development
#### [saas-api-platform](./plugins/saas-api-platform)
**REST and GraphQL API Scaffolding**
API development toolkit for FastAPI and Express projects with OpenAPI integration.
- Framework-aware scaffolding (FastAPI, Express)
- OpenAPI spec generation and validation
- Middleware catalog with authentication, CORS, rate limiting
- Route pattern enforcement and test generation
**Commands:** `/api setup`, `/api scaffold`, `/api validate`, `/api docs`, `/api middleware`, `/api test-routes`
#### [saas-db-migrate](./plugins/saas-db-migrate)
**Database Migration Management**
Migration toolkit for Alembic, Prisma, and raw SQL with safety validation.
- ORM/tool auto-detection
- Migration safety analysis (data loss, locks, rollback)
- Execution planning with rollback strategies
- Migration history tracking
**Commands:** `/db-migrate setup`, `/db-migrate generate`, `/db-migrate validate`, `/db-migrate plan`, `/db-migrate history`, `/db-migrate rollback`
#### [saas-react-platform](./plugins/saas-react-platform)
**React Frontend Development Toolkit**
Component scaffolding, routing, and state management for Next.js and Vite projects.
- Framework detection (Next.js App Router/Pages, Vite, CRA, Remix)
- TypeScript-first component generation with co-located tests
- State management pattern selection (Context, Zustand, Redux Toolkit)
- Anti-pattern detection and component tree analysis
**Commands:** `/react setup`, `/react component`, `/react route`, `/react state`, `/react hook`, `/react lint`
#### [saas-test-pilot](./plugins/saas-test-pilot)
**Test Automation Toolkit**
Test generation and coverage analysis for pytest, Jest, Vitest, and Playwright.
- Framework auto-detection and configuration
- Test case generation from code analysis
- Coverage gap detection with risk prioritization
- E2E test scenario generation from user stories
**Commands:** `/test setup`, `/test generate`, `/test coverage`, `/test fixtures`, `/test e2e`, `/test run`
### Operations
#### [ops-release-manager](./plugins/ops-release-manager)
**Release Management Automation**
Semantic versioning, changelog generation, and tag management.
- Version location auto-detection across manifests
- Conventional commit-based bump suggestions
- Keep a Changelog format automation
- Release branch/tag creation and rollback
**Commands:** `/release setup`, `/release prepare`, `/release validate`, `/release tag`, `/release rollback`, `/release status`
#### [ops-deploy-pipeline](./plugins/ops-deploy-pipeline)
**Deployment Pipeline Management**
CI/CD for Docker Compose and systemd-based services on self-hosted infrastructure.
- Docker Compose configuration generation
- Caddy reverse proxy patterns
- Environment-specific config management
- Pre-deployment health checks and rollback planning
**Commands:** `/deploy setup`, `/deploy generate`, `/deploy validate`, `/deploy env`, `/deploy check`, `/deploy rollback`
### Debugging
#### [debug-mcp](./plugins/debug-mcp)
**MCP Server Debugging Toolkit**
Diagnostic tools for MCP server health, testing, and development.
- MCP server health status dashboard
- Individual tool call testing
- Server log analysis with error pattern recognition
- MCP server scaffold generation
**Commands:** `/debug-mcp status`, `/debug-mcp test`, `/debug-mcp logs`, `/debug-mcp inspect`, `/debug-mcp scaffold`
## 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 (`/viz 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 | `/viz design-gate` |
| Data | data-platform | `/data gate` |
## MCP Servers ## MCP Servers
MCP servers are **shared at repository root** and configured in `.mcp.json`. All MCP servers are shared at repository root and configured in `.mcp.json`.
### Gitea MCP Server (shared) | Server | Used By | External System |
|--------|---------|-----------------|
Full Gitea API integration for project management. | gitea | projman, pr-review | Gitea (issues, PRs, wiki, milestones) |
| netbox | cmdb-assistant | NetBox (DCIM, IPAM) |
| Category | Tools | | data-platform | data-platform | PostgreSQL, dbt |
|----------|-------| | viz-platform | viz-platform | DMC component registry |
| Issues | `list_issues`, `get_issue`, `create_issue`, `update_issue`, `add_comment`, `aggregate_issues` | | contract-validator | contract-validator | Internal validation |
| 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` |
| 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)
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)
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)
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 ## Installation
@@ -356,16 +164,14 @@ Cross-plugin compatibility validation tools.
- Python 3.10+ - Python 3.10+
- Access to target services (Gitea, NetBox as needed) - Access to target services (Gitea, NetBox as needed)
### Add Marketplace to Claude Code ### Add marketplace to Claude Code
**Option 1 - CLI command (recommended):**
```bash ```bash
/plugin marketplace add https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git /plugin marketplace add https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git
``` ```
**Option 2 - Settings file (for team distribution):** Or add to `.claude/settings.json`:
Add to `.claude/settings.json` in your target project:
```json ```json
{ {
"extraKnownMarketplaces": { "extraKnownMarketplaces": {
@@ -379,136 +185,55 @@ Add to `.claude/settings.json` in your target project:
} }
``` ```
### Run Interactive Setup ### Setup MCP servers
After installing plugins, run the setup wizard: After installing, create Python venvs for MCP servers:
```bash
cd ~/.claude/plugins/marketplaces/leo-claude-mktplace && ./scripts/setup.sh
```
Then restart Claude Code and run the interactive setup:
``` ```
/projman setup /projman setup
``` ```
The wizard handles everything: See [CONFIGURATION.md](./docs/CONFIGURATION.md) for manual setup and advanced options.
- 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): ### Install to consumer projects
```
/pr init
```
**After moving a repository:** ```bash
``` ./scripts/install-plugin.sh <plugin-name> /path/to/project
/pr sync ./scripts/list-installed.sh /path/to/project
``` ./scripts/uninstall-plugin.sh <plugin-name> /path/to/project
See [docs/CONFIGURATION.md](./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:**
1. **Check installed plugins list:**
```
/plugin list
```
Look for `✔ plugin-name · Installed`
2. **Test a plugin command directly:**
```
/git-flow:git-status
/projman:sprint-status
/clarity-assist:clarify
```
If the command executes and shows output, the plugin is working.
3. **Check for loading errors:**
```
/plugin list
```
Look for any `Plugin Loading Errors` section - this indicates manifest issues.
**Command format:** All plugin commands use the format `/plugin-name:command-name`
| Plugin | Test Command |
|--------|--------------|
| git-flow | `/git-flow:gitflow-status` |
| projman | `/projman:sprint-status` |
| pr-review | `/pr-review:pr-summary` |
| clarity-assist | `/clarity-assist:clarity-clarify` |
| doc-guardian | `/doc-guardian:doc-audit` |
| code-sentinel | `/code-sentinel:sentinel-scan` |
| claude-config-maintainer | `/claude-config-maintainer:claude-config-analyze` |
| cmdb-assistant | `/cmdb-assistant:cmdb-search` |
| data-platform | `/data-platform:data-ingest` |
| viz-platform | `/viz-platform:viz-chart` |
| contract-validator | `/contract-validator:cv-validate` |
## 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 (20 total)
│ ├── projman/ # Sprint management
│ ├── git-flow/ # Git workflow automation
│ ├── pr-review/ # PR review
│ ├── clarity-assist/ # Prompt optimization
│ ├── doc-guardian/ # Documentation drift detection
│ ├── code-sentinel/ # Security scanning
│ ├── claude-config-maintainer/ # CLAUDE.md optimization
│ ├── contract-validator/ # Cross-plugin validation
│ ├── project-hygiene/ # Manual cleanup checks
│ ├── cmdb-assistant/ # NetBox CMDB integration
│ ├── data-platform/ # Data engineering
│ ├── viz-platform/ # Visualization
│ ├── data-seed/ # Test data generation (scaffold)
│ ├── saas-api-platform/ # API scaffolding (scaffold)
│ ├── saas-db-migrate/ # DB migrations (scaffold)
│ ├── saas-react-platform/ # React toolkit (scaffold)
│ ├── saas-test-pilot/ # Test automation (scaffold)
│ ├── ops-release-manager/ # Release management (scaffold)
│ ├── ops-deploy-pipeline/ # Deployment pipeline (scaffold)
│ └── debug-mcp/ # MCP debugging (scaffold)
├── docs/ # Documentation
│ ├── ARCHITECTURE.md # System architecture & plugin reference
│ ├── CANONICAL-PATHS.md # Path reference
│ ├── CONFIGURATION.md # Setup guide
│ └── MIGRATION-v9.md # v8→v9 migration guide
├── scripts/ # Setup scripts
└── CHANGELOG.md # Version history
``` ```
## Documentation ## Documentation
| Document | Description | | Document | Description |
|----------|-------------| |----------|-------------|
| [CLAUDE.md](./CLAUDE.md) | Main project instructions | | [CLAUDE.md](./CLAUDE.md) | Project instructions for Claude Code |
| [ARCHITECTURE.md](./docs/ARCHITECTURE.md) | System architecture and plugin reference | | [ARCHITECTURE.md](./docs/ARCHITECTURE.md) | System architecture and plugin reference |
| [CONFIGURATION.md](./docs/CONFIGURATION.md) | Centralized setup guide |
| [COMMANDS-CHEATSHEET.md](./docs/COMMANDS-CHEATSHEET.md) | All commands quick reference | | [COMMANDS-CHEATSHEET.md](./docs/COMMANDS-CHEATSHEET.md) | All commands quick reference |
| [UPDATING.md](./docs/UPDATING.md) | Update guide for the marketplace | | [CONFIGURATION.md](./docs/CONFIGURATION.md) | Centralized setup guide |
| [CANONICAL-PATHS.md](./docs/CANONICAL-PATHS.md) | Authoritative path reference |
| [DEBUGGING-CHECKLIST.md](./docs/DEBUGGING-CHECKLIST.md) | Systematic troubleshooting guide | | [DEBUGGING-CHECKLIST.md](./docs/DEBUGGING-CHECKLIST.md) | Systematic troubleshooting guide |
| [UPDATING.md](./docs/UPDATING.md) | Update guide for the marketplace |
| [MIGRATION-v9.md](./docs/MIGRATION-v9.md) | v8.x to v9.0.0 migration guide | | [MIGRATION-v9.md](./docs/MIGRATION-v9.md) | v8.x to v9.0.0 migration guide |
| [CANONICAL-PATHS.md](./docs/CANONICAL-PATHS.md) | Authoritative path reference |
| [CHANGELOG.md](./CHANGELOG.md) | Version history | | [CHANGELOG.md](./CHANGELOG.md) | Version history |
## Validation
```bash
./scripts/validate-marketplace.sh # Marketplace compliance (manifests, domains, paths)
./scripts/verify-hooks.sh # Hook inventory (4 PreToolUse + 1 UserPromptSubmit)
```
## License ## License
MIT License MIT License
## Support ## Support
- **Issues**: Contact repository maintainer - **Repository**: https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git
- **Repository**: `https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git`

8
docs/CANONICAL-PATHS.md
View File

@@ -195,12 +195,14 @@ leo-claude-mktplace/
├── scripts/ # Setup and maintenance scripts ├── scripts/ # Setup and maintenance scripts
│ ├── setup.sh # Initial setup (create venvs, config templates) │ ├── setup.sh # Initial setup (create venvs, config templates)
│ ├── post-update.sh # Post-update (clear cache, show changelog) │ ├── post-update.sh # Post-update (clear cache, show changelog)
│ ├── check-venv.sh # Check if venvs exist (read-only) │ ├── setup-venvs.sh # Setup MCP server venvs (create only, never delete)
│ ├── validate-marketplace.sh # Marketplace compliance validation │ ├── validate-marketplace.sh # Marketplace compliance validation
│ ├── verify-hooks.sh # Verify all hooks use correct event types │ ├── verify-hooks.sh # Verify all hooks use correct event types
│ ├── setup-venvs.sh # Setup MCP server venvs (create only, never delete)
│ ├── release.sh # Release automation with version bumping │ ├── release.sh # Release automation with version bumping
│ └── claude-launch.sh # Task-specific launcher with profile selection │ ├── claude-launch.sh # Task-specific launcher with profile selection
│ ├── install-plugin.sh # Install plugin to consumer project
│ ├── list-installed.sh # Show installed plugins in a project
│ └── uninstall-plugin.sh # Remove plugin from consumer project
├── CLAUDE.md ├── CLAUDE.md
├── README.md ├── README.md
├── LICENSE ├── LICENSE

11
plugins/doc-guardian/commands/doc-sync.md
View File

@@ -22,11 +22,11 @@ Apply all pending documentation updates detected by `/doc audit`.
## Process ## Process
1. **Review Pending Queue** 1. **Detect Drift**
Execute `skills/sync-workflow.md` - read `.doc-guardian-queue` Run `/doc audit` first (or use its most recent results) to identify documentation that is out of sync with code.
2. **Batch Updates** 2. **Batch Updates**
For each pending item: For each drift item:
- Show the specific change needed - Show the specific change needed
- Apply the update - Apply the update
- Track in change list - Track in change list
@@ -36,8 +36,5 @@ Apply all pending documentation updates detected by `/doc audit`.
- Single commit: `docs: sync documentation with code changes` - Single commit: `docs: sync documentation with code changes`
- Include summary in commit body - Include summary in commit body
4. **Clear Queue** 4. **Output**
After successful sync, clear the queue file
5. **Output**
Use format from `skills/sync-workflow.md` Use format from `skills/sync-workflow.md`

26
plugins/doc-guardian/skills/sync-workflow.md
View File

@@ -16,20 +16,11 @@ Defines how to synchronize documentation with code changes.
--- ---
## Queue File ## Drift Detection
Location: `.doc-guardian-queue` in project root Run `/doc audit` to detect documentation drift. The audit produces a list of files and changes that need synchronization. Use those results as input to the sync process below.
Format: > **Note:** The queue file (`.doc-guardian-queue`) was removed in v8.1.0 when the PostToolUse hook was deleted (Decision #29). Drift detection is now manual via `/doc audit`.
```
# Doc Guardian Queue
# Generated: YYYY-MM-DD HH:MM:SS
## Pending Updates
- README.md:45 | reference | calculate_total -> compute_total
- CLAUDE.md:23 | version | Python 3.9 -> 3.11
- src/api/README.md:12 | path | old/path.py -> new/path.py
```
--- ---
@@ -55,9 +46,9 @@ Format:
## Sync Process ## Sync Process
1. **Review Queue** 1. **Review Drift Results**
- Read `.doc-guardian-queue` - Use output from `/doc audit`
- List all pending items - List all items needing sync
2. **Batch Updates** 2. **Batch Updates**
- Apply each update - Apply each update
@@ -68,11 +59,6 @@ Format:
- Single commit: `docs: sync documentation with code changes` - Single commit: `docs: sync documentation with code changes`
- Include summary in commit body - Include summary in commit body
4. **Clear Queue**
```bash
echo "# Doc Guardian Queue - cleared after sync on $(date +%Y-%m-%d)" > .doc-guardian-queue
```
--- ---
## Output Format ## Output Format

37
scripts/check-venv.sh
View File

@@ -1,37 +0,0 @@
#!/usr/bin/env bash
#
# check-venv.sh - Check if MCP server venvs exist in installed marketplace
#
# Usage: ./scripts/check-venv.sh
#
# Exit codes:
# 0 - All venvs exist (or not installed via marketplace)
# 1 - Venvs missing, needs setup
#
# This script is designed to be called from SessionStart hooks
# to enable self-healing MCP server setup.
set -euo pipefail
# Installed marketplace location
MKTPLACE="$HOME/.claude/plugins/marketplaces/leo-claude-mktplace"
# If not installed via marketplace, exit silently
if [[ ! -d "$MKTPLACE" ]]; then
exit 0
fi
# Check if gitea venv exists
if [[ ! -f "$MKTPLACE/mcp-servers/gitea/.venv/bin/python" ]]; then
echo "SETUP_NEEDED"
exit 1
fi
# Check if netbox venv exists
if [[ ! -f "$MKTPLACE/mcp-servers/netbox/.venv/bin/python" ]]; then
echo "SETUP_NEEDED"
exit 1
fi
# All good
exit 0