SDD Infrastructure

This skill provides the complete infrastructure for the Specification-Driven Development (SDD) workflow, including templates, scripts, and documentation that power all /sdd:* commands.

Quick Reference

Component Types

Templates (5 files)

Templates define the structure for SDD artifacts. Each template includes:

• •Purpose and usage context
• •Required sections and fields
• •Customization guidelines
• •Examples

Available templates:

• •spec-template.md - Feature specifications with user stories
• •plan-template.md - Technical implementation plans
• •tasks-template.md - Independent, testable user stories
• •checklist-template.md - Quality validation checklists
• •agent-file-template.md - AI agent context and guidelines

📖 See Template Guide for detailed documentation.

Scripts (5 files)

Bash scripts automate common SDD workflow tasks:

• •common.sh - Shared utilities (feature paths, validation)
• •create-new-feature.sh - Initialize new feature with branch and spec
• •setup-plan.sh - Create plan from template
• •check-prerequisites.sh - Validate feature readiness
• •update-agent-context.sh - Sync AI agent configuration

Scripts use .sdd/ directory for runtime content:

• •.sdd/codebase/ - Auto-generated codebase documentation
• •.sdd/memory/ - Project constitution and principles
• •.sdd/features/<name>/ - Feature-specific artifacts

📖 See Script Guide for parameters and examples.

Constitution Framework

The constitution defines project-specific principles and constraints:

• •assets/constitution/constitution-template.md - Template for project constitution

Commands copy this to .sdd/memory/constitution.md and load it into Claude's memory for context-aware development.

📖 See Constitution Guide for principles catalog.

Architecture

Plugin-managed (versioned):

plugins/sdd/skills/sdd-infrastructure/
├── SKILL.md                           # This file
├── templates/                         # Reusable templates
├── scripts/                           # Automation scripts
├── assets/constitution/               # Constitution template
└── references/                        # Extended documentation

User repository (runtime, gitignored):

.sdd/
├── .gitignore                         # Ignore runtime content
├── codebase/                          # Auto-generated docs (from /map)
│   ├── STACK.md
│   ├── ARCHITECTURE.md
│   └── ...
├── memory/
│   └── constitution.md                # Project principles
└── features/<name>/                   # Feature artifacts
    ├── spec.md
    ├── plan.md
    └── tasks.md

Usage Patterns

From Commands

Commands invoke this skill's resources using ${CLAUDE_PLUGIN_ROOT}:

# Resolve plugin root (once per command)
PLUGIN_ROOT=$(python3 /tmp/cpr.py sdd)

# Use templates
cat "$PLUGIN_ROOT"/skills/sdd-infrastructure/templates/spec-template.md

# Execute scripts
"$PLUGIN_ROOT"/skills/sdd-infrastructure/scripts/create-new-feature.sh --json "$ARGS"

Local Overrides

Users can override templates by creating .sdd/templates/<template-name>.md. Commands check for local overrides before using plugin templates.

Script Integration

Scripts source common.sh for shared utilities:

#!/usr/bin/env bash
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SCRIPT_DIR/common.sh"

# Now use shared functions
get_feature_paths "$FEATURE_NAME"

Learn More

• •Workflow Overview - Complete SDD process from constitution to implementation
• •Template Guide - Deep dive on each template with customization examples
• •Script Guide - Script parameters, examples, and extension patterns
• •Constitution Guide - Creating and maintaining project constitutions

Related Skills

• •sdd:code-mapping - Generates codebase documentation (uses this skill's scripts)

Version

This skill is part of SDD plugin v1.0.0 (migrated from .specify to .sdd architecture).