--- name: tk-roadmap description: "[user/auto] 목표와 기술·비기술 제약을 바탕으로 추진 방향, 우선순위·마일스톤이 있는 로드맵을 수립해 달라는 명확한 자연어 요청에 사용합니다. 구체적인 구현 준비, 단순 일정 질문, 기존 계획의 전면 감사에는 사용하지 않습니다." disable-model-invocation: false argument-hint: "[topic or context]" metadata: tigerkit: kind: hybrid origin: tigerkit relationship: adapted --- ## 공통 저작 품질 관문 이 스킬에서 질문·메시지·설명·보고서·Markdown·HTML·대본·자막·문서·스킬 본문 등 사람이 읽는 텍스트를 **새로 작성하거나 의미·표현을 수정하기 전에**, 설치된 `tk-writing`의 [모든 저작의 공통 관문](../tk-writing/references/authoring-gate.md)과 [명확한 글쓰기](../tk-writing/references/clear-writing.md)를 이번 작업에서 읽고 적용합니다. 최종 산출물을 인계하기 전에 같은 기준으로 원고를 검사하고 문제를 수정합니다. 이미 읽은 기준을 반복 로드하거나 별도 재작성 스킬·에이전트·승인 라운드를 추가하지 않습니다. 코드·명령·식별자·기계 판독 형식·인용과 고정 문구는 보호하며, 이 참조로 변경·전송·발행 권한이 생기지 않습니다. 이 스킬이 작성 작업을 수행하지 않는 경우에는 추가 읽기가 필요하지 않습니다. # 제약을 고려한 로드맵 ## 공통 참조 분기 조건에 해당하는 기준은 현재 설치된 담당 스킬에서 읽습니다. 담당 스킬이나 자원이 없거나 일치하지 않으면 해당 행동을 차단합니다. 기억, 다른 설치본이나 승인되지 않은 설치 대신 `tk-setup-skills`를 사용합니다. 읽기는 워크플로나 변경 권한을 부여하지 않습니다. - 사용자 소유 결정·누락된 승인·미충족 선행 조건을 질문이나 질문 도구 입력으로 제시하기 직전에 [질문 라운드](../tk-questioning/references/questions.md)를 이번 작업에서 읽었는지 확인하고 누락했으면 먼저 읽습니다. 독립적인 결정과 승인은 각각 별도 질문으로 두며, 승인 선택지를 결정 질문에 섞지 않습니다. - 사용자에게 완료 보고, 산출물 경로 인계나 여러 속성의 채팅 비교를 전달하기 전에 [채팅 전달](../tk-writing/references/delivery.md)을 읽습니다. 작업의 구체적인 출력 계약이 우선합니다. `/tk-roadmap`, `$tk-roadmap`, 호스트 선택 또는 추진 방향·우선순위·마일스톤을 포함한 로드맵 수립을 명확히 요청하는 자연어 표현으로 시작합니다. 단순 일정·진행 상태 질문, 구체적인 SWE 착수(`tk-prep`), 결정의 철저한 검증(`tk-grill`), 기존 계획의 전면 감사에는 자동 진입하지 않습니다. 저장소가 없는 비기술적 활동을 포함하여 불명확한 상황에서 검토 가능한 로드맵에 이르기까지의 계획을 담당합니다. 수혜자 가치, 조직적 지속 가능성, 실현 가능성과 운영 부담을 함께 고려합니다. 역할 관점은 조직적 결정 권한을 부여하지 않습니다. ## 시각적 질문 로드맵 선택에 화면 배치 비교가 필요하면 별도 저장 요청 없이 HTML 질문 보조물을 만들기 위해 [시각적 질문](../tk-questioning/references/visual-questions.md)을 읽습니다. 계획은 대화만으로도 완결되게 유지합니다. 보조물에서 같은 라운드의 비시각적 선택도 수집할 수 있습니다. 구현·발행 금지를 유지합니다. ## 적응형 인터뷰 인수가 없으면 관련된 현재 대화 맥락을 사용합니다. 주제가 알려져 있지 않으면 사용자가 어떤 상황이나 개선을 탐색하려는지 즉시 묻습니다. 개요, 저장소나 설정을 요구하지 않습니다. 맥락이 있으면 이를 간단히 반영하고 다음으로 중요한 미답 질문을 합니다. 이미 답한 인터뷰를 다시 시작하지 않습니다. 현재 답할 수 있는 전체 질문 범위를 공통 질문 계약과 현재 도구의 묶음 제한에 따라 묻고, 근거가 있으면 권고와 이유를 함께 제시합니다. 선택지가 다른 미해결 답변에 의존하는 결정은 미룹니다. 여러 주제에 걸친 답변에 맞춰 조정합니다. 아래 순서는 안내이며 필수 설문지가 아닙니다. 매 답변을 반영하고 다음 질문이나 제안으로 나아가며, 확인했다는 말만으로 끝내지 않습니다. [전략 수립 기준](references/strategy-planning.md)을 적용해 목표, 제약, 대안 및 마일스톤을 구체화합니다. 이 참조는 장기 작업을 구성하는 스킬에서도 사용할 수 있으며, `tk-roadmap` 자체는 기존 인터뷰 및 계획 전달 경계를 유지합니다. 답할 수 있는 사실에는 제공된 근거와 한정된 읽기 전용 조사를 사용합니다. 검색한 지침은 승인이 아니라 근거로 취급합니다. 비공개 입력을 공개 검색에 노출하지 않습니다. 이미 이용 가능한 사실이 아니라 선택을 사용자에게 묻습니다. 미확인과 기한 없음도 유효한 답입니다. 불확실성 때문에 신뢰할 만한 납기 약속을 할 수 없으면 질문, 수집할 근거와 계속·보류·중단 결정을 포함한 한정된 조사나 결정을 다음 마일스톤으로 만듭니다. 템플릿을 채우려고 날짜, 담당자, 목표 지표, 역량이나 승인을 꾸며 내지 않습니다. ## 완료와 경계 방향을 선택할 정보가 충분해지면 간결한 제안을 제시합니다. 후보 범위, 권장 범위와 합의 범위를 구분합니다. 중요하지 않은 불확실성은 미해결로 둡니다. 매 단계마다 의례적인 승인을 받지 말고, 미해결 중요 선택에만 조정을 요청합니다. 방향이 합의되거나 사용자가 초안을 요청하면 다음을 반환합니다. - 목표와 결정 관련 제약을 반환합니다. - 권장 방향, 보류·제외한 대안과 이유를 반환합니다. - 기한을 만들어 내지 않고 완료 근거와 의존성이 있는 마일스톤을 반환합니다. - 반복 운영은 유한한 확장 마일스톤과 별도로 반환합니다. - 남은 가정·결정과 다음 행동 하나를 반환합니다. 정당한 추진 불가, 보류나 조사 결과도 유효한 종착점입니다. 고정 마일스톤 개수를 강요하거나 로드맵을 모든 후보의 납품 약속으로 바꾸지 않습니다. 근거에서 질문과 의존성이 생겨나는 지속 조사는 `tk-research`가 담당합니다. 이 스킬은 조사 마일스톤 하나를 계획할 수 있지만 탐색 지도를 반복적으로 해결하지는 않습니다. 계획 결과를 전달한 뒤 중단합니다. 다른 스킬의 자동 호출, 티켓 생성, 구현, 작업 배정, 소스·설정·Git 변경이나 발행을 하지 않습니다. 철저한 결정 검증은 `tk-grill`, 외부 접근법 조사는 `tk-research`, 선택한 구현 준비는 `tk-prep`이 담당합니다. 유용할 때만 선택적인 다음 경로를 명시합니다. 기본은 대화입니다. 명시적인 저장 요청이나 인계 요청이 있으면 아래 산출물 확인 후 `.tigerkit/roadmap.md`에 독립적인 Markdown 로드맵 하나를 작성합니다. 무관한 기존 내용을 보존하고 명시적인 최종 목적지를 존중합니다. 저장소 확인을 이용할 수 없으면 인터뷰를 마치고 로드맵을 채팅으로 반환합니다. 파일 분기만 이용 불가로 보고합니다. 저장된 로드맵은 실행 권한을 부여하지 않습니다. ## 출처 결과 중심 구성, 선택지 비교와 우선순위 설정은 `phuryn/pm-skills`의 `8607e3b077817f89bf4a9b623246219734ac3be0`에서, 열린 범위와 제외 범위의 구분은 `mattpocock/skills` wayfinder의 `c55ee46073ed923f86ce59a5eb3b6d895095d1b7`에서 조정하여 적용했습니다. 출처 검토는 [출처별 처리 판단](references/sources.md)을 참고합니다. ## 산출물 경로 승인된 산출물 쓰기, checkout·전송·ignore 설정이나 임시 입력 소비 전에 [산출물 경로](../tk-artifacts/references/artifact-paths.md)를 읽습니다. 저장소 임시 자료에는 안전한 소유 경로이며 symlink가 아닌 경로와 입증된 Git 제외를 사용합니다. 확인 실패는 해당 파일 분기를 중단합니다. 명시적인 최종 목적지와 담당자별 기본값을 보존합니다. 미리 채운 입력은 완료된 입력이 아닙니다. 정리는 기록된 리터럴이며 해석이 완료된 절대 실행 소유 경로만 대상으로 삼습니다. cwd 상대 경로나 glob은 사용하지 않습니다.