Claude Skill-Driven Development Framework - AI-powered software development boilerplate
npm install csdd> v0.1.0 - 모듈화된 AI 개발 파이프라인 프레임워크
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 │
│ │
└─────────────────────────────────────────────────────────────────────────┘
---
일반적인 AI 코딩 워크플로우:
`
요구사항 → Claude가 코드 생성 → 에러 발생 → 피드백 → 수정 → 반복
이 방식은 빠르고 직관적이지만, 프로젝트가 복잡해질수록:
- 어느 부분에서 문제가 발생했는지 파악하기 어려움
- 특정 영역(예: 스키마)만 교체하거나 개선하기 번거로움
- 개발 과정의 중간 산출물이 명확하지 않음
CSDD는 개발 파이프라인을 독립적인 모듈(스킬)로 분리합니다:
`
요구사항 → [스키마 스킬] → [API 스킬] → [테스트 스킬] → [배포 스킬]
│ │ │ │
▼ ▼ ▼ ▼
schema.sql openapi.yaml tests/ Dockerfile
각 스킬은:
- 자신이 담당하는 영역의 CLI를 생성
- 해당 CLI로 작업을 수행하고 결과물을 생성
- 문제가 있으면 해당 스킬/CLI만 수정
---
스키마 설계에 문제가 있다면? → schema-designer 스킬만 수정api-contract-gen
API 구조를 바꾸고 싶다면? → 스킬만 교체
전체 코드를 다시 생성할 필요 없이, 문제가 있는 파이프라인 단계만 수정합니다.
새로운 요구사항이 생기면 스킬을 추가하여 파이프라인을 확장합니다:
- GraphQL 지원이 필요하면 → graphql-gen 스킬 추가perf-tester
- 성능 테스트가 필요하면 → 스킬 추가
각 단계 완료 후 자동 검증 + 사용자 승인을 거쳐 다음 단계로 진행:
`
P0 (Requirements) ──[Gate]──> P1 (Design) ──[Gate]──> P2 (Implementation)
│
P5 (Export) <──[Gate]── P4 (Stabilization) <──[Gate]── P3 (Testing)
문제를 조기에 발견하고, 잘못된 방향으로 진행하는 것을 방지합니다.
개발 중에는 스킬이 CLI를 생성하고 수정합니다. 완성되면:
`bash`P5 단계: 스킬 의존성 없는 순수 코드로 Export
스킬과의 연결고리를 제거한 독립 실행 가능한 버전으로 배포할 수 있습니다.
프로덕션 환경에서는 CSDD 프레임워크가 필요 없습니다.
배포 후에도 업그레이드나 새로운 기능 개발이 필요하면:
`
Standalone 코드 ← 다시 스킬 연결 → 스킬로 업데이트 → 새 Standalone 배포
스킬은 개발 도구로 계속 활용됩니다. 일회성이 아닌 지속적인 개발 파트너입니다.
---
`bash`
npx csdd
프로젝트의 .claude/ 폴더에 스킬들이 설치됩니다:
`
your-project/
├── .claude/
│ └── skills/ # 파이프라인 스킬들
│ ├── global/ # 오케스트레이터, Phase 체커
│ ├── scaffold/ # 스키마, API 계약
│ ├── data/ # 테스트 데이터, 마이그레이션
│ ├── verification/ # 테스트, 검증
│ ├── documentation/ # README, CHANGELOG
│ └── deployment/ # 컨테이너, CI/CD
├── csdd.yaml # 프로젝트 설정
└── .csdd/ # 런타임 생성물
└── cli/ # 스킬이 생성한 CLI들
---
`bash1. CSDD 설치
npx csdd
---
스킬 구조
각 스킬은 SKILL.md(지식)와 templates/(CLI 청사진)로 구성됩니다:
skills/scaffold/schema-designer/
├── SKILL.md # 스킬의 역할, 워크플로우, CLI 생성 방법
└── templates/
└── schema_designer.py.template # CLI 템플릿
스킬이 프로젝트를 분석한 후, 맥락에 맞는 맞춤형 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
yaml
csdd.yaml
project:
name: my-project
type: rest-api # rest-api | cli-tool | web-app | data-pipeline
language: python
framework: fastapidatabase:
type: postgresql
orm: sqlalchemy
gates:
strict_mode: true
require_user_approval: true
``---
| 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 |
---
| 문서 | 설명 |
|------|------|
| ARCHITECTURE.md | 상세 아키텍처 |
| GETTING_STARTED.md | 시작 가이드 |
| PHASE_GATES.md | Phase Gate 시스템 |
| SKILL_DEVELOPMENT.md | 커스텀 스킬 개발 |
---
| 특성 | 기존 AI 코딩 | CSDD |
|------|-------------|------|
| 구조 | 통합된 코드 생성 | 모듈화된 파이프라인 |
| 수정 | 전체 맥락에서 디버깅 | 해당 스킬/CLI만 수정 |
| 확장 | 프롬프트 수정 | 스킬 추가 |
| 검증 | 결과물 확인 | 단계별 Gate |
| 배포 | 생성된 코드 그대로 | Standalone Export |
| 유지보수 | 다시 생성 | 스킬 재활용 |
---
MIT License
v0.1.0