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

SkillDocs & knowledge

Applies the hyper-waterfall task start procedure. Checks GitHub issue registration, updates {BASE_BRANCH}, creates a local/task{N} branch, adds an item to today's to-do list, and generates a work plan template. Used to align the working phase before starting new code or document changes.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the 하이퍼-워터폴 타스크 시작 skill

What this skill tells your AI

The instructions your AI receives, as published by postmelee/hyper-waterfall in templates/mydocs/skills/task-start/SKILL.md and read by ahel’s review.

트리거

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

사전 조건

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

절차

  1. 이슈 정보 확인
    gh issue view {N} --json number,title,milestone,state,body
    
  2. {BASE_BRANCH} 최신화
    git fetch origin
    git checkout {BASE_BRANCH}
    git pull --ff-only
    
  3. 작업 브랜치 생성. 다른 작업자가 메인 worktree를 점유 중이면 분리 worktree 사용:
    # 단일 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. 변경 검증
    git status --short
    git diff --check
    
  7. 단일 커밋
    git add mydocs/plans/task_m{milestone}_{N}.md mydocs/orders/{yyyymmdd}.md
    git commit -m "Task #{N}: 수행 계획서 작성과 오늘할일 갱신"
    
  8. 작업지시자에게 수행계획서 승인 요청

검증

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

절대 하지 말 것

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

호출 방법

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

Signals

GitHub stars
80
Forks
15
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
task-start
Source
github.com/postmelee/hyper-waterfall