마크다운 파일로 7,600개 태스크를 관리하는 시스템

Source: Dev.to

개요

태스크 하나가 폴더 하나이며, 그 안에 index.md 파일이 존재합니다. YAML frontmatter에 메타데이터를 기록하고, 폴더 구조가 카테고리 역할을 합니다. DB 없이 파일 시스템이 데이터베이스 역할을 합니다.

현재 7,655개 태스크가 94% 완료율로 운영 중입니다.

hq/
├── 회사A/
├── 회사B/
├── 개인/
└── inbox/

태스크 구조

배포-프로세스-개선/
└── index.md

frontmatter (YAML)

date: 2026-02-07
estimation: 2h
focus_time: 1h 30m
priority: P1
done: false
recurrence: weekly

본문에 상세 내용, 메모, 결과물을 자유롭게 적습니다.

frontmatter 필드

중복 태스크 명명 규칙

같은 이름의 태스크가 생기면 ___숫자를 붙입니다. 예: 주간_회의, 주간_회의___2, 주간_회의___3.

Claude Code Skills 연동

Claude Code의 Skills 시스템으로 자연어 명령을 태스크 조작으로 연결합니다.

• 시작: ~/.focus_session.json에 시작 시간을 기록
• 완료: 경과 시간을 계산하여 focus_time에 누적

포커스 세션 예시

🎯 포커스 시작!
   태스크: index.md
   시작: 2026-02-07T12:24:53

✅ 포커스 종료!
   태스크: index.md
   소요 시간: 56m

동시에 하나의 세션만 허용됩니다.

반복 태스크 자동 생성

recurrence 필드가 있는 태스크를 완료하면 다음 날짜의 태스크를 자동 생성합니다. done은 false로 초기화하고 focus_time은 비웁니다.

• weekly → +7일
• daily → +1일

오늘 할일 스크립트 예시

"오늘 할일"이라고 말하면 Python 스크립트가 전체 파일을 스캔합니다.

📅 오늘 할일 (2026-02-07)

📋 오늘 (2개)
  ⬜ [P1] 블로그_글쓰기 (2026-02-07) 🔄
  ⬜ [P1] 코드_리뷰 (2026-02-07)

⚡ 높은 우선순위 미배정 (1개)
  ⬜ [P1] 시스템_개선

기한이 지난 미완료 태스크와 날짜가 없는 P0/P1 태스크도 함께 표시됩니다.

연동 대상

시스템 흐름

1. 사용자 (시작, 완료, 오늘 할일)
2. Claude Code Hook (키워드 감지)
3. Skill (Python 스크립트 실행)
4. 마크다운 파일 (frontmatter 업데이트)
5. Git (버전 관리, 푸시)

태스크 라이프사이클

• 생성 → 날짜/우선순위 배정 → 포커스 시작 → 완료 → (반복이면) 다음 태스크 자동 생성