결정 지도 설계

에이전트 세션 하나에 담기엔 너무 크고 안개에 싸여 있어서, 목적지까지의 길이 아직 보이지 않는 작업에는 이 스킬을 쓴다. 이 스킬은 필요한 결정을 티켓으로 나누어 저장소 이슈 트래커의 공유 지도에 기록한다. 각 결정 티켓은 실행할 빌드 조각이 아닌 질문을 담는다. 에이전트는 티켓을 하나씩 해결해 목적지에 도달한다.

목적지는 노력마다 다르고, 이름을 붙이는 것이 설계의 첫 행위이다. 이름이 모든 티켓의 형태를 결정한다. 인계해 반복할 명세, 계획 시작 전에 잠글 결정, 또는 데이터 구조 마이그레이션처럼 자리에서 이루어지는 변경일 수 있다. 지도는 도메인에 무관하다: 엔지니어링 작업, 강좌 콘텐츠, 형태에 맞는 무엇이든.

계획하지, 하지 않는다

이 스킬의 기본 동작은 계획 수립이다. 각 티켓에서 하나의 결정을 해결한다. 필요한 결정을 모두 내리면 지도를 마친다. 이때 실행을 시작하기 전에 더 결정할 일이 남지 않는다.

바로 작업하고 싶다면 보통 지도를 마치고 인계할 시점이다. 노력의 Notes에 실행을 포함할 수 있지만, 그 기록 자체가 구현을 승인하지는 않는다. 구현 전환에는 아래 승인 규칙을 적용한다. 그런 지시가 없으면 이 스킬의 결과는 실행 산출물이 아니라 결정이다.

구현 전환 승인

구현을 시작하기 전에 변경 범위, 구현 방식, 검증 방법을 사용자에게 제시하고 명시적인 구현 승인을 받는다. 승인을 기다리는 동안에는 구현을 시작하지 않는다. 계획 수립이나 검토, 결정 티켓 진행에 대한 동의는 구현 승인이 아니다. "계속 진행"이라는 응답은 사용자가 무엇에 동의했는지 문맥으로 판단한다. 계획 진행 요청을 구현 권한으로 확대하지 않는다.

이 규칙은 Notes에 실행을 포함한 경우에도 적용한다. 단일 티켓 규모라서 vibe-implement로 바로 전환하는 경우에도 같은 승인이 필요하다. 직행은 중간 계획 문서 단계를 줄이는 것이며, 계획 제시와 구현 승인을 생략하는 것이 아니다.

사용자가 이미 제시된 계획의 해당 범위를 명시적으로 구현 승인했다면 다시 묻지 않는다. 구현 범위가 승인 범위를 벗어나면 변경된 계획을 제시한다. 추가 범위의 승인을 받은 뒤 구현을 진행한다.