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

$3

``bash
npm install -g @letuscode/spec-kit
`

$3

`bash
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

1. /constitution → set project principles
2. /specify → write the feature spec (what/why)
3. /plan → design the technical approach
4. /tasks → break down implementation
5. /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.