菜单
Use when making architectural decisions, choosing between frameworks/libraries/databases, deciding on data models, or recording any decision that would be expensive to reverse. Do NOT use for code documentation (comments belong in code), daily notes (use obsidian-note), or TIL (use til).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when GenOS 작업에서 얻은 재사용 가능한 지식(플랫폼 패턴·함정·고객사 결정)을 개인 Obsidian vault(Projects/GenonAI)에 기록할 가치가 생겼거나, GenOS 작업 맥락에서 사용자가 "지식 캡처", "vault에 정리/기록", "MOC", "읽는 순서", "field note", "/genos-knowledge-capture"를 요청할 때 사용. Do NOT use for: GenOS와 무관한 노트, 웹 리서치 기반 일반 개념 노트, 단순 진행상황·세션 상태.
Use when user says "wiki compile", "위키 컴파일", "raw 정리", "지식 컴파일", "소스 컴파일", or wants to compile raw sources into a structured wiki. Do NOT use for individual note creation (use obsidian-note) or vault maintenance (use vault-linter).
Use when user says "vault lint", "노트 점검", "vault 정리", "orphan notes", "링크 점검", or wants to check Obsidian vault health. Do NOT use for individual note creation (use obsidian-note) or tag management (use til-tagger).
Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts. Use when user says "다이어그램", "diagram", "excalidraw", "시각화", "아키텍처 그려". Do NOT use for Mermaid diagrams or draw.io.
Use when user mentions "Obsidian", "옵시디언", "write as note", "save to notes", "노트로 저장", or /obsidian-note command. Do NOT use for TIL (use til), YouTube notes (use youtube-summarizer), GenOS 작업 지식 캡처 (use genos-knowledge-capture), or deep/team/multi-angle note research (use agentic-notes).
Use when the user asks to create an Obsidian note with an agent team, deep research, strict verification, multiple angles, or phrases like "팀으로 조사해서 노트", "깊게 조사해서 옵시디언 노트", "/agentic-notes", "--team", "--verify strict", or "--deep". Do NOT use for a simple one-shot Obsidian note; use obsidian-note instead.
| name | adr |
| description | Use when making architectural decisions, choosing between frameworks/libraries/databases, deciding on data models, or recording any decision that would be expensive to reverse. Do NOT use for code documentation (comments belong in code), daily notes (use obsidian-note), or TIL (use til). |
결정의 이유를 기록. 코드는 무엇을 했는지 보여주지만 ADR은 왜 그렇게 했는지와 어떤 대안을 버렸는지를 보존한다. 이 맥락은 미래의 엔지니어와 에이전트가 재논쟁하지 않도록 한다.
Superseded by ADR-NNN으로 표시. 과거 맥락을 삭제하지 말 것.docs/decisions/ADR-NNN-짧은-제목.md:
# ADR-001: Primary DB로 PostgreSQL 사용
## Status
Accepted | Superseded by ADR-NNN | Deprecated
## Date
2026-04-16
## Context
태스크 관리 애플리케이션의 primary DB가 필요하다. 주요 요구사항:
- 관계형 데이터 모델 (users, tasks, teams 관계)
- 태스크 상태 변경을 위한 ACID 트랜잭션
- 태스크 내용에 대한 full-text search
- 관리형 호스팅 (소규모 팀, 운영 역량 제한)
## Decision
PostgreSQL + Prisma ORM 사용.
## Alternatives Considered
### MongoDB
- **Pros:** 유연한 스키마, 시작 용이
- **Cons:** 우리 데이터는 본질적으로 관계형. 관계를 수동 관리해야 함
- **Rejected:** 문서 저장소의 관계형 데이터는 복잡한 join 또는 데이터 중복을 초래
### SQLite
- **Pros:** 설정 없음, 임베디드, 읽기 빠름
- **Cons:** 동시 쓰기 제한, 프로덕션 관리형 호스팅 없음
- **Rejected:** 멀티유저 웹 프로덕션에 부적합
### MySQL
- **Pros:** 성숙하고 널리 지원
- **Cons:** PostgreSQL이 JSON·full-text search·ecosystem 툴링에서 우위
- **Rejected:** 우리 기능 요구에 PostgreSQL이 더 적합
## Consequences
### Positive
- Prisma가 타입 안전 DB 접근 + migration 제공
- PostgreSQL의 full-text search로 Elasticsearch 추가 회피
- 관리형 서비스 (Supabase, Neon, RDS)에서 호스팅 가능
### Negative
- 팀이 PostgreSQL 지식 필요 (표준 스킬이라 리스크 낮음)
- Prisma 학습 곡선 (MongoDB 쓴 경험과 다름)
### Neutral
- 마이그레이션이 버전 관리됨 — 롤백 전략 필요
PROPOSED → ACCEPTED → (SUPERSEDED | DEPRECATED)
| Status | 의미 |
|---|---|
| Proposed | 검토 중, 아직 결정 안 됨 |
| Accepted | 결정됨, 구현됨 |
| Superseded | 새 ADR이 이 결정을 대체 — 본문에 Superseded by ADR-NNN 명시 |
| Deprecated | 더 이상 유효하지 않지만 대체가 없음 — 역사적 참조용 |
ADR-007이 ADR-001을 대체한다면:
Superseded by ADR-007로 업데이트"왜 이렇게 했지?"를 3년 뒤 누군가 물을 때, 원본 ADR의 Context가 답이다.
docs/decisions/ 또는 docs/adr/ (프로젝트 관습 따름)ADR-NNN-kebab-case-title.md (예: ADR-003-use-postgres.md)docs/decisions/README.md에 ADR 목록 유지 (선택)AI 에이전트가 코드베이스에서 작업할 때 ADR은 특히 가치가 크다:
docs/decisions/를 읽으라고 지시 가능| 변명 | 반박 |
|---|---|
| "코드가 스스로 문서화된다" | 코드는 무엇을 보여준다. 왜 그렇게 했는지, 어떤 대안을 버렸는지, 어떤 제약이 있었는지는 안 보여준다. |
| "API가 안정화되면 문서화할게요" | API는 문서화할 때 더 빨리 안정화된다. 문서는 설계의 첫 테스트다. |
| "아무도 문서 안 읽어요" | 에이전트는 읽는다. 미래 엔지니어도 읽는다. 3개월 뒤의 당신도 읽는다. |
| "ADR은 오버헤드예요" | 10분짜리 ADR이 6개월 뒤 같은 결정에 대한 2시간 논쟁을 예방한다. |
| "되돌리면 되잖아요" | 되돌릴 수 있으면 ADR이 필요 없다. 되돌리기 어렵기 때문에 기록한다. |
Proposed 상태로 방치된 ADRADR 작성 후:
ADR-NNN-kebab-title.md 형식| Topic | Skill |
|---|---|
| 개인 지식 노트 | obsidian-note |
| TIL (일일 학습) | til |
| 프로젝트 작업 로그 | devlog |
| 세션 맥락 전달 | session-handoff |
| 코드 리뷰 | code-review |