# KSDD

> Kognar Spec-Driven Design & Development — a slash command system for Claude Code and OpenAI Codex that guides products from raw brainstorm to an implementable design system, in four stages with mandatory human approval between each one.

KSDD is distributed as an npm package (`@kognar/ksdd`) under AGPL-3.0. It is content, not runtime — the CLI copies markdown commands, skills, and references into the conventional folders Claude Code and Codex read. The method centers on cumulative artifacts (brainstorm.md → SPEC.md → architecture.md → DESIGN.md) and explicit approval gates between stages.

## Install

```bash
npm install -g @kognar/ksdd
```

## Docs

- [README](https://github.com/kognar-ai/ksdd#readme): Full installation, command list, philosophy, principles
- [Templates](https://github.com/kognar-ai/ksdd/tree/main/references): Canonical artifact templates (brainstorm, SPEC, architecture, DESIGN, feature)
- [CHANGELOG](https://github.com/kognar-ai/ksdd/blob/main/CHANGELOG.md): Version history with migration notes
- [CONTRIBUTING](https://github.com/kognar-ai/ksdd/blob/main/CONTRIBUTING.md): How to contribute

## Commands

- /ksdd:start — Structured brainstorm session, produces `brainstorm.md` (raw idea → refined concept)
- /ksdd:spec — Concept becomes a product + design contract, produces `SPEC.md`
- /ksdd:tech — Technical architecture with stack, schemas, ADRs, produces `architecture.md`
- /ksdd:design — Design system in Google Stitch format with tokens, produces `DESIGN.md`
- /ksdd:new:feature — New feature spec broken into implementable tasks
- /ksdd:build:feature — Implement a feature end-to-end (issue, branch, context, code, quality gates, PR)
- /ksdd:build:all — Full project build with phase decomposition and checkpoints
- /ksdd:setup — Reverse-engineer the four canonical artifacts from an existing project

## Optional

- [Source](https://github.com/kognar-ai/ksdd): GitHub repository
- [Package](https://www.npmjs.com/package/@kognar/ksdd): npm
- [License](https://www.gnu.org/licenses/agpl-3.0.html): GNU Affero General Public License v3.0
- [Kognar](https://kognar.com): The team behind KSDD