# dev-docs

> 개발 작업 문서화 및 추적 도구. 사용자가 (1) 활성 작업 목록 확인, (2) 새 작업 시작, (3) 작업 진행상황 업데이트, (4) 완료된 작업 이관을 요청할 때 사용. /dev:docs, "dev docs", "작업 상태 업데이트" 등으로 트리거.

- Author: Jusun Kim
- Repository: e-jusun/cc-system
- Version: 20260101142533
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/e-jusun/cc-system
- Web: https://mule.run/skillshub/@@e-jusun/cc-system~dev-docs:20260101142533

---

---
name: dev-docs
description: 개발 작업 문서화 및 추적 도구. 사용자가 (1) 활성 작업 목록 확인, (2) 새 작업 시작, (3) 작업 진행상황 업데이트, (4) 완료된 작업 이관을 요청할 때 사용. /dev:docs, "dev docs", "작업 상태 업데이트" 등으로 트리거.
---

# Dev Docs

개발 작업의 계획(plan), 컨텍스트(context), 태스크(tasks)를 문서화하고 추적하는 시스템.

## 폴더 구조

모든 프로젝트에서 `.claude/dev/` 폴더를 사용:

```
.claude/dev/
├── active/           # 진행 중인 작업
│   └── [task-name]/
│       ├── [task-name]-plan.md
│       ├── [task-name]-context.md
│       └── [task-name]-tasks.md
└── completed/        # 완료된 작업 아카이브
```

자세한 구조 설명은 [references/folder-structure.md](references/folder-structure.md) 참조.

## 워크플로우

### 1. 활성 작업 확인

```bash
ls -la .claude/dev/active/
```

**결과에 따라:**
- **0개**: 새 작업 생성 제안
- **1개**: 자동 선택
- **2개+**: AskUserQuestion으로 선택

### 2. 완료 작업 확인 및 이관

tasks.md에서 진행 중/대기 중 항목이 0개이고 완료 기준이 모두 충족되면:

```bash
mv .claude/dev/active/[task-name] .claude/dev/completed/
```

### 3. 새 작업 생성

```bash
python3 ~/.claude/skills/dev-docs/scripts/init_task.py [task-name] .claude/dev/active/
```

또는 수동으로 [assets/](assets/) 템플릿 사용.

### 4. 문서 업데이트

각 파일 읽고 현재 대화 컨텍스트 기반으로 갱신:

| 파일 | 역할 | 업데이트 시점 |
|------|------|--------------|
| plan.md | 구현 계획, 기술적 접근 | 계획 변경 시 |
| context.md | 핵심 파일, 결정사항, 의존성 | 중요 변경 발생 시 |
| tasks.md | 진행 상태, 다음 단계 | 매 업데이트 |

**타임스탬프 형식:** `**Last Updated**: YYYY-MM-DD HH:MM`

### 5. 결과 보고

```
╔════════════════════════════════════════════════════════════╗
║  ✅ Dev Docs 업데이트 완료                                   ║
╚════════════════════════════════════════════════════════════╝

작업: [task-name]
위치: .claude/dev/active/[task-name]/

업데이트된 파일:
✓ [task-name]-plan.md
✓ [task-name]-context.md
✓ [task-name]-tasks.md

💡 다음 단계:
[tasks.md의 다음 단계 내용]
```

## 템플릿

새 작업 생성 시 [assets/](assets/) 폴더의 템플릿 사용:
- `plan-template.md` - 구현 계획
- `context-template.md` - 컨텍스트 정보
- `tasks-template.md` - 태스크 추적

## 스크립트

- `scripts/init_task.py` - 새 작업 폴더 및 파일 자동 생성

## 예외 처리

### 폴더가 없는 경우

```bash
mkdir -p .claude/dev/active .claude/dev/completed
```

### 작업 이름 규칙

- kebab-case 사용 (예: `api-key-management`)
- 공백/특수문자 포함 시 자동 변환 제안