From 65a989fe0981519a65f4b93de90744ed24e07b1b Mon Sep 17 00:00:00 2001 From: Seongho Bae Date: Tue, 1 Sep 2026 20:11:27 +0900 Subject: [PATCH 1/3] docs: add DeepWiki badge --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index b398562..da4fd0f 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # Contextual Wisdom Lab Homepage +[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ContextualWisdomLab/ContextualWisdomLab.github.io) + Static homepage for [Contextual Wisdom Lab](https://github.com/ContextualWisdomLab). Local preview: From c7afa69a24a3925e9266fbc7f6816cae51587b69 Mon Sep 17 00:00:00 2001 From: Seongho Bae Date: Wed, 2 Sep 2026 06:08:47 +0900 Subject: [PATCH 2/3] docs: make organization homepage README visitor-first --- README.md | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 69 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index da4fd0f..579cb03 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,77 @@ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ContextualWisdomLab/ContextualWisdomLab.github.io) -Static homepage for [Contextual Wisdom Lab](https://github.com/ContextualWisdomLab). +**The public home for ContextualWisdomLab: research context, product direction, and a human-readable path into the organization’s work.** -Local preview: +This repository owns the static organization homepage. The site explains the Contextual Wisdom thesis—turning scattered documents, messages, logs, schedules, and other evidence into context that supports human judgment and action—and gives visitors a curated route into the lab’s research and projects. + +It is a presentation and navigation surface, not the runtime or system of record for the products it links to. Product capabilities, releases, security boundaries, licenses, and integration contracts remain authoritative in their owning repositories. + +## What visitors can explore + +The current site provides: + +- a Korean/English language switch; +- the Contextual Wisdom and DIKW framing used to explain the lab’s research direction; +- research/evidence and reference sections; +- a dedicated Naruon introduction; +- project and fork discovery sections; and +- direct navigation to the ContextualWisdomLab GitHub organization. + +The homepage deliberately separates a research thesis from product authority. A statement on this site should not be used to infer that a linked repository has shipped a release, passed certification, reached production readiness, or acquired customers unless the owning repository exposes that evidence itself. + +## Repository boundary + +| This repository owns | Owning product repositories retain | +| --- | --- | +| Organization-level public narrative and navigation | Runtime behavior and APIs | +| Homepage information architecture and visual presentation | Product PRDs, ADRs, schemas, databases, and domain authority | +| Korean/English homepage copy | Release and deployment evidence | +| Static homepage assets and accessibility behavior | Security, compliance, and operational claims | +| Links into current organization work | Product-specific license and integration obligations | + +When a product changes materially, update its owning repository first and then reconcile this homepage. Do not make the homepage the only place where a product claim exists. + +## Local preview + +The site is static and does not require a package manager or application server. From the repository root: ```bash python3 -m http.server 4173 ``` + +Then open `http://127.0.0.1:4173/`. + +Before changing public copy or navigation, verify both language states and the responsive layout. The current document includes a skip link, semantic navigation labels, keyboard-focus targets, explicit image dimensions, a restrictive Content Security Policy, and self-hosted assets; preserve those accessibility, security, and performance boundaries unless a reviewed change intentionally replaces them. + +## Editing the public surface + +The primary files are intentionally small and direct: + +- `index.html` — page structure, public copy, navigation, metadata, and asset references; +- `i18n.js` — Korean/English copy and language switching; +- `styles.css` — layout, typography, responsive behavior, and interaction styling; +- `assets/` — images, diagrams, and self-hosted presentation assets; +- `CHANGELOG.md` — repository-facing change history; +- `AGENTS.md` and `CLAUDE.md` — contributor and automation constraints. + +For a content change, keep the Korean and English surfaces semantically aligned rather than translating labels independently. For a project link or capability statement, verify the target repository’s current default branch, product documentation, and release evidence before publishing it here. + +## Quality and trust rules + +- Do not publish customer, certification, deployment, benchmark, adoption, revenue, or release claims without owning-repository evidence. +- Do not expose internal implementation boundaries as customer-facing product language. +- Treat externally sourced images, fonts, code, and other assets as inbound dependencies: commercial-use-compatible provenance is required before inclusion. +- Prefer organization-owned or properly licensed local assets; do not introduce noncommercial, research-only, evaluation-only, or commercially restrictive material. +- Preserve the site’s restrictive browser security posture rather than loosening CSP or external-resource policy for convenience. + +## Where to go next + +- [ContextualWisdomLab organization](https://github.com/ContextualWisdomLab) — browse source repositories and their current product documentation. +- [Ask DeepWiki](https://deepwiki.com/ContextualWisdomLab/ContextualWisdomLab.github.io) — explore this homepage repository structure. + +For product integration, installation, security, contribution, or release questions, follow the documentation in the repository that owns that product rather than treating this homepage as a substitute. + +## License + +ContextualWisdomLab original source and documentation in this repository are licensed under the [MIT License](LICENSE). Third-party assets or materials, when present, retain their own license and attribution requirements; the repository’s MIT grant does not relicense them. From 8002e7641d60238e38cfa70ef40c48f8f9e88709 Mon Sep 17 00:00:00 2001 From: Seongho Bae Date: Wed, 2 Sep 2026 09:29:16 +0900 Subject: [PATCH 3/3] docs: record visitor-first README refresh --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index e097a55..3e49f8c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,7 @@ # CHANGELOG ## [Unreleased] +- **문서 개선**: 조직 홈페이지 저장소 README를 방문자·유지보수자·통합자·잠재 구매자가 바로 이해할 수 있는 공개 진입점으로 확장하고, 저장소 책임 범위·로컬 미리보기·콘텐츠 권위·품질/신뢰 경계·MIT 라이선스 안내를 명확히 했습니다. - **보안 개선**: `i18n.js`에서 잘못된 언어 요청 시 `console.warn` 메시지에 사용자 입력값이 직접 포함되지 않도록 수정하여 로그 인젝션(Log Injection) 취약점을 제거했습니다. - **성능 개선**: `.skip-link` 애니메이션을 `top`에서 `transform: translateY()`로 변경하여 전환 중 레이아웃 재계산을 줄일 수 있도록 했습니다. 실제 효과는 브라우저별 측정 대상입니다. - **렌더링 힌트 정합성**: 첫 화면의 eager 이미지와 단일 LCP 후보에서 강제 `decoding="async"`를 제거해 HTML 표준의 기본 `auto` 판단에 맡기고, 지연 로드 이미지에는 비동기 디코딩 힌트를 유지했습니다. 정적 테스트가 eager, lazy, LCP 후보 집합의 존재와 조합을 검증하며, 실제 LCP 효과는 배포 후 실측 대상으로 유지합니다.