Skip to content

jwill9999/spec-kit

Repository files navigation

Node Spec-Kit

Spec-Driven Development, made simple with Node.

CI Status Coverage npm (scoped) npm beta


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

  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.

About

Start a project with by running speckit in your terminal, and let the wizard configure your Spec-Kit tooling.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published