Skip to content

Overview

SDTK is a suite of six local-first CLI toolkits that turn AI-assisted software work into governed, auditable, resumable engineering. Instead of trusting a chat thread, every phase of work writes real artifacts into your repository — specs, prototypes, review packets, deployment evidence, wiki pages, and run ledgers — with human approval gates where decisions matter.

SDTK works with Claude Code and Codex as execution runtimes. The runtimes execute; SDTK governs.

The suite at a glance

ToolkitCLIOwnsMaturity
SDTK-SPECsdtk-specDiscovery, specs, PM → BA → ARCH → DEV → QA planning, 17-file SDLC scaffoldShipped
SDTK-DESIGNsdtk-designScreen maps, design briefs, static prototypes, design → code handoffShipped
SDTK-CODEsdtk-codeGoverned implementation workflow, trust layer, review packetsShipped
SDTK-OPSsdtk-opsDeployment, verification, monitoring, incident journeys (skill-driven)Shipped
SDTK-WIKIsdtk-wikiLocal knowledge graph, docs viewer, kanban board, grounded AskShipped
SDTK-AGENTsdtk-agentDurable multi-step agent orchestration with human gatesShipped

Four toolkits (SPEC, DESIGN, CODE, OPS) each own one phase of the idea-to-ship pipeline. Two are cross-cutting: SDTK-WIKI is the memory layer every phase reads from, and SDTK-AGENT is the orchestration layer that chains phases into one durable run.

Standalone: SDTK-BRAIN

SDTK-BRAIN is not part of the six-toolkit suite and is not installed by sdtk-kit — it ships on its own (npm i -g sdtk-brain-kit). The boundary is deliberate:

  • SDTK-WIKI is the knowledge of one product — it indexes that repo's own docs in place and every SDLC phase reads from it.
  • SDTK-BRAIN is the knowledge of one person — a personal, cross-project second-brain vault living in its own folder, outside any repo, maintained by your agent.

They share a graph builder and viewer, and nothing else. The second-brain pipeline verbs (ingest/compile/discover/enrich) moved out of sdtk-wiki in wiki 0.10.0 and belong to SDTK-BRAIN now.

What makes SDTK different

A governance kernel, not a chat wrapper. Multi-step work runs against a file-backed ledger with a pure state machine: workflow state, events, evidence, approvals, and reports live on disk in your repo. Close the terminal, come back tomorrow, continue exactly where you stopped. See The Governance Kernel.

Evidence over vibes. A PR ships with a review packet. A deploy closes with verification evidence. An agent run renders a durable report of every task, gate decision, and evidence file. See The Trust Layer.

Human gates where they matter. Phase gates in the spec pipeline, review gates before ship, and human_gate stages in agent workflows that block everything downstream until a person decides.

Local-first. Ledgers, artifacts, graphs, and reports are files in your repository. External model/API/runtime calls happen only when you explicitly invoke your AI runtime (for example /orchestrator in Claude Code, or sdtk-wiki ask on Pro — the free Ask tier retrieves locally and calls nothing).

Free and Pro

The core suite is free and MIT-licensed. A one-time Pro purchase unlocks premium capabilities across all kits on a machine:

  • Project Intelligencesdtk-spec project ingest / audit / refresh Pro
  • Wiki Asksdtk-wiki ask. Free: ranked, cited passages from your built graph, returned verbatim. Pro: an answer synthesized from those same sources, or NOT IN SOURCES.
  • Sleep Executesdtk-code sleep authorizesleep execute: after one attended authorization, a bounded doc-class agent session runs headless within hard ceilings (10 iterations / $10 / 24h TTL). Uses your own provider API key; not SDTK-hosted. Pro

Activate once with sdtk activate --license SDTK-XXXX-YYYY. See Installation.

Where to go next

SDTK — governed, auditable, resumable AI-assisted engineering.