blas1n/claude-skills

a-cached-config-layer-keeps-the-first-credential-it-saw

런마다 다른 크리덴셜을 긴 수명 프로세스의 **설정 층**으로 주입하면, 그 층은 런보다 **거친 키**(디렉터리·프로젝트·워크스페이스)로 캐시돼서 **처음 본 토큰을 계속 쓴다** — 그런데 기능은 캐시로 멀쩡히 돌아가므로 표면에서는 절대 안 보인다. 유일한 센서는 **받는 쪽**이다: 토큰을 바꾼 뒤 서버에 요청이 **새로 오는가**를 봐라. 트리거 - per-run 토큰을 설정 파일/설정 API 로 주입, 긴 수명 데몬(serve·LSP·language…

Idioma del texto original: coreano

a-check-that-cannot-flip-is-not-measuring-anything

테스트가 아닌 검사 — 부재 가드 · 완료 감지기 · 문서 전체를 훑는 단언 — 은 RED 를 먼저 보는 습관이 없어서, **구조상 한쪽 판정만 낼 수 있는 채로** 배포된다. 초록이면 "결함 없음"이 아니라 "빨개질 수 없음"이고, 타임아웃이면 "전파 안 됨"이 아니라 "성공을 감지할 수 없음"이다. 검사마다 **반대 판정을 한 번 강제로 보라.** 트리거 - `until`/폴링 대기 루프, 삭제 PR 의 부재 가드, dict/응답을 문자열로 합쳐 매칭하는…

Idioma del texto original: coreano

a-rejection-records-a-verdict-but-the-reason-is-what-expires

측정해서 기각한 접근은 문서에 **평결**로 남는다("못 한다") — 그런데 실제로 유통기한이 있는 건 평결이 아니라 **그때의 조건**이다. 조건이 바뀌면 평결은 조용히 거짓이 되고, 아무도 다시 재지 않는다. 기각을 적을 땐 *무엇이 달라지면 이게 뒤집히는가*를 같이 적고, 선행조건이 닫히면 **기각된 레버부터 다시 재라.** 트리거 - 인수인계/이슈에 "측정 끝, 못 한다"가 적혀 있을 때, 차단 조건이 방금 해소됐을 때, 트랙 우선순위를 정할 때,…

Idioma del texto original: coreano

a-guard-on-the-shared-function-proves-nothing-about-its-call-sites

공유 함수에 테스트를 붙이면 그 함수의 *계산*은 지켜지지만, 그걸 **부르는 쪽의 배선**은 무방비로 남는다. 인자를 틀리게 넘기거나 아예 안 넘겨도 스위트가 전부 초록이다. 감지기는 초록/빨강이 아니라 **호출 지점에서 전선을 끊었을 때도 빨개지는가**다. 호출자가 N 개면 테스트도 N 개 — 한쪽에 붙인 가드는 다른 쪽에 대해 아무 말도 안 한다. 트리거 - 공유 함수에 새 파라미터/콜백 추가, 두 곳 이상에서 같은 메커니즘을 배선, "계산은…

Idioma del texto original: coreano

alembic-fresh-pg-smoke-test

SQLite-only unit tests cannot catch PostgreSQL-only migration bugs. Add a fresh-PG smoke test that runs `alembic upgrade head` against an empty container so DROP DEFAULT, enum DDL listener collisions, and dependent-object errors fail at PR time instead of on…

Idioma del texto original: inglés

who-still-holds-the-inputs-decides-who-can-retry

재시도·재전달·재개 메커니즘을 설계할 때 첫 질문은 "언제 다시 보낼까"가 아니라 **"그때 입력을 아직 누가 들고 있나"**다. 요청의 일부는 *일부러* 저장되지 않는다 — 시크릿·수명이 짧은 토큰·요청 스코프 자격. 그걸 안 세고 백그라운드 스위퍼를 고르면, 설계가 조용히 "안 저장하기로 한 것을 저장하라"를 요구하게 되고 신뢰성 수정이 보안 회귀로 결제된다. 트리거 - 재전달/재시도/재개/리플레이 설계, "스위퍼가 훑어서 다시 보낸다",…

Idioma del texto original: coreano

an-isolation-flag-covers-a-mechanism-not-its-goal

격리 플래그는 목표가 아니라 **메커니즘 하나**를 끈다 — `--setting-sources ""` 는 설정 파일을 끄지만 cwd 로 키잉된 auto-memory 는 못 끈다. 그래서 "호스트로부터 격리됨" 주석은 절반만 참인 채로 몇 달을 산다. 검증은 플래그를 세는 게 아니라 **보면 안 되는 것을 그대로 인용해 보라고 시키는 것**이다. 트리거 - 서브프로세스/샌드박스/에이전트 격리 주장, "--no-X 를 줬으니 안 들어온다", 벤더 CLI 를…

Idioma del texto original: coreano

collapsing-per-item-dirs-merges-state-keyed-on-the-path

태스크마다 만들던 임시 디렉터리를 "아무도 안 쓰니까" 하나로 합치면, **그 경로로 키잉된 남의 상태**가 전부 하나로 합쳐진다 — 우연히 있던 격리가 사라지는데 런타임 동작 변화는 0으로 보인다. "안 쓰인다"를 내 코드에서만 grep 했기 때문이다. 트리거 - per-task/per-run 디렉터리 제거, "고정 cwd 하나로", 임시 디렉터리 정리 PR, 벤더 CLI/툴을 subprocess 로 띄우는 코드, 멀티테넌트 워커, "이 디렉터리는 아무도…

Idioma del texto original: coreano

same-second-correlation-is-not-cause-remove-the-condition

행·크래시·타임아웃을 추적하다 시스템 로그에서 '같은 초에' 일어난 사건을 찾으면 그게 원인처럼 읽힌다 — 두 번 반복되면 확신이 된다. 하지만 확정은 '그 조건을 없애면 증상이 사라지는가'로만 온다. 그 제거 실험이 대개 코드 0줄·10분인데도, 하기 전에 '원인 확정'이라고 쓰게 된다. 트리거 - 시스템 로그에서 타임스탬프가 일치하는 이벤트 발견, '이게 원인이다' 라고 쓰기 직전, 설정 하나로 조건을 없앨 수 있는데 안 해봤을 때, 같은 이슈에서 가설이…

Idioma del texto original: coreano

force-push-does-not-erase-what-pull-refs-hold

private 레포를 public 으로 바꾸기 전 비밀을 지우려고 `filter-repo` + force push 를 해도 **GitHub 은 PR 마다 만든 `refs/pull/N/head` 로 옛 커밋을 붙잡고 있다** — 그 ref 는 사용자가 지울 수 없고(PR 삭제 불가), 공개되는 순간 `git fetch origin 'refs/pull/*/head:…'` 한 줄로 전부 회수된다. 실측: 세탁본 26커밋을 force push 했는데 원격 미러는…

Idioma del texto original: coreano

a-living-doc-repeats-a-fact-and-updates-only-one-copy

Living 문서(STATUS·ROADMAP·인수인계)는 같은 사실을 산문·취소선·표에 여러 번 적는데, 갱신은 **산문만** 된다 — 표의 행이 가장 늦게 썩고, 그 행이 백로그를 이슈로 옮길 때 근거가 된다. 그리고 문서 이주·의존성 제거 과제에서는 **옮기기 전에 그 참조가 아직 살아 있는지부터 재라** — 실측하니 코드의 문서 인용 13개 중 8개가 이미 죽은 링크였다. 그리고 **이주는 다른 세션에 전파되지 않는다** — 옛 경로에 쓰는 것은 실패하지…

Idioma del texto original: coreano

notion-mcp-large-page-content-truncates-the-call

Notion MCP `create-pages` 에 큰 `content`(대략 10KB+, 한글이면 `\uXXXX` 이스케이프로 3배 부풀어 더 빨리)를 넘기면 툴 호출 JSON 자체가 중간에서 잘려 `InputValidationError: could not be parsed as JSON` 이 난다 — 내용 문제가 아니라 크기 문제다. **create(앞부분) → update-page `insert_content` `{"type":"end"}`(뒷부분)**…

Idioma del texto original: coreano

zsh-word-splitting-fails-the-edit-and-the-grep-that-checks-it

zsh 는 `$var` 를 단어 분할하지 않는다 — `FILES=$(find ...)` 뒤 `sed ... $FILES` 는 목록 전체를 **파일명 하나**로 넘겨 15개 치환이 전부 실패한다. 진짜 위험은 실패 자체가 아니라, 바로 뒤 검증 `grep ... $FILES` 가 **같은 관용구를 공유해 함께 죽는 것**이다: 편집도 안 되고 검증도 "잔여 없음"처럼 보인다. 배열 `FILES=(...)` + `"${FILES[@]}"` 를 쓰고, 검증은 편집과…

Idioma del texto original: coreano

a-timeout-names-the-waiter-not-the-cause-read-the-other-end

타임아웃은 기다린 쪽의 경험이지 사건의 원인이 아니다. 보고 홉(worker→backend, client→API, job→queue)이 보내는 쪽에서 응답을 안 보고 받는 쪽에서 거절을 200 으로 돌려주면, 실패한 쓰기가 성공 로그로 세탁된다 — 그리고 한쪽 끝만 읽어 만든 진단표에는 진실이 들어갈 칸이 아예 없다. 두 끝을 같은 타임스탬프로 나란히 읽어라: 모순 자체가 진단이다. 트리거 - '왜 자꾸 타임아웃이지', 재현 안 되는 간헐 행(hang), 같은…

Idioma del texto original: coreano

absence-guard-listing-spellings-proves-only-imagination

부재 가드를 "내가 본 적 있는 철자 목록"으로 쓰면 상상 밖의 철자로 살아남은 인스턴스를 통과시킨다 — 가드는 green, 결함은 생존. 패턴 목록 대신 **결과 집합(파일/호출자/심볼)을 핀으로 박아라**: 어떤 이름으로든 새 인스턴스가 생기면 목록에 없어서 실패한다. 핀이 썩는 것도 같이 막아라. 트리거 - 부재/금지를 grep 으로 주장하는 테스트, 삭제 PR 의 가드, "이제 아무도 X 를 안 읽는다" 주장, 감사 후속 정리.

Idioma del texto original: coreano

a-dead-entity-can-be-the-subject-of-a-live-claim

producer 없는 테이블·0행 컬럼·안 불리는 설정을 발견하면 "청소 항목"으로 분류되지만, 그 이름은 대개 **어딘가에서 사용자에게 무언가를 주장하는 문장의 주어**로 살아 있다 — 공시·보존 정책·대시보드·프롬프트·문서. 죽은 것은 무해하지 않고 **거짓 주장을 생산한다.** 지우기 전에 "무엇이 이것에 대해 말하는가"를 따로 세라. 트리거 - "0행이니 죽은 듯", 감사/인수인계의 미확인 잔재 목록, DROP 마이그레이션 착수, "안 쓰이니 지우자",…

Idioma del texto original: coreano

cannot-do-x-must-be-narrowed-by-a-control-you-own

"에이전트라서 못 한다 / OS 경계다 / 권한이 없다" 는 능력을 통째로 부정하는 진단이고, 거의 항상 너무 넓다. 반증은 싸다 — 같은 종류의 자원을 **내가 만들고 내가 통제하는 인스턴스**로 하나 세워 똑같은 연산을 해봐라. 성공하면 진단은 즉시 '그 객체가, 그 상태에서' 로 좁아진다. 트리거 - "권한이 없어서 못 합니다", "비대화형이라 안 됩니다", "OS/샌드박스 제약입니다", 인수인계가 여러 세션 이월한 '사람 손이 필요한 것', 사람이 직접…

Idioma del texto original: coreano

a-failed-read-degraded-to-empty-becomes-a-measurement

읽기 실패를 `[]`/`false`/`0` 으로 degrade 하면, 그 비어 있음 자체로 UI·규칙이 주장을 만드는 순간 blip 한 번이 "안 잰 것"을 단언한다. 트리거 - `.catch(() => [])`, `?? false`, `except: return None`, "never blanks the surface" 주석, "blip 때 조용히 잘못된 안내가 뜬다", 인수인계가 넘긴 미확인 결함 후보.

Idioma del texto original: coreano

a-cut-that-does-not-compile-is-not-a-wire-cut

가드를 실증하려고 코드를 되돌렸는데 그 치환이 문법 오류를 만들면, 빨강은 나오지만 아무것도 증명되지 않는다 — 그리고 빨강이 나왔으므로 성공처럼 읽힌다. 이걸 잡는 신호는 초록/빨강이 아니라 **돌아간 테스트 개수**다. 트리거 - 전선 절단/mutation 실증, sed·python 로 소스 되돌리기, "가드가 진짜 잡는지 확인", 절단 후 실패 수가 예상과 다를 때.

Idioma del texto original: coreano

status-code-is-not-a-reason-code

An endpoint that refused for exactly one reason gets a client that keys its message off the HTTP status. Add a second refusal reason and that mapping shows the WRONG actionable hint — plausible, silent, and reported by nobody. Before adding a refusal, open…

Idioma del texto original: inglés

a-never-walked-checklist-item-may-be-unbuildable

한 번도 안 걸어본 E2E 체크리스트의 `- [ ]` 는 "아직 확인 안 함"이 아니라 "제품이 만들 수 없는 상태를 적어둔 문장"일 수 있다 — 그리고 유닛 스위트가 자식 컴포넌트를 직접 렌더하며 부모가 절대 안 주는 조합을 넣고 있으면, 코드도 문서도 초록인 채로 그 거짓이 산다. 트리거 - 미체크 항목이 오래 남은 체크리스트, "유닛은 다 통과인데 라이브는 안 걸어봄", 자식 컴포넌트를 직접 렌더하는 테스트, 문서가 약속한 UI 상태를 못 찾을 때,…

Idioma del texto original: coreano

playwright-e2e-patterns

Playwright E2E patterns — devcontainer setup (fonts, system libs), selector pitfalls, API-based testing

Idioma del texto original: inglés

the-branch-behind-a-human-gate-was-never-run

사람이 비밀·승인·설정을 넣어야만 실행되는 분기는, 그 사람이 오기 전까지 단 한 번도 실행된 적이 없다 — 그래서 그 안의 결함(빠진 의존성·오타·죽은 경로)은 사람이 값을 넣는 바로 그 순간 처음 터진다. "값이 없으면 SKIP 된다"를 실증한 것은 SKIP 을 실증한 것이지 그 뒤를 실증한 게 아니다. 트리거 - Keychain/env/시크릿이 있어야 켜지는 기능, "설정 전까지는 조용히 스킵", 야간·크론 잡의 인증 절반, 승인 후에만 도는 경로, 사람…

Idioma del texto original: coreano

a-question-back-instead-of-a-choice-means-the-menu-is-wrong

선택지를 냈는데 사용자가 고르지 않고 **되물으면**, 그건 혼란이 아니라 **프레이밍이 틀렸다는 증거**다. 되물음은 거의 항상 내가 건너뛴 층을 정확히 가리킨다 — 답을 주고 같은 메뉴를 다시 내지 말고, **그 질문이 드러낸 층을 먼저 측정해서 지도를 그려라.** 메뉴를 두 번 되돌려받으면 결정 자체가 아직 이르다는 뜻이다. 트리거 - AskUserQuestion 응답이 물음표로 끝날 때, "그러면 X 는 어떻게 되는 거야?", "그건 Y 가 안 된다는…

Idioma del texto original: coreano

verify-handoff-claims-against-code-before-building

A delegation brief or handoff memory that says "X is missing / unsolved, go build it" is a point-in-time snapshot that may be stale. Verify the claimed-undone work actually is undone against current code/state BEFORE building — especially before destructive…

Idioma del texto original: inglés

the-precedent-you-found-may-be-an-exception-entry

기존 코드가 X 를 하고 있다고 해서 X 가 허용된 패턴인 건 아니다 — 그 줄이 **예외 목록에 등록된 위반**일 수 있다. 호출 지점에서는 선례와 예외가 **똑같이 생겼다**: 둘 다 그냥 도는 코드다. 차이는 아키텍처 게이트의 설정 파일에만 있다. 설계를 선례 위에 세우기 전에, 그 선례가 `ignore_imports` · `noqa` · allowlist · `# type: ignore` 에 이름이 올라가 있는지 **먼저 확인하라.** 트리거 - "이미…

Idioma del texto original: coreano

narrowing-an-overbroad-assertion-must-restate-its-proposition

공유 테스트 헬퍼가 명제보다 **넓은 범위**를 세면(디렉터리 전체 rglob, 테이블 전체 count), `len == 1` 이 사실은 "이 범위에 물건이 딱 하나 존재한다"는 훨씬 센 주장이 된다. 같은 범위에 쓰는 기능이 하나 생기면 무관한 테스트가 우수수 빨개지고, **가드가 깨진 것처럼 보이지만 가드는 멀쩡하다**. 함정은 고치는 쪽에 있다 — 헬퍼를 좁히면 그 명제가 제외된 표면에서 조용히 사라진다. 좁히면 **반드시 그 명제를 새 표면에 다시…

Idioma del texto original: coreano

bulk-code-transform-costs-more-than-it-saves

리팩터에서 N곳을 자동 변환(ast.unparse · 넓은 정규식 · sed)하면 대상 밖까지 바꾸거나 값을 틀리게 계산한다 — 그리고 테스트는 통과하므로 diff 를 한 줄씩 읽어야만 드러난다. 손익분기점은 생각보다 훨씬 높다(N≈20+). 트리거 - "N곳을 한 번에 고치자", ast.unparse/NodeTransformer 로 파일 재작성, `re.sub` 로 리터럴 변환, sed -i 일괄 치환, 대량 테스트 픽스처 갱신.

Idioma del texto original: coreano

cwd-resets-across-a-background-task-boundary

워크트리에서 작업하다 백그라운드 작업을 띄우고 그 완료 알림으로 돌아오면, `cd` 를 한 번도 안 쳤는데 셸의 cwd 가 기본 작업 디렉터리로 돌아가 있다. 상대경로 편집이 조용히 **엉뚱한 git 트리**에 떨어진다. "절대경로로 cd 해라"는 규율은 이걸 못 막는다 — 내가 cd 를 안 했기 때문이다. 트리거 - 워크트리 + 백그라운드 테스트/빌드, 알림 복귀 직후 첫 명령, "방금 되던 `.venv/bin/...` 가 no such file", 두…

Idioma del texto original: coreano

piped-gate-masks-exit-code

로컬에서 CI 게이트를 돌릴 때 `ruff check ... | tail -1` 처럼 파이프를 걸면 파이프라인 종료코드는 마지막 명령(tail)의 것이라 실패가 통째로 숨는다. `&&` 체인은 그대로 통과하고 "전부 green"이라고 보고하게 된다. 트리거: 로컬은 green인데 CI에서 lint/test 실패, `cmd | tail`, `cmd | head`, `set -e` + 파이프.

Idioma del texto original: coreano

local-green-is-not-evidence-when-the-backend-is-gated

스위트가 환경변수/도달성으로 백엔드를 고르면(BSVIBE_DATABASE_URL 있으면 PG 아니면 SQLite, Ollama 안 뜨면 skip), **로컬 전체 통과는 근거가 못 된다.** 가장 값진 테스트가 조용히 skip 되고, 그 skip 은 통과처럼 집계된다. CI 와 로컬이 같은 눈먼 지점을 공유하면 결함은 양쪽 모두를 통과한다. 트리거 - `use_real_pg()`, `pytest.skip("... not reachable")`, "로컬은 되는데…

Idioma del texto original: coreano

completion-detector-fires-on-an-earlier-success-string

긴 작업을 기다리는 폴링 루프의 패턴이 **종료 이벤트에만** 나타나는 문자열이 아니면, 앞선 단계의 성공 메시지에 걸려 일찍 끝난다 — "끝났다"는 알림이 오는데 결과는 아직 없다. 체인된 게이트(`ruff && mypy && pytest`)에서 특히 잘 터진다. 종료 신호는 **형태로 유일**해야 하고, 안 되면 마커를 직접 심어라. 트리거 - `until grep -q ...` 대기, `tail -f | grep` 완료 감지, CI/배포 폴링, 여러…

Idioma del texto original: coreano

absence-measurement-validity-check

Before concluding "X doesn't happen" in an integrated system, verify the pipeline that would produce X is actually running. Measuring zero is trivially easy when the producer is off.

Idioma del texto original: Varios idiomas

ascii-fixture-cannot-catch-byte-vs-char-confusion

두 단위가 우연히 같아지는 픽스처("x"*N, 정수 1.0, UTC 자정)로 만든 테스트는 단위 혼동을 영원히 못 잡는다 — 계약이 단위를 말하면 픽스처는 그 단위가 갈라지는 값을 써야 한다.

Idioma del texto original: coreano

llm-grounding-additions-can-evict-existing-grounding

프롬프트에 "당연히 관련 있는" 근거 파일을 더하면 능력이 늘 것 같지만, 이미 잘 되던 것을 밀어내 능력이 줄 수 있다. 근거 추가는 기능 추가가 아니라 예산 재배분이다 — 더하기 전에 재라.

Idioma del texto original: coreano

failure-duration-names-the-timeout-that-caused-it

실패까지 걸린 시간을 코드베이스의 타임아웃 상수들과 대조하라. 합이 맞으면 로직 버그가 아니라 두 층이 서로를 기다리다 죽은 것이고, 범인은 응답하지 않은 쪽이다.

Idioma del texto original: coreano

blocking-defect-masks-the-ones-behind-it

When a defect stops execution entirely, every defect downstream of it is invisible — so a fix is not a checkmark but a probe. Re-prove in production after EACH fix instead of planning the whole repair up front; expect the next layer to appear only once the…

Idioma del texto original: inglés

confirm-the-premise-before-offering-the-choice

사용자에게 선택지를 제시하기 전에, 그 선택지가 실제로 무엇을 하는지 코드로 확인하라. 인수인계·설계문서·백로그 문장을 근거로 질문을 만들면 사용자가 틀린 전제 위에서 결정하게 되고, 그 결정은 되돌릴 수 없다(사람은 이미 골랐다). 코드 작성 전 검증보다 **질문 전 검증**이 먼저다. 트리거 - AskUserQuestion 으로 옵션 제시, "A 하면 B 가 됩니다" 형태의 설명, 문서를 인용해 결정을 요청, 되돌릴 수 없는 작업의 승인 요청.

Idioma del texto original: coreano

deletion-pr-needs-an-absence-guard-and-a-control

죽은 코드/테이블을 지울 때 삭제만 하고 스위트가 green 이면 "지웠다"가 거짓일 수 있다 — 빈 디렉터리가 namespace package 로 살아남고, downgrade 는 안 돌려봐서 죽어 있고, 알리바이 테스트가 죽은 표면을 명세로 박아둔다. 부재를 주장하는 가드(RED→GREEN)와 살아남아야 할 것의 양성 대조군을 먼저 써라. 트리거 - 서브시스템/패키지/테이블 삭제, 구조 감사 후속, "호출자 0이니 지우자", 드롭 마이그레이션, 죽은 코드…

Idioma del texto original: coreano

verification-query-moves-the-metric

배선이 도달했는지 재려고 잡은 지표를, 확인하는 쿼리 자체가 움직이는 경우 — `pg_stat_user_tables.seq_scan` 을 지표로 쓰면 `count(*)` 확인이 카운터를 올려 거짓 양성이 된다. 기준선을 문서로 넘겨받으면 다음 세션이 자기 확인 쿼리를 성공으로 오독한다. 트리거 - "카운터가 늘었으면 배선된 것", 스캔/히트 카운터를 증거로 삼기, 기준선을 인수인계에 적기, 관측 지표 설계.

Idioma del texto original: coreano