junior-architect-position-plugin

Claude Code Team Plugin

Team onboarding plugin with clarity workflow commands, worktree skill, and commit guards.

Dependencies

Install these before using the plugin:

jq (JSON processor - required for hooks):

# Ubuntu/Debian
sudo apt install jq

# Mac
brew install jq

gh (GitHub CLI):

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh
gh auth login

uv (Python package manager):

curl -LsSf https://astral.sh/uv/install.sh | sh

git-worktree-runner (worktree management):

git clone https://github.com/coderabbitai/git-worktree-runner.git
cd git-worktree-runner
./install.sh

Homebrew (package manager for WSL):

# Install build-essential first (required for WSL)
sudo apt-get update
sudo apt-get install build-essential

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Add to PATH
test -d ~/.linuxbrew && eval $(~/.linuxbrew/bin/brew shellenv)
test -d /home/linuxbrew/.linuxbrew && eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)
echo "eval \$($(brew --prefix)/bin/brew shellenv)" >> ~/.bashrc
source ~/.bashrc

Supabase CLI (database operations):

npm install -g supabase
supabase login

hand-picked-tools MCP (AI tools):

claude mcp add hand-picked-tools --transport http --scope user https://metamcp.iitr-cloud.de/metamcp/hand-picked-tools/mcp

Google Chrome (for Chrome DevTools MCP):

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install

mcp2rest (MCP gateway - optional):

npm install -g mcp2rest

# Install as service (use env to preserve PATH for nvm users)
sudo env "PATH=$PATH" npx mcp2rest service install

# Or run in foreground
npx mcp2rest start

# Add Chrome DevTools server
npx mcp2rest add chrome chrome-devtools-mcp@latest

# Verify
curl http://localhost:28888/health

Install

Public Repository (default)

/plugin marketplace add MariusWilsch/claude-code-team-marketplace
/plugin install claude-code-team-plugin@wilsch-ai-plugins

Update

/plugin marketplace update wilsch-ai-plugins
/plugin update claude-code-team-plugin@wilsch-ai-plugins

Restart Claude Code after updating for changes to take effect.

Troubleshooting

If /plugin marketplace add fails with a clone error:

1. Remove any existing marketplace entry:

   /plugin marketplace remove wilsch-ai-plugins
   

2. Clean up leftover files:

   rm -rf ~/.claude/plugins/marketplaces/MariusWilsch-claude-code-team-marketplace
   

3. Retry:

   /plugin marketplace add MariusWilsch/claude-code-team-marketplace
   

Private Repository Setup

If this repo is made private, each user needs to configure GitHub authentication.

Step 1: Create a GitHub Fine-Grained Personal Access Token (PAT)

1. Go to GitHub Settings > Developer Settings > Fine-grained tokens
2. Configure the token:
   • Token name: claude-code-team-marketplace
   • Repository access: "Only select repositories" > MariusWilsch/claude-code-team-marketplace
   • Permissions: Contents > Read-only
   • Expiration: choose based on your security policy
3. Click "Generate token" and copy it (github_pat_...)

Step 2: Set the token in your shell environment

Add to ~/.zshrc (Mac) or ~/.bashrc (Linux):

export GITHUB_TOKEN=github_pat_xxxxxxxxxxxx

Then reload:

source ~/.zshrc  # or source ~/.bashrc

Step 3: Add marketplace and install

/plugin marketplace add MariusWilsch/claude-code-team-marketplace
/plugin install claude-code-team-plugin@wilsch-ai-plugins

Note: The GITHUB_TOKEN env var is required for both initial clone and background auto-updates. Without it, Claude Code cannot authenticate against private repos because it runs git with terminal prompts disabled. See Claude Code docs on private repositories for details.

Contents

Commands