delivery은(는) 무엇을 하나요?
사용자는 목표와 제약 조건을 제시하고, 감독 없이 완료되고 검증된 결과를 기대합니다. 현재 지침과 저장소 규칙이 아래 모든 내용보다 우선합니다. 사용자의 전역 지침에는 개인별 특성(머신 제한, 제품, 리뷰 봇, 말투)이 포함될 수 있습니다. 이를 따르십시오.
작업 설정
- 저장소의
AGENTS.md/CLAUDE.md, 관련 아키텍처, 패키지 매니페스트와 잠금 파일, 현재 Git 상태를 읽습니다. 편집 전에 작업의 실제 브랜치, 베이스, 이슈, 기존 워크트리를 검사합니다. - 관찰 가능한 수용 기준(동작, 설정, 호환성, UI 정리, 테스트 증거, 요청된 전달 방법)을 식별합니다. 합리적인 되돌릴 수 있는 선택을 합니다; 결과에 영향을 미치는 모호성에 대해서만 질문합니다.
- 상당한 규모의 관련 없는 작업은 격리된 Git 워크트리가 필요합니다. 하네스가 이미 이 작업을 위해 만든 워크트리를 재사용합니다. 공유 체크아웃을 전환하거나 재설정하지 마십시오. 여러 에이전트가 의도적으로 워크트리를 공유하는 경우 파일 소유권과 Git 작성자 한 명에 합의합니다. 이전에 main에 푸시하라는 요청이 있었다고 해서 새로운 푸시를 허용하지는 않습니다.
구현 및 검증
- 제품의 정체성을 유지합니다. 작업에서 재설계를 요구하지 않는 한, 기존 표면을 재설계하기보다 다듬습니다.
- 새 API를 사용하기 전에 설치된 프레임워크 및 API 버전을 확인합니다. 익숙하지 않거나 버전에 민감한 동작의 경우 최신 공식 문서나 (설치된 경우) Context7을 참조합니다.
- 플랫폼 대상(게임 서버, 모바일 OS 버전, 브라우저 엔진, 런타임)의 경우 빌드의 실제 대상 및 공식 API와의 호환성을 확인합니다. 프로덕션 환경을 개발 인스턴스 대신 테스트 용도로 사용하지 마십시오.
- 저장소의 테스트 및 빌드 명령을 선호합니다. 동작 변경에 대해 의미 있는 회귀 테스트 범위를 추가한 후 영향을 받는 통합을 테스트합니다. UI 작업의 경우 요청 없이
visual-qa를 사용합니다. - 유용할 경우 독립적인 연구와 편집을 명확한 소유권 하에 병렬화합니다. 동시성을 머신 크기에 맞춥니다: 하나 이상의 무거운 빌드나 렌더링을 실행하거나 두 개 이상의 브라우저 세션을 실행하기 전에 CPU와 메모리를 확인합니다. 백그라운드 서버를 축적하거나 중복 에이전트 swarm을 실행하지 마십시오.
엔지니어링 플레이북 (pstack)
이 스킬은 라우터 역할을 유지합니다. Lauren Tan의 pstack 플러그인이 설치된 경우, 작업 내 엔지니어링 방법에 대해 해당 플레이북을 사용합니다. 대부분의 pstack 스킬은 수동 전용이므로 로드될 때까지 기다리지 않고 <pstack>/skills/<name>/SKILL.md 경로로 읽습니다. pstack 파일을 따르기 전에, 하네스용 어댑터를 세션당 한 번 읽습니다. 이 어댑터는 Cursor 도구, 모델 및 경로 이름을 매핑합니다.
하네스에 맞게 <pstack>을 확인합니다:
- Claude Code:
ls -d ~/.claude/plugins/cache/cursor-plugins/pstack/*/ | sort -V | tail -1. 어댑터<pstack>/docs/harness/claude-code.md. 모델 시트~/.claude/rules/pstack-models.md, 자동 로드됨. - Codex:
ls -d ~/.codex/plugins/cache/tinderbox-pstack/pstack/*/ | sort -V | tail -1. 어댑터<pstack>/docs/harness/codex.md. 모델 시트~/.codex/pstack-models.md; 역할 모델을 생성하기 전에 읽습니다.
두 경로 모두 존재하지 않으면 pstack이 설치되지 않은 것입니다: pstack 없이 작업합니다.
| 작업 형태 | 읽고 따를 것 |
|---|---|
| 보고된 결함 | skills/poteto-mode/playbooks/bug-fix.md |
| 측정된 느림, 또는 개선해야 할 하나의 지표 | perf-issue.md, hillclimb.md |
| 누수, 스핀 또는 글리치; 캡처된 프로파일 | runtime-forensics.md, trace-forensics.md |
| 새 동작; 구조만 변경 | feature.md, refactoring.md |
| 경험적 설계 분기 | 사용자에게 묻지 않고 prototype.md |
| 읽기 전용 "어떻게/왜/확실한가" | investigation.md, skills/how, skills/why |
| 영향 범위가 불분명한 변경 | 편집 전 skills/blast-radius |
| 벤치마크 또는 속도 향상 주장 | 보고 전 skills/benchmark-checklist |
| 반복 가능한 앱 증거가 없는 프로젝트 | skills/create-verification-skill (한 번 질문) |
| PR 제목, 본문, 릴리스 노트 | 초안 작성 후 skills/unslop |
플레이북 경로는 <pstack>/skills/poteto-mode/playbooks/ 아래에 있습니다. 플레이북이 인용하는 각 principle-* 리프를 적용하기 전에 읽으십시오.
pstack이 다른 경우 다음 규칙이 우선합니다:
- 전달. PR 생성, CI 및 리뷰는
pr-follow-through및file-pr에 맡깁니다. pstack의opening-a-pr,babysit및shipping플레이북은 참고 자료로만 사용합니다. 해당 자율성 섹션은 현재 요청 범위를 넘어서는 커밋, 푸시, 병합, 외부 메시지 또는 배포를 승인하지 않습니다. - 리소스.
arena,swarm,interrogate및architect팬아웃은 사용자가 더 요청하지 않는 한 최대 3개의 하위 에이전트로 제한됩니다. 코드 작성 레인은 자체 워크트리를 얻습니다(Claude Code에서는isolation: "worktree", Codex에서는git worktree add). 사용자가 이름을 요청하지 않는 한autopilot-full및orchestrate는 건너뜁니다. - 모델. 모델 시트는 pstack의 역할을 하네스가 도달할 수 있는 모델에 매핑합니다. 교차 공급자 리뷰는
council에 맡깁니다. - 누락된 Cursor 부분.
cursor-team-kit은 설치되어 있지 않습니다./deslop에는pr-review-toolkit:code-simplifier(가능한 경우)를 사용합니다.control-ui에는visual-qa및playwright-cli를 사용합니다.control-cli에는 CLI를 직접 실행합니다. Bugbot, Cursor 자동화 및 클라우드 에이전트 단계는 어댑터의 지시에 따라 한 줄로 건너뜁니다. - 말투. pstack의 응답 규칙(짧은 문장, 긴 대시 없음, 증거 레이블)은 그대로 사용할 수 있습니다. 첫 메시지의 목표 재진술은 두 문장으로 유지합니다.
마무리
- 요청에 PR 또는 리뷰 수정이 포함된 경우
pr-follow-through를 사용합니다. - 현재 작업이 해당 작업을 승인하는 경우에만 커밋, 푸시, 릴리스 생성 또는 병합을 수행합니다. 먼저 저장소의 릴리스 자동화를 검사합니다. 릴리스가 어떻게 수행되는지 가정하지 마십시오.
- 실제 결과(URL, 테스트된 시나리오, 증거 링크, 실패, 사용자의 조치가 실제로 필요한 사항)를 보고합니다. 확인하지 않고 미리보기, 플랫폼 빌드, 릴리스 또는 리뷰가 통과했다고 말하지 마십시오.
- 컨텍스트 재설정 또는 긴 대기 전에 추적된 소스 외부에 간결한 인수인계(예: 작업의
.agent-artifacts/HANDOFF.md)를 남깁니다. 여기에는 브랜치/워크트리, 목표, 완료된 변경 사항, 명령/결과, PR/HEAD SHA, 차단 항목, 소유 파일, 리소스/세션 이름 및 정확한 다음 작업이 포함되어야 합니다. 토큰을 포함하지 마십시오. - 자신이 소유한 서버와 브라우저 세션만 중지합니다. 유용한 증거를 보관하고 관련 없는 워크트리, 캐시 또는 사용자 작업을 삭제하지 마십시오.