브레인스토밍
모호한 문제를 구조화된 후보 ADR 및 계획 항목 집합으로 변환합니다. 이 스킬은 생성적이며 읽기/제안 전용입니다 — ADR이나 계획 파일을 직접 작성하지 않습니다. 승인 시 각 후보를 new-adr 및 new-plan 스킬에 전달합니다.
0단계 — 전제 조건 및 컨텍스트
- 저장소가 부트스트랩되었는지 확인합니다 (또는 출력이 bootstrap 스킬의 새로운 실행을 시드할 수 있음을 기록합니다).
CONVENTIONS.md에서 ADR 모양과 수명 주기를 읽고,INDEX.md와 기존 ADR을 훑어 후보가 이미 있는 내용과 중복되거나 모순되지 않도록 하고 의존성이 실제 ADR을 가리키도록 합니다.
0.5단계 — 평가 (먼저 실행)
분해 전에 공유 평가 프로토콜을 실행합니다:
-
먼저 제공된 답변을 재사용합니다. 이미 요청 또는 이 세션에 제공된 적용 가능한 선택(깊이 포함)을 이미 답변된 것으로 취급합니다. 다시 묻지 않고 요약하며, 기본값은 명시적 선택을 대체하지 않습니다. 모든 중요한 선택이 제공되면 진행합니다. 중요한 누락 또는 충돌하는 선택이 있는 경우에만 질문합니다. 저장소 기본 설정만으로는 현재 답변이나 실행 허가가 아닙니다.
-
해결되지 않은 선택에 대한 깊이 선택기. 깊이가 제공되지 않고 선택 사항이 남아 있는 경우, 이 평가를 얼마나 깊이 진행할지 묻습니다: 간략 — 모든 선택이 권장 기본값을 따릅니다. 파생 가능한 기본값이 없는 질문(자유 텍스트 필수 사항)만 여전히 질문합니다. 안내 — 아래의 높은 영향으로 표시된 질문과 자유 텍스트 필수 사항만 질문합니다. 전체 — 아래의 모든 질문을 질문합니다. 저장소의
CONVENTIONS.md에평가 깊이:가 기록되어 있으면, 질문할 때 권장 옵션으로 미리 선택합니다. 기록된 깊이는 절대 자동으로 적용되지 않습니다. 그렇지 않으면 요청이 거의 또는 전혀 컨텍스트 없이 도착했을 때 전체를 권장하고, 이미 완전히 지정된 경우 간략을 권장합니다. 어떤 질문에서든 운영자가 "여기서부터 기본값 사용" 또는 "더 깊이 진행"이라고 답할 수 있습니다. 즉시 전환을 따릅니다. -
아래 질문을 한 번에 하나씩 묻고, 각각 권장 옵션과 한 줄 이유를 함께 제시합니다. 각 답변을 기다립니다.
-
구조화된 선택(단일 또는 다중 선택)을 사용합니다. 호스트가 구조화된 단일/다중 선택 질문 도구를 노출하면 그것을 사용하고 권장 옵션을 표시합니다. 그렇지 않으면 옵션을 일반 텍스트로 A/B/C로 나열하고 권장되는 것을 지정합니다. 열거 가능한 집합이 불가능한 경우에만 자유 텍스트를 사용합니다(예: 목표 설명).
-
운영자가 결정합니다. 답변 없이 질문을 넘기지 말고, 컨텍스트 없이 호출될 때 범위를 추측하지 마십시오.
질문 (요청이 이미 답변한 것은 건너뜁니다):
- 목표 / 문제 — 자유 텍스트 (피할 수 없는 열린 답변, 모든 깊이에서 질문) 아직 제공되지 않은 경우.
- 출력 — 후보 ADR만, 또는 ADR + 계획 항목. 권장: ADR + 계획 항목.
- 분해 깊이 — 빠른 (상위 후보) 또는 철저한 (전체 분해). 권장: 먼저 빠르게, 요청 시 확장.
이 스킬에는 높은 영향으로 표시된 질문이 없습니다 — 안내 실행은 이 스킬에 대해 간략처럼 동작합니다.
이 스킬은 여전히 개요를 승인할 때까지 아무것도 쓰지 않습니다.
1단계 — 문제 이해
목표/기능/문제가 제공되지 않은 경우 질문합니다. 범위 경계, 제약 조건, 이 저장소에 중요한 규제/품질 문제를 탐색합니다. 목표가 명확해질 때까지 분해를 시작하지 마십시오.
2단계 — 분해
후보 목록을 생성합니다. 각 후보 ADR에 대해:
- 제안된 번호(다음 사용 가능한 연속 번호), 작업 제목, 모양(저장소가 구분하는 경우 기능 vs. 기술).
- 한 줄 범위 — 캡처하는 단일 결정.
- 다른 후보 또는 기존 ADR에 대한 의존성.
ADR 당 하나의 결정. 후보가 여러 결정을 묶는 경우 분할하고 그 이유를 설명합니다. 후보가 실제로 수정이 필요한 기존 ADR인 경우 새 번호를 제안하는 대신 그렇게 말합니다.
3단계 — 작업 순서 지정
의존성 엣지를 존중하면서 계획 순서(어떤 plan/todo/ 항목을 어떤 순서로)를 제안합니다. 병렬화할 수 있는 작업을 기록합니다(agent-wave 스킬에 유용한 입력).
4단계 — 검토 및 인계
전체 집합을 검토 가능한 개요(후보 + 의존성 + 순서)로 제시합니다. 수정 사항을 받습니다. 아직 아무것도 쓰지 마십시오. 사용자가 승인하면 각 후보에 대해 new-adr 스킬을, 각 대기 항목에 대해 new-plan 스킬을 호출하여 생성하거나 — 승인된 개요를 해당 스킬에 전달합니다.
가드레일: 문제가 너무 모호하여 요구 사항을 발명하지 않고는 분해할 수 없는 경우, 추측성 ADR을 생성하지 말고 그렇게 말하고 더 많은 정보를 요청합니다.
합의된 옵션과 남은 결정의 이름을 지정합니다. 논의만으로는 아티팩트를 작성하지 않습니다.
마감 보고서
차단, 실패 및 중지된 실행을 포함한 모든 실행을 정확히 Status at a glance라는 제목의 섹션으로 종료하고, 다음 세 가지 레이블을 포함합니다:
- This run: 실제로 시도된 작업과 그 결과만 포함합니다. 각 검증 게이트의 정확한 출력과 종료 코드(시간 초과 또는 중단 포함)를 인용합니다.
- Overall: 구현됨, 부분적으로 검증됨, 검증됨, 차단됨, 실패 또는 알 수 없음. 통과한 하위 단계는 전체 통과가 아닙니다. 불완전하거나 누락된 증거는 결코 성공이 되지 않습니다.
- Yet to do: 모든 남은 작업, 해결되지 않은 발견, 검증, 정리 또는 필요한 입력. 전체 작업이 검증 가능하게 완료된 경우에만 None을 작성합니다. 예산이 종료되었다고 해서 작업을 생략하지 마십시오.
일상적인 진행 메시지는 블록이 필요하지 않습니다. 최종 결과를 간결하게 유지하고 PR에서 준비된 작업과 배송이 확인된 작업을 구분합니다.