https://github.com/jwill9999/spec-kit
Start a project with by running speckit in your terminal, and let the wizard configure your Spec-Kit tooling.
https://github.com/jwill9999/spec-kit
ai-agents github planning spec-kit tasks tooling
Last synced: 5 months ago
JSON representation
Start a project with by running speckit in your terminal, and let the wizard configure your Spec-Kit tooling.
- Host: GitHub
- URL: https://github.com/jwill9999/spec-kit
- Owner: jwill9999
- License: other
- Created: 2025-09-21T03:12:57.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-26T23:00:18.000Z (9 months ago)
- Last Synced: 2026-01-08T14:13:09.136Z (5 months ago)
- Topics: ai-agents, github, planning, spec-kit, tasks, tooling
- Language: TypeScript
- Homepage: http://letuscode.co.uk/spec-kit/
- Size: 2.78 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
Node Spec-Kit
Spec-Driven Development, made simple with Node.
---
> ### [Node Spec-Kit Homepage](http://letuscode.co.uk/spec-kit/)
> ## Disclaimer
>
> This Spec Kit is a fork of GitHub's original repository [spec-kit](https://github.com/github/spec-kit.git.)\
> It has been modified to use Node and npm.\
> It uses a simple interactive setup wizard.\
> Fork maintained by [@jwill9999](https://github.com/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
```bash
npm install -g @letuscode/spec-kit
```
### Initialize a new project
```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.