🔷 11. 태스크 시스템

TaskCreate/Update/List/Get를 사용해 의존성 있는 작업을 병렬로 관리하는 방법을 설명합니다.

빠르게 실행 (복붙)

TaskCreate({ subject: "Build frontend" })
TaskCreate({ subject: "Run integration tests", blockedBy: ["T-001","T-002"] })
TaskList()
TaskUpdate({ id: "T-001", status: "completed" })

flowchart LR
A[TaskCreate] --> B[병렬 실행]
B --> C[blockedBy 해제]
C --> D[TaskUpdate 완료]

단계별 적용

1) Task 스키마 이해

• 설명: subject, blockedBy, blocks, status 필드 의미를 먼저 이해합니다.
• 실행 예시: TaskCreate({ subject: "Build frontend" })

2) 독립 작업 먼저 생성

• 설명: blockedBy가 빈 태스크부터 만들면 자동 병렬화됩니다.
• 실행 예시: TaskCreate({ subject: "Run integration tests", blockedBy: ["T-001","T-002"] })

3) 의존 작업 연결

• 설명: 통합 테스트/배포처럼 후행 작업에 blockedBy를 연결합니다.
• 실행 예시: TaskList()

4) 상태 갱신으로 진행

• 설명: TaskUpdate로 완료 표시하면 다음 작업이 자동 unblocked 됩니다.
• 실행 예시: TaskUpdate({ id: "T-001", status: "completed" })

5) 저장 경로 확인

• 설명: .sisyphus/tasks JSON 저장으로 세션 재시작 후에도 이어서 진행합니다.
• 실행 예시: TaskUpdate({ id: "T-001", status: "completed" })

부록) 원문 코드 스니펫 (검수용, 초보자는 건너뛰기)

[Build Frontend]    ──┐
                      ├──→ [Integration Tests] ──→ [Deploy]
[Build Backend]     ──┘

TaskCreate({ subject: "Build frontend" })                    // T-001
TaskCreate({ subject: "Build backend" })                     // T-002
TaskCreate({ subject: "Run integration tests",
             blockedBy: ["T-001", "T-002"] })                 // T-003

TaskList()
// T-001 [pending] Build frontend        blockedBy: []
// T-002 [pending] Build backend         blockedBy: []
// T-003 [pending] Integration tests     blockedBy: [T-001, T-002]

TaskUpdate({ id: "T-001", status: "completed" })
TaskUpdate({ id: "T-002", status: "completed" })
// T-003 now unblocked

마무리 체크

• 위 “빠르게 실행” 명령을 최소 1개 실행했다.
• 실패 시 “원문 실행 코드 확장”의 관련 코드를 사용해 재검증했다.
• 원본 항목 대조 인덱스에서 빠진 기능이 없는지 확인했다.

---

출처

• 원문(로컬): oh-my-opencode/docs/task-system.md
• 원문(GitHub): https://github.com/code-yeongyu/oh-my-opencode/blob/dev/docs/task-system.md