blas1n/claude-skills - Seite 2

a-layering-contracts-refusal-names-the-right-home

새 import 가 아키텍처 계약(import-linter 등)을 깨뜨리면, 기본 반응은 ignore_imports 추가다 — 그런데 대개 그 거절은 "공유하려는 그것이 지금 엉뚱한 컨텍스트에 산다"는 말이다. 올바른 층으로 내리면 기존 호출자 여럿이 그걸 채택할 수 있게 되고, 그중 하나는 이미 조용히 드리프트해 있다.

Quellsprache: Koreanisch

re-parenting-a-dependency-moves-the-test-override-seam

FastAPI 의존성의 부모를 바꾸면 `dependency_overrides` 씸이 같이 이동한다 — 스위트가 오버라이드하던 콜러블에 더는 아무도 의존하지 않아서, 테스트는 조용히 프로덕션 인증을 다시 타고 "missing Authorization header" 로 무너진다. 기능이 틀린 게 아니라 씸이 옮겨간 것이다.

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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…

Quellsprache: Englisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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 했는데 원격 미러는…

Quellsprache: Koreanisch

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"}`(뒷부분)**…

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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…

Quellsprache: Englisch

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

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

Quellsprache: Koreanisch

playwright-e2e-patterns

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

Quellsprache: Englisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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…

Quellsprache: Englisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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")`, "로컬은 되는데…

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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.

Quellsprache: Mehrsprachig

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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

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

Quellsprache: Koreanisch

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…

Quellsprache: Englisch

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

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

Quellsprache: Koreanisch

verification-query-moves-the-metric

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

Quellsprache: Koreanisch

half-wired-subsystem-audit

서브시스템의 "보이는 절반"(설정 UI·스키마·워커·읽기 엔드포인트)만 만들어지고 "안 보이는 절반"(프로덕션 producer/consumer, authoring 입력구, 서버 승격)이 빠지는 반복 결함. 유닛테스트 100% green으로 통과하며, 자율성은 전부 그 안 보이는 절반에 산다. 신규 서브시스템 설계·리뷰 시, 그리고 "설정은 있는데 왜 동작 안 하지" 증상에서 사용.

Quellsprache: Koreanisch

prompt-instruction-loses-to-the-later-specific-sentence

Adding a rule to an LLM system prompt silently loses to a LATER, more specific sentence that covers the same case — including the "escape hatch" that lets the model opt out. Fix the sentence that actually fires, never stack emphasis in front of it. Unit tests…

Quellsprache: Englisch

head-1-diff-shows-only-the-last-commit

"무엇이 바뀌었나"를 `git diff HEAD~1 HEAD` 로 만들어 LLM 판사·리뷰봇·알림·딜리버러블에 넣으면, 에이전트가 커밋을 두 번 이상 한 순간 **첫 커밋들이 통째로 사라진다.** 파일 목록은 맞는데 내용이 0바이트라 "파일이 없다/검증할 수 없다"는 오판이 나온다. 트리거 - `git diff HEAD~1`, `HEAD^..HEAD`, 판사/리뷰어에게 보낼 컨텍스트 조립, "코드를 볼 수 없습니다" 반복 거절, 커밋 여러 개 만드는 에이전트…

Quellsprache: Koreanisch

guard-must-borrow-the-systems-own-lease

"죽었나 살았나"를 스스로 고른 신선도 창(3분 등)으로 판정하는 가드·워치독·리퍼·헬스체크는, 보호 대상 시스템이 자기 계약서에 적어둔 lease(예: 한 턴 최대 1시간)와 어긋나면 **가장 값진 작업 구간에서 정확히 오판**한다. 트리거 - `updated_at > now() - interval 'N minutes'`, "in flight 면 배포 연기", stale-claim 리퍼, liveness/readiness probe, 배포 직전 드레인 가드,…

Quellsprache: Koreanisch

agent-degraded-output-suspect-execution-environment

When a capable agent first declares a STRONG plan/contract/approach then a retry or continuation produces a WEAKER one, suspect the execution environment couldn't run the strong version — not model laziness or a prompting gap.

Quellsprache: Mehrsprachig

deleting-inert-config-row-disables-hidden-feature

설정 행(룰·바인딩·커넥터·플래그 테이블)을 "한 번도 발화한 적 없으니 중복/불필요"라며 지우기 전에 — 그 행의 *존재*를 `has_any`/`exists`/`count>0` 로 읽는 코드가 있는지 세라. 한 용도에서의 비활성이 다른 용도에서의 무해함을 뜻하지 않는다. 증상: 무관해 보이는 기능이 삭제 직후 조용히 꺼지고, 아무 에러도 안 난다.

Quellsprache: Koreanisch