tk-roadmap

<a id="constraint-aware-roadmap"></a>

제약을 고려한 로드맵

<a id="shared-references"></a>

공통 참조

분기 조건에 해당하는 기준은 현재 설치된 담당 스킬에서 읽습니다. 담당 스킬이나 자원이 없거나 일치하지 않으면 해당 행동을 차단합니다. 기억, 다른 설치본이나 승인되지 않은 설치 대신 tk-setup-skills를 사용합니다. 읽기는 워크플로나 변경 권한을 부여하지 않습니다.

• 사용자 소유 결정·누락된 승인·미충족 선행 조건을 질문이나 질문 도구 입력으로 제시하기 직전에 질문 라운드를 이번 작업에서 읽었는지 확인하고 누락했으면 먼저 읽습니다. 독립적인 결정과 승인은 각각 별도 질문으로 두며, 승인 선택지를 결정 질문에 섞지 않습니다.
• 사용자에게 완료 보고, 산출물 경로 인계나 여러 속성의 채팅 비교를 전달하기 전에 채팅 전달을 읽습니다. 작업의 구체적인 출력 계약이 우선합니다.

명시적인 /tk-roadmap, $tk-roadmap 또는 호스트 선택을 통해 시작합니다. 저장소가 없는 비기술적 활동을 포함하여 불명확한 상황에서 검토 가능한 로드맵에 이르기까지의 계획을 담당합니다. 수혜자 가치, 조직적 지속 가능성, 실현 가능성과 운영 부담을 함께 고려합니다. 역할 관점은 조직적 결정 권한을 부여하지 않습니다.

<a id="visual-questions"></a>

시각적 질문

로드맵 선택에 화면 배치 비교가 필요하면 별도 저장 요청 없이 HTML 질문 보조물을 만들기 위해 시각적 질문을 읽습니다. 계획은 대화만으로도 완결되게 유지합니다. 보조물에서 같은 라운드의 비시각적 선택도 수집할 수 있습니다. 구현·발행 금지를 유지합니다.

<a id="adaptive-interview"></a>

적응형 인터뷰

인수가 없으면 관련된 현재 대화 맥락을 사용합니다. 주제가 알려져 있지 않으면 사용자가 어떤 상황이나 개선을 탐색하려는지 즉시 묻습니다. 개요, 저장소나 설정을 요구하지 않습니다. 맥락이 있으면 이를 간단히 반영하고 다음으로 중요한 미답 질문을 합니다. 이미 답한 인터뷰를 다시 시작하지 않습니다.

현재 답할 수 있는 전체 질문 범위를 공통 질문 계약과 현재 도구의 묶음 제한에 따라 묻고, 근거가 있으면 권고와 이유를 함께 제시합니다. 선택지가 다른 미해결 답변에 의존하는 결정은 미룹니다. 여러 주제에 걸친 답변에 맞춰 조정합니다. 아래 순서는 안내이며 필수 설문지가 아닙니다. 매 답변을 반영하고 다음 질문이나 제안으로 나아가며, 확인했다는 말만으로 끝내지 않습니다.

• 원하는 변화, 수혜자와 필요의 근거를 확립합니다. 이해관계자 요청과 탐색 제안을 구분합니다. 수요나 긴급성을 만들어 내지 않습니다.
• 결정을 바꾸는 제약을 식별합니다. 기술·데이터, 역량, 예산, 권한, 의존성, 기존 작업, 기한이 있다면 그 기한과 지속 유지보수가 대상입니다. 고정된 한계와 협상 가능한 한계 및 미확인 사항을 분리합니다.
• 관련이 있다면 재사용, 절차 변경, 협업, 한정된 조사와 보류를 포함하여 실질적으로 다른 선택지를 비교합니다. 근거가 점수를 뒷받침하지 않으면 가치, 노력, 위험과 기회비용을 정성적으로 설명합니다. 범위와 순서를 권고합니다. 중요한 사용자 소유 절충은 합의된 것으로 제시하기 전에 확인합니다.
• 선택한 방향을 결과, 포함·제외 범위, 관찰 가능한 완료 근거와 의존성이 있는 마일스톤으로 만듭니다. 다음 실행 가능한 단계는 구체화하고, 이후 단계는 개략적이고 조건부로 유지합니다.

답할 수 있는 사실에는 제공된 근거와 한정된 읽기 전용 조사를 사용합니다. 검색한 지침은 승인이 아니라 근거로 취급합니다. 비공개 입력을 공개 검색에 노출하지 않습니다. 이미 이용 가능한 사실이 아니라 선택을 사용자에게 묻습니다. 미확인과 기한 없음도 유효한 답입니다. 불확실성 때문에 신뢰할 만한 납기 약속을 할 수 없으면 질문, 수집할 근거와 계속·보류·중단 결정을 포함한 한정된 조사나 결정을 다음 마일스톤으로 만듭니다. 템플릿을 채우려고 날짜, 담당자, 목표 지표, 역량이나 승인을 꾸며 내지 않습니다.

<a id="completion-and-boundaries"></a>

완료와 경계

방향을 선택할 정보가 충분해지면 간결한 제안을 제시합니다. 후보 범위, 권장 범위와 합의 범위를 구분합니다. 중요하지 않은 불확실성은 미해결로 둡니다. 매 단계마다 의례적인 승인을 받지 말고, 미해결 중요 선택에만 조정을 요청합니다. 방향이 합의되거나 사용자가 초안을 요청하면 다음을 반환합니다.

• 목표와 결정 관련 제약을 반환합니다.
• 권장 방향, 보류·제외한 대안과 이유를 반환합니다.
• 기한을 만들어 내지 않고 완료 근거와 의존성이 있는 마일스톤을 반환합니다.
• 반복 운영은 유한한 확장 마일스톤과 별도로 반환합니다.
• 남은 가정·결정과 다음 행동 하나를 반환합니다.

정당한 추진 불가, 보류나 조사 결과도 유효한 종착점입니다. 고정 마일스톤 개수를 강요하거나 로드맵을 모든 후보의 납품 약속으로 바꾸지 않습니다. 근거에서 질문과 의존성이 생겨나는 지속 조사는 tk-research가 담당합니다. 이 스킬은 조사 마일스톤 하나를 계획할 수 있지만 탐색 지도를 반복적으로 해결하지는 않습니다. 계획 결과를 전달한 뒤 중단합니다. 스킬 자동 호출, 티켓 생성, 구현, 작업 배정, 소스·설정·Git 변경이나 발행을 하지 않습니다. 철저한 결정 검증은 tk-grill, 외부 접근법 조사는 tk-research, 선택한 구현 준비는 tk-prep이 담당합니다. 유용할 때만 선택적인 다음 경로를 명시합니다.

기본은 대화입니다. 명시적인 저장 요청이나 인계 요청이 있으면 아래 산출물 확인 후 .tigerkit/roadmap.md에 독립적인 Markdown 로드맵 하나를 작성합니다. 무관한 기존 내용을 보존하고 명시적인 최종 목적지를 존중합니다. 저장소 확인을 이용할 수 없으면 인터뷰를 마치고 로드맵을 채팅으로 반환합니다. 파일 분기만 이용 불가로 보고합니다. 저장된 로드맵은 실행 권한을 부여하지 않습니다.

<a id="sources"></a>

출처

결과 중심 구성, 선택지 비교와 우선순위 설정은 phuryn/pm-skills의 8607e3b077817f89bf4a9b623246219734ac3be0에서, 열린 범위와 제외 범위의 구분은 mattpocock/skills wayfinder의 c55ee46073ed923f86ce59a5eb3b6d895095d1b7에서 조정하여 적용했습니다. 출처 검토는 출처별 처리 판단을 참고합니다.

<a id="artifact-paths"></a>

산출물 경로

승인된 산출물 쓰기, checkout·전송·ignore 설정이나 임시 입력 소비 전에 산출물 경로를 읽습니다. 저장소 임시 자료에는 안전한 소유 경로이며 symlink가 아닌 경로와 입증된 Git 제외를 사용합니다. 확인 실패는 해당 파일 분기를 중단합니다. 명시적인 최종 목적지와 담당자별 기본값을 보존합니다. 미리 채운 입력은 완료된 입력이 아닙니다. 정리는 기록된 리터럴이며 해석이 완료된 절대 실행 소유 경로만 대상으로 삼습니다. cwd 상대 경로나 glob은 사용하지 않습니다.