# Task Start

> 하이퍼-워터폴 타스크 시작 절차를 적용한다. GitHub 이슈 등록 확인, {BASE_BRANCH} 최신화, local/task{N} 브랜치 생성, 오늘할일 항목 추가, 수행계획서 템플릿 생성을 수행한다. 새 코드/문서 변경을 시작하기 전 진행 단계 정렬 용도.

- Skill: `postmelee/task-start` (Agent Skill)
- Install (CLI): `npx skillmds@latest add postmelee/task-start`
- Raw SKILL.md: https://api.skillmd.com/api/skills/postmelee/task-start/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: postmelee (https://skillmd.com/u/postmelee)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/postmelee/task-start

---


# 하이퍼-워터폴 타스크 시작

## 트리거

- 작업지시자가 "이슈 #N 시작", "타스크 #N 진행"처럼 명시 지시한 경우
- 작업지시자가 본 SKILL을 직접 호출한 경우

## 사전 조건

- 작업지시자 승인된 이슈 번호와 마일스톤이 존재
- 작업 대상 저장소 working tree clean (또는 분리된 worktree 사용 결정)
- 현재 사용자 자격 증명으로 `gh` CLI 인증 완료

## 절차

1. 이슈 정보 확인
   ```bash
   gh issue view {N} --json number,title,milestone,state,body
   ```
2. {BASE_BRANCH} 최신화
   ```bash
   git fetch origin
   git checkout {BASE_BRANCH}
   git pull --ff-only
   ```
3. 작업 브랜치 생성. 다른 작업자가 메인 worktree를 점유 중이면 분리 worktree 사용:
   ```bash
   # 단일 worktree
   git checkout -b local/task{N}

   # 분리 worktree (권장: 다른 에이전트 비간섭)
   git worktree add ../{repo}-task{N} -b local/task{N} origin/{BASE_BRANCH}
   ```
4. 오늘할일 갱신: `mydocs/orders/{yyyymmdd}.md`에 행 추가
   - 출력 형식은 `mydocs/_templates/orders.md`를 기준으로 한다.
   - 형식: `| #{N} | {타스크 제목} | 진행중 | M{milestone}, 수행계획서 작성 후 승인 대기 |`
   - 적절한 마일스톤 섹션에 배치 (운영 작업은 "공통 — 운영 작업")
5. 수행계획서 생성: `mydocs/plans/task_m{milestone}_{N}.md`
   - 중앙 템플릿 `mydocs/_templates/task_plan.md`를 기준으로 작성한다.
   - 템플릿을 읽을 수 없는 경우에만 다음 최소 섹션을 fallback으로 사용한다: 목적 / 배경 / 범위(포함·제외) / 설계 방향 / 예상 변경 파일 / 잠정 단계(3~6단계) / 검증 계획 / 리스크 / 승인 요청 사항
6. 변경 검증
   ```bash
   git status --short
   git diff --check
   ```
7. 단일 커밋
   ```bash
   git add mydocs/plans/task_m{milestone}_{N}.md mydocs/orders/{yyyymmdd}.md
   git commit -m "Task #{N}: 수행 계획서 작성과 오늘할일 갱신"
   ```
8. 작업지시자에게 수행계획서 승인 요청

## 검증

- `git log --oneline -1`이 `Task #{N}: 수행 계획서 작성과 오늘할일 갱신`을 보여야 한다
- `mydocs/orders/{yyyymmdd}.md`에 #{N} 행 존재
- `mydocs/plans/task_m{milestone}_{N}.md`가 `mydocs/_templates/task_plan.md`의 필수 섹션을 채움

## 절대 하지 말 것

- 수행계획서 승인 전 구현 계획서 작성
- 수행계획서 승인 전 코드/매뉴얼 변경
- 다른 작업자의 미커밋 변경 또는 다른 task 브랜치 working tree 건드리기

## 호출 방법

- Codex: `$task-start` 또는 `/skills` 메뉴에서 `task-start` 선택
- Claude Code: `/task-start`