personal-projects/leo-claude-mktplace
Template
0
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f4e62dd1fbf9f8111e3c5fbb6e082e0cdccd5d25
leo-claude-mktplace/docs/ARCHITECTURE.md
lmiranda a169399da7 docs(marketplace): documentation cleanup, version alignment, architecture doc 
- Delete orphan files (.doc-guardian-queue, stale backup, switch-profile.sh)
- Delete stale doc folders (architecture/, designs/, prompts/)
- Create consolidated docs/ARCHITECTURE.md for v9.1.0
- Bump all 12 original plugin versions to 9.0.1
- Fix project-hygiene descriptions (no longer a hook)
- Normalize /rfc, /project, /adr command rows in all docs
- Update CANONICAL-PATHS.md, UPDATING.md, README.md, CLAUDE.md
- COMMANDS-CHEATSHEET.md expanded to one row per sub-command

Version: 9.1.0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 16:16:18 -05:00

6.7 KiB
Raw Blame History

Architecture — Leo Claude Marketplace v9.1.0

Overview

Plugin marketplace for Claude Code. 20 plugins across 5 domains, 5 shared MCP servers, 4 PreToolUse safety hooks + 1 UserPromptSubmit quality hook.

System Architecture

Plugin Domains

Domain Purpose Plugins
core Development workflow projman, git-flow, pr-review, code-sentinel, doc-guardian, clarity-assist, contract-validator, claude-config-maintainer, project-hygiene
data Data engineering data-platform, viz-platform, data-seed
saas SaaS development saas-api-platform, saas-db-migrate, saas-react-platform, saas-test-pilot
ops Operations cmdb-assistant, ops-release-manager, ops-deploy-pipeline
debug Diagnostics debug-mcp

MCP Servers (Shared at Root)

Server Plugins Using It External System
gitea projman, pr-review Gitea (issues, PRs, wiki)
netbox cmdb-assistant NetBox (DCIM, IPAM)
data-platform data-platform PostgreSQL, dbt
viz-platform viz-platform DMC registry
contract-validator contract-validator (internal validation)

Hook Architecture

Plugin Event Trigger Script
code-sentinel PreToolUse Write|Edit|MultiEdit security-check.sh
git-flow PreToolUse Bash (branch naming) branch-check.sh
git-flow PreToolUse Bash (git commit) commit-msg-check.sh
cmdb-assistant PreToolUse MCP create/update validate-input.sh
clarity-assist UserPromptSubmit All prompts vagueness-check.sh

No other hook types permitted. All workflow automation is via explicit commands.

Agent Model (projman)

Agent Model Permission Mode Role
Planner opus default Sprint planning, architecture analysis, issue creation
Orchestrator sonnet acceptEdits Sprint execution, parallel batching, lesson capture
Executor sonnet bypassPermissions Code implementation, branch management
Code Reviewer opus default Pre-close quality review, security, tests

Config Hierarchy

Level Location Contains
System ~/.config/claude/{service}.env Credentials
Project .env in project root Repo-specific config

Branch Security

Pattern Access
development, feat/, fix/ Full
staging, stage/* Read-only code, can create issues
main, master, prod/* READ-ONLY. Emergency only.

Launch Profiles

Profile Plugins
sprint projman, git-flow, pr-review, code-sentinel, doc-guardian, clarity-assist
data data-platform, viz-platform, data-seed
saas saas-api-platform, saas-react-platform, saas-db-migrate, saas-test-pilot
ops cmdb-assistant, ops-release-manager, ops-deploy-pipeline
review pr-review, code-sentinel
debug debug-mcp
full all plugins

Plugin Reference

Core Domain

projman (v9.0.1)

Sprint planning and project management with Gitea integration.

  • Commands: /sprint (plan|start|status|close|review|test), /project (initiation|plan|status|close), /adr (create|list|update|supersede), /rfc (create|list|review|approve|reject), /labels sync, /projman setup
  • Agents: planner, orchestrator, executor, code-reviewer
  • MCP: gitea

git-flow (v9.0.1)

Git workflow automation with smart commits and branch management.

  • Commands: /gitflow (commit|branch-start|branch-cleanup|status|config)
  • Commit flags: --push, --merge, --sync
  • Agents: git-assistant
  • Hooks: PreToolUse (branch-check.sh, commit-msg-check.sh)

pr-review (v9.0.1)

Multi-agent PR review with confidence scoring.

  • Commands: /pr (review|summary|findings|diff|setup|init|sync)
  • Agents: coordinator, security-reviewer, performance-analyst, maintainability-auditor, test-validator
  • MCP: gitea

code-sentinel (v9.0.1)

Security scanning and code refactoring.

  • Commands: /sentinel (scan|refactor|refactor-dry)
  • Agents: security-reviewer, refactor-advisor
  • Hooks: PreToolUse (security-check.sh)

doc-guardian (v9.0.1)

Documentation drift detection and synchronization.

  • Commands: /doc (audit|sync|changelog-gen|coverage|stale-docs)
  • Agents: doc-analyzer

clarity-assist (v9.0.1)

Prompt optimization with ND-friendly accommodations.

  • Commands: /clarity (clarify|quick-clarify)
  • Agents: clarity-coach
  • Hooks: UserPromptSubmit (vagueness-check.sh)

contract-validator (v9.0.1)

Cross-plugin compatibility validation.

  • Commands: /cv (validate|check-agent|list-interfaces|dependency-graph|setup|status)
  • Agents: full-validation, agent-check
  • MCP: contract-validator

claude-config-maintainer (v9.0.1)

CLAUDE.md and settings optimization.

  • Commands: /claude-config (analyze|optimize|init|diff|lint|audit-settings|optimize-settings|permissions-map)
  • Agents: maintainer

project-hygiene (v9.0.1)

Manual project file cleanup checks.

  • Commands: /hygiene check (--fix flag for auto-fix)

Data Domain

data-platform (v9.0.1)

pandas, PostgreSQL, and dbt integration.

  • Commands: /data (ingest|profile|schema|explain|lineage|lineage-viz|run|dbt-test|quality|review|gate|setup)
  • Agents: data-advisor, data-analysis, data-ingestion
  • MCP: data-platform

viz-platform (v9.0.1)

DMC validation, Plotly charts, and theming.

  • Commands: /viz (setup|chart|chart-export|dashboard|theme|theme-new|theme-css|component|accessibility-check|breakpoints|design-review|design-gate)
  • Agents: design-reviewer, layout-builder, component-check, theme-setup
  • MCP: viz-platform

data-seed (v0.1.0)

Test data generation and database seeding. Scaffold — not yet implemented.

SaaS Domain

saas-api-platform (v0.1.0)

REST/GraphQL API scaffolding for FastAPI and Express. Scaffold.

saas-db-migrate (v0.1.0)

Database migration management for Alembic, Prisma, raw SQL. Scaffold.

saas-react-platform (v0.1.0)

React frontend toolkit for Next.js and Vite. Scaffold.

saas-test-pilot (v0.1.0)

Test automation for pytest, Jest, Vitest, Playwright. Scaffold.

Ops Domain

cmdb-assistant (v9.0.1)

NetBox CMDB integration for infrastructure management.

  • Commands: /cmdb (search|device|ip|site|audit|register|sync|topology|change-audit|ip-conflicts|setup)
  • Agents: cmdb-assistant
  • MCP: netbox
  • Hooks: PreToolUse (validate-input.sh)

ops-release-manager (v0.1.0)

Release management with SemVer and changelog automation. Scaffold.

ops-deploy-pipeline (v0.1.0)

Deployment pipeline for Docker Compose and systemd. Scaffold.

Debug Domain

debug-mcp (v0.1.0)

MCP server debugging and diagnostics. Scaffold.

Reference in New Issue View Git Blame Copy Permalink