sdd init

Initializes a project with SDD Tool.

Usage

sdd init [options]

Options

Option	Description
-f, --force	Overwrite existing configuration
--skip-git-setup	Skip Git/CI-CD setup
--auto-approve	Auto-approve all settings

Generated Files

your-project/
├── .sdd/
│   ├── constitution.md     # Project constitution template
│   ├── AGENTS.md           # AI workflow guide
│   ├── specs/              # Feature specs directory
│   ├── changes/            # Change proposals directory
│   ├── archive/            # Completed changes archive
│   └── templates/          # Spec templates
│
└── .claude/
    └── commands/           # Slash commands (20 total)
        ├── sdd.start.md
        ├── sdd.spec.md
        ├── sdd.plan.md
        └── ...

Git Workflow Setup

After initialization, the tool analyzes your project structure and suggests Git workflow settings:

1. Git Hooks Installation: Automatic spec validation on commit/push
2. Commit Template Installation: Consistent commit message format
3. GitHub Actions Setup: Automatic validation and labeling on PRs

Each setting is executed after user approval.

Examples

Basic Initialization (Interactive)

sdd init

Example output:

Initializing SDD project...
✓ SDD project initialized.

🔍 Analyzing project structure...

=== Project Analysis Results ===

📁 Project Type:
   TypeScript (Node.js)

🔧 Git Status:
   Repository: ✅ Initialized
   Hooks: ❌ Not installed
   Commit Template: ❌ None

🚀 CI/CD Status:
   GitHub Actions: ❌ Not configured

📋 Recommended Settings:
   • Git Hooks: Automatic spec validation on commit/push
   • Commit Template: Consistent commit message format
   • GitHub Actions: Automatic validation and labeling on PRs

Install Git workflow (Hooks + Template)? (y/n): y
✓ Git workflow installation complete!

Set up GitHub Actions CI/CD? (y/n): y
✓ sdd-validate.yml created
✓ sdd-labeler.yml created

Auto-Approve (for CI/Scripts)

sdd init --auto-approve

All settings are applied automatically without prompts.

Skip Git Setup

sdd init --skip-git-setup

Initializes only the SDD structure, skipping Git/CI-CD setup.

Overwrite Existing Configuration

sdd init --force

After Initialization

1. Run Claude Code: claude
2. Start the workflow: /sdd.start

Related Documentation

• sdd git - Git workflow setup
• sdd cicd - CI/CD pipeline setup
• Commit Convention
• CI/CD Setup Guide