yd-db-expert SKILL.md skillA

yd-db-expert from leeyudok/doksam-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add leeyudok/doksam-skills/yd-db-expert@git:20261011.76a7b1a

Pins git:20261011.76a7b1a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
leeyudok/doksam-skills
Path
skills/yd-db-expert/SKILL.md
Versions recorded
5
Latest version
git:20261011.76a7b1a, committed Oct 11, 2026
First version recorded
Oct 4, 2026
Size
9,020 bytes
Repository stars
14
License
MIT

엔진과 무관한 관계형 설계를 다룰 때 사용한다 — 스키마 정규화·키·NULL 의미·DB 제약·소프트 삭제·인덱스 선택 원칙·쿼리 규칙(N+1·플레이스홀더·커서 페이징)·트랜잭션 경계·마이그레이션 단계. PostgreSQL 고유 주제는 yd-pg-expert, Oracle 고유 주제는 yd-oracle-expert, SQLite 고유 주제는 yd-sqlite-expert 를 쓴다.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# yd-db-expert

엔진과 무관한 관계형 설계가 대상이다. 잠금·테이블 재작성·실행계획 읽는 법·타입 세부처럼
엔진마다 다른 동작은 엔진 스킬이 맡는다 — PostgreSQL 은 `yd-pg-expert`, Oracle 은
`yd-oracle-expert`, SQLite 파일은 `yd-sqlite-expert`. 애플리케이션 코드는 각 언어 스킬이 맡는다.

아래 단언 가운데 SQL 의미론에 관한 것은 `scripts/verify_db_claims.py` 가 SQLite 로
재현한다(8장). 같은 의미론은 표준 SQL 이라 PostgreSQL·Oracle 에서도 같다. 엔진마다 갈리는
지점은 본문에 적었다.

## 1. 스키마 설계 — 판단 기준

정규화는 목적이 아니라 **이상현상(anomaly)을 없애는 수단**이다. 3NF 를 기본으로 두고,
역정규화는 **측정된 병목**이 있을 때만, 그리고 **갱신 경로를 하나로 유지**할 수 있을 때만.

설계하기 전에 스스로 답한다:

1. **이 테이블의 한 행은 무엇 하나인가** — 한 문장으로 안 되면 쪼갤 신호다.
2. **자연키인가 대리키인가** — 사업자번호·사번처럼 외부가 소유한 값은 바뀐다.
   대리키(식별자)를 두고 자연키에는 유니크 제약을 건다.
3. **이 컬럼이 NULL 일 수 있는 실제 상황은 무엇인가** — 답이 없으면 `NOT NULL`.
   NULL 은 "모름"이지 "없음"이나 "0"이 아니다.
4. **삭제하면 무엇이 같이 사라져야 하는가** — FK 의 `ON DELETE` 를 의도적으로 정한다.
   기본값에 맡기지 않는다.

### 제약은 애플리케이션이 아니라 DB 에 건다

`NOT NULL`·`UNIQUE`·`CHECK`·`FOREIGN KEY` 는 마지막 방어선이다. 애플리케이션 검증은
사용자 경험용이고, 데이터 무결성은 DB 가 보장한다. **버그·수동 작업·다른 클라이언트는
애플리케이션을 우회한다.** 제약이 없는 테이블에 수동 SQL 세 줄을 넣으면 NULL·중복·음수 잔액이
그대로 들어가고, 제약이 있는 테이블은 셋 다 거부한다.

### NULL 의 의미론

- **`NULL = NULL` 은 참이 아니라 NULL 이다.** `WHERE col = NULL` 은 아무 행도 고르지 못한다.
  `IS NULL` 을 쓴다. `col <> 'x'` 도 NULL 인 행을 고르지 않는다.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add leeyudok/doksam-skills/yd-db-expert@sha256:984d204859a73702

The line at the top of this page pins the label git:20261011.76a7b1a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_txsxrtdgofpg3r22.svg)](https://markdownregistry.com/a/art_txsxrtdgofpg3r22)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 4, 2026 and Oct 11, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261011.76a7b1a latest2026-10-11 76a7b1a 9,020 BA view · diff
git:20261004.14d5e022026-10-04 14d5e02 9,035 BA view · diff
git:20261004.c7aa5612026-10-04 c7aa561 9,031 BA view · diff
git:20261004.0d5ff502026-10-04 0d5ff50 7,408 BA view · diff
git:20261004.9d92d692026-10-04 9d92d69 7,407 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9020 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

leeyudok/doksam-skills · 14 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_txsxrtdgofpg3r22
GET https://markdownregistry.com/api/v1/resolve?ref=leeyudok/doksam-skills/yd-db-expert
GET https://markdownregistry.com/api/v1/blob/984d204859a73702201801a588b61a86830aa4496f9f2ccc6d7154b970883a2e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from leeyudok/doksam-skills

AGENTS.md AGENTS.md file
leeyudok/doksam-skills · AGENTS.md
git:20261017.ec49e19 · audit A · 14 stars
yd-agents-mem SKILL.md skill
leeyudok/doksam-skills · skills/yd-agents-mem/SKILL.md · 에이전트 메모리·전역 지침·설정을 GitLab agents-mem 레포에 백업하고 되돌린다. 전역 CLAUDE.md·infra-*.md·ref-*.md·프로젝트 메모리·스킬·에이전트·settings 를 고친 뒤…
git:20261011.76a7b1a · audit A · 14 stars
yd-agents-yaml SKILL.md skill
leeyudok/doksam-skills · skills/yd-agents-yaml/SKILL.md · 저장소의 에이전트 지침을 사람용 AGENTS.md + 기계 판독용 AGENTS.yaml + 검증기 scripts/check-agents-yaml.sh 세 파일로 세팅하거나 갱신한다. AGENTS.yaml 이 없는…
git:20261011.76a7b1a · audit A · 14 stars
yd-blueprint SKILL.md skill
leeyudok/doksam-skills · skills/yd-blueprint/SKILL.md · 프로젝트의 구조·기록 흐름·구현 현황·남은 작업을 JSONL 데이터로 적고 bun+Vite+React 청사진 화면(localhost:5173/blueprint/)으로 띄운다. 청사진·구조도·구현 현황표를 만들거나…
git:20261011.fc9c4fb · audit A · 14 stars
yd-claude-auth-sync SKILL.md skill
leeyudok/doksam-skills · skills/yd-claude-auth-sync/SKILL.md · 한 PC 에서 claude login 으로 다시 인증한 Claude Code 로그인을, 사용자가 등록해 둔 다른 PC·서버에도 똑같이 맞춘다. 키체인·~/.claude/.credentials.json 의…
git:20261017.ec49e19 · audit B · 14 stars
yd-doc-sync SKILL.md skill
leeyudok/doksam-skills · skills/yd-doc-sync/SKILL.md · 문서 현행화(doc-sync) — 코드·구성이 바뀐 뒤(디렉터리 삭제·이동, 포트·명령·의존성 변경, 큰 리팩터링 머지) 에이전트 지침(AGENTS.md·CLAUDE.md)·README·규칙(.claude/rules…
git:20261011.980cdb2 · audit A · 14 stars
yd-doksam-ui SKILL.md skill
leeyudok/doksam-skills · skills/yd-doksam-ui/SKILL.md · doksam 프로젝트의 UI 를 만들거나 수정할 때, 사용자가 "ui.doksam.com 참고" / "doksam-ui" / "독삼 표준 UI" 라고 말할 때, 프론트엔드 작업이 doksam 인프라를 대상으로 할…
git:20261004.0d5ff50 · audit B · 14 stars
yd-finguard SKILL.md skill
leeyudok/doksam-skills · skills/yd-finguard/SKILL.md · FinGuard CLI로 소스코드 취약점을 점검하고 심각도 기반 보안 게이트와 제한된 수정·재검증 루프를 수행할 때 사용한다. 일반 코드 품질 리뷰나 SCA·모의해킹은 범위 밖이다.
git:20261004.0d5ff50 · audit A · 14 stars
yd-frontend-build SKILL.md skill
leeyudok/doksam-skills · skills/yd-frontend-build/SKILL.md · pnpm 워크스페이스와 Vite 빌드를 설정·정비하거나, 의존성·락파일·번들 크기·폐쇄망 self-host 문제를 다룰 때 사용한다. 프레임워크 자체의 코드 작성이 아니라 빌드/패키징 층이 대상이다.
git:20261004.c66a4ea · audit A · 14 stars
yd-git-ship SKILL.md skill
leeyudok/doksam-skills · skills/yd-git-ship/SKILL.md · GitLab 레포에 에이전트(Claude Code·Codex·Antigravity)가 작업을 올리는 절차 — 이슈 등록, batch/<agent>-<날짜>-<8자리 hex> 브랜치, "[<model>]…
git:20261011.76a7b1a · audit A · 14 stars
yd-git-sync SKILL.md skill
leeyudok/doksam-skills · skills/yd-git-sync/SKILL.md · 여러 호스트(맥·pig·doksam 등)에 클론해 둔 같은 저장소를 맞춘다 — 각 클론을 git pull --ff-only 로 origin 에 맞추고 추적 파일 수·목록 해시를 비교한 뒤, git 이 관리하지 않는…
git:20261015.6d4494b · audit A · 14 stars
yd-go-expert SKILL.md skill
leeyudok/doksam-skills · skills/yd-go-expert/SKILL.md · Go 코드를 작성·리뷰·리팩터링하거나 에러 처리, 동시성, 테스트, net/http 서버, go:embed 를 다룰 때 사용한다. Go 1.22+ 기준.
git:20261004.6e1e1fe · audit A · 14 stars

Every file in leeyudok/doksam-skills

Other files named yd-db-expert

yd-db-expert SKILL.md skill
leeyudok/agents-scaffold · plugins/yd-skills/skills/yd-db-expert/SKILL.md · 엔진과 무관한 관계형 설계를 다룰 때 사용한다 — 스키마 정규화·키·NULL 의미·DB 제약·소프트 삭제·인덱스 선택 원칙·쿼리 규칙(N+1·플레이스홀더·커서 페이징)·트랜잭션 경계·마이그레이션 단계…
git:20261024.27d9360 · audit A · 36 stars
yd-db-expert SKILL.md skill
leeyudok/agents-scaffold · .claude/skills/yd-db-expert/SKILL.md · 엔진과 무관한 관계형 설계를 다룰 때 사용한다 — 스키마 정규화·키·NULL 의미·DB 제약·소프트 삭제·인덱스 선택 원칙·쿼리 규칙(N+1·플레이스홀더·커서 페이징)·트랜잭션 경계·마이그레이션 단계…
git:20261024.c5b81d9 · audit A · 36 stars

Browse by kind, by grade A, or by owner.