Find Your Knowns (내 알려진 것들 찾기)
이 라우팅 워크플로우를 사용하여 사용자의 '지도'와 실제 '영역' 사이의 간극을 좁히고, 위험한 구현 선택을 내리기 전에 작업을 진행하세요. 지도는 사용자가 제공한 프롬프트, 티켓, 계획 또는 참조 자료입니다. 영역은 실제 레포지토리, 제품 동작, 디자인 시스템, 데이터, API, 프로덕션 제약 조건 및 암묵적인 사용자 기대치입니다.
참조: 이는 Thariq Shihipar의 기사 "A Field Guide to Fable: Finding Your Unknowns"와 동반 자료 "Know your unknowns" 예제에서 영감을 받은 독창적인 에이전트 워크플로우입니다. 재사용 가능한 아티팩트를 생성할 때는 프레임워크를 인용하고 출처를 밝히되, 원문 텍스트를 복사하지 마십시오.
트리거 정책
다음과 같은 경우 이 워크플로우를 사용하세요: 작업이 모호하거나, 미적 판단을 요구하거나, 전략적이거나, 중요도가 높거나, 익숙하지 않거나, 장기 실행되거나, 검사되지 않은 코드베이스 영역에 있거나, 제품, 디자인, API, 보안, 데이터, 마이그레이션 또는 운영 제약 조건을 숨길 가능성이 있는 경우.
강한 트리거 문구로는 "더 좋게", "더 깔끔하게", "예쁘게", "직관적으로", "프로덕션 준비 완료", "네가 결정해", "X처럼" 등이 있습니다. 또한 대규모 구현 계획을 수립하기 전, 구현 현실이 계획과 모순될 때, 또는 구현 후 리뷰어/이해관계자의 동의를 구하거나, 머지 전 설명을 위해, 또는 변경 사항 이해 워크플로우를 위해 사용하세요.
일반적인 코드 리뷰, 버그 리뷰, 보안 리뷰 또는 PR 결함 찾기 요청에는 이 워크플로우를 사용하지 마십시오. 이러한 작업에는 미지의 요소 발견 라우팅이 아닌 리뷰 특화 방법이 필요합니다. 변경 사항이 매우 작거나, 명확하거나, 직접 지정되었거나, 영향이 적거나, 탐색보다 수정이 더 저렴한 경우 이 워크플로우를 간소화하거나 건너뛰십시오.
운영 규칙
- 아주 작고 명확한 작업에는 의례를 피하십시오. 변경 사항이 직접적이고, 위험이 낮으며, 잘 지정된 경우 미지의 요소 영향이 낮다고 말하고 진행하십시오.
- 추측하기 전에 영역을 먼저 조사하십시오. 관련 파일, 테스트, 문서, 설정, 스키마, 로그 또는 제품 참조 자료를 읽은 후 위험을 사실로 제시하십시오.
- 되돌릴 수 없는 구현 전에 저렴한 탐색을 선호하십시오. 대규모 아키텍처에 전념하기 전에 목업, grep 패스, 소규모 테스트, 일회성 스크립트 또는 참조 지도를 사용하십시오.
- 사용자 입력이 필요할 때는 한 번에 하나의 영향력이 큰 질문을 하십시오. 아키텍처, 데이터 모델, UX, 보안 태세, 마이그레이션 전략, 공개 API 또는 릴리스 위험을 변경할 수 있는 질문을 우선시하십시오.
- 구체적인 아티팩트를 생성하십시오. 유용한 아티팩트로는 위험 테이블, 의미 맵, 목업, 결정 기록, 구현 노트 파일, 동의 문서 또는 퀴즈가 될 수 있습니다. 다음 조치가 없는 일반적인 "X 고려" 목록은 피하십시오.
- 막히지 않는 한 계속 작업하십시오. 사용자가 없고 위험이 아키텍처/API/보안/데이터에 치명적이지 않다면 가장 보수적인 되돌릴 수 있는 기본값을 선택하고, 가정을 기록한 후 계속 진행하십시오.
빠른 분류
플레이북을 선택하기 전에 작업을 분류하십시오:
- 알려진 알려진 것(Known knowns): 사용자가 명시적으로 제공한 요구 사항.
- 알려진 미지의 것(Known unknowns): 사용자가 이미 언급했거나 명확히 암시한 미해결 질문.
- 미지의 알려진 것(Unknown knowns): 사용자에게 보여주면 인식할 취향, 규칙, 품질 기준 및 도메인 기대치.
- 미지의 미지의 것(Unknown unknowns): 양측 모두 아직 표면화하지 않은 숨겨진 제약 조건, 동작, 위험 또는 누락된 도메인 지식.
그런 다음 불확실성을 분류하십시오:
- 낮은 불확실성, 낮은 영향: 직접 구현하십시오. 선택적으로 사용한 가정 하나를 기록하십시오.
- 중간 불확실성: 하나의 집중 플레이북을 실행하고 계속 진행하십시오.
- 높은 불확실성 또는 높은 영향 반경: 레포지토리를 조사하고, 블라인드 스팟 패스를 실행한 후 면접, 참조 사냥, 목업 또는 조정 가능한 계획으로 라우팅하십시오.
- 작업 중 계획이 현실과 모순됨: 구현 노트를 사용하고 영향을 받은 부분을 다시 계획하십시오.
- 작업이 완료되었지만 이해나 동의가 부족함: 동의 문서 또는 변경 퀴즈를 사용하십시오.
라우팅 테이블
현재 작업에 필요한 플레이북만 로드하십시오:
- 익숙하지 않은 코드베이스 모듈, 숨겨진 제약 조건 또는 위험 영역:
references/blindspot-pass.md를 읽으십시오. - 사용자에게 도메인 용어나 전문가 수준의 품질 기준이 부족함:
references/teach-me-my-unknowns.md를 읽으십시오. - 모호한 디자인, UX 취향, "더 좋게 만들기", "직관적으로", "X처럼":
references/design-directions.md를 읽으십시오. - 백엔드, API 또는 상태 작업 전에 UX/제품 형태가 불명확함:
references/mock-before-wire.md를 읽으십시오. - 솔루션 공간이 열려 있고 비용/위험 트레이드오프가 중요함:
references/effort-axis-brainstorm.md를 읽으십시오. - 알려진 모호성에 사용자 결정이 필요함:
references/interview.md를 읽으십시오. - 기존 구현, 제품 또는 경쟁사 동작이 명세가 되어야 함:
references/reference-hunt.md를 읽으십시오. - 대규모 계획을 수립하려고 함:
references/tweakable-plan.md를 읽으십시오. - 구현 중 예상치 못한 상황이 발생하거나 계획이 무효화됨:
references/implementation-notes.md를 읽으십시오. - 완료된 작업에 리뷰어 또는 이해관계자의 동의가 필요함:
references/buy-in-doc.md를 읽으십시오. - 사용자가 머지 전에 대규모 변경 사항을 이해하려 함:
references/change-quiz.md를 읽으십시오.
기본 워크플로우
- 지도를 간략히 다시 설명: 사용자가 요청한 내용과 이미 알려진 사항.
- 영역 조사: 위험을 평가하기 전에 관련 레포지토리/제품 표면에서 증거를 수집.
- 가장 영향력이 큰 미지의 요소 명명: 사용자가 탐색을 요청하지 않았다면 간결하게 유지.
- 라우팅: 테이블에서 하나 이상의 참조 플레이북을 선택.
- 실행: 요청된 아티팩트를 생성하거나, 영향력이 큰 질문을 하나 하거나, 기록된 가정과 함께 구현.
특수 플레이북이 필요하지 않을 때는 이 간결한 출력 형식을 사용하십시오:
Unknowns check:
- Known knowns: ...
- Highest-risk unknown: ...
- Cheap probe performed: ...
- Assumption or question: ...
- Next action: ...
예제 라우팅
- 익숙하지 않은 코드베이스 모듈: "이 auth 패키지에 SSO를 추가하세요. 예전에 만져본 적이 없습니다." ->
blindspot-pass.md, 위험이 높다면tweakable-plan.md. - 모호한 디자인 요청: "리뷰 대시보드를 더 깔끔하고 프리미엄급으로 만들어 주세요." ->
design-directions.md, 선택적으로mock-before-wire.md. - 알려진 아키텍처 모호성: "이게 API 게이트웨이에 있어야 할까요, 워커에 있어야 할까요?" ->
interview.md, 그 다음tweakable-plan.md. - 참조 기반 구현: "이 Rust 크레이트의 재시도 동작을 TypeScript 클라이언트로 포팅하세요." ->
reference-hunt.md. - 구현 중 예상치 못한 상황: "스키마가 계획된 마이그레이션을 지원하지 않습니다." ->
implementation-notes.md, 새 경로가 데이터/API 계약을 변경하는 경우에만 질문. - 머지 전 퀴즈: "제가 이 브랜치를 머지하기 전에 제대로 이해했는지 확인해 주세요." ->
change-quiz.md.