spec-kit
Node Spec-Kit
Spec-Driven Development, made simple with Node.
Node Spec-Kit Homepage
Disclaimer
This Spec Kit is a fork of GitHub’s original repository spec-kit
It has been modified to use Node and npm.
It uses a simple interactive setup wizard.
Fork maintained by @jwill9999.
Overview
This is an NPM package built upon the foundations of GitHubs own Spec-Kit.
It implements a simple wizard that steps you though the initial setup and allows you to save preset configurations for different environments.
Start a project with by running speckit in your terminal, and let the wizard configure your Spec-Kit tooling.
Then follow the steps below
Requirements
- macOS/Linux/Windows
- Node.js 20+
- Git
Quick start
Installation
npm install -g @letuscode/spec-kit
Initialize a new project
speckit
This launches a simple, interactive wizard. It asks for a project name and your preferred AI assistant, then lays down the right command templates and scripts.
Tip: You can also run speckit --help to see all available options.
What it generates
Depending on the AI assistant you pick, the wizard creates agent-specific command files under the right folders, for example:
- .claude/commands/
- .github/prompts/
- .cursor/commands/
- .qwen/commands/
- .opencode/command/
- .windsurf/workflows/
It also includes cross-platform helper scripts under scripts/ and prepares a space for your specifications (see specs/ when you start a feature).
Workflow steps at a glance
Once you have completed the wizard use your chosen environment i.e VSCode to run the prompt commands in.
Steps
- /constitution → set project principles
- /specify → write the feature spec (what/why)
- /plan → design the technical approach
- /tasks → break down implementation
- /implement → build according to the plan
Troubleshooting
- Ensure Node 20+ and Git are installed and on PATH.
- If your terminal is very narrow, the wizard uses a compact view automatically.
- The wizard remembers your last choices in .specify/wizard.json (repo-local). Delete it to reset.
License
MIT — see LICENSE for details.