Skip to main content
command CX Codex

spec-workflow-setup — Claude Code command: what it does

spec-workflow-setup — a slash command that walks you through wiring the spec-workflow MCP server into Claude: dependencies, .mcp.json, .spec-workflow.json, then a connection check.

no license ★ 1,357 updated 2026-03-01

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/spec-workflow-setup.md
Open on GitHub

What spec-workflow-setup does

The command is a guided install for the spec-workflow MCP server inside Claude. It opens with a prerequisite sweep: Node.js 18+, npm or yarn, Git, MCP support switched on. From there it installs the server, drops .mcp.json at the project root and fills in .spec-workflow.json with folders for specs and tasks.

Three routes are covered. The @pimzino/spec-workflow-mcp package from npm, global or as a dev dependency. A clone of the repo, built locally and linked. Or the ./scripts/install-spec-workflow-mcp.sh script that ships with the suite. Environment variables such as SPEC_WORKFLOW_PROJECT_PATH and SPEC_WORKFLOW_AUTO_SYNC get set along the way, and the project file carries task statuses plus maxParallel for agents.

Node.js 18+ and MCP enabled in Claude are the floor — skip them and step one fails. Verification runs through /spec-workflow:test-connection, /spec-workflow:list-specs and /spec-workflow:task-status. When the server stays silent, the guide points at the settings syntax and a restart.

What it helps with

  • install the spec-workflow MCP server into an existing repo
  • write a .mcp.json that launches the server through npx
  • declare spec and task folders in .spec-workflow.json
  • set task statuses and the parallel agent cap
  • diagnose a server that refuses to connect

Example prompts for the agent

  • /spec-workflow-setup — walk me through installing spec-workflow MCP in this repo.
  • Use /spec-workflow-setup and configure the server globally instead of per project.
  • Run /spec-workflow-setup, then check the link with /spec-workflow:test-connection.

How to install spec-workflow-setup

Manually: put the files in place

.claude/commands/spec-workflow-setup.md

Call it with /spec-workflow-setup. For all projects use ~/.claude/commands/

Questions about spec-workflow-setup

How do I install spec-workflow-setup in Claude Code?

Copy the command file to .claude/commands/spec-workflow-setup.md; Claude then exposes it as /spec-workflow-setup.

What does spec-workflow-setup do?

It runs the spec-workflow MCP server setup step by step: prerequisites, a choice of install route, the .mcp.json and .spec-workflow.json files, and a final connection test.

What do I need before running it?

Node.js 18+, npm or yarn, Git, and Claude with MCP support enabled.

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set112

The whole set →
code-reviewer-pro code-reviewer-pro — a Claude Code subagent that reviews code for quality, security and best practices. Runs right after you write or modify code. CX Codex ★ 1,357repo stars audit-env-variables audit-env-variables scans environment variables in a JS/TS codebase, flags unused ones, guesses the service behind each variable name, and maps where it's referenced in code. CX Codex +1 ★ 1,357repo stars release-manager release-manager handles SemVer bumps, drafts changelog records, and verifies checklists before production deployment. CX Codex ★ 1,357repo stars incremental-feature-build The incremental-feature-build command breaks a request into testable features, tracks progress in project files, and works through features one at a time. Use it for multi-stage implementation tasks. CX Codex +1 ★ 1,357repo stars audit-clean-arch audit-clean-arch audits a Rust codebase against Clean Architecture rules. It locates improper layer dependencies, framework leaks, and concrete adapter couplings. CX Codex +1 ★ 1,357repo stars suggest-refactor The suggest-refactor command reviews Rust code for clean-architecture violations and returns ranked refactoring steps with code examples. CX Codex +1 ★ 1,357repo stars simulation_examples simulation_examples — a set of ready prompts for the simulation commands in Claude: how to frame a decision, a market response or a timeline before you commit to it. CX Codex +1 ★ 1,357repo stars azure-devops-specialist azure-devops-specialist configures Microsoft Azure services and sets up CI/CD automation using the Azure CLI and MCP tools. Helpful when building pipelines and managing cloud deployments. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open