Name: dekspec
Author: dektora

Stats

Actions

Available In

Tags

DekSpec

A spec-driven-development framework for AI-augmented engineering. Turns the markdown artifacts your team already writes — ADRs, Architecture Elements, Working Specs, Interface Contracts, Implementation Briefs, Intents, Missions, Domain Glossary, System Vision — into a typed, validated spec graph that compiles into enforcement artifacts (contract tests, CI gates, AGENTS.md context).

DekSpec is shipped as a Python library + CLI + Claude Code skills + markdown templates, vendored into consumer repos via a single install script. The current version is v0.109.0.

What's here

Path

Contents

tooling/dekspec/

Python package: Constraint Compiler (parsers + 9 IR schemas + emitters), fidelity audit (~30 audit rules), persistence layer (SQLite-indexed run history), and the dekspec CLI.

tooling/dekspec/schemas/

JSON Schema Draft 2020-12 definitions (YAML) for each artifact type. Shipped as package data; loadable via importlib.resources.

plugins/dekspec/skills/

Claude Code skills (authoring + orchestration): /write-ae, /write-adr, /write-ws, /write-ic, /write-ibs, /write-intent, /write-mission, /write-sv, /write-ggc, /write-sp, /write-evals, /write-tests, /write-beads, /exec-coding-session, /archeology, /brownfield-ingest, /orchestrate-intent, /using-dekspec. Ship through the Claude Code plugin marketplace at Dektora/dekspec.

plugins/dekspec/commands/

Slash-command wrappers + CLI mirrors: /doctor, /compile, /validate-artifact, /migrate, /upgrade, /graph-export (CLI verb mirrors); plus Skill-wrapper pairs for /archeology, /brownfield-ingest, /exec-coding-session, /orchestrate-intent, /using-dekspec.

templates/

Artifact templates (ADR, AE, WS, IC, IB, Intent, Mission, Vision Note, plus a checklists subdirectory).

docs/

Methodology docs: dekspec-operating-guide.md, dekspec-quick-reference.md, architecture-frameworks-reference.md, plus the framework's own architecture.md.

.beads/

Project's own bead tracker (br CLI; SQLite + JSONL).

The nine IR types

Each artifact type has a typed schema + lossy markdown parser + cross-artifact resolution. The parser is deliberately permissive — missing fields surface as parse_warnings rather than raising. Schema validation catches the genuinely-malformed.

ID prefix

Artifact

Layer

Purpose

ADR-NNN

Architecture Decision Record

Decisions that shape one or more AEs

AE-NNN

Architecture Element

The system's architectural slices (with subtype: System / Subsystem / Container / Component / Pipeline / Data Model / Cross-Cutting Concern / Platform Concern / Interface Surface / Workflow / Process)

WS-NNN

Working Spec

Behavioral contract: business rules + failure behaviors + interface contracts

IC-NNN

Interface Contract

Provider/Consumer API contracts with parties + capabilities + error semantics

IB-NNN

Implementation Brief

Per-task implementation contract: files-to-modify scope + done-when criteria, references its parent WS + source AEs

INT-NNN

Intent

(cross-layer)

Captured engineer intent — what change is being made and why, with components_affected (diff-confinement globs) + verification predicate (TESTPASS gate)

MSN-NNN

Mission

(cross-Intent)

Long-horizon container: outcome, mission verification, out-of-scope contract, flag strategy, rollback plan, kill criteria, Intent queue

DOMAIN-GLOSSARY

Domain Glossary (singleton)

Canonical term definitions: term + category + canonical_definition + not_this + code_convention

SYSTEM-VISION

System Vision (singleton)

One-paragraph elevator pitch + What this is + Why this exists + What success looks like + What we are NOT building

CLI — eleven subcommands

dekspec --version dekspec --help

DekSpec

DekSpec is shipped as a Python library + CLI + Claude Code skills + markdown templates, vendored into consumer repos via a single install script. The current version is v0.109.0.

What's here

Path	Contents
`tooling/dekspec/`	Python package: Constraint Compiler (parsers + 9 IR schemas + emitters), fidelity audit (~30 audit rules), persistence layer (SQLite-indexed run history), and the `dekspec` CLI.
`tooling/dekspec/schemas/`	JSON Schema Draft 2020-12 definitions (YAML) for each artifact type. Shipped as package data; loadable via `importlib.resources`.
`plugins/dekspec/skills/`	Claude Code skills (authoring + orchestration): `/write-ae`, `/write-adr`, `/write-ws`, `/write-ic`, `/write-ibs`, `/write-intent`, `/write-mission`, `/write-sv`, `/write-ggc`, `/write-sp`, `/write-evals`, `/write-tests`, `/write-beads`, `/exec-coding-session`, `/archeology`, `/brownfield-ingest`, `/orchestrate-intent`, `/using-dekspec`. Ship through the Claude Code plugin marketplace at `Dektora/dekspec`.
`plugins/dekspec/commands/`	Slash-command wrappers + CLI mirrors: `/doctor`, `/compile`, `/validate-artifact`, `/migrate`, `/upgrade`, `/graph-export` (CLI verb mirrors); plus Skill-wrapper pairs for `/archeology`, `/brownfield-ingest`, `/exec-coding-session`, `/orchestrate-intent`, `/using-dekspec`.
`templates/`	Artifact templates (ADR, AE, WS, IC, IB, Intent, Mission, Vision Note, plus a checklists subdirectory).
`docs/`	Methodology docs: `dekspec-operating-guide.md`, `dekspec-quick-reference.md`, `architecture-frameworks-reference.md`, plus the framework's own `architecture.md`.
`.beads/`	Project's own bead tracker (`br` CLI; SQLite + JSONL).

The nine IR types

ID prefix	Artifact	Layer	Purpose
`ADR-NNN`	Architecture Decision Record	L1	Decisions that shape one or more AEs
`AE-NNN`	Architecture Element	L1	The system's architectural slices (with subtype: System / Subsystem / Container / Component / Pipeline / Data Model / Cross-Cutting Concern / Platform Concern / Interface Surface / Workflow / Process)
`WS-NNN`	Working Spec	L2	Behavioral contract: business rules + failure behaviors + interface contracts
`IC-NNN`	Interface Contract	L2	Provider/Consumer API contracts with parties + capabilities + error semantics
`IB-NNN`	Implementation Brief	L3	Per-task implementation contract: files-to-modify scope + done-when criteria, references its parent WS + source AEs
`INT-NNN`	Intent	(cross-layer)	Captured engineer intent — what change is being made and why, with components_affected (diff-confinement globs) + verification predicate (TESTPASS gate)
`MSN-NNN`	Mission	(cross-Intent)	Long-horizon container: outcome, mission verification, out-of-scope contract, flag strategy, rollback plan, kill criteria, Intent queue
`DOMAIN-GLOSSARY`	Domain Glossary (singleton)	L0	Canonical term definitions: term + category + canonical_definition + not_this + code_convention
`SYSTEM-VISION`	System Vision (singleton)	L0	One-paragraph elevator pitch + What this is + Why this exists + What success looks like + What we are NOT building

CLI — eleven subcommands

dekspec --version
dekspec --help

dekspec

Popularity

What's Inside

Confidence

README

DekSpec

What's here

The nine IR types

CLI — eleven subcommands

Similar Plugins

ecc

everything-claude-code

cc-polymath

DekSpec

What's here

The nine IR types

CLI — eleven subcommands

Popularity

Health & Quality

Similar Plugins

ecc

everything-claude-code

cc-polymath