콘텐츠로 이동
🗓️ 기록기존 내용은 절대 지우지 말고, 새 항목만 날짜와 함께 추가하세요(포맷: templates/log).작성 Claude · 2026-06-03 · v12 재편·raw 컴파일·인간화

ADR-0018 — D-EDU 사내위키 마스터 스펙(v12) 채택

Context

  • 현 위키는 Karpathy LLM-wiki 패턴으로 출발해 ADR-0002 → ADR-0011~ADR-0015를 거치며 teams/(직군) · features/(기능) · decisions/ 축, stub/draft/active/superseded 상태, raw/ → 선별·합성 → wiki/ 인테이크 모델로 운영돼 왔다.
  • 별도로 작성된 D-EDU 사내위키 마스터 스펙 v12가 위키의 원칙·카테고리·이용 가이드·시나리오·하네스를 단일 기준 문서로 재정의한다. 현 구조와 축·상태·완료추적·Notion 관계가 전부 다르다:
  • 1단 축 = 왜 / 무엇 / 어떻게 / 찾기 / 입구 (0.메타 ~ 5.직무별 탭)
  • 상태 = protected / living / append-only / derived (4상태)
  • 완료 추적의 진실 = GitHub Issue (위키에 완료여부 직접 기록 X)
  • Wiki = 확정·히스토리 / Notion = 작업·live — 확정본만 Notion→Wiki 이관
  • 모든 노드는 최소 1개 시나리오(S1~S15)로 정당화, frontmatter에 policy/scenarios 추가
  • 위키가 사람 가이드일 뿐 아니라 에이전트 페르소나 컨텍스트(직무 탭 = 그 역할처럼 사고)라는 점을 1급 목표로 명시.

Decision

D-EDU 마스터 스펙 v12를 위키 운영의 단일 기준으로 채택한다.

  1. 스펙 원본을 wiki-spec(wiki/meta/wiki-spec.md, policy: protected)로 편입 — 위키 자기관리 축(0.메타)의 보호 노드.
  2. 이 ADR이 채택 결정·배경·후속 과제를 기록한다(추적의 진실은 본 ADR + 후속 마이그레이션 이슈).
  3. 구조 전환(5축·4상태·신 frontmatter)은 점진 마이그레이션으로 진행 — 본 채택 시점엔 스펙 편입만 완료하고 기존 페이지/툴링은 옛 규칙을 유지한다(빅뱅 재편 금지).

Consequences

긍정 - 위키 전체가 한 기준 문서로 수렴 — 축·상태·라우팅·frontmatter·에이전트 페르소나가 명문화됨. - "건들 곳/말 곳"이 4상태로 일관 정의 → 사람·에이전트 모두 편집 안전성 향상. - 직무 탭이 에이전트 페르소나 컨텍스트로 1급화 → 역할별 에이전트 동작 근거 확보.

부정 / 후속 과제 (TODO) 1. CLAUDE.md §4~14 ↔ v12 충돌 — 루트 CLAUDE.md의 위키 스키마(축·상태·frontmatter·templates)가 여전히 옛 규칙. v12로 개정하거나, v12를 위임 참조하도록 §4~14를 재작성해야 함. (별도 작업·오너 검토 필요) 2. /wiki-lint·frontmatter 검증 — 옛 enum(type: domain|concept|..., status: stub|...)을 v12(type: persona|feature|frd|..., policy: ...)로 갱신 필요. 현재 wiki/meta/wiki-spec.md는 lint에 일시 부정합. 3. 디렉토리 마이그레이션 — teams/·features/ → 0~5 축으로 이동/재배치. 점진 진행, 매핑표 필요. 4. raw/ → wiki vs Notion 작업 → Wiki 확정 이관 인테이크 모델 정합 — ADR-0013·ADR-0015(Slack/Stage2 라우팅)과 v12 §6 라우팅 표 조정. 5. 공개/비공개(visibility) 범위 미정 — 메인 '/' 리크루팅 공개 + private 경계는 추후 결정(wiki-access-todo 연계).

관련 기존 ADR (재정의 대상 — status 전환은 마이그레이션 시 개별 판단) - ADR-0011 wiki 중간 레이어 역할 / ADR-0012 운영 기본 모델 / ADR-0013 협업 진입점 / ADR-0014 자동화 인프라 / ADR-0015 Stage2 라우팅 — v12가 상위 기준이 되며, 충돌 항목은 후속 마이그레이션에서 정리.

Alternatives

  • A. 별도 보관(raw/ 또는 ADR 흡수) — 스펙을 참고 자료로만 두고 위키 규칙은 현행 유지. 채택 신호가 약해 기각.
  • B. 즉시 전면 재편 — 디렉토리·CLAUDE.md·lint를 한 번에 v12로 전환. 리스크·작업량 과다로 기각, 점진 채택 선택.

Status

accepted (스펙 편입 완료 / 구조 마이그레이션은 후속 이슈)

Date

2026-06-03