개발자 경험 설계

업데이트: 2026-10-03. 이 페이지는 구현과 문서를 발전시키는 설계 방향입니다.

Gooo를 쓰는 사람이 먼저 이해해야 할 것은 자신의 입력, 생성 결과, 실패 이유와 다음 행동입니다. 내부 계약과 원본 증거는 필요할 때 더 깊게 찾아갈 수 있도록 연결합니다.

작업에서 시작하기

한 기능의 안내는 다음 흐름을 따릅니다.

만들려는 결과
  → 가장 작은 예제
  → 실제 입력과 출력
  → 실패했을 때 이어갈 작업
  → 작동 원리와 지원 범위
  → 원본·계약·관측

위키의 시작하기는 선언 검사와 바디 생성에서 출발합니다. 작은 모델과 메타프로그래밍은 조립 작업장의 비유로 역할을 설명하고 실제 호출 계약에 연결합니다.

모델 결과를 이해하기

사용자가 알고 싶은 것	가까이 보여줄 정보
무엇을 골랐나	허용된 선택지와 선택한 경로
얼마나 잘 동작했나	제공 예시의 충족 수와 분모
몇 번 더 시도했나	실제 호출·후보 수와 예산
무엇이 남았나	미해결 항목, 사유와 다음 작업
얼마나 들었나	모델 판단·생성·빌드·실행의 시간과 메모리

예를 들어 “16개 중 12개 예시를 만족했고, 두 후보를 더 시도할 수 있습니다”라는 설명 뒤에 실제 실패 입력과 판단 기록을 보여주는 흐름을 지향합니다. 이 문장은 설계 예시입니다.

문서와 코드의 현재 위치

홈은 프로젝트가 하는 일을 요약하고, 현재 상태는 소스·SDK·모델·배포 태그를 구분합니다. 지표 페이지는 분모와 측정 범위를 설명하며 원본 보고서로 연결합니다. 날짜별 실험은 고정된 관측으로 보존합니다.

조건·대입·분기와 모델 선택의 실제 지원 범위는 각 구현 계약에 있습니다. 앞으로 더 넓은 타입과 자연어 계획 발견이 들어오면, 실행 가능한 작은 예제와 함께 안내를 확장합니다.

사용성도 관측하기

다음에는 독자가 첫 생성 결과에 도달하는 과정, 실패 이유를 찾아 작업을 재개하는 과정, 모델 없는 경로로 전환하는 과정을 관측하려 합니다. 이해 시간과 재개 성공률은 실제 사용자 관측을 얻은 뒤 기록합니다.

코드와 도구도 같은 원칙을 따릅니다. 이름이 역할을 설명하고, 한 변경을 이해하는 데 필요한 경계를 줄이며, 결과의 숫자가 어떤 계약에서 왔는지 찾을 수 있게 합니다.

문서 홈 · 현재 상태 · 용어와 참고 자료