From a04a3c7a605cac8bbe09a3a4ea695ad77537a021 Mon Sep 17 00:00:00 2001 From: lmiranda Date: Tue, 3 Feb 2026 21:19:59 -0500 Subject: [PATCH] docs: update all cross-cutting documentation for v7.0.0 namespace rename Updated: - docs/COMMANDS-CHEATSHEET.md - command reference table + all workflow examples - docs/CONFIGURATION.md - setup commands + plugin config table - README.md - all plugin command lists - CLAUDE.md - command reference tables Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 18 ++++---- README.md | 20 ++++---- docs/COMMANDS-CHEATSHEET.md | 92 ++++++++++++++++++------------------- docs/CONFIGURATION.md | 46 +++++++++---------- 4 files changed, 88 insertions(+), 88 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 9c5d590..c336a61 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -129,7 +129,7 @@ These plugins exist in source but are **NOT relevant** to this project's workflo | **viz-platform** | For dashboard projects (Dash, Plotly) | | **cmdb-assistant** | For infrastructure projects (NetBox) | -**Do NOT suggest** `/ingest`, `/profile`, `/chart`, `/cmdb-*` commands - they don't apply here. +**Do NOT suggest** `/data-ingest`, `/data-profile`, `/viz-chart`, `/cmdb-*` commands - they don't apply here. ### Key Distinction @@ -180,16 +180,16 @@ A plugin marketplace for Claude Code containing: | Category | Commands | |----------|----------| -| **Setup** | `/setup` (modes: `--full`, `--quick`, `--sync`) | +| **Setup** | `/pm-setup` (modes: `--full`, `--quick`, `--sync`) | | **Sprint** | `/sprint-plan`, `/sprint-start`, `/sprint-status` (with `--diagram`), `/sprint-close` | -| **Quality** | `/review`, `/test` (modes: `run`, `gen`) | +| **Quality** | `/pm-review`, `/pm-test` (modes: `run`, `gen`) | | **Versioning** | `/suggest-version` | | **PR Review** | `/pr-review`, `/pr-summary`, `/pr-findings`, `/pr-diff` | | **Docs** | `/doc-audit`, `/doc-sync`, `/changelog-gen`, `/doc-coverage`, `/stale-docs` | | **Security** | `/security-scan`, `/refactor`, `/refactor-dry` | | **Config** | `/config-analyze`, `/config-optimize`, `/config-diff`, `/config-lint` | | **Validation** | `/validate-contracts`, `/check-agent`, `/list-interfaces`, `/dependency-graph` | -| **Debug** | `/debug` (modes: `report`, `review`) | +| **Debug** | `/pm-debug` (modes: `report`, `review`) | ### Plugin Commands - NOT RELEVANT to This Project @@ -197,8 +197,8 @@ These commands are being developed but don't apply to this project's workflow: | Category | Commands | For Projects Using | |----------|----------|-------------------| -| **Data** | `/ingest`, `/profile`, `/schema`, `/lineage`, `/dbt-test` | pandas, PostgreSQL, dbt | -| **Visualization** | `/component`, `/chart`, `/dashboard`, `/theme` | Dash, Plotly dashboards | +| **Data** | `/data-ingest`, `/data-profile`, `/data-schema`, `/data-lineage`, `/dbt-test` | pandas, PostgreSQL, dbt | +| **Visualization** | `/viz-component`, `/viz-chart`, `/viz-dashboard`, `/viz-theme` | Dash, Plotly dashboards | | **CMDB** | `/cmdb-search`, `/cmdb-device`, `/cmdb-sync` | NetBox infrastructure | ## Repository Structure @@ -449,12 +449,12 @@ See `docs/DEBUGGING-CHECKLIST.md` for systematic troubleshooting. | Symptom | Likely Cause | Fix | |---------|--------------|-----| | "X MCP servers failed" | Missing venv in installed path | `cd ~/.claude/plugins/marketplaces/leo-claude-mktplace && ./scripts/setup.sh` | -| MCP tools not available | Venv missing or .mcp.json misconfigured | Run `/debug report` to diagnose | +| MCP tools not available | Venv missing or .mcp.json misconfigured | Run `/pm-debug report` to diagnose | | Changes not taking effect | Editing source, not installed | Reinstall plugin or edit installed path | **Debug Commands:** -- `/debug report` - Run full diagnostics, create issue if needed -- `/debug review` - Investigate and propose fixes +- `/pm-debug report` - Run full diagnostics, create issue if needed +- `/pm-debug review` - Investigate and propose fixes ## Versioning Workflow diff --git a/README.md b/README.md index cb75402..3a850d4 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ AI-guided sprint planning with full Gitea integration. Transforms a proven 15-sp - 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` +**Commands:** `/sprint-plan`, `/sprint-start`, `/sprint-status`, `/sprint-close`, `/labels-sync`, `/pm-setup`, `/pm-review`, `/pm-test`, `/pm-debug`, `/suggest-version`, `/proposal-status`, `/rfc` #### [git-flow](./plugins/git-flow) *NEW in v3.0.0* **Git Workflow Automation** @@ -33,7 +33,7 @@ Smart git operations with intelligent commit messages and branch management. - Merge and cleanup automation - Protected branch awareness -**Commands:** `/commit`, `/commit-push`, `/commit-merge`, `/commit-sync`, `/branch-start`, `/branch-cleanup`, `/git-status`, `/git-config` +**Commands:** `/git-commit`, `/git-commit-push`, `/git-commit-merge`, `/git-commit-sync`, `/branch-start`, `/branch-cleanup`, `/git-status`, `/git-config` #### [pr-review](./plugins/pr-review) *NEW in v3.0.0* **Multi-Agent PR Review** @@ -45,7 +45,7 @@ Comprehensive pull request review using specialized agents. - 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` +**Commands:** `/pr-review`, `/pr-summary`, `/pr-findings`, `/pr-diff`, `/pr-setup`, `/project-init`, `/project-sync` #### [claude-config-maintainer](./plugins/claude-config-maintainer) **CLAUDE.md and Settings Optimization** @@ -65,7 +65,7 @@ Validate plugin marketplaces for command conflicts, tool overlaps, and broken ag - Data flow validation for agent sequences - Markdown or JSON reports with actionable suggestions -**Commands:** `/validate-contracts`, `/check-agent`, `/list-interfaces`, `/dependency-graph`, `/initial-setup` +**Commands:** `/validate-contracts`, `/check-agent`, `/list-interfaces`, `/dependency-graph`, `/cv-setup` ### Productivity @@ -108,7 +108,7 @@ Security vulnerability detection and code refactoring tools. 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` +**Commands:** `/cmdb-setup`, `/cmdb-search`, `/cmdb-device`, `/cmdb-ip`, `/cmdb-site`, `/cmdb-audit`, `/cmdb-register`, `/cmdb-sync`, `/cmdb-topology`, `/change-audit`, `/ip-conflicts` ### Data Engineering @@ -123,7 +123,7 @@ Comprehensive data engineering toolkit with persistent DataFrame storage. - 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` +**Commands:** `/data-ingest`, `/data-profile`, `/data-schema`, `/data-explain`, `/data-lineage`, `/lineage-viz`, `/data-run`, `/dbt-test`, `/data-quality`, `/data-review`, `/data-gate`, `/data-setup` ### Visualization @@ -139,7 +139,7 @@ Visualization toolkit with version-locked component validation and design token - 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` +**Commands:** `/viz-chart`, `/viz-chart-export`, `/viz-dashboard`, `/viz-theme`, `/viz-theme-new`, `/viz-theme-css`, `/viz-component`, `/accessibility-check`, `/viz-breakpoints`, `/design-review`, `/design-gate`, `/viz-setup` ## Domain Advisory Pattern @@ -255,7 +255,7 @@ Add to `.claude/settings.json` in your target project: After installing plugins, run the setup wizard: ``` -/initial-setup +/pm-setup ``` The wizard handles everything: @@ -315,8 +315,8 @@ After installing plugins, the `/plugin` command may show `(no content)` - this i | 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` | +| data-platform | `/data-platform:data-ingest` | +| viz-platform | `/viz-platform:viz-chart` | | contract-validator | `/contract-validator:validate-contracts` | ## Repository Structure diff --git a/docs/COMMANDS-CHEATSHEET.md b/docs/COMMANDS-CHEATSHEET.md index 4a892f1..b42212a 100644 --- a/docs/COMMANDS-CHEATSHEET.md +++ b/docs/COMMANDS-CHEATSHEET.md @@ -11,25 +11,25 @@ Quick reference for all commands in the Leo Claude Marketplace. | **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 (requires approval or `--force`) | | **projman** | `/sprint-status` | | X | Check current sprint progress (add `--diagram` for Mermaid visualization) | -| **projman** | `/review` | | X | Pre-sprint-close code quality review (debug artifacts, security, error handling) | -| **projman** | `/test` | | X | Run tests (`/test run`) or generate tests (`/test gen `) | +| **projman** | `/pm-review` | | X | Pre-sprint-close code quality review (debug artifacts, security, error handling) | +| **projman** | `/pm-test` | | X | Run tests (`/pm-test run`) or generate tests (`/pm-test gen `) | | **projman** | `/sprint-close` | | X | Complete sprint and capture lessons learned to Gitea Wiki | | **projman** | `/labels-sync` | | X | Synchronize label taxonomy from Gitea | -| **projman** | `/setup` | | X | Auto-detect mode or use `--full`, `--quick`, `--sync`, `--clear-cache` | -| **projman** | *SessionStart hook* | X | | Detects git remote vs .env mismatch, warns to run `/setup --sync` | -| **projman** | `/debug` | | X | Diagnostics (`/debug report`) or investigate (`/debug review`) | +| **projman** | `/pm-setup` | | X | Auto-detect mode or use `--full`, `--quick`, `--sync`, `--clear-cache` | +| **projman** | *SessionStart hook* | X | | Detects git remote vs .env mismatch, warns to run `/pm-setup --sync` | +| **projman** | `/pm-debug` | | X | Diagnostics (`/pm-debug report`) or investigate (`/pm-debug review`) | | **projman** | `/suggest-version` | | X | Analyze CHANGELOG and recommend semantic version bump | | **projman** | `/proposal-status` | | X | View proposal and implementation hierarchy with status | | **projman** | `/rfc` | | X | RFC lifecycle management (`/rfc create\|list\|review\|approve\|reject`) | -| **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** | `/git-commit` | | X | Create commit with auto-generated conventional message | +| **git-flow** | `/git-commit-push` | | X | Commit and push to remote in one operation | +| **git-flow** | `/git-commit-merge` | | X | Commit current changes, then merge into target branch | +| **git-flow** | `/git-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** | `/pr-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 | @@ -57,7 +57,7 @@ Quick reference for all commands in the Leo Claude Marketplace. | **claude-config-maintainer** | `/config-audit-settings` | | X | Audit settings.local.json permissions (100-point score) | | **claude-config-maintainer** | `/config-optimize-settings` | | X | Optimize permissions (profiles, consolidation, dry-run) | | **claude-config-maintainer** | `/config-permissions-map` | | X | Visual review layer + permission coverage map | -| **cmdb-assistant** | `/initial-setup` | | X | Setup wizard for NetBox MCP server | +| **cmdb-assistant** | `/cmdb-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 | @@ -69,27 +69,27 @@ Quick reference for all commands in the Leo Claude Marketplace. | **cmdb-assistant** | `/change-audit` | | X | NetBox audit trail queries with filtering | | **cmdb-assistant** | `/ip-conflicts` | | X | Detect IP conflicts and overlapping prefixes | | **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** | `/data-ingest` | | X | Load data from CSV, Parquet, JSON into DataFrame | +| **data-platform** | `/data-profile` | | X | Generate data profiling report with statistics | +| **data-platform** | `/data-schema` | | X | Explore database schemas, tables, columns | +| **data-platform** | `/data-explain` | | X | Explain query execution plan | +| **data-platform** | `/data-lineage` | | X | Show dbt model lineage and dependencies | +| **data-platform** | `/data-run` | | X | Run dbt models with validation | | **data-platform** | `/lineage-viz` | | X | dbt lineage visualization as Mermaid diagrams | | **data-platform** | `/dbt-test` | | X | Formatted dbt test runner with summary and failure details | | **data-platform** | `/data-quality` | | X | DataFrame quality checks (nulls, duplicates, types, outliers) | -| **data-platform** | `/initial-setup` | | X | Setup wizard for data-platform MCP servers | +| **data-platform** | `/data-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** | `/chart-export` | | X | Export charts to PNG, SVG, PDF via kaleido | +| **viz-platform** | `/viz-setup` | | X | Setup wizard for viz-platform MCP server | +| **viz-platform** | `/viz-chart` | | X | Create Plotly charts with theme integration | +| **viz-platform** | `/viz-dashboard` | | X | Create dashboard layouts with filters and grids | +| **viz-platform** | `/viz-theme` | | X | Apply existing theme to visualizations | +| **viz-platform** | `/viz-theme-new` | | X | Create new custom theme with design tokens | +| **viz-platform** | `/viz-theme-css` | | X | Export theme as CSS custom properties | +| **viz-platform** | `/viz-component` | | X | Inspect DMC component props and validation | +| **viz-platform** | `/viz-chart-export` | | X | Export charts to PNG, SVG, PDF via kaleido | | **viz-platform** | `/accessibility-check` | | X | Color blind validation (WCAG contrast ratios) | -| **viz-platform** | `/breakpoints` | | X | Configure responsive layout breakpoints | +| **viz-platform** | `/viz-breakpoints` | | X | Configure responsive layout breakpoints | | **viz-platform** | `/design-review` | | X | Detailed design system audits | | **viz-platform** | `/design-gate` | | X | Binary pass/fail design system validation gates | | **viz-platform** | *SessionStart hook* | X | | Checks DMC version (non-blocking warning) | @@ -99,7 +99,7 @@ Quick reference for all commands in the Leo Claude Marketplace. | **contract-validator** | `/check-agent` | | X | Validate single agent definition | | **contract-validator** | `/list-interfaces` | | X | Show all plugin interfaces | | **contract-validator** | `/dependency-graph` | | X | Mermaid visualization of plugin dependencies | -| **contract-validator** | `/initial-setup` | | X | Setup wizard for contract-validator MCP | +| **contract-validator** | `/cv-setup` | | X | Setup wizard for contract-validator MCP | --- @@ -107,7 +107,7 @@ Quick reference for all commands in the Leo Claude Marketplace. | Category | Plugins | Primary Use | |----------|---------|-------------| -| **Setup** | projman, pr-review, cmdb-assistant, data-platform | `/setup`, `/initial-setup` | +| **Setup** | projman, pr-review, cmdb-assistant, data-platform, viz-platform, contract-validator | `/pm-setup`, `/pr-setup`, `/cmdb-setup`, `/data-setup`, `/viz-setup`, `/cv-setup` | | **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 | @@ -163,10 +163,10 @@ A typical workflow for planning and executing a feature sprint: 4. /sprint-start # Begin execution with dependency ordering 5. /branch-start feat/... # Create feature branch ... implement features ... -6. /commit # Commit with conventional message +6. /git-commit # Commit with conventional message 7. /sprint-status --diagram # Check progress with visualization -8. /review # Pre-close quality review -9. /test run # Verify test coverage +8. /pm-review # Pre-close quality review +9. /pm-test run # Verify test coverage 10. /sprint-close # Capture lessons learned ``` @@ -178,8 +178,8 @@ 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 +3. /git-commit # Auto-generate commit message +4. /git-commit-push # Push to remote 5. /branch-cleanup # Clean merged branches ``` @@ -213,8 +213,8 @@ Safe refactoring with preview: 1. /refactor-dry # Preview opportunities 2. /security-scan # Baseline security check 3. /refactor # Apply improvements -4. /test run # Verify nothing broke -5. /commit # Commit with descriptive message +4. /pm-test run # Verify nothing broke +5. /git-commit # Commit with descriptive message ``` ### Example 6: Infrastructure Documentation @@ -233,12 +233,12 @@ Managing infrastructure with CMDB: 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 +1. /data-ingest file.csv # Load data into DataFrame +2. /data-profile # Generate data profiling report +3. /data-schema # Explore database schemas +4. /data-lineage model_name # View dbt model dependencies +5. /data-run model_name # Execute dbt models +6. /data-explain "SELECT ..." # Analyze query execution plan ``` ### Example 7: First-Time Setup (New Machine) @@ -246,7 +246,7 @@ Working with data pipelines: Setting up the marketplace for the first time: ``` -1. /setup --full # Full setup: MCP + system config + project +1. /pm-setup --full # Full setup: MCP + system config + project # → Follow prompts for Gitea URL, org # → Add token manually when prompted # → Confirm repository name @@ -260,7 +260,7 @@ Setting up the marketplace for the first time: Adding a new project when system config exists: ``` -1. /setup --quick # Quick project setup (auto-detected) +1. /pm-setup --quick # Quick project setup (auto-detected) # → Confirms detected repo name # → Creates .env 2. /labels-sync # Sync Gitea labels @@ -272,8 +272,8 @@ Adding a new project when system config exists: ## 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 `/git-commit` over `git commit`** - generates better commit messages following conventions +- **Run `/pm-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 diff --git a/docs/CONFIGURATION.md b/docs/CONFIGURATION.md index 398a825..4ef59c3 100644 --- a/docs/CONFIGURATION.md +++ b/docs/CONFIGURATION.md @@ -9,7 +9,7 @@ Centralized configuration documentation for all plugins and MCP servers in the L **After installing the marketplace and plugins via Claude Code:** ``` -/setup +/pm-setup ``` The interactive wizard auto-detects what's needed and handles everything except manually adding your API tokens. @@ -25,8 +25,8 @@ The interactive wizard auto-detects what's needed and handles everything except └─────────────────────────────────────────────────────────────────────────────┘ │ ▼ - /setup --full - (or /setup auto-detects) + /pm-setup --full + (or /pm-setup auto-detects) │ ┌──────────────────────────────┼──────────────────────────────┐ ▼ ▼ ▼ @@ -79,7 +79,7 @@ The interactive wizard auto-detects what's needed and handles everything except │ ┌───────────────┴───────────────┐ ▼ ▼ - /setup --quick /setup + /pm-setup --quick /pm-setup (explicit mode) (auto-detects mode) │ │ │ ┌──────────┴──────────┐ @@ -109,7 +109,7 @@ The interactive wizard auto-detects what's needed and handles everything except ## What Runs Automatically vs User Interaction -### `/setup --full` - Full Setup +### `/pm-setup --full` - Full Setup | Phase | Type | What Happens | |-------|------|--------------| @@ -121,7 +121,7 @@ The interactive wizard auto-detects what's needed and handles everything except | **6. Project Config** | Automated | Creates `.env` file, checks `.gitignore` | | **7. Validation** | Automated | Tests API connectivity, shows summary | -### `/setup --quick` - Quick Project Setup +### `/pm-setup --quick` - Quick Project Setup | Phase | Type | What Happens | |-------|------|--------------| @@ -136,10 +136,10 @@ The interactive wizard auto-detects what's needed and handles everything except | Mode | When to Use | What It Does | |------|-------------|--------------| -| `/setup` | Any time | Auto-detects: runs full, quick, or sync as needed | -| `/setup --full` | First time on a machine | Full setup: MCP server + system config + project config | -| `/setup --quick` | Starting a new project | Quick setup: project config only (assumes system is ready) | -| `/setup --sync` | After repo move/rename | Updates .env to match current git remote | +| `/pm-setup` | Any time | Auto-detects: runs full, quick, or sync as needed | +| `/pm-setup --full` | First time on a machine | Full setup: MCP server + system config + project config | +| `/pm-setup --quick` | Starting a new project | Quick setup: project config only (assumes system is ready) | +| `/pm-setup --sync` | After repo move/rename | Updates .env to match current git remote | **Auto-detection logic:** 1. No system config → **full** mode @@ -148,9 +148,9 @@ The interactive wizard auto-detects what's needed and handles everything except 4. Both exist, match → already configured, offer to reconfigure **Typical workflow:** -1. Install plugin → run `/setup` (auto-runs full mode) -2. Start new project → run `/setup` (auto-runs quick mode) -3. Repository moved? → run `/setup` (auto-runs sync mode) +1. Install plugin → run `/pm-setup` (auto-runs full mode) +2. Start new project → run `/pm-setup` (auto-runs quick mode) +3. Repository moved? → run `/pm-setup` (auto-runs sync mode) --- @@ -213,7 +213,7 @@ Before running `/setup`: Run the setup wizard in Claude Code: ``` -/setup +/pm-setup ``` The wizard will guide you through each step interactively and auto-detect the appropriate mode. @@ -387,18 +387,18 @@ PR_REVIEW_AUTO_SUBMIT=false | Plugin | System Config | Project Config | Setup Command | |--------|---------------|----------------|---------------| -| **projman** | gitea.env | .env (GITEA_REPO=owner/repo) | `/setup` | -| **pr-review** | gitea.env | .env (GITEA_REPO=owner/repo) | `/initial-setup` | +| **projman** | gitea.env | .env (GITEA_REPO=owner/repo) | `/pm-setup` | +| **pr-review** | gitea.env | .env (GITEA_REPO=owner/repo) | `/pr-setup` | | **git-flow** | git-flow.env (optional) | .env (optional) | None needed | | **clarity-assist** | None | None | None needed | -| **cmdb-assistant** | netbox.env | None | `/initial-setup` | -| **data-platform** | postgres.env | .env (optional) | `/initial-setup` | -| **viz-platform** | None | .env (optional DMC_VERSION) | `/initial-setup` | +| **cmdb-assistant** | netbox.env | None | `/cmdb-setup` | +| **data-platform** | postgres.env | .env (optional) | `/data-setup` | +| **viz-platform** | None | .env (optional DMC_VERSION) | `/viz-setup` | | **doc-guardian** | None | None | None needed | | **code-sentinel** | None | None | None needed | | **project-hygiene** | None | None | None needed | | **claude-config-maintainer** | None | None | None needed | -| **contract-validator** | None | None | `/initial-setup` | +| **contract-validator** | None | None | `/cv-setup` | --- @@ -408,7 +408,7 @@ Once system-level config is set up, adding new projects is simple: ``` cd ~/projects/new-project -/setup +/pm-setup ``` The command auto-detects that system config exists and runs quick project setup. @@ -631,7 +631,7 @@ For agents with 8+ skills, use **phase-based loading** in the agent body text. T ### API Validation -When running `/setup`, the command: +When running `/pm-setup`, the command: 1. **Detects** organization and repository from git remote URL 2. **Validates** via Gitea API: `GET /api/v1/repos/{org}/{repo}` @@ -646,7 +646,7 @@ When you start a Claude Code session, a hook automatically: 1. Reads `GITEA_REPO` (in `owner/repo` format) from `.env` 2. Compares with current `git remote get-url origin` -3. **Warns** if mismatch detected: "Repository location mismatch. Run `/setup --sync` to update." +3. **Warns** if mismatch detected: "Repository location mismatch. Run `/pm-setup --sync` to update." This helps when you: - Move a repository to a different organization