create

Task List — 생성/추가

~/.claude/tasks/에 태스크 리스트를 생성하거나 기존 리스트에 태스크를 추가합니다.

메타데이터 컨벤션

필드	타입	설명	예시
deadline	ISO date	마감일	2026-03-25
priority	enum	중요도	high, medium, low
category	string	분류	finance, legal, meeting, dev

메타데이터는 선택 사항. 사용자가 언급하지 않으면 생략한다. deadline은 제목에 명시적이거나("오늘 ~") 사용자가 직접 말한 경우만 채운다. 임의로 추론하지 않는다.

• "오늘까지" / "오늘 ~" → deadline: <오늘 날짜>
• "급한" / "중요한" → priority: high

Step 1: 리스트 이름 결정

$ARGUMENTS에 리스트 이름이 있으면 사용. 없으면 질문한다.

기존 리스트에 추가할지, 새로 만들지 판단:

ls ~/.claude/tasks/ | grep -v '^[0-9a-f]\{8\}-'

Step 2: 태스크 항목 파싱

사용자가 제공한 항목들에서 추출:

• subject: 태스크 제목
• description: 상세 설명 (없으면 subject와 동일)
• metadata: deadline, priority, category (문맥에서 추론)
• blockedBy: 의존 관계 (사용자가 명시한 경우만)

Step 3: 생성

새 리스트인 경우, 먼저 guard task(0.json)를 생성한다. 이 태스크는 모든 태스크가 completed 되었을 때 Claude Code가 리스트 디렉토리를 자동 삭제하는 것을 방지한다.

mkdir -p ~/.claude/tasks/<list-name>
python3 -c "
import json, os

base = os.path.expanduser('~/.claude/tasks/<list-name>')

# Guard task — 새 리스트일 때만 생성
guard_path = os.path.join(base, '0.json')
if not os.path.exists(guard_path):
    guard = {
        'id': '0',
        'subject': 'Do Not Complete This Task',
        'description': 'This is a guard task to prevent the task list from being auto-deleted when all other tasks are completed. Do NOT mark this task as completed.',
        'status': 'pending',
        'blocks': [],
        'blockedBy': []
    }
    with open(guard_path, 'w') as f:
        json.dump(guard, f, indent=2, ensure_ascii=False)
    print('  ✓ 0. Guard task created')

# 기존 태스크 ID 이어서 번호 매기기 (0은 guard이므로 제외)
existing = [int(f.split('.')[0]) for f in os.listdir(base) if f.endswith('.json') and f != '0.json']
next_id = max(existing) + 1 if existing else 1

tasks = [
    # (subject, description, metadata_dict, blocked_by_list)
]

for i, (subj, desc, meta, blocked) in enumerate(tasks):
    tid = str(next_id + i)
    task = {
        'id': tid,
        'subject': subj,
        'description': desc,
        'status': 'pending',
        'blocks': [],
        'blockedBy': blocked,
    }
    if meta:
        task['metadata'] = meta
    with open(os.path.join(base, f'{tid}.json'), 'w') as f:
        json.dump(task, f, indent=2, ensure_ascii=False)
    print(f'  ✓ {tid}. {subj}')
"

Step 4: 결과 표시

생성된 태스크를 마크다운 테이블로 표시:

#	Task	Deadline	Priority	Category
1	example	2026-03-25	high	finance

메타데이터가 없는 컬럼은 -로 표시.