QDM - Quantum Documentation Method

AI 기반 문서 중심 개발 방법론

QDM은 소규모 팀(5명 이하)을 위한 AI 기반 개발 방법론입니다. 모든 작업을 체계적으로 문서화하고 추적하여 AI IDE와의 협업을 최적화합니다.

특징

• 사용자 수준 적응: 초보자부터 전문가까지 맞춤 설명
• 실패 학습: Debug Log로 모든 시행착오 기록 보존
• 컨텍스트 복원: 언제든 작업 재개 가능
• IDE 독립: Claude Code, Cursor, VS Code, Codex, OpenCode 지원

설치

npm install -g qdm

시작하기

# 프로젝트 폴더에서
qdm init

대화형 설정 후 QDM이 설치됩니다.

사용법

Claude Code

/qdm                    # Quinn 에이전트 메뉴
/qdm:feature "설명"     # 새 기능 개발 (spec + plan + status)
/qdm:bug "설명"         # 버그 수정 (adaptive 3-5 steps)
/qdm:ui "설명"          # UI 변경 (2 steps)
/qdm:status             # 작업 현황

Cursor

@qdm/agent              # Quinn 에이전트
@qdm/feature            # 새 기능 개발
@qdm/bug                # 버그 수정
@qdm/ui                 # UI 변경
@qdm/status             # 작업 현황

OpenCode / Codex CLI

/qdm-agent              # Quinn 에이전트
/qdm-feature            # 새 기능 개발
/qdm-bug                # 버그 수정
/qdm-ui                 # UI 변경
/qdm-status             # 작업 현황

CLI에서

qdm status              # 작업 현황 확인
qdm help                # 도움말

워크플로우

Feature Development (7단계)

init → 요구사항분석 → 코드분석 → spec작성 → plan작성 → status초기화 → 개발준비완료

출력물:

• spec.md - 뭘 만들 건지
• plan.md - 어떻게 만들 건지
• status.md - 진행 상황

Bug Fix (적응형 3-5단계)

assess → [simple: fix] 또는 [complex: investigate → root-cause → plan → execute]

UI Fix (2단계)

assess → execute

생성되는 파일 구조

your-project/
├── _qdm/                    # QDM 설정 및 워크플로우
│   ├── config.yaml
│   ├── agents/
│   ├── workflows/
│   └── templates/
├── _sdd/                    # 작업 추적 폴더
│   ├── index.yaml           # 전체 작업 현황
│   ├── _user/profile.yaml   # 사용자 프로필 (gitignore)
│   ├── feature-xxx/
│   │   ├── spec.md
│   │   ├── plan.md
│   │   └── status.md
│   └── bug-xxx/
│       └── status.md
└── .claude/commands/qdm/    # IDE 통합 (자동 생성)

사용자 수준 적응

Quinn 에이전트는 프로필 기반으로 설명을 조절합니다:

| 수준 | 인사 | 설명 스타일 | 코드 참조 | |------|------|-------------|-----------| | 초보 | 친근하고 환영 | 비유 + 단계별 | "이 파일을 열어보세요" | | 중급 | 협업적 | 핵심 개념 | "handleSubmit 함수" | | 고급 | 간결 | 기술 용어 | "auth.ts:validateToken" | | 전문가 | 최소 | 패턴 이름 | "auth.ts:45" |

지원 IDE

| IDE | 디렉토리 | 명령어 형식 | |-----|---------|------------| | Claude Code | .claude/commands/qdm/ | /qdm, /qdm:feature | | Cursor | .cursor/rules/qdm/ | @qdm/agent, @qdm/feature | | OpenCode | .opencode/agent/, .opencode/command/ | /qdm-agent, /qdm-feature | | Codex CLI | .codex/prompts/ | /qdm-agent, /qdm-feature |

라이선스

Apache License 2.0

기여

이슈와 PR을 환영합니다!

Made with ❤️ for AI-assisted development