실습(Practice) 환경을 위한 범위 지정 리본(Scope Ribbon) 만들기

명단(roster) 없이 진행된 실습 근무는 공유 부채(shared debt)가 됩니다. 무료 모델 접근은 초안 작성 비용을 낮추지만, 잘못된 병합(bad merge)의 비용까지 낮추지는 못합니다.

이제 팀들은 점심시간이 끝나기 전에 인터페이스를 스케치할 수 있습니다. 하지만 그 스케치는 여전히 리포지토리(repos), 로그(logs), 키(keys)에 영향을 줍니다. 이름 붙여진 소유자 없이 속도만 있으면 조용한 표류(quiet drift)가 발생합니다.

효용성 있는 해결책은 한 페이지짜리 근무 시트입니다. 세 명이 첫 번째 프롬프트 전에 그것에 서명해야 합니다. 이 시트는 채팅이 아닌 팀 위키(team wiki)에 보관되어야 합니다.

이 플레이북은 공유 리포지토리를 가진 소규모 제품 팀에 적합합니다. 또한 샌드박스(sandbox)를 유지하는 플랫폼 그룹에도 적합합니다. 혼자 하는 주말 실험에는 적합하지 않습니다.

어떤 도구보다 먼저 실패 지점 명명하기 (Name the failure before any tool)

생성된 패치(generated patch)는 완성된 것처럼 보일 수 있지만 여전히 틀릴 수 있습니다. 잘못된 부분은 구문(syntax)이 아니라 종종 범위(scope) 문제입니다. 버튼은 작동하지만 데이터 경로가 유출될 수 있습니다.

검토자들은 경계(bounds) 대신 취향에 대해 논쟁합니다. 초안은 이미 공유 호스트에 놓여 있습니다. 다른 사람들이 그것을 본 후에 롤백(rollback) 이야기가 시작됩니다.

명단 시트(roster slip)는 그 순서를 한 단계 더 일찍 막습니다. 누가 프롬프트를 제공하고, 누가 검사하며, 누가 폐기할지 명시합니다. 또한 이 근무가 절대 건드려서는 안 되는 것도 명시합니다.

쉽게 생성된 사이트에 대한 공개적인 이야기는 이러한 실패를 흔하게 만듭니다. 포트폴리오 초안과 서비스 초안은 하나의 위험을 공유합니다. 둘 다 아무도 마감(close)을 소유하지 않으면 실습 레인에서 벗어날 수 있습니다.

실습 레인에 무료 용량 유지하기 (Keep free capacity on a practice lane)

공개: 이 기사는 MonkeyCode의 제품 아웃리치(product outreach)의 일환으로 작성되었습니다. MonkeyCode는 이러한 종류의 실습을 위해 무료 모델 접근을 제공합니다. 또한 폐기용 호스트에 대한 무료 서버 옵션도 제공합니다.

두 주장 모두 실험실 테스트가 아닌 운영자로부터 나온 것입니다. 할당량(Quotas), 모델 이름, 가동 시간(uptime)은 여기서 가정되지 않습니다. 무료 옵션은 팀 투표 없이 변경될 수 있습니다.

이 레인은 실습 상태를 유지하며 절대 약속이 되지 않도록 합니다. 팀은 시트가 완료된 후에만 그 접근을 사용합니다. 프롬프트는 메인 브랜치(main)가 아닌 실습 브랜치(practice branch)에 남아 있어야 합니다.

호스트 이름은 프로덕션처럼 보여서는 안 됩니다. 라이브 토큰(Live tokens)은 개요와 프롬프트에서 제외되어야 합니다. 고객 행(Customer rows) 또한 프롬프트에서 제외되어야 합니다.

합성(Synthetic) 테스트 케이스가 이번 작업에서 유일하게 안전한 샘플입니다. 팀은 이 테스트 케이스들을 실습 저장소(practice repo)에만 보관합니다. 실제 데이터는 절대로 이 테스트 케이스 영역으로 들어오지 않습니다.

세 개의 좌석과 하나의 시계

프롬프터(prompter)가 짧고 간결한 브리프(brief)로 작업을 작성합니다. 체커(checker)는 차이점(diffs), 테스트, 그리고 비밀 스캔을 담당합니다. 디스카드어(discarder)는 종료(shutdown), 브랜치 삭제(branch delete), 그리고 기록(note)을 담당합니다.

한 사람이 작은 팀에서 두 개의 좌석을 맡을 수 있습니다. 하지만 한 사람이 세 개의 좌석을 모두 맡아서는 안 됩니다. 디스카드어가 빠지면 실습이 프로덕션 환경처럼 변질됩니다.

시계는 감정적인 느낌이 아니라 벽에 걸린 시간입니다. 90분은 기준점(benchmark)이 아니라 제안된 상한선(cap)일 뿐입니다. 이 상한선에 도달하면 디스카드어가 호스트를 종료합니다.

상한선은 제품의 제한이 아니라 팀 규칙입니다. 연장은 새로운 슬립과 새로운 마감 기한을 필요로 합니다. 조용한 연장(silent extension)은 시계가 없는 것과 같습니다.

인수인계는 의도적으로 짧게 유지된다

프롬프터는 입력값과 금지된 경로를 담은 브리프를 전달합니다. 체커는 통과(pass), 실패(fail), 또는 차단(block)을 전달합니다. 디스카드어는 종료된 호스트와 삭제된 브랜치를 전달합니다.

각 인수인계는 네 줄의 짧은 내용 안에 포함되어야 합니다. 채팅 기록이 위키 페이지를 대체해서는 안 됩니다. 한 줄이라도 빠지면 작업(shift)은 여전히 진행 중인 것입니다.

프롬프터가 초안 작성이 완료되었다고 선언하지 않습니다. 체커가 호스트가 종료되었다고 선언하지도 않습니다. 이 문장들은 이유가 있어서 서로 다른 좌석에 속해 있습니다.

'통과(pass)'는 차이점(diff)이 리본(ribbon)과 일치한다는 의미입니다. '실패(fail)'는 차이점이 브리프를 놓쳤다는 의미입니다. '차단(block)'은 차이점이 금지된 경로를 건드렸다는 의미입니다.

이 페이지를 붙여넣고 빈칸을 채우세요

아래 아티팩트(artifact)는 기록된 로그가 아니라 제안서입니다. 팀은 작업을 시작하기 전에 이것을 위키에 복사합니다. 모든 빈칸은 채워져야 하며, 그렇지 않으면 작업은 시작되지 않습니다.

Practice shift slip
Shift id: PS-____
Date: ____
...

실패 시 안전하게 닫히는 체커

작업(shift)이 시작되기 전에 작은 스크립트가 슬립을 보호합니다. 이 스크립트는 모델이나 원격 API를 호출하지 않습니다. 오직 디스크에 있는 로컬 환경 파일만 읽습니다.

이 스크립트는 현지 사용을 위한 실행되지 않은 예시입니다. 팀은 먼저 임시 클론(throwaway clone)에서 이를 실행합니다. 이는 릴리스 저장소에는 속하지 않습니다.

열기(open), 확인(check), 닫기(close) 명령어

아래 명령어들은 예시일 뿐, 실제 세션 기록은 아닙니다. 각 명령어는 비밀 정보가 없는 임시 클론 환경을 가정합니다. 명령이 실패하면 사람이 직접 읽을 때까지 작업 흐름(shift)이 중단됩니다.

프롬터(prompter)는 어떤 프롬프트가 시작되기 전에 실습 브랜치(practice branch)를 생성합니다. 채워진 슬립은 그 작업 옆에 보관됩니다. 체커(checker)는 어떤 에디터가 열리기 전에 스크립트를 실행합니다.

git checkout -b practice/readme-draft
cp shift-slip.env.example shift-slip.env
bash check-slip.sh shift-slip.env

체커는 비밀 정보를 붙여넣지 않고 짧은 줄을 기록합니다. 이 인계 메모(handoff note)에는 상태 정보(stat line)만 충분합니다. 비밀 정보를 포함할 수 있는 원본 diff는 채팅에 남겨두지 않습니다.

git diff --stat
printf '%s\n' "checker: pass" "note: readme only" >> handoff.txt

폐기자(discarder)는 로컬 git 명령어와 스탬프를 이용해 종료합니다. 호스트 종료 자체는 제공업체 콘솔에서 여전히 발생합니다. 이 스탬프는 오직 로컬 작업이 완료되었음을 증명할 뿐입니다.

git checkout main
git branch -D practice/readme-draft
printf '%s\n' "host: closed in console" "branch: deleted" "time: $(date -u +%FT%TZ)" >> handoff.txt

채워진 슬립 파일은 git 히스토리 밖에 보관됩니다. 팀은 채워진 파일이 아닌 예시(example)를 커밋합니다. 채워진 파일에는 내부적으로만 유지되어야 할 이름들이 포함될 수 있습니다.

printf '%s\n' "shift-slip.env" "handoff.txt" >> .gitignore
git check-ignore -q shift-slip.env && echo "filled slip ignored"

세 가지 표시를 정책으로 읽으세요

체커의 표시가 실패하면, 프롬터는 한 번 수정할 수 있습니다. 두 번째 실패는 즉시 작업 흐름을 종료합니다. 폐기자는 여전히 그날 호스트를 닫습니다.

체커가 블록을 표시하면 아무도 코드를 푸시하지 않습니다. '블록'이란 비밀 정보(secrets), 프로덕션 이름(prod names) 또는 범위 확장(scope creep)을 의미합니다. 이 경우, 모델이 아닌 위키로 돌아가야 합니다.

체커 마크가 통과하면 작업은 일반 검토 단계에 진입할 수 있습니다. 그 검토는 팀의 일반적인 릴리스 파이프라인을 사용합니다. 실습 환경(practice host)이 절대 릴리스 환경(release host)이 되어서는 안 됩니다.

통과(pass) 자체가 배포 승인(deploy approval)은 아닙니다. 통과는 오직 리본(ribbon)과의 일치 여부만을 의미할 뿐입니다. 릴리스에는 여전히 팀의 기존 검토 게이트가 필요합니다.

시트와 스크립트의 한계점

체커 스크립트는 실제 제품 감각을 판단할 수 없습니다. 무료 서버가 격리되었는지 증명할 수 없습니다. 프롬프트에 입력된 비밀 정보를 볼 수도 없습니다.

무료 모델 접근은 사전 통지 없이 변경될 수 있습니다. 무료 서버 용량도 같은 방식으로 변동될 수 있습니다. 이 문서는 어떠한 할당량(quota), 칩 유형, 또는 기간을 주장하지 않습니다.

이러한 프로세스 단계 뒤에 어떤 벤치마크 결과가 존재하지 않습니다. 고객 수 역시 마찬가지입니다. 가치는 기적이 아니라 더 깨끗한 인계(handoff)입니다.

호스트 레이블에 대한 문자열 검사는 피상적입니다. 'prod'라는 단어가 없더라도 호스트는 위험할 수 있습니다. 인간은 여전히 첫 프롬프트 전에 이름을 읽습니다.

스크립트는 의도적으로 슬립 파일(slip file)을 신뢰합니다. 거짓말쟁이는 가짜 폐기자 이름(discarder name)을 입력할 수 있습니다. 사회적 신뢰는 bash가 증명할 수 있는 범위를 벗어납니다.

이 플레이북을 사용하지 않아야 하는 팀

팀들은 데이터가 규제되는 경우 이 접근 방식을 건너뜁니다. 유일한 호스트가 프로덕션인 경우 이를 건너뜁니다. 폐기자(discarder)가 남아 있을 수 없는 경우에도 건너뜁니다.

그들은 밤새 작동하는 에이전트 때문에 이 방법을 건너뜁니다. 비감독 프롬프트는 매번 3인 규칙을 깨뜨립니다. 마감 시간에는 반드시 사람이 폐기자로 남아 있어야 합니다.

그들은 삭제할 수 없는 데모를 위해 이 방법을 건너뜁니다. 실습은 아티팩트가 의식 없이 죽을 수 있음을 의미합니다. 출시 후보(launch candidate)는 일반 릴리스 트레인(release train)이 필요합니다.

법무팀(counsel)이 프롬프트 텍스트를 소유하는 경우에도 건너뜁니다. 이 시트는 엔지니어링 습관일 뿐 법적 조언이 아닙니다. 규제되는 텍스트는 여전히 팀의 법무팀 경로가 필요합니다.

실제 브리핑 전에 실패를 연습하라

리허설은 빈 실습 레포지토리에서 시작합니다. 슬립에는 실제 이름만 들어가고 가짜 데이터만 사용됩니다. 체커는 스크립트로부터 짧은 'ok' 라인을 기대합니다.

아래의 리허설 스크립트 역시 실행되지 않은 제안입니다. 같은 폴더에 있는 체커 파일을 기대합니다. 모델이나 원격 호스트와는 절대 통신하지 않습니다.

#!/usr/bin/env bash
# Proposal only. Local rehearsal. No model calls.
set -euo pipefail
...

다음 실행은 의도적으로 폐기자(discarder) 필드를 공백으로 만듭니다. 스크립트는 그 빈 필드에서 종료되어야 합니다. 이름은 어떤 추가 프롬프트 작업보다 먼저 반환됩니다.

그 후 호스트 필드는 'prod'를 포함하는 이름을 사용합니다. 스크립트는 이 안전하지 않은 호스트 문자열을 거부해야 합니다. 시프트가 계속되기 전에 호스트 레이블이 변경됩니다.

프롬터는 readme에만 영향을 주는 diff를 제공합니다. 체커는 톤(tone)이 아니라 stat 라인을 읽습니다. 여전히 패스는 diff에 대한 인간의 눈을 기다립니다.

클로즈는 실습 브랜치를 삭제하고 시간을 기록합니다. 슬립은 위키에 이력으로 남습니다. 실습 노트가 메인 readme에 들어가지 않습니다.

리본이 모델보다 우선한다

Scope는 작업 주변에 묶인 리본처럼 작동합니다. 그 리본 바깥에서는 시프트가 권한을 갖지 못합니다. 리본 안에서는 체커가 '아니오'라고 말할 수 있습니다.

더 강력한 모델이 이 리본을 대체하지 않습니다. 더 저렴한 서버도 마찬가지입니다. 이 리본은 작은 스크립트를 가진 사회적 통제 장치입니다.

슬립은 전체 분기가 아닌 하나의 시프트를 다룹니다. 폐기자가 클로즈 라인을 작성할 때 만료됩니다. 다음 시프트는 백지 상태에서 시작합니다.

이전 노트는 프롬프트 씨앗으로가 아니라 증거로 남습니다. 새로운 Scope는 어제의 예외가 다시 자라나는 것을 막습니다. 그 습관이 어떤 단일 초안보다 더 중요합니다.

따분한 클로즈는 이 플레이북의 특징입니다. 폐기자가 호스트를 멈추고 브랜치를 삭제합니다. 시프트 슬립에는 승리의 연설은 속할 자리가 없습니다.

그러한 무료 옵션을 원하는 팀은 버려지는(throwaway) 레포지토리에서 시작합니다. 팀은 시트를 붙여넣고 체커를 먼저 실행합니다. 그 순서가 실험을 코드베이스보다 작게 유지시킵니다.