sdd-init-repo

Initializes Spec-Driven Development directory structure and memory files in a repository.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/phm-aguiar/test_documentacao --skill sdd-init-repo-phm-aguiar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-init-repo
Source: https://github.com/phm-aguiar/test_documentacao/tree/main/.claude/skills/sdd-init-repo
Command: npx skills add https://github.com/phm-aguiar/test_documentacao --skill sdd-init-repo-phm-aguiar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Setting up Spec-Driven Development (SDD) in a new or existing repository requires manually creating a consistent folder structure, memory files, and workflow documentation, which is error-prone and inconsistent across projects. ## Core Features & Use Cases - Repository Scaffolding: Creates .github/memory/ (constitution.md, tech.md) and specs/ (domain-events, features, infra) directories, either step-by-step or via the bundled scaffold-sdd.sh script. - CLAUDE.md Integration: Merges an SDD Workflow section into the existing CLAUDE.md idempotently, never overwriting existing content without user approval. - Reusable Templates: Ships templates for constitution, spec, plan, and tasks artifacts so every feature follows the same SDD format. - Use Case: You adopt SDD on an existing codebase and want the standard structure plus CLAUDE.md workflow rules created in one pass, with guidance on next steps like mapping the tech stack. ## Quick Start Ask the assistant to initialize SDD in this repository so it creates the memory files, specs directories, and updates CLAUDE.md.

Frequently Asked Questions about sdd-init-repo

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

FAQPage Schema
How do I set up Spec-Driven Development in an existing repository?▼

Run the sdd-init-repo skill, which creates .github/memory/ with constitution.md and tech.md, plus specs/ subdirectories for domain-events, features, and infra. It also merges an SDD Workflow section into your CLAUDE.md without overwriting existing content.

What directory structure does Spec-Driven Development require?▼

SDD uses .github/memory/ for global context files (constitution.md, tech.md) and specs/ with three subdirectories: domain-events for formal contracts, features for numbered spec/plan/tasks folders, and infra for infrastructure declarations.

Does sdd-init-repo work with any programming language?▼

Yes, the skill is language-agnostic and assumes no technology stack. The SDD structure it creates is independent of language, and the tech.md file is filled in later by the sdd-explore-tech skill.

Will initializing SDD overwrite my existing CLAUDE.md file?▼

No, the skill is idempotent and only merges the SDD Workflow section. If CLAUDE.md already contains a Fluxo SDD section it skips the step, and it asks before overwriting any existing files or directories.

What should I do after initializing the SDD repository structure?▼

The recommended next steps are running sdd-explore-tech to map the technology stack into tech.md, filling in constitution.md rules with user confirmation, and using sdd-brainstorm to create the first feature specification.