spec-driver

Create, list, find, show, edit, and complete spec-driver entities via CLI.

26|3|Updated Oct 9, 2025
One-click install
npx skills add https://github.com/davidlee/spec-driver --skill spec-driver-davidlee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driver
Source: https://github.com/davidlee/spec-driver/tree/main/.spec-driver/skills/spec-driver
Command: npx skills add https://github.com/davidlee/spec-driver --skill spec-driver-davidlee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

spec-driver eliminates the guesswork and inconsistencies that happen when humans or agents create, locate, edit, or reference spec artifacts like ADRs, specs, deltas, revisions, and related workflow documents.

Core Features & Use Cases

  • Deterministic CLI-driven artifact operations: create, list, find, show, view/raw, edit, and complete lifecycle actions without manually inventing IDs, paths, or command shapes.
  • Discovery-first workflow guidance: routes users toward “show/list/find” commands to inspect what exists rather than browsing generated files.
  • Workflow- and memory-aware usage: provides guidance for canonical ordering, completion paths, and selecting the right memory for task-focused help (including delta completion and concept-specific guidance).

Quick Start

Use the spec-driver skill when you want to create or inspect ADRs, specs, deltas, revisions, audits, or memories via the CLI without guessing IDs or command structures.

Frequently Asked Questions about spec-driver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage ADRs and specs via the CLI without guessing file paths?

Spec-driven artifact management uses deterministic CLI operations to create, list, and edit ADRs or specs without manually inventing IDs or command shapes. It steers you toward discovery-first inspection commands to locate existing workflow documents reliably.

What is spec-driven development workflow guidance for agent-led tasks?

Spec-driven development workflow guidance routes humans and agents toward canonical lifecycle actions and memory routing. It ensures reliable command usage by applying schema-aware introspection patterns and completion paths for deltas, revisions, and audits.

How do I list and find existing spec deltas and revisions in a project?

You list and find spec deltas and revisions by using CLI inspection commands like show, list, and find. This discovery-first approach ensures you inspect existing artifact schemas and lifecycle states rather than browsing generated files manually.

Does spec-driven artifact management work for both human-led and agentic workflows?

Spec-driven artifact management supports both human-led and agentic workflows for artifact discovery and lifecycle actions. It provides reliable command usage guidance, ensuring path and ID correctness across ADRs, specs, policies, standards, and backlog items.

When should I use schema introspection for spec artifact lifecycle actions?

Schema introspection is used when you need path and ID correctness for spec artifact lifecycle actions. It applies schema-aware introspection patterns to route users toward the right CLI commands and memory for task-focused help during delta completion.

What is the best way to complete spec deltas and route agentic memory?

The best way to complete spec deltas is through canonical CLI completion paths with memory-aware usage guidance. This selects the right memory for task-focused help, ensuring reliable artifact lifecycle actions and concept-specific guidance.