Files
leo-claude-mktplace/plugins/projman/commands/projman-setup.md
lmiranda 2d51df7a42 feat(marketplace): command consolidation + 8 new plugins (v8.1.0 → v9.0.0) [BREAKING]
Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action>
sub-command pattern. Git-flow consolidated from 8→5 commands (commit
variants absorbed into --push/--merge/--sync flags). Dispatch files,
name: frontmatter, and cross-reference updates for all plugins.

Phase 2: Design documents for 8 new plugins in docs/designs/.

Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate,
saas-react-platform, saas-test-pilot, data-seed, ops-release-manager,
ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents,
skills, README, and claude-md-integration. Marketplace grows from 12→20.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 14:52:11 -05:00

3.0 KiB

name, description
name description
projman setup Configure projman - full setup, quick project init, or sync after repo move

Projman Setup

Skills Required

  • skills/mcp-tools-reference.md
  • skills/repo-validation.md
  • skills/setup-workflows.md

Purpose

Unified setup command for all configuration needs.

Important:

  • Uses Bash, Read, Write, AskUserQuestion - NOT MCP tools
  • MCP tools won't work until after setup + session restart
  • Tokens must be entered manually for security

Invocation

/projman setup              # Auto-detect appropriate mode
/projman setup --full       # Full wizard (MCP + system + project)
/projman setup --quick      # Project-only setup
/projman setup --sync       # Update after repo move
/projman setup --clear-cache # Clear plugin cache (between sessions only)

Mode Detection

If no argument provided, auto-detect:

  1. Check ~/.config/claude/gitea.env

    • Missing → full mode
  2. Check project .env

    • Missing → quick mode
  3. Compare .env with git remote

    • Mismatch → sync mode
    • Match → offer reconfigure or exit

Mode: Full

Execute skills/setup-workflows.md → Full Setup Workflow

Phases:

  1. Environment validation (Python 3.10+)
  2. MCP server setup (venv + requirements)
  3. System-level config (~/.config/claude/gitea.env)
  4. Project-level config (.env)
  5. Final validation

Mode: Quick

Execute skills/setup-workflows.md → Quick Setup Workflow

Steps:

  1. Verify system config exists
  2. Verify git repository
  3. Check existing .env
  4. Detect org/repo from git remote
  5. Validate via API
  6. Create/update .env
  7. Check .gitignore

Mode: Sync

Execute skills/setup-workflows.md → Sync Workflow

Steps:

  1. Read current config
  2. Detect git remote
  3. Compare values
  4. Show changes
  5. Validate new values
  6. Update .env
  7. Confirm

Mode: Clear Cache (--clear-cache)

Clear plugin cache to force fresh configuration reload.

WARNING: Only run between sessions, never mid-session. Clearing cache mid-session destroys MCP tool venv paths and breaks all MCP operations.

Steps:

  1. Execute: rm -rf ~/.claude/plugins/cache/leo-claude-mktplace/
  2. Inform user: "Cache cleared. Restart Claude Code for changes to take effect."

When to use:

  • After updating the marketplace (git pull or reinstall)
  • When MCP servers show stale configuration
  • When plugin changes don't take effect

Visual Output

╔══════════════════════════════════════════════════════════════════╗
║  📋 PROJMAN                                                      ║
║  ⚙️ SETUP                                                        ║
║  [Mode: Full | Quick | Sync]                                     ║
╚══════════════════════════════════════════════════════════════════╝