결정

원본: projects/skill-lens/product/decisions.md

---
title: SkillLens 결정
status: active
owner: PM
updated: 2026-11-09
source_of_truth: true
---

SkillLens 결정

SkillLens의 결정은 이 파일 하나에 적는다(AI 협업 규칙 W-0 11절). PM이 대화에서 정한 것은 그날 안에 날짜와 함께 맨 위에 더한다. 다른 문서는 결정 번호로 링크한다.
지난 제로 대시보드의 결정 232개(DEC-001~232)는 decisions-imported.md에 얼려 두었다. 지난 결정을 바꾸면 여기에 새 결정으로 적고 "바꿈: DEC-000"을 붙인다.

2026-11-09

• DEC-233 원본은 GitHub(ideber 저장소) 하나다. 아티팩트는 쓰지 않는다. 보기용은 자동으로 만들어지는 문서 사이트(https://skilllens.ideber.com, 공개, 검색 제외, AI는 /llms.txt 와 /all.md). 바꿈: DEC-001(대시보드 아티팩트가 정본), DEC-212의 "시안은 아티팩트로".
• DEC-234 공용 작업 브랜치는 dev이고 GPT와 Claude가 함께 쓴다. main은 PM이 승인한 안정판이다(W-0 13절).
• DEC-235 레벨 용어는 요구레벨 하나다(관리자 화면, 실무자 화면 모두). "목표 레벨"은 쓰지 않는다. 조직의 목표는 레벨이 아니라 목표 SRS(점수)다.
• DEC-236 렌지 레벨 추천은 맞닿은 두 레벨 범위로 보인다(예: Lv 3~4, 끝이면 Lv 1~2나 Lv 4~5). 레벨마다 맞는 조건을 한 문장씩 붙이고, 최종 선택은 실무자가 한다. 하나는 결정처럼 읽히고 셋 이상은 도움이 안 된다. 바꿈: DEC-084, DEC-160의 "가까운 레벨 하나".
• DEC-237 레벨 표기는 "Lv 3"(점 없음, 띄어 씀). 레벨 한글 이름은 화면, 가이드, 문서 어디에도 쓰지 않는다. 바꿈: DEC-201 ⑤.
• DEC-238 인원 이름은 최대인원(뜻: 계약 인원, 운영자가 정하고 관리자는 보기만). DEC-094, DEC-180 그대로이며 용어 사전을 이에 맞췄다.
• DEC-239 실무자가 고친 표준 스킬(사본)도 커스텀스킬처럼 하나씩 반영 대상이다(점수 부풀리기 막음). 바꿈: DEC-017의 "커스텀스킬에만", DEC-100.
• DEC-240 반영한 커스텀스킬은 그 사람 결과와 조직 결과에만 들어가고, 이번 회차 다른 사람에게는 묻지 않는다(다음 스킬셋 후보). 미반영은 개인 결과에 "미반영(개인 결과에만)"으로 남는다. DEC-118, DEC-019, DEC-143 그대로이며 기준 문서를 이에 맞췄다.
• DEC-241 목표점수 기본값은 75로 두고 "고객사 평균"이라는 말은 쓰지 않는다(실제 고객 없음). 8판 칩 글은 구현 때 고친다. 바꿈: DEC-053, DEC-196, R-010 ③의 예외.
• DEC-242 결과확정은 반영 대기(정하지 않은 반영)가 남아 있으면 막는다. 자동 미반영은 없다(03 도메인 규칙 6절).
• DEC-243 정할 것 Q-058, Q-061, Q-064, Q-067, Q-071은 PM이 정했다(03 도메인 규칙 9절).
• DEC-244 디자인 시스템과 시안 예시의 "웅진스킬원"은 우리 팀 브랜드라 공개 사이트에 그대로 둔다.
• DEC-245 문서 사이트 주소는 https://skilllens.ideber.com (ideber.com 도메인, IDEBER 안의 SkillLens 프로젝트). 예전 주소 skilllens-docs.pages.dev도 그대로 열린다. IDEBER는 플랫폼(제품)이고 SkillLens는 IDEBER로 만드는 첫 프로젝트다. 둘을 같이 만든다.
• DEC-246 운영자 화면(조직 열기, 목록, 상세, 파기)도 8판 완성도로 새로 만든다. 심플 화면은 시연에도 쓰지 않는다(심플은 실패한 화면이다).
• DEC-247 제로 조직 규칙을 위한 서버 고침(구조 확정안 6절)은 운영 DB 복사본에 붙인 시험용 서버에서 확인한 뒤 운영 서버에 올린다. 제로 앱 주소는 app.skilllens.kr.
• DEC-248 문서에는 결정된 결과만 쓴다. 비교, 이력, 바뀌기 전 이름, 검토 중 메모 같은 과정은 쓰지 않는다. 과정이 필요하면 지난 기록(decisions-imported, sources)을 찾아본다.
• DEC-249 기능 범위는 심플과 일반에서 확인해 빠짐없이 넣는다(DEC-084). 화면, 메뉴 구조, 배치, CSS, 마크업은 심플에서 가져오지 않고 8판과 디자인 시스템으로 새로 만든다. API, 데이터, 산식은 화면 명세, 데이터 계약, 권한, 상태 전이와 맞는지 확인한 뒤 채택하고, 맞지 않으면 고치거나 새로 만든다. 제로에서 정한 정책이 심플 동작보다 우선한다. 입구 화면(가입, 로그인, 비밀번호 찾기, 재설정)도 8판으로 새로 만든다. 메일은 문구와 정보를 지난 버전에서 확인하고 꾸밈은 디자인 시스템을 따른다. 바꿈: DEC-172(입구는 지난 버전 화면 그대로). 근거: W-0 0절 1(PM 2026-11-09).
• DEC-250 main 반영은 PM, Claude, GPT 세 주체의 합의가 확인된 것만 한다. PR에 PM 승인, Claude 검토 의견, GPT 검토 의견(PM이 전달한 글)을 남기고, 검토 뒤 주요 내용이 바뀌면 다시 검토한다. 합의되지 않은 것은 dev에 둔다.
• DEC-251 디자인 시스템 0.18.0(외부 검토 반영, PM 위임 2026-11-09): 히트맵 칸 호버와 포커스(행과 열 표시, 근거와 다음 행동), 검토 서랍 사람 이동과 처리 항목 접기와 단축키, 레벨 고르기 렌지 추천 범위 점과 숫자키, 점수 막대 목표선, 버튼 화살표 아이콘과 비활성 표시, 큰 카드와 파일 칸 호버. 긴 이름은 두 줄까지 줄바꿈하고 넘으면 줄이며 전체는 호버와 포커스로 보인다. 둥글기와 간격은 8판 값 그대로 둔다. 숫자 전용 글꼴, 렌지 자동 적용 버튼, 계속 도는 움직임은 넣지 않는다.
• DEC-252 된다, 안 된다는 PM이 판단한다. AI는 시연, 일정, 작업량의 가능성을 따지거나 날짜를 옮기자고 하지 않고 정한 때까지 만든다. 답 검사 장치(docs/hooks/redlines.mjs)가 이런 말을 막는다(PM 2026-11-09).
• DEC-253 1회차 서버 규칙(PM 위임, Claude 판단 2026-11-09). 진단 목적은 2~40자(초대·결과 메일 제목과 마침 화면 제목으로 쓰는 한 줄). 만료된 관리자 가입 링크는 "운영 담당자에게 연락"과 운영 연락처를 보이고, 운영자가 슈퍼어드민에서 다시 초대한다(옛 링크는 막힘). 결과확정은 검토완료 0명이어도 할 수 있고, 이때는 "결과 없이 회차를 닫습니다" 확인을 한 번 더 받는다(반영 대기가 있으면 DEC-242대로 막음). 초대 뒤에는 회사 이름과 함께 업종, 직무, 진단스킬, 편집 범위도 잠근다(결과의 기준이 바뀌지 않게). '미달 몰린 스킬'은 대상자 절반 이상이 미달인 스킬. 미달자 이름 보기는 미달 인원 5명 이상일 때만. 목표달성률은 지금 SRS ÷ 목표 SRS(DEC-053), 목표를 넘은 사람 비율은 보조 값.

이 사이트는 ideber 저장소 projects/skill-lens/ 에서 자동으로 만들어집니다. 고칠 때는 저장소를 고칩니다. 공개 주소이지만 검색엔진에는 나오지 않습니다.