create-docops

DocOps - Evidence 기반 문서 관리 시스템 설치 도구

특징

• TypeScript 지원: 완전한 타입 안전성
• 다국어 지원 (i18n): 한국어/영어 메시지
• 보안 강화: Path traversal 방어, 콘텐츠 검증
• SHA256 체크섬: 파일 무결성 검증
• 테스트 완비: 71개 테스트 케이스

설치

# 새 프로젝트에 DocOps 설치
npx create-docops

# 최신 버전으로 업데이트
npx create-docops --update

# 업데이트 확인만
npx create-docops --check

사용법

새 프로젝트에 설치

cd my-project
npx create-docops

기존 프로젝트에 설치

cd existing-project
npx create-docops
# 자동으로 MIGRATE 모드 감지

업데이트

# 업데이트 확인
npx create-docops --check

# 업데이트 실행
npx create-docops --update

# 정책 문서 포함 업데이트 (백업 생성됨)
npx create-docops --update --force

옵션

| 옵션 | 설명 | |------|------| | (없음) | DocOps 설치 | | --update, -u | 최신 버전으로 업데이트 | | --check, -c | 업데이트 확인만 | | --force, -f | 강제 덮어쓰기 | | --verbose | 상세 로그 | | --help, -h | 도움말 | | --version, -v | 버전 |

설치되는 파일

항상 업데이트

• scripts/* - CLI 도구
• .claude/skills/docops/* - AI 에이전트 Skill

초기 설치만

• docs/00_ssot/* - SSOT 문서
• CLAUDE.md - 프로젝트 지침

업데이트 안 함 (사용자 데이터)

• docs/00_ssot/COVERAGE_MATRIX.md
• docs/00_ssot/DRIFT_REPORT.md
• docs/03_standards/specs/*

설치 후

1. Claude Code에서 /docops:verify 실행
2. 첫 Spec 문서 작성 (DOC_POLICY.md 섹션 8 참조)
3. 작업 완료 시 /docops:finish 실행

개발

빌드

cd packages/create-docops
npm install
npm run build        # TypeScript 컴파일
npm test            # 테스트 실행

프로젝트 구조

src/
├── commands/
│   ├── init.ts       # 설치 명령어
│   └── update.ts     # 업데이트 명령어
├── utils/
│   ├── cli.ts        # CLI 유틸리티
│   ├── errors.ts     # 에러 처리
│   ├── files.ts      # 파일 유틸리티
│   ├── checksum.ts   # SHA256 체크섬
│   └── i18n.ts       # 다국어 지원
└── index.ts          # 메인 엔트리

문서

• DocOps README
• 사용자 매뉴얼
• 전체 스펙

License

MIT