Claude Skill-Driven Development (CSDD) Framework

v0.1.0 - 모듈화된 AI 개발 파이프라인 프레임워크

What is CSDD?

CSDD는 소프트웨어 개발 과정을 독립적인 스킬 모듈로 분리하고, 각 스킬이 담당 영역의 CLI를 동적으로 생성하여 개발하는 프레임워크입니다.

┌─────────────────────────────────────────────────────────────────────────┐
│                         CSDD Pipeline                                    │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  requirements.md                                                         │
│        │                                                                 │
│        ▼                                                                 │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐          │
│  │ Schema   │ → │   API    │ → │  Test    │ → │ Container│          │
│  │ Designer │    │ Contract │    │ Synth    │    │ Builder  │          │
│  └────┬─────┘    └────┬─────┘    └────┬─────┘    └────┬─────┘          │
│       │               │               │               │                 │
│       ▼               ▼               ▼               ▼                 │
│  schema.sql      openapi.yaml    tests/*.py      Dockerfile            │
│  models/*.py                                     docker-compose        │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

Why CSDD?

기존 AI 코딩의 접근

일반적인 AI 코딩 워크플로우:

요구사항 → Claude가 코드 생성 → 에러 발생 → 피드백 → 수정 → 반복

이 방식은 빠르고 직관적이지만, 프로젝트가 복잡해질수록:

• 어느 부분에서 문제가 발생했는지 파악하기 어려움
• 특정 영역(예: 스키마)만 교체하거나 개선하기 번거로움
• 개발 과정의 중간 산출물이 명확하지 않음

CSDD의 접근

CSDD는 개발 파이프라인을 **독립적인 모듈(스킬)**로 분리합니다:

요구사항 → [스키마 스킬] → [API 스킬] → [테스트 스킬] → [배포 스킬]
              │               │              │              │
              ▼               ▼              ▼              ▼
          schema.sql     openapi.yaml    tests/       Dockerfile

각 스킬은:

• 자신이 담당하는 영역의 CLI를 생성
• 해당 CLI로 작업을 수행하고 결과물을 생성
• 문제가 있으면 해당 스킬/CLI만 수정

핵심 장점

1. 모듈화된 개발

스키마 설계에 문제가 있다면? → schema-designer 스킬만 수정 API 구조를 바꾸고 싶다면? → api-contract-gen 스킬만 교체

전체 코드를 다시 생성할 필요 없이, 문제가 있는 파이프라인 단계만 수정합니다.

2. 유연한 확장

새로운 요구사항이 생기면 스킬을 추가하여 파이프라인을 확장합니다:

• GraphQL 지원이 필요하면 → graphql-gen 스킬 추가
• 성능 테스트가 필요하면 → perf-tester 스킬 추가

3. 단계별 검증 (Phase Gate)

각 단계 완료 후 자동 검증 + 사용자 승인을 거쳐 다음 단계로 진행:

P0 (Requirements) ──[Gate]──> P1 (Design) ──[Gate]──> P2 (Implementation)
                                                             │
P5 (Export) <──[Gate]── P4 (Stabilization) <──[Gate]── P3 (Testing)

문제를 조기에 발견하고, 잘못된 방향으로 진행하는 것을 방지합니다.

4. Standalone 배포

개발 중에는 스킬이 CLI를 생성하고 수정합니다. 완성되면:

# P5 단계: 스킬 의존성 없는 순수 코드로 Export

스킬과의 연결고리를 제거한 독립 실행 가능한 버전으로 배포할 수 있습니다. 프로덕션 환경에서는 CSDD 프레임워크가 필요 없습니다.

5. 지속적인 업그레이드

배포 후에도 업그레이드나 새로운 기능 개발이 필요하면:

Standalone 코드 ← 다시 스킬 연결 → 스킬로 업데이트 → 새 Standalone 배포

스킬은 개발 도구로 계속 활용됩니다. 일회성이 아닌 지속적인 개발 파트너입니다.

Installation

npx csdd

프로젝트의 .claude/ 폴더에 스킬들이 설치됩니다:

your-project/
├── .claude/
│   └── skills/              # 파이프라인 스킬들
│       ├── global/          # 오케스트레이터, Phase 체커
│       ├── scaffold/        # 스키마, API 계약
│       ├── data/            # 테스트 데이터, 마이그레이션
│       ├── verification/    # 테스트, 검증
│       ├── documentation/   # README, CHANGELOG
│       └── deployment/      # 컨테이너, CI/CD
├── csdd.yaml                # 프로젝트 설정
└── .csdd/                   # 런타임 생성물
    └── cli/                 # 스킬이 생성한 CLI들

Quick Start

# 1. CSDD 설치
npx csdd

# 2. requirements.md 작성
# (엔티티, 엔드포인트, 비즈니스 규칙)

# 3. Claude에게 오케스트레이션 요청
# "orchestrate this project"

# 4. 각 Phase를 거쳐 개발 진행
# Phase Gate에서 검증 + 승인

# 5. P5에서 Standalone 버전으로 Export

스킬 구조

각 스킬은 SKILL.md(지식)와 templates/(CLI 청사진)로 구성됩니다:

skills/scaffold/schema-designer/
├── SKILL.md              # 스킬의 역할, 워크플로우, CLI 생성 방법
└── templates/
    └── schema_designer.py.template  # CLI 템플릿

스킬이 프로젝트를 분석한 후, 맥락에 맞는 맞춤형 CLI를 .csdd/cli/에 생성합니다.

7-Layer Architecture

| Layer | 역할 | 스킬 | |-------|------|------| | L0: Meta | 오케스트레이션, 계획 | project-orchestrator, phase-checker | | L1: Scaffold | 스키마, API, 구조 | schema-designer, api-contract-gen | | L2: Data | 테스트 데이터, 마이그레이션 | fake-data-factory, migration-generator | | L3: Implementation | 비즈니스 로직 | {entity}-crud (프로젝트별 자동 생성) | | L4: Verification | 테스트, 검증 | test-synthesizer, contract-verifier | | L5: Documentation | README, CHANGELOG | readme-sync, changelog-tracker | | L6: Deployment | 컨테이너, CI/CD | container-builder |

Phase Gate System

P0 (Requirements) ──[Gate]──> P1 (Design) ──[Gate]──> P2 (Skill Creation)
                                                            │
P5 (Export) <──[Gate]── P4 (Stabilization) <──[Gate]── P3 (Debugging)

| Phase | 설명 | Gate 조건 | |-------|------|-----------| | P0 | 요구사항 정의 | requirements.md 완성 | | P1 | 스키마, API 설계 | schema.sql, openapi.yaml 검증 | | P2 | CLI 생성 | 모든 스킬 CLI 생성 완료 | | P3 | 구현, 테스트 | 테스트 통과, 커버리지 충족 | | P4 | 안정화 | 연속 5회 성공 | | P5 | Standalone Export | 스킬 의존성 제거된 버전 |

모든 Gate는 자동 검증 + 사용자 승인을 거칩니다.

Configuration

# csdd.yaml
project:
  name: my-project
  type: rest-api        # rest-api | cli-tool | web-app | data-pipeline
  language: python
  framework: fastapi

database:
  type: postgresql
  orm: sqlalchemy

gates:
  strict_mode: true
  require_user_approval: true

Supported Project Types

| Type | 생성물 | |------|--------| | REST API | FastAPI/Express + ORM + OpenAPI + Docker | | CLI Tool | argparse/commander + man page | | Web App | React/Vue + components + Storybook | | Data Pipeline | ETL + scheduler + validation |

Documentation

| 문서 | 설명 | |------|------| | ARCHITECTURE.md | 상세 아키텍처 | | GETTING_STARTED.md | 시작 가이드 | | PHASE_GATES.md | Phase Gate 시스템 | | SKILL_DEVELOPMENT.md | 커스텀 스킬 개발 |

Summary

| 특성 | 기존 AI 코딩 | CSDD | |------|-------------|------| | 구조 | 통합된 코드 생성 | 모듈화된 파이프라인 | | 수정 | 전체 맥락에서 디버깅 | 해당 스킬/CLI만 수정 | | 확장 | 프롬프트 수정 | 스킬 추가 | | 검증 | 결과물 확인 | 단계별 Gate | | 배포 | 생성된 코드 그대로 | Standalone Export | | 유지보수 | 다시 생성 | 스킬 재활용 |

License

MIT License

Version

v0.1.0