가난한 박과장 › 막혔을 때

막혔을 때 — 증상으로 찾기

하네스로 만들다 막히면 증상부터 찾아보세요. 증상마다 흔한 원인과 에이전트에게 할 말을 적어 두었습니다. 에이전트에게 그대로 붙여 넣어도 됩니다.

하네스에서 자주 만나는 것6건

배포가 「주소를 받지 못했습니다」로 끝난다

흔한 원인: 가입 상태가 중간에 바뀌어 이전 연결 기록이 남았다. 파일 이름에 한글이 들어 있다. 배포 서비스가 응답하지 않는다
에이전트에게: 「다시 올려 줘」. 또 실패하면 「배포가 왜 실패했는지 마지막 오류 문구를 보여 줘」

같은 한 줄인데 5분이 걸릴 때도, 20분이 걸릴 때도 있다

흔한 원인: 대부분 사진을 받는 시간이다. 사진을 내주는 외부 서비스의 속도에 따라 달라진다
에이전트에게: 기다린다. 20분을 넘기면 「지금 뭐 하고 있어?」

사진이 글의 내용과 맞지 않는다

흔한 원인: 사진을 단어로 검색해서 받기 때문에 뜻이 어긋날 수 있다
에이전트에게: 「○○ 사진을 다시 받아 줘」. 내 사진을 폴더에 넣고 「이 사진을 ○○에 넣어 줘」

운영자 비밀번호를 잊었다

흔한 원인: 한 번 정하면 화면에서는 다시 정할 수 없게 되어 있다
에이전트에게: 「운영자 비밀번호를 다시 정하는 방법을 알려 줘」. 주문 데이터는 그대로 남는다

방금 한 것을 되돌리고 싶은데 되돌릴 스냅샷이 없다

흔한 원인: 스냅샷은 변경 요청을 거칠 때만 생긴다. 그 순서를 건너뛰고 파일을 직접 고쳤다
에이전트에게: 「스냅샷 목록을 보여 줘」. 가게의 데이터라면 「데이터 백업 목록을 보여 줘」

창을 닫았다가 열었더니 처음부터 하자고 한다

흔한 원인: 지난번과 다른 폴더에서 열었다. 이어서 할 내용은 그 폴더의 진도 파일에서 읽는다
에이전트에게: 그 폴더에서 다시 실행한 뒤 「이어서 하자」

이 증상과 이어지는 저자 사례 묶음: 올렸는데 안 보인다 → 사례 찾기

사이트가 안 열릴 때11건

내 컴퓨터에서도 열리지 않는다

흔한 원인: 서버를 실행한 프로그램이 종료됐다. 컴퓨터를 다시 켰다. 다른 프로그램이 그 포트 번호를 사용하고 있다
에이전트에게: 「사이트를 실행한 프로그램이 지금 실행 중이야?」

내 컴퓨터에서는 열리는데 다른 사람에게는 열리지 않는다

흔한 원인: 보낸 주소가 127.0.0.1이다. 아직 배포하지 않았다. 임시 주소의 유효 시간 60분이 지났다
에이전트에게: 「이 주소는 어디서 열리는 주소야?」

같은 와이파이에 연결한 휴대폰에서 열리지 않는다

흔한 원인: 방화벽이 막고 있다. 주소를 127.0.0.1로 입력했다. 휴대폰이 다른 와이파이나 이동통신망에 연결되어 있다
에이전트에게: 「같은 와이파이에 연결한 휴대폰에서 열 주소를 알려 줘」

가게의 외부 주소가 어제는 열렸는데 오늘은 열리지 않는다

흔한 원인: 컴퓨터를 껐다가 켰다. 터널이 끊겼다. 주소가 새 주소로 바뀌었다
에이전트에게: 「가게와 외부 주소가 지금 동작하고 있어?」

배포했는데 「없는 페이지(404)」가 나온다

흔한 원인: 아직 반영되는 중이다. 주소의 대소문자가 다르다. 그 파일이 올라가지 않았다. 호스팅 쪽의 처리가 실패했다
에이전트에게: 「방금 올린 주소가 실제로 열리는지 확인해 줘」

도메인을 연결했는데 안 열린다

흔한 원인: 아직 전파되는 중이다(몇 분~2일). 입력한 값이 틀렸다
에이전트에게: 「도메인 설정에 입력한 값이 맞는지만 확인해 줘. 맞으면 기다릴게」

「안전하지 않음」 경고가 표시된다

흔한 원인: 주소가 http로 시작한다. 인증서가 아직 적용되지 않았다. 한 화면에 http 주소로 불러오는 사진이 포함되어 있다
에이전트에게: 「이 화면에서 https가 아닌 주소로 불러오는 게 있어?」

「시간 초과」 오류가 난다

흔한 원인: 외부 서버가 느리다. 내 서버가 요청 하나를 너무 오래 처리한다. 회선이 끊겼다
에이전트에게: 「시간 초과가 내 쪽에서 난 거야, 그쪽에서 난 거야?」

403이 나온다

흔한 원인: 로그인이 해제됐다. 그 사이트가 자동 프로그램의 접속을 막는다. 권한이 없는 주소다
에이전트에게: 「403을 준 쪽이 누구고 뭘 보고 막은 것 같아?」

429가 나온다

흔한 원인: 요청을 너무 자주 보냈다. 한도에 도달했다
에이전트에게: 「멈추고, 이 서비스의 한도가 뭘 세는지 찾아 줘」

500번대가 나온다

흔한 원인: 서버의 프로그램이 처리 도중에 종료됐다. 그 뒤에 있는 데이터베이스나 외부 서비스가 응답하지 않는다
에이전트에게: 「서버 기록에서 그 시각의 오류를 찾아 줘」

이 증상과 이어지는 저자 사례 묶음: 올렸는데 안 보인다 → 사례 찾기

고쳤는데 안 보일 때7건

파일을 수정했는데 화면이 그대로다

흔한 원인: 원본만 수정하고 다시 빌드하지 않았다. 다른 파일을 수정했다. 브라우저가 이전 화면을 보여 주고 있다
에이전트에게: 「수정한 내용이 화면에 실제로 표시됐는지 캡처해서 확인해 줘」

내 화면은 바뀌었는데 공개한 주소는 그대로다

흔한 원인: 다시 배포하지 않았다. 배포가 실패했다. 중간 서버의 캐시가 아직 이전 내용이다
에이전트에게: 「마지막 배포가 성공했어? 공개한 주소를 새로 받아서 확인해 줘」

내 브라우저에서만 이전 화면이 보인다

흔한 원인: 브라우저 캐시
에이전트에게: 강력 새로 고침(Ctrl+Shift+R)을 하고 다른 브라우저로도 열어 본다

「수정했습니다」라고 하는데 바뀐 것이 없다

흔한 원인: 에이전트가 확인하지 않고 보고했다. 수정한 파일이 화면에서 사용하는 파일이 아니다
에이전트에게: 「방금 실제로 바뀐 줄을 보여 줘」

지시한 것 외에 다른 것도 바뀌었다

흔한 원인: 지시가 짧아서 에이전트가 빠진 부분을 임의로 채웠다
에이전트에게: 「되돌려 줘」라고 한 뒤에 바꿀 것을 하나씩 말한다

검색 결과에 이전 제목이 나온다

흔한 원인: 검색 회사의 로봇이 아직 다시 방문하지 않았다
에이전트에게: 기다린다. 며칠에서 몇 주가 걸린다

글을 삭제했는데 검색 결과에 남아 있다

흔한 원인: 위와 같다. 로봇이 방문해서 글이 없다는 것을 확인해야 검색 결과에서 빠진다
에이전트에게: 기다린다

이 증상과 이어지는 저자 사례 묶음: 올렸는데 안 보인다 · 틀린 내용이 나갔다 → 사례 찾기

검색에 안 나오고 사람이 안 올 때5건

공개한 지 며칠이 지났는데 검색되지 않는다

흔한 원인: 로봇이 아직 방문하지 않았다. 임시 주소다. 주소 목록을 제출하지 않았다. 검색 제외 표시가 붙어 있다
에이전트에게: 「이 사이트에 검색을 막는 표시가 있어?」

글은 많은데 일부만 검색된다

흔한 원인: 내용이 부족하거나 서로 비슷한 글이 많다. 다른 사이트에 이미 있는 내용이다
에이전트에게: 「서로 비슷하거나 내용이 부족한 글을 찾아 줘」

방문자가 갑자기 줄었다

흔한 원인: 통계가 멈췄다. 검색 회사의 기준이 바뀌었다. 주소가 바뀌었다. 배포가 며칠째 실패하고 있다
에이전트에게: 「통계가 마지막으로 수집된 게 언제야?」

방문자가 갑자기 늘었다

흔한 원인: 로봇의 접속이다. 내 팀의 확인 접속이다. 누군가 링크를 걸었다
에이전트에게: 「오늘 방문을 어디에서 온 것인지 나눠 줘」

방문은 있는데 아무도 주문하지 않는다

흔한 원인: 휴대폰에서 화면이 깨진다. 첫 화면이 느리다. 무엇을 판매하는지 첫 화면에서 알 수 없다
에이전트에게: 「휴대폰 폭으로 첫 화면을 캡처해 줘」라고 하고 직접 휴대폰으로도 열어 본다

이 증상과 이어지는 저자 사례 묶음: 수를 잘못 읽었다 → 사례 찾기

느릴 때5건

사이트의 첫 화면이 늦게 표시된다

흔한 원인: 사진의 용량이 크다. 한 화면에 너무 많은 것을 넣었다. 터널을 거치는 가게다
에이전트에게: 「첫 화면이 받는 파일이 몇 MB야? 큰 것부터 보여 줘」

집에서는 빠른데 밖에서는 느리다

흔한 원인: 회선의 차이다. 내 컴퓨터에서 열 때는 외부 회선을 거치지 않는다
에이전트에게: 휴대폰의 이동통신망으로 직접 열어 본다

컴퓨터 전체가 느려졌다

흔한 원인: 메모리가 가득 찼다. 같은 프로그램이 여러 개 실행되고 있다. 디스크가 가득 찼다
에이전트에게: 「지금 메모리를 많이 쓰는 프로그램을 보여 줘. 같은 게 여러 개 실행되고 있어?」

에이전트가 점점 느려지고 엉뚱한 답을 한다

흔한 원인: 대화가 길어져서 문맥이 가득 찼다
에이전트에게: 정한 내용을 파일에 적게 한 뒤에 창을 새로 연다

운영자 화면 하나가 특히 느리다

흔한 원인: 열 때마다 표 전체를 읽는다
에이전트에게: 「이 화면이 열릴 때 데이터베이스에서 몇 줄을 읽어?」

이 증상과 이어지는 저자 사례 묶음: 한도에 닿았다 → 사례 찾기

에이전트가 멈추거나 이상할 때10건

「사용 한도에 도달했습니다」

흔한 원인: 계정의 모델 사용 한도를 모두 썼다. 다른 창과 예약 작업도 같은 한도를 쓴다
에이전트에게: 기다린다. 다른 창과 예약 작업이 무엇을 쓰고 있는지 확인한다

「권한이 없습니다」, 「접근이 거부됐습니다」

흔한 원인: 다른 프로그램이 그 파일을 열고 있다. 관리자 권한이 필요한 위치다. 설정으로 막아 둔 파일이다
에이전트에게: 「누가 이 파일을 사용하고 있어?」라고 묻는다. 에이전트를 관리자 권한으로 실행하지는 않는다

「명령을 찾을 수 없습니다」

흔한 원인: 설치되지 않았다. 설치했지만 열려 있는 창이 새 목록을 인식하지 못한다
에이전트에게: 창을 닫았다가 다시 열고 「이어서 하자」

「이미 사용 중인 포트」

흔한 원인: 같은 프로그램이 이미 실행되고 있다. 이전에 실행한 것이 완전히 종료되지 않았다
에이전트에게: 「그 포트 번호를 누가 쓰고 있어?」

같은 명령에서 계속 실패한다

흔한 원인: 명령 창의 문법이 다르다. 경로에 한글이나 공백이 있다
에이전트에게: 세 번을 넘으면 멈추게 하고 「왜 실패하는지 먼저 설명해 줘」

어제 정한 내용을 모른다

흔한 원인: 창을 새로 열었다. 대화가 요약됐다. 정한 내용이 파일에 없다
에이전트에게: 「그 규칙이 어느 파일에 적혀 있어?」라고 묻고, 없으면 적게 한다

로그인 화면, 사람 확인 화면에서 멈춘다

흔한 원인: 사람이 직접 해야 하는 단계다
에이전트에게: 직접 한다. 에이전트가 통과하게 하지 않는다

무언가를 설치하겠다고 한다

흔한 원인: 문제를 해결하려면 부품이 필요하다고 판단했다
에이전트에게: 「그게 꼭 필요해? 공식 배포처가 어디야?」

한글이 깨져서 표시된다

흔한 원인: 문자 인코딩이 맞지 않는다
에이전트에게: 깨진 상태로 저장하지 않는다. 「이 파일을 UTF-8로 다시 읽어 줘」

확인 창이 표시되어서 작업 전체가 멈췄다

흔한 원인: 브라우저의 「정말 ~하시겠습니까」 창이 표시되어 있다
에이전트에게: 그 창을 직접 닫는다

이 증상과 이어지는 저자 사례 묶음: 여러 세션이 같은 것을 고쳤다 · 한도에 닿았다 → 사례 찾기

자동으로 돌던 것이 멈췄을 때6건

아침에 보니 아무것도 처리되어 있지 않다

흔한 원인: 컴퓨터가 절전 상태가 됐다. 꺼져 있었다. 업데이트 때문에 다시 시작됐다
에이전트에게: 「예약이 마지막으로 실행된 게 언제야? 그때 컴퓨터가 켜져 있었어?」

예약은 등록되어 있는데 결과가 없다

흔한 원인: 시작하자마자 오류로 끝난다. 잠금 표시가 남아 있어서 계속 건너뛴다
에이전트에게: 「마지막 결과 코드가 뭐야? 기록의 마지막 줄을 보여 줘」

내가 지시하면 되는데 예약으로는 되지 않는다

흔한 원인: 시작하는 폴더가 다르다. 한글을 출력하다가 종료된다. 로그인이 필요하다
에이전트에게: 「예약으로 실행될 때와 내가 실행할 때 뭐가 다른지 찾아 줘」

같은 일이 두 번 실행됐다

흔한 원인: 앞의 작업이 끝나지 않았는데 다음 작업이 시작됐다. 예약이 두 개 등록되어 있다
에이전트에게: 「이 일을 하는 예약이 몇 개 등록되어 있어?」

어제까지 되던 배포가 「인증 만료」로 실패한다

흔한 원인: 인증 키의 유효 기간이 지났다. 다시 로그인하면서 이전 인증 키가 폐기됐다
에이전트에게: 직접 다시 로그인한다. 그 인증 키를 쓰는 예약이 더 있는지 물어본다

컴퓨터가 느려졌고 같은 프로그램이 수백 개 실행되고 있다

흔한 원인: 「이미 실행 중인지」를 확인하는 코드가 틀려서 매번 새로 실행한다
에이전트에게: 「같은 이름의 프로그램이 몇 개 실행되고 있어? 예약을 먼저 끄고 정리하자」

이 증상과 이어지는 저자 사례 묶음: 저절로 돌던 것이 멈추거나 겹쳤다 → 사례 찾기

없어졌을 때7건

글이나 페이지가 사라졌다

흔한 원인: 에이전트가 정리하다가 삭제했다. 만드는 도중의 일부가 비어 있는 상태가 배포됐다
에이전트에게: 더 수정하지 않는다. 「언제 없어졌는지 이력에서 찾아 줘」

수정해서 배포했더니 주문이 보이지 않는다

흔한 원인: 데이터 파일을 코드와 함께 덮어썼다. 다른 폴더의 가게를 보고 있다
에이전트에게: 더 수정하지 않는다. 「데이터 파일과 백업이 어디 있어?」

되돌렸더니 그사이에 작업한 것이 사라졌다

흔한 원인: 롤백은 만든 것 전부를 그 시점의 상태로 되돌린다
에이전트에게: 다시 「되돌려 줘」라고 한다. 롤백도 되돌릴 수 있다

장바구니가 비었다

흔한 원인: 브라우저의 저장소를 비웠다. 다른 기기나 다른 브라우저다. 가게 주소가 바뀌었다
에이전트에게: 고장이 아니라 로그인이 없는 가게의 특성이다

두 창에서 작업한 것 가운데 한쪽이 사라졌다

흔한 원인: 두 세션이 같은 파일을 수정해서 나중에 저장한 것이 앞의 것을 덮어썼다
에이전트에게: 「이 파일의 이력에서 사라진 부분을 찾아 줘」라고 하고, 그 파일은 한 창에서만 수정하게 한다

작업 폴더 전체가 없어졌다

흔한 원인: 임시 폴더 안에 만들었다. 정리 프로그램이 삭제했다
에이전트에게: 오래 쓸 폴더는 문서 폴더나 바탕 화면 아래에 둔다

디스크가 가득 찼다

흔한 원인: 내려받은 부품, 스냅샷, 영상, 대화 기록이 쌓였다
에이전트에게: 「용량을 많이 쓰는 폴더를 보여 줘. 다시 받을 수 있는 것과 아닌 것을 나눠서」라고 하고, 삭제할 것은 내가 정한다

이 증상과 이어지는 저자 사례 묶음: 지워졌다 → 사례 찾기

남의 서비스가 막았을 때6건

「한도를 넘었습니다」

흔한 원인: 무료 사용량을 모두 썼다. 에이전트가 짧은 시간에 요청을 많이 보냈다
에이전트에게: 멈춘다. 무엇을 세는 한도인지 공식 안내에서 확인한다

계정이 정지됐다

흔한 원인: 짧은 시간에 여러 개를 올렸다. 같은 글을 여러 곳에 올렸다. 링크가 들어 있는 글을 반복해서 올렸다
에이전트에게: 그 서비스에 올리는 일을 전부 중단한다. 문의는 사람이 한다

올린 글이나 댓글이 다른 사람에게 보이지 않는다

흔한 원인: 서비스가 알림 없이 보이지 않게 처리했다
에이전트에게: 로그인하지 않은 브라우저로 열어서 확인한다

어제는 되던 것이 오늘은 되지 않는데 내 쪽은 바뀐 것이 없다

흔한 원인: 그 서비스가 화면이나 규칙을 바꿨다. 그 서비스에 장애가 났다
에이전트에게: 배포를 반복하지 않는다. 그 서비스의 상태 안내를 먼저 확인한다

사람 확인이 내 에이전트의 브라우저에서만 표시된다

흔한 원인: 프로그램이 실행한 브라우저라는 표시가 있다
에이전트에게: 그 일은 직접 한다

청구된 요금이 예상보다 많다

흔한 원인: 사용한 만큼 요금을 내는 서비스에서 프로그램이 많이 사용했다
에이전트에게: 금액 한도와 알림을 직접 설정한다

이 증상과 이어지는 저자 사례 묶음: 한도에 닿았다 · 바깥 서비스가 막았다 → 사례 찾기

돈과 손님 정보6건

주문은 있는데 입금됐는지 알 수 없다

흔한 원인: 계좌 입금은 가게에 자동으로 전달되지 않는다
에이전트에게: 통장을 직접 확인하고 「입금 확인」을 누른다

입금자 이름이 주문자와 다르다

흔한 원인: 다른 사람이 보냈다
에이전트에게: 주문서의 입금자 이름 칸과 대조한다. 맞지 않으면 손님에게 물어본다

재고가 없는데 주문이 들어왔다

흔한 원인: 재고를 줄이는 처리가 없거나, 확인하고 줄이는 사이에 시간 간격이 있다
에이전트에게: 「하나 남은 상품에 주문 두 건이 동시에 들어오면 어떻게 돼?」

비밀 값이 들어 있는 파일을 저장소에 올려 버렸다

흔한 원인: 올리지 않는 목록에 그 파일이 빠져 있었다
에이전트에게: 삭제하는 것으로 끝나지 않는다. 그 서비스에 접속해서 그 인증 키를 폐기하고 새로 발급받는다

비밀번호를 대화창에 붙여 넣었다

흔한 원인: 대화 기록에 남는다
에이전트에게: 그 비밀번호를 바꾼다. 다음부터는 파일에 직접 입력한다

운영자 화면의 주소가 유출됐다

흔한 원인: 주소를 숨기는 것은 접근을 막는 것이 아니다
에이전트에게: 「비밀번호 없이 운영자 요청을 보내면 막히는지 확인해 줘」라고 하고 비밀번호를 바꾼다

이 증상과 이어지는 저자 사례 묶음: 승인이 넓게 읽혔다 → 사례 찾기

증상표는 책 부록 「증상으로 찾는 상식」과 같은 원본입니다. 하네스를 쓰며 새로 만난 증상은 표에 더합니다. 지금 겪는 일을 말로 적어 비슷한 저자 사례를 찾으려면 사례 찾기를 쓰세요. 자료 파일은 symptoms.json입니다.