whatisgithub

What is sdd-interview?

galego/sdd-interview — explained in plain English

Analysis updated 2026-05-18

3Audience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

An AI-driven skill that interviews you like a chief software architect and produces a full set of Markdown architecture documents before you write any code.

Mindmap

mindmap
  root((SDD Interview))
    What it does
      Structured architect interview
      Generates Markdown docs
      Runs before coding starts
    Methodologies
      Domain Driven Design
      CQRS
      Clean Architecture
      Event Driven Development
      TDD and BDD
    Use cases
      Plan a new project
      Scope a new feature
      Untangle a complex bug
    Audience
      Developers and tech leads
      Founders
    Tech stack
      Markdown
      Prompt engineering
      Any AI IDE or CLI agent

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a structured architecture interview before starting a new software project.

USE CASE 2

Generate Domain-Driven Design and CQRS documentation from a guided Q&A process.

USE CASE 3

Resume an interrupted architecture planning session exactly where you left off.

USE CASE 4

Feed an existing project's legacy documentation in to pre-fill architectural drafts.

What is it built with?

MarkdownPrompt engineering

How does it compare?

galego/sdd-interview000madz000/payload-test-api-route-handler0marildo/imago
Stars333
LanguageTypeScriptPython
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

No backend or infrastructure needed, but the full interview across all phases takes real time to complete.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

SDD-Interview is a skill for AI coding assistants that acts like a senior software architect interviewing you before any code gets written. Instead of jumping straight into building a project, it walks a developer, technical lead, or founder through a structured series of questions, one at a time, and turns the answers into a full set of architectural documentation saved as Markdown files inside your project. The README describes the AI adopting the persona of a strict, analytical chief architect that asks one question at a time so it stays focused and does not lose track of context. The process is not a rigid script though: you can change your mind mid interview, and the AI is able to go back and edit documents it already generated earlier without breaking the overall flow. As the interview moves through different phases, the AI also cross references earlier answers, so a decision made about the database early on stays consistent with interface requirements decided later. The output covers a wide range of established software planning methods, including Domain-Driven Design, Command Query Responsibility Segregation, Clean Architecture, Event-Driven Development, Behavior-Driven Development, and Test-Driven Development, among others, organized into eighteen phases producing over thirty separate documents. The whole system tracks its own progress in a state file, so you can pause partway through and resume later without losing what was already decided. It is described as platform and model agnostic, meaning it is built only from Markdown files and prompt instructions rather than any custom software, so it can be used with different AI tools and different underlying language models. It requires no backend infrastructure and runs entirely inside your IDE or command line agent through text files, at no extra cost beyond the AI tool you are already using. It can also read an existing project's documentation to prefill some answers automatically, and the interview and its output documents can be conducted in different languages.

Copy-paste prompts

Prompt 1
Start the SDD-Interview process for a new project and walk me through the initial discovery phase.
Prompt 2
Resume my previous interview from where the tracking changelog left off.
Prompt 3
Use this skill to generate Domain-Driven Design artifacts for the feature I'm about to build.
Prompt 4
Point this skill at my existing project docs and have it pre-fill the discovery phase from that context.

Frequently asked questions

What is sdd-interview?

An AI-driven skill that interviews you like a chief software architect and produces a full set of Markdown architecture documents before you write any code.

What license does sdd-interview use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is sdd-interview to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is sdd-interview for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.