SkillLens

원본: projects/skill-lens/README.md

상태: 진행 중
목표: 2026-11-11 베타 시연 가능한 실제 동작 제품

SkillLens는 조직의 Skill-Based Organization 전환을 돕는 B2B 제품이다. 조직의 목표 스킬과 구성원의 현재 스킬을 진단하고, 스킬 격차·공백을 파악해 육성·채용·내부 이동의 의사결정을 지원한다.

이 프로젝트에서 중요한 기준

기능 범위는 심플과 일반에서 확인해 빠짐없이 넣는다(DEC-084). 화면, 메뉴 구조, 배치, CSS, 마크업은 심플에서 가져오지 않고 8판과 디자인 시스템으로 새로 만든다. API, 데이터, 산식은 화면 명세, 데이터 계약, 권한, 상태 전이와 맞는지 확인한 뒤 채택하고, 맞지 않으면 고치거나 새로 만든다. 제로에서 정한 정책이 심플 동작보다 우선한다(DEC-249).
Zero는 디자인·UX 기준선이다.
main(Simple)은 기존 서비스 동작과 API 연결을 확인하는 참고선이다.
General은 오래된 기능·업무 규칙의 참고 자료다. 존재만으로 재사용 대상으로 확정하지 않는다.
Zero의 데모 데이터와 시뮬레이션을 실제 제품 기능으로 오인하지 않는다.
화면 개선과 SRS 산식, 권한, 테넌트 격리, 개인정보 정책을 분리해 보호한다.
운영 Worker/D1 변경과 고객 메일 발송은 별도 명시 승인 전 금지한다.

예전 정본 문서(대조 전)

가장 먼저 알 것(PM 2026-11-09)

기능의 95% 이상은 심플(main)과 일반(옛 버전)에 이미 있다. 기능이 없다고 말하기 전에 심플과 일반 코드부터 찾는다.
화면은 심플과 일반에서 가져오지 않는다. 8판과 디자인 시스템으로 새로 만든다(W-0 0절 1).

출처 순서(만들거나 "없다"고 말하기 전에 찾는 곳)

무엇	찾는 순서
화면, 디자인, 로고, 움직임	8판 시안 → 디자인 시스템 → 심플 → 일반
기능, 데이터, API, 산식	심플(`main`) → 일반 → 이 저장소 기준 문서
규칙, 결정, 용어	결정 → 이 저장소 기준 문서 → 지난 결정

기준 문서(입구)

원본은 이 저장소다(AI 협업 규칙 W-0 11절). 보기용 문서 사이트: https://skilllens.ideber.com (이 폴더 전체와 8판 시안, 저장소에 올리면 자동으로 바뀜, 공개이지만 검색 제외). AI 검토용 읽기 주소: https://ai.skilllens.ideber.com/llms.txt 또는 https://ai.skilllens.ideber.com/all.md. 상태: 제안 = PM 승인 전, 확정 = PM 승인.

문서	상태
결정: 결정은 이 파일 하나. 지난 대시보드 결정 232개는 decisions-imported.md(얼림)	확정(PM이 정한 것만 적음)
핵심 가치 V-0	제안(3판)
용어 사전	제안(4판)
스킬 편집, 반영, 결과 규칙	제안(5판)
서버(Worker) 개편 계획: 기존 코드를 복사해서 기능별로 나누기	제안(5판)
SRS 산식과 정답 표(`product/04-srs-formula.md`)	만들 것
흐름(여정): 한 회차, 역할별 여정, 흐름 지도 21단계, 온보딩 분기	제안(지난 대시보드에서 옮겨 고침)
기능 범위: 할 것과 안 할 것, 심플 기능 170개	제안(옮겨 고침)
화면 목록(화면 등록표): 화면 카드 72개, 그중 1회차에 만드는 화면 54개, 화면마다 누가, 폭, 폰, 버튼, 문구	제안(옮겨 고침). 8판 디자인으로 다시 그릴 때 기준
메뉴(IA)와 상태표	제안(옮겨 고침)
심플 벤치마킹: 지난 버전에서 가져옴, 고침, 뺌	제안(옮겨 고침)
지금 서버로 만들 수 있는 화면: 화면별 API, 데이터 흐름	제안(옮겨 고침, 공개 사이트에는 없음)
정책(역할과 권한, 개인정보)	만들 것
API 지도(서버 개편 때 만드는 기능 지도)	만들 것
디자인 시스템: 8판 시안 기준, 8판 대응표. 보기: https://skilllens.ideber.com/design/	제안(PM 확인 전)

용어 검사: node projects/skill-lens/scripts/check-terms.mjs. 금지어는 용어 사전에서 읽는다. 이 저장소 .claude/settings.json 훅이 파일 저장 뒤와 커밋 전에 돌린다.

"만들 것"은 지난 제로 대시보드(skill-lens 저장소 zero-dashboard/backup.json)의 결과물(기획안, 규칙, 결정 결론, 열린 정할 것)로 채운다. 결정 근거, 대화, 변경 기록 같은 로그는 가져오지 않고, 어긋난 곳이 있을 때만 찾아본다. 없는 내용은 지어내지 않고 "정할 것"으로 남긴다.

진행 순서(PM 2026-11-09)

정리: 위 "만들 것"을 지난 대시보드 결과물로 채우고, 오늘까지 정한 문서와 어긋나는 곳만 PM에게 묻는다.
디자인 시스템: 지금 아티팩트 내용을 그대로 design/으로 옮김 → 디자인 하위 에이전트 세팅 → 그 에이전트가 8판 시안 기준으로 고침(움직임은 8판 기준, 연두색 체크 표시 삭제, 8판 화면 요소 채택) → 보기용 페이지를 발행해 PM 확인. 이후 디자인 시스템 아티팩트는 원본이 아니다.
2026-11-09 진행: 0.15.1을 그대로 design/으로 옮기고(첫 커밋), 8판 CSS를 부품별로 옮긴 0.16.0을 다음 커밋으로 넣고 아티팩트에도 발행했다. 하위 에이전트 세팅은 아직 안 함.
2026-11-09: 보기용을 아티팩트에서 문서 사이트(https://skilllens.ideber.com)로 바꿨다. 디자인 시스템 아티팩트는 더 이상 쓰지 않는다(지우지는 않음). 사이트 생성: node projects/skill-lens/scripts/build-site.mjs.
세팅: 대시보드(보기 창)와 승인 게이트를 이 저장소 원본 기준으로 바꾼다. 새로 만드는 도구(파일 쓰기, 문서 사이트 반영)를 쓰기 전에 "출처를 찾았나"를 묻는 자동 확인(훅)을 더한다(AI 협업 규칙 W-0 9절 0단계를 사람이 기억하지 않아도 지켜지게). skill-lens 저장소 CLAUDE.md의 "규칙은 대시보드에만"도 이때 고친다.
구현: 서버 개편과 화면.

대조가 남은 문서

아래 예전 문서는 위 기준 문서와 어긋나는지 아직 대조하지 않았다. 다르면 위 기준 문서가 우선이다.

이 README의 "이 프로젝트에서 중요한 기준", "정본 문서", "버전 계보", "현재 작업 방식"
프로젝트 브리프, 초기 저장소 실사, 베타 실행 계획, 자산 감사(Rebuild 4, GPT 2026-11-08, PR #1에서 옮김)

작업 방식은 AI 협업 규칙 W-0를 따른다. 기준 문서가 늘면 위 표에 먼저 올린다.

버전 계보

이름	의미	활용
General	최초 일반 버전, 저장된 구버전	과거 기능·업무 규칙의 참고
Simple	현재 `main` 브랜치	기존 서비스 동작·API·업무 로직의 참고
Zero	별도 `zero` 브랜치	디자인·UX·IA 기준선
Rebuild 4	네 번째 리빌딩	Zero의 디자인 품질을 기반으로 실제 기능을 선별 연결하고, 코드·맥락·AI 협업 구조를 단순화

이 계보는 프로젝트 작업의 기준이다. 특정 브랜치의 기능이 모두 정상 동작하거나 완성됐다는 뜻은 아니다.

현재 작업 방식

순서와 화면 통과 기준은 구조 확정안 7절을 따른다.

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