OpenSpec SDD-E2E Kit

A portable OpenSpec project-local schema, Codex/Claude Code skill overlay, and SDD/E2E gate scripts for phase-based Spec Driven Development.

Usage

From a target project root, install the kit assets with one command:

npx openspec-sdd-e2e-kit

You will be prompted to select which AI platform to install skills for:

? Which AI platform do you want to install skills for?
❯ codex (OpenAI Codex agent)
  claude-code (Anthropic Claude Code)
  both

You can also specify the target platform via CLI flag:

npx openspec-sdd-e2e-kit --target-ai codex
npx openspec-sdd-e2e-kit --target-ai claude-code
npx openspec-sdd-e2e-kit --target-ai both

Preview the writes first:

npx openspec-sdd-e2e-kit --dry-run
npx openspec-sdd-e2e-kit --dry-run --target-ai claude-code

From this repository:

node bin/sdd-e2e-kit.mjs
node bin/sdd-e2e-kit.mjs check /path/to/project
node bin/sdd-e2e-kit.mjs diff /path/to/project
node bin/sdd-e2e-kit.mjs install /path/to/project

After publishing or linking as a package:

sdd-e2e-kit
sdd-e2e-kit check /path/to/project
sdd-e2e-kit diff /path/to/project
sdd-e2e-kit install /path/to/project

Commands

• Running without a command installs the kit into the current working directory.
• check: verify required assets and package.json sdd:* scripts exist.
• diff: compare a target project against the kit baseline.
• install: copy assets and merge sdd:* scripts. Changed target files are not overwritten unless --force is used.
• update: alias for install; still conservative by default.

Options

• --target-ai <codex|claude-code|both>: Select AI platform. Prompts interactively if omitted.
• --dry-run: Print planned writes without changing files.
• --force: Overwrite changed target files and conflicting package scripts.
• --source <path>: Source project root for kit assets.
• --json: Print machine-readable JSON (check/diff only).

AI Platform Adapters

The kit installs different skill files depending on the selected platform:

Codex (--target-ai codex)

Installs .codex/skills/ with 9 SKILL.md files covering the full OpenSpec SDD + E2E lifecycle.

Claude Code (--target-ai claude-code)

Installs .claude/ with:

• CLAUDE.md — cross-cutting workflow rules that Claude Code always reads
• commands/*.md — 9 slash commands (/project:propose, /project:apply, etc.)
• skills/*/SKILL.md — 9 skills with auto-triggering descriptions for intent matching
• agents/feature-e2e-validator.md — custom agent for Playwright E2E validation

Both (--target-ai both)

Installs both .codex/skills/ and .claude/ directories.

Shared assets (openspec schema, gate scripts, flow docs) are always installed regardless of platform selection.