gh-jschulte-claude-plugins-stackshift/commands/setup.md

description

description
Install StackShift and Spec Kit slash commands to this project for team use. Run this if you joined a project after StackShift analysis was completed.

StackShift Setup - Install Slash Commands

Use this if:

• You cloned a project that uses StackShift
• Slash commands aren't showing up (/speckit., /stackshift.)
• You want to add features but don't have the commands

---

Step 1: Install Commands

# Create commands directory
mkdir -p .claude/commands

# Copy from StackShift plugin
cp ~/.claude/plugins/stackshift/.claude/commands/speckit.*.md .claude/commands/
cp ~/.claude/plugins/stackshift/.claude/commands/stackshift.*.md .claude/commands/

# Verify
ls .claude/commands/

You should see:

• ✅ speckit.analyze.md
• ✅ speckit.clarify.md
• ✅ speckit.implement.md
• ✅ speckit.plan.md
• ✅ speckit.specify.md
• ✅ speckit.tasks.md
• ✅ stackshift.modernize.md
• ✅ stackshift.setup.md

---

Step 2: Update .gitignore

Ensure .gitignore allows .claude/commands/ to be committed:

# Check if .gitignore exists
if [ ! -f .gitignore ]; then
  echo "Creating .gitignore..."
  touch .gitignore
fi

# Add rules to allow slash commands
cat >> .gitignore <<'EOF'

# Claude Code - Allow slash commands (team needs these!)
!.claude/
!.claude/commands/
!.claude/commands/*.md

# Ignore user-specific Claude settings
.claude/settings.json
.claude/mcp-settings.json
.claude/.storage/
EOF

echo "✅ .gitignore updated"

---

Step 3: Commit to Git

git add .claude/commands/
git add .gitignore

git commit -m "chore: add StackShift slash commands for team

Adds /speckit.* and /stackshift.* slash commands.

Commands installed:
- /speckit.specify - Create feature specifications
- /speckit.plan - Create technical implementation plans
- /speckit.tasks - Generate task breakdowns
- /speckit.implement - Execute implementation
- /speckit.clarify - Resolve specification ambiguities
- /speckit.analyze - Validate specs match code
- /stackshift.modernize - Upgrade dependencies
- /stackshift.setup - Install commands (this command)

These enable spec-driven development for the entire team.
All team members will have commands after cloning.
"

---

Done!

✅ Commands installed to project ✅ .gitignore updated to allow commands ✅ Commands committed to git ✅ Team members will have commands when they clone

Type /spec and you should see all commands autocomplete!

---

For Project Leads

After running StackShift on a project, always:

1. ✅ Run /stackshift.setup (or manual Step 1-3 above)
2. ✅ Commit .claude/commands/ to git
3. ✅ Push to remote

This ensures everyone on your team has access to slash commands without individual setup.

---

Troubleshooting

"Commands still not showing up" → Restart Claude Code after installing

"Git says .claude/ is ignored" → Check .gitignore has !.claude/commands/ rule

"Don't have StackShift plugin installed" → Install: /plugin marketplace add jschulte/claude-plugins then /plugin install stackshift

"StackShift plugin not in ~/.claude/plugins/" → Commands might be in different location, manually copy from project that has them