하나의 레인이 하나의 유효한 페이로드를 반환할 때 주말 에이전트 데모가 완료됩니다. 다른 호출은 다른 프로젝트입니다. 이 제안된 빌드 로그는 다음 한계 내에서 내보내기 투어를 유지합니다: 캐시된 파일 목록, 로컬 스텁, 선택적 호스팅 실행, 그리고 레인당 단 한 번의 시도 제한.
이 투어는 폴더 목록에서 내보내기 이름을 가져옵니다. 파일을 편집하거나, 풀 리퀘스트를 열거나, 어시스턴트를 순위 매기지는 않습니다. 스텁 레인은 데모입니다. 호스팅 레인은 같은 날 URL이 확인될 때까지 꺼져 있는 스위치입니다.
무엇을 잘라냈는지 (What the cut protects)
최근의 공개 토론은 모델 품질을 주요 변수로, 일반적인 소프트웨어 작업을 사후 고려 사항으로 다루었습니다. 이러한 틀은 사이드 프로젝트에는 적합하지 않습니다. 주말에 발생하는 실패 모드는 더 작고 덜 눈에 띕니다: 설정되지 않은 변수, 결과를 조용히 변경하는 두 번째 호출, 또는 JSON이 잘못되었는데도 끝난 것처럼 보이는 단락입니다.
유지된 경로 (Path that stayed)
생존한 경로는 네 부분으로 구성됩니다.
samples/exports.json은 캐시된 파일 목록을 저장하고 allow_writes를 false로 설정합니다.lane_runner.py는 네트워크가 없는 결정론적 스텁을 실행합니다.--lane both는 HOSTED_BASE_URL이 있을 때 하나의 호스팅 호출을 수행할 수 있습니다.lane-report.json은 페이로드, 시도 횟수, 그리고 건너뛴 이유를 기록합니다.
제거된 경로 (Path that left)
잘려나간 작업:
- 백오프(backoff), 지터(jitter), 백업 모델
- 설치(install), 형식 지정(format) 또는 커밋 단계
- 벤더 스코어보드
- 가입 자동화(signup automation)
- 토큰 할당, 머신 크기, 또는 무료 등급 지속 기간에 대한 모든 수치적 주장
이 잘라냄 자체가 아티팩트입니다. 더 긴 프롬프트는 단지 건너뛰기 목록을 길게 만들 뿐입니다.
작동하는 스텁 (Working stub)
다음 섹션의 스크립트는 제안입니다. 이 기사를 위해 실행된 적이 없습니다. 측정된 것이 없으므로 지연 시간 수치는 주장되지 않습니다.
예상되는 스텁 동작은 좁습니다. src/app.py, src/__init__.py, 그리고 README.md가 주어지면, 내보내기 목록에는 app만 포함되어 있고 그 외는 없습니다. attempts는 1과 같고 writes는 비어 있습니다. 방문자는 네트워크 연결이 끊긴 상태에서 이 결과를 검사할 수 있습니다.
0이 아닌 종료 코드는 shape 검사가 실패했음을 의미합니다. 이 경우 데모가 제대로 작동하지는 않습니다. 스텁(stub)을 수정하면, 동일한 명령이 다시 실행됩니다. 이때의 나중 로컬 실행은 모델의 재시도(retry)가 아니라 사람의 편집 주기입니다.
로컬 레인용 명령어
mkdir -p samples
printf '%s\n' '{"allow_writes":false,"files":["src/app.py","src/__init__.py","README.md"]}' > samples/exports.json
python lane_runner.py --lane stub
...
레너(Runner), 레인당 한 번의 시도
#!/usr/bin/env python3
"""제안만 합니다. 본 기사에서는 실행되지 않습니다. 레인당 한 번의 시도."""
...
보고서에 작성되어야 할 내용
성공적인 스텁 보고서는 아래 샘플과 같습니다. 값들은 라이브 서비스에서 온 것이 아니라, 준비된 파일 목록(canned file list)에서 가져온 것입니다.
{
"demo": "export-tour",
"max_attempts": 1,
...
problems는 비어 있어야 합니다. 재치 있는 요약 필드는 의도적으로 무시됩니다. 왜냐하면 투어가 이를 요구하지 않았기 때문입니다. 추가적인 산문은 주말 데모가 끝난 척하는 방식입니다.
가상의 제한 없이 호스팅된 레인
공개 고지: 본 기사는 MonkeyCode의 제품 홍보의 일환으로 작성되었습니다.
이 초안에 대한 운영자 브리프는 MonkeyCode를 오픈 소스 프로젝트로 설명하며 두 가지 이용 가능성 주장(availability claims)을 제공합니다. 무료 모델 접근과 무료 서버 옵션입니다. 둘 다 호스팅된 레인에만 해당됩니다. 이것들은 벤치마크 결과가 아닙니다.
본 기사는 어떤 모델도 언급하지 않으며, 토큰 할당량도 명시하지 않고, 하드웨어에 대해서도 설명하지 않으며, 두 옵션이 얼마나 오래 유지될지도 말하지 않습니다. 2026-10-12 기준으로 주된 할당량이나 가격 페이지는 첨부되지 않았습니다. 구식 수치는 침묵보다 나쁠 것이므로, 수치들은 빠져 있습니다.
프로젝트가 여전히 제공하는 무료 서버는 이와 동일한 레너를 부팅하기에 편리한 장소입니다. 이것은 MAX_ATTEMPTS를 증가시키지 않습니다. 실패한 무료 호출도 여전히 한 번의 시도입니다. 건너뛴 이유(skip reason)는 보고서에 들어가고, 프로세스는 중단됩니다.
export HOSTED_BASE_URL="https://example.invalid"
python lane_runner.py --lane both
unset HOSTED_BASE_URL
example.invalid는 서비스가 아니라 플레이스홀더입니다. 현재 프로젝트 문서를 읽은 후에만 대체되어야 합니다. stub을 실행하기 전에 hosted lane을 먼저 실행하면 주말의 순서가 역전됩니다. 흥미로운 실패 지점이 네트워크로 이동하고, 로컬 버그는 숨겨진 상태로 남아있게 됩니다.
| 상황 | 신뢰할 수 있는 Lane | 보고서에 표시되어야 할 내용 |
|---|
| 계정 없음, 노트북만 사용 | stub | stub 결과 1개, hosted 키 부재 |
| ... | | |
| Free model access는 단일 호출의 위치를 변경할 뿐입니다. 패스 규칙을 바꾸지는 않습니다. Shape이 Fluency보다 여전히 중요합니다. | | |
작업 순서 (Order of work)
주말 진행 순서는 고정되어 있어 hosted 옵션이 너무 일찍 끼어드는 것을 막습니다.
- 캐시 파일 목록(canned file list)을 작성하고 해당 파일에 대한 쓰기를 거부합니다.
problems가 비어질 때까지 stub lane을 실행합니다.- 현재 host 문서를 읽습니다. free 서버 옵션이 불분명하거나 사라졌다면 중단합니다.
--lane both를 한 번 실행합니다. 호출에 실패하면 건너뛰기(skip)로 기록합니다.- 재시도(retries)는 구현하지 않습니다.
4단계에서 시작하는 데모는 기준선(baseline)이 없습니다. stub 결과가 바로 기준선입니다. Hosted 출력은 그 shape과 일치하거나 건너뛰기를 인정할 때만 흥미롭습니다.
이 순서는 또한 free 모델 호출이 첫 번째 테스트가 되는 것을 방지합니다. 첫 번째 테스트는 케이블을 뽑은 노트북에서 통과해야 합니다. 이 제약 조건은 어떤 벤더에 대한 언급이라기보다는 일반적인 엔지니어링의 영역입니다.
이번 주말에 건너뛰는 항목 (What this weekend skips)
건너뛰기 목록(skip list)은 두 번째 도구가 아니라 로그의 일부입니다.
- 모든 종류의 재시도 헬퍼(Retry helpers).
- 하나의 누락만으로 lane이 종료됩니다.
- 셸 측 부작용, 패치 및 커밋. 이 투어는 내보내기(exports)를 설명합니다.
- 다중 계정 오케스트레이션 및 사람을 가입시키는 모든 스크립트.
- 다른 어시스턴트와의 비교 게시물. 하나의 폴더 목록이 그 무게를 감당할 수 없습니다.
- 단일 JSON 보고서 이상의 지속성(Persistence). 이 데모에는 데이터베이스가 없습니다.
- 포트폴리오 레이아웃, 출시 문구 및 공개 가동 시간 주장.
이러한 항목들은 나중 주말에 돌아올 수 있습니다. 내보내기 투어를 보여주기 위해 필수는 아닙니다.
데모 완료 전 확인 사항 (Checks before the demo is called done)
아래의 검사들은 제어 흐름(control flow)을 설명합니다. 이들은 측정된 타이밍이 아니며, 본문 작성 시 실행되지 않았습니다.
env -u HOSTED_BASE_URL python lane_runner.py --lane stub
env -u HOSTED_BASE_URL python lane_runner.py --lane both
python - <<'PY'
...
한 가지 검사는 별도의 브랜치(scratch branch)에 두어야 합니다. stub_lane을 수정하여 attempts를 2로 설정하고, stub lane을 실행한 후 종료 코드 1이 나올 것을 예상하십시오. 실패가 나타나면 수정한 내용을 되돌리십시오. 그 실패 지점이 바로 이 제한(cap)의 핵심입니다.
호스트를 두 번 호출하는 녹색 프로세스(green process)가 바로 이 제한이 포착하려는 버그입니다. 보고서(report)는 두 번째 요청 대신 0이 아닌 종료 코드로 버그가 나타나야 하는 곳입니다.
이 접근 방식을 그대로 두어야 할 경우
이 제한은 사이드 프로젝트를 위한 범위 잠금 장치(scope lock)입니다. 다른 설정에서는 좋지 않은 기본값(default)입니다.
- 멱등적 읽기(idempotent reads)에 대한 온콜 디버깅(on-call debug). 이 경우 문서화된 재시도 정책(retry policy)이 적절할 수 있습니다.
- 계약상의 할당량(quota), 명명된 모델(named model), 또는 하드웨어 사양(hardware spec)이 필요한 조달 메모(procurement note).
- 보안 검토(security review). stub에 빈
writes 목록이 실제 도구가 디스크를 건드릴 수 없다는 것을 증명하지는 못합니다.
- 리더보드, 해커톤 순위, 또는 하나의 미리 작성된 파일이 어시스턴트 품질을 측정한다는 모든 주장.
- 고객 데이터가 포함된 프로덕션 에이전트(production agent).
lane-report.json은 감사 로그(audit log)가 아닙니다.
무료 호스트는 추가 시도를 값싸게 느끼게 만듭니다. 값싼 것이 완성되었다는 것과 같지는 않습니다. 추가 호출은 또한 이 초안이 예측하기를 거부하는 속도 제한(rate limits)의 위험을 안고 있습니다.
이 러너가 유용성을 유지하려면 모든 제품 이름이 제거되어야 합니다. 미리 작성된 파일 목록, 단일 시도, 그리고 보고서만 남기십시오. 여전히 호스트된 lane을 원하는 독자는 프로젝트의 현재 무료 모델 액세스 및 무료 서버 옵션에 대한 노트를 읽고, 두 번째 명령어가 같은 주말에 속하는지 결정할 수 있습니다.