spec-driven-development

Enforce a spec-first workflow with structured artifacts for multi-agent feature work.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/pjordan/claude-toolkit --skill spec-driven-development-pjordan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/pjordan/claude-toolkit/tree/main/skills/examples/spec-driven-development
Command: npx skills add https://github.com/pjordan/claude-toolkit --skill spec-driven-development-pjordan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a structured, spec-first workflow that organizes feature work into a clear artifact hierarchy, enabling teams to align requirements with implementation from the start.

Core Features & Use Cases

  • Artifact organization: Consistent directory structure for specs, plans, tasks, notes, and progress to support traceability.
  • Multi-agent coordination: Framework for handoffs, task ownership, and progressive context loading across teammates.
  • Documentation-driven development: Guides teams from specification through implementation and validation with interconnected artifacts.

Quick Start

  • mkdir -p agentdocs/features/<feature-slug>/{tasks,notes,progress}
  • touch agentdocs/features/<feature-slug>/spec.md
  • touch agentdocs/features/<feature-slug>/plan.md
  • Use the spec-writing, plan-writing, and task-writing skills to populate artifacts.

Frequently Asked Questions about spec-driven-development

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

FAQPage Schema
How do I coordinate feature work across multiple agents from spec to delivery?

Spec-first workflow coordination organizes feature development into a structured artifact hierarchy with spec.md, plan.md, and tasks/ directories. This enforces traceability and aligns requirements with implementation across multiple agents through progressive context loading and cross-linked documentation.

What is the best way to structure documentation for multi-agent feature development?

Structured documentation for multi-agent development uses a consistent directory structure containing specs, plans, tasks, notes, and progress folders. This artifact hierarchy supports task ownership, multi-agent handoffs, and traceability from initial specification through final implementation and validation.

How do I set up a spec-first workflow directory for a new feature?

Create the directory structure by running mkdir -p agentdocs/features/<feature-slug>/{tasks,notes,progress}, then initialize spec.md and plan.md files. Use spec-writing, plan-writing, and task-writing skills to populate these artifacts and guide the development process.

Can I use this spec-driven development workflow for team-based feature planning?

Yes, spec-driven development is designed for teams coordinating multiple agents across requirements, planning, and implementation phases. It provides frameworks for task ownership, multi-agent handoffs, and progressive context loading to support collaborative feature delivery.

What artifacts do I need for traceability in a multi-agent development workflow?

Traceability in multi-agent workflows requires interconnected artifacts including spec.md for requirements, plan.md for planning, tasks/ for task tracking, notes/ for documentation, and progress/ for logging. These artifacts enable cross-linking and structured handoffs throughout the development lifecycle.

When should I use a spec-first workflow instead of direct implementation?

Use a spec-first workflow when coordinating multiple agents across complex feature requirements that demand traceability from specification to delivery. It ensures alignment between requirements and implementation through structured artifacts, making it essential for team-based development with progressive context loading needs.