blas1n/claude-skills

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

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

Source text: Korean

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

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

Source text: Korean

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

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

Source text: Korean

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

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

Source text: Korean

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

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

Source text: Korean

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

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

Source text: Korean

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…

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…

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

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

Source text: Korean

playwright-e2e-patterns

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

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

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

Source text: Korean

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

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

Source text: Korean

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…

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

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

Source text: Korean

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

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

Source text: Korean

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

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

Source text: Korean

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

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

Source text: Korean

piped-gate-masks-exit-code

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

Source text: Korean

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

Source text: Korean

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

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

Source text: Korean

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.

Source text: Mixed languages

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

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

Source text: Korean

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

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

Source text: Korean

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

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

Source text: Korean

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…

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

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

Source text: Korean

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

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

Source text: Korean

verification-query-moves-the-metric

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

Source text: Korean

half-wired-subsystem-audit

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

Source text: Korean

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…

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

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

Source text: Korean

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

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

Source text: Korean

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.

Source text: Mixed languages

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

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

Source text: Korean

config-menu-offers-options-nothing-implements

사용자가 고르는 선택지 목록(enum·레지스트리·카탈로그·allowlist)을 폼/검증기/LLM 프롬프트가 "고를 수 있는 메뉴"로 읽을 때, 그 목록의 항목이 **실제로 구현돼 있는지는 아무도 검사하지 않는다.** 사용자가 유령 항목을 고르면 에러도 없이 그냥 아무 일도 안 일어난다 — 설정은 저장되고, 화면에도 보이고, 영원히 발화하지 않는다. 트리거 - 설정 드롭다운/룰 작성/라우팅 대상/웹훅 이벤트/기능 플래그 목록, "설정했는데 왜 동작 안 하지",…

Source text: Korean

seam-must-assert-what-the-consumer-sees

시임(seam)의 생산자 쪽만 보고 "정리하는 게 맞다"고 추론해 상태를 지우면, 그 상태가 소비자에게는 인계 그 자체일 수 있다. 테스트를 그 추론대로 쓰면 green 이 추론을 검증해준 것처럼 보인다. 트리거 - 핸드오프/재투입/재시도 경계 설계, cleanup·abort·reset·clear 를 추가할 때, "리소스를 돌려줘야 하니까 정리한다", 다음 단계가 "할 일이 없다"고 보고하며 아무것도 안 함.

Source text: Korean

stale-migration-pr-splits-alembic-head

마이그레이션이 든 PR 은 열려 있는 동안 다른 마이그레이션이 머지되면 배포를 깨뜨리는 지뢰가 된다 — `down_revision` 이 더 이상 head 가 아닌 리비전을 가리켜 머지 순간 head 가 둘로 갈라지고 컨테이너가 재시작 루프에 빠진다. 그런데 **git 도 브랜치 CI 도 이걸 못 본다**(새 파일이라 충돌 없음 + 브랜치 자체 체인은 단일 head). 트리거 - 며칠 묵은 PR 머지, 마이그레이션 포함 PR, "CI green 인데 배포가…

Source text: Korean

build-the-missing-link-not-the-missing-system

백로그가 "X 가 없다"고 말할 때, 대개 X 의 부품은 대부분 이미 있고 **연결 하나**만 없다. 사슬(생산자→전송→저장→읽기→화면)을 링크별로 측정하면 서브시스템 하나가 200줄짜리 배선으로 줄어든다. 트리거 - "가시성이 없다"·"자기 자신을 모른다" 같은 부재형 증상, "새 메커니즘이 필요하다"는 결론, 코드에 있는데 프로덕션 출력을 본 적 없는 기능, 큰 신규 트랙 착수 직전.

Source text: Korean

truncated-diagnostic-shows-only-the-passing-half

자동 소비자(에이전트·봇·CI)에게 실패 원인을 돌려줄 때 결과 객체 전체를 직렬화하고 앞에서 N자를 자르면, 통과 블록이 먼저 직렬화될 경우 "실패했다"면서 통과 목록만 보여준다. 소비자는 우회하지 않고 같은 실패를 무한 반복한다. 트리거 - 실패 피드백/에러 리포트/재시도 프롬프트를 만들 때, `json.dumps(result)[:N]` 같은 blind prefix, 동일 실패가 3회 이상 반복, 라인 번호가 안 움직이는 반복 실패, "어려운 작업인가…

Source text: Korean

waiting-on-a-human-is-not-an-outage

사람의 결정을 기다리는 작업을 "실행 중" 상태로 파킹해두면, 시간 기반 stall/wedge 모니터가 그걸 장애로 읽어 답을 기다리는 그 사람에게 장애 알람을 보낸다. 트리거 - 승인 대기·질문 대기 상태 설계, "N시간+ running 이면 wedge" 류의 모니터, 사용자가 "자꾸 이상 감지 알림이 온다"고 할 때, 대기 큐가 있는 시스템의 알림 튜닝.

Source text: Korean