taskforge-help

name	taskforge-help
description	Guides the user through the full TaskForge Pro usage and workflow. Use when the user says "/taskforge-help", "help", "how do I use this", "how does this work", "what do I do first", or similar. Also suggests the appropriate next step based on the current situation.

Help — Usage Guide v2

Explain all TaskForge Pro features and recommend the appropriate next step based on the current project state.

On Execution

1. Detect Current State

Check project state files to determine which stage the project is at.

Check _workspace/projects/ for existing projects. If multiple exist, show all with their states.

Files present (under _workspace/projects/{projectId}/)	State	Recommended next step
Nothing in _workspace/projects/	시작 전	/taskforge-discover — 프로젝트 정의 시작
spec-card.json only	정의 완료	/taskforge-plan — 작업 계획 수립
project-plan.json (unapproved)	계획 검토 중	/taskforge-plan 에서 승인
execution-state.json	실행 중	/taskforge-execute 또는 /taskforge-execute-all
Sprint complete state	스프린트 완료	/taskforge-validate 또는 /taskforge-status 확인
Milestone complete state	마일스톤 완료	/taskforge-validate milestone — 품질 검증 필수
Fully complete	마무리	/taskforge-retro — 회고 후 종료

2. Show Situation-Specific Guidance

TaskForge Pro — 현재 상황

프로젝트: {projectName}
진행: 마일스톤 {m}/{M} — 스프린트 {s}/{S} — 태스크 {t}/{T}

지금 할 수 있는 것:
- /taskforge-execute     — 다음 태스크 1개 실행: "{nextTaskName}" [{difficultyLabel}]
- /taskforge-execute-all — 이번 스프린트 끝까지 자동 실행
- /taskforge-status      — 전체 진행 상황 보기

3. First-Time User Guide

If no project files exist:

TaskForge Pro 처음 시작하기

1. /taskforge-discover  — 만들고 싶은 것을 대화로 정의
2. /taskforge-plan      — AI가 작업을 자동으로 쪼개줌
3. /taskforge-execute-all — 자동으로 실행 (또는 /taskforge-execute로 하나씩)
4. /taskforge-validate milestone — 완성도 자동 검증
5. /taskforge-playtest  — 직접 확인
6. /taskforge-retro     — 회고 + 다음 단계 계획

작은 수정 하나라면: /taskforge-quick 으로 바로 시작

전체 워크플로우 안내

대규모 프로젝트 (마일스톤 3개 이상)

/taskforge-vision      → 전체 방향 + 마일스톤 스케치
/taskforge-discover    → 이번 마일스톤 상세 정의
/taskforge-plan        → 작업 쪼개기 + 승인
/taskforge-execute-all → 자동 실행
/taskforge-validate milestone → 품질 검증
/taskforge-playtest    → 직접 확인
/taskforge-retro       → 회고 + 다음 마일스톤 계획 갱신
(다음 마일스톤으로 반복)

소규모 프로젝트 (마일스톤 1-2개)

/taskforge-discover    → 바로 정의 시작
/taskforge-plan        → 작업 쪼개기
/taskforge-execute     → 하나씩 실행
/taskforge-validate    → 검증

빠른 수정

/taskforge-quick       → 바로 실행 (계획 없이)

전체 스킬 목록 (v2)

스킬	용도
/taskforge-vision	전체 프로젝트 방향과 마일스톤을 큰 그림으로 스케치 (대규모 프로젝트용)
/taskforge-discover	이번 마일스톤에서 만들 것을 대화로 구체적으로 정의
/taskforge-plan	정의된 내용을 작업 단위로 쪼개고 계획 수립
/taskforge-plan-edit	수립된 계획을 수정 (태스크 추가/삭제/변경)
/taskforge-execute	다음 태스크 1개를 실행
/taskforge-execute-all	이번 스프린트의 모든 태스크를 자동으로 연속 실행
/taskforge-quick	계획 없이 지금 당장 작은 수정 하나를 실행
/taskforge-validate	AI가 자동으로 완성도를 검증 (빌드, 코드 품질 등)
/taskforge-playtest	직접 사용해보면서 재미나 완성도를 확인
/taskforge-retro	마일스톤 마친 후 회고 + 다음 마일스톤 계획 업데이트
/taskforge-verify	완성된 결과를 대화로 함께 확인
/taskforge-status	전체 진행 상황을 한눈에 보기
/taskforge-cost	지금까지 사용한 비용 요약

자주 묻는 질문

Q: 실행 중에 멈추고 싶어요. A: "stop" 또는 "멈춰"라고 하면 현재 태스크가 끝난 뒤 멈춥니다. 이후 /taskforge-execute로 하나씩 이어갈 수 있습니다.

Q: 태스크가 실패했어요. A: /taskforge-status에서 실패 위치를 확인하고, 자동으로 재시도가 이루어집니다. 계속 실패하면 /taskforge-quick으로 직접 다른 방식을 시도할 수 있습니다.

Q: 스프린트가 끝났는데 다음에 뭘 해야 해요? A: /taskforge-status에서 백그라운드 검증 결과를 확인한 뒤, /taskforge-execute-all로 다음 스프린트를 이어가면 됩니다.

Q: 마일스톤이 끝났는데 다음에 뭘 해야 해요? A: 반드시 /taskforge-validate milestone을 먼저 실행해 품질을 확인한 뒤, /taskforge-playtest로 직접 확인하고, /taskforge-retro로 회고하세요.