diff --git a/.github/assets/collection-lockup.svg b/.github/assets/collection-lockup.svg
new file mode 100644
index 0000000..c71a3a0
--- /dev/null
+++ b/.github/assets/collection-lockup.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/.github/assets/collection-mark.svg b/.github/assets/collection-mark.svg
new file mode 100644
index 0000000..770ff15
--- /dev/null
+++ b/.github/assets/collection-mark.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/.github/assets/readme-header.png b/.github/assets/readme-header.png
new file mode 100644
index 0000000..aaacb64
Binary files /dev/null and b/.github/assets/readme-header.png differ
diff --git a/.github/assets/social-preview.png b/.github/assets/social-preview.png
new file mode 100644
index 0000000..e266df8
Binary files /dev/null and b/.github/assets/social-preview.png differ
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d2636a1..52d839e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -9,6 +9,21 @@ permissions:
contents: read
jobs:
+ brand:
+ name: Verify O12 brand assets
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v7
+ with:
+ fetch-depth: 0
+
+ - uses: actions/setup-node@v4
+ with:
+ node-version: '22'
+
+ - name: Verify O12 collection brand contract
+ run: node scripts/check-brand-assets.mjs
+
detect:
name: Detect demos to build
runs-on: ubuntu-latest
diff --git a/README.ko.md b/README.ko.md
index 0ba57a8..33f05c0 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -1,5 +1,11 @@
# devslab-examples
+
+ 
+
+
+**[DevsLab](https://devslab.kr/) 오픈소스** · [OSS 브랜드 가이드](https://devslab.kr/brand/open-source/) · 컬렉션 O12
+
[English](README.md) · **한국어**
[devslab-kr](https://github.com/devslab-kr) Spring Boot 스타터와 라이브러리들의 실행 가능한 예제 모음.
diff --git a/README.md b/README.md
index e68b120..0cda474 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,11 @@
# devslab-examples
+
+
+
+
+**Open source by [DevsLab](https://devslab.kr/)** · [OSS brand guide](https://devslab.kr/brand/open-source/) · Collection O12
+
**English** · [한국어](README.ko.md)
Runnable examples for [devslab-kr](https://github.com/devslab-kr) Spring Boot starters and libraries.
diff --git a/scripts/check-brand-assets.mjs b/scripts/check-brand-assets.mjs
new file mode 100644
index 0000000..fd37a68
--- /dev/null
+++ b/scripts/check-brand-assets.mjs
@@ -0,0 +1,72 @@
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const root = resolve(import.meta.dirname, '..');
+const expectedHashes = new Map([
+ ['.github/assets/readme-header.png', '47a942ffe3633979b805495dc3f27eef10d243ff278c72f1061152eac8a7f078'],
+ ['.github/assets/social-preview.png', 'e9bc6856c557ee4ede2db139b6b40cd754d1e90ebf63b25dc6f02f546cfbd151'],
+ ['.github/assets/collection-mark.svg', 'f2370535bb544213ecc0648d82298cd83767388a1c0ac991b907e4a778a03287'],
+ ['.github/assets/collection-lockup.svg', 'eaac691c43dd97c4033b966e27272a02d1dc06a5c0b01b95ec8483f6c2ff8bad'],
+]);
+
+const read = (file) => readFileSync(resolve(root, file), 'utf8');
+const assert = (condition, message) => {
+ if (!condition) throw new Error(message);
+};
+const changedFiles = () => execFileSync('git', ['diff', '--name-only', 'origin/main'], { cwd: root, encoding: 'utf8' })
+ .trim()
+ .split(/\r?\n/)
+ .filter(Boolean);
+
+for (const [file, expected] of expectedHashes) {
+ const absolute = resolve(root, file);
+ assert(existsSync(absolute), `missing required O12 collection asset: ${file}`);
+ const actual = createHash('sha256').update(readFileSync(absolute)).digest('hex');
+ assert(actual === expected, `${file} has ${actual}; expected oss-brand v0.1.1 hash ${expected}`);
+}
+
+const mark = read('.github/assets/collection-mark.svg');
+const lockup = read('.github/assets/collection-lockup.svg');
+assert(mark.includes('data-oss-project="O12"'), 'collection mark must identify the O12 asset');
+assert(mark.includes('M10 6H6V26H10') && mark.includes('M14 11L21 16L14 21Z'), 'collection mark must retain O12 bracket-and-play geometry');
+assert(lockup.includes('data-oss-lockup="O12"') && lockup.includes('Open source by DevsLab'), 'collection lockup must provide the O12 endorsement');
+
+for (const [file, endorsement] of [
+ ['README.md', 'Open source by [DevsLab](https://devslab.kr/)'],
+ ['README.ko.md', '[DevsLab](https://devslab.kr/) 오픈소스'],
+]) {
+ const content = read(file);
+ assert(content.includes('.github/assets/readme-header.png'), `${file} must use the local O12 README header`);
+ assert(content.includes('https://devslab.kr/brand/open-source/'), `${file} must link to the canonical OSS brand guide`);
+ assert(content.includes(endorsement), `${file} must include its localized collection endorsement`);
+}
+
+const rootOnly = new Set([
+ '.github/workflows/ci.yml',
+ '.github/assets/readme-header.png',
+ '.github/assets/social-preview.png',
+ '.github/assets/collection-mark.svg',
+ '.github/assets/collection-lockup.svg',
+ 'README.md',
+ 'README.ko.md',
+ 'scripts/check-brand-assets.mjs',
+]);
+for (const file of changedFiles()) {
+ assert(rootOnly.has(file), `O12 is collection-level only; unexpected changed path: ${file}`);
+}
+
+const ci = read('.github/workflows/ci.yml');
+const brandStart = ci.indexOf(' brand:\n');
+assert(brandStart >= 0, 'CI must include a dedicated O12 brand job');
+const nextJobPattern = /\n [A-Za-z][A-Za-z0-9_-]*:\n/g;
+nextJobPattern.lastIndex = brandStart + ' brand:\n'.length;
+const nextJob = nextJobPattern.exec(ci);
+const brandJob = ci.slice(brandStart, nextJob?.index ?? ci.length);
+assert(brandJob.includes("node-version: '22'"), 'dedicated O12 brand job must use Node 22');
+assert(brandJob.includes('fetch-depth: 0'), 'dedicated O12 brand job must fetch origin/main for collection-only diff validation');
+assert(brandJob.includes('run: node scripts/check-brand-assets.mjs'), 'dedicated O12 brand job must run the collection checker');
+assert(!brandJob.includes('needs:'), 'dedicated O12 brand job must not depend on the demo matrix');
+
+console.log(`O12 collection brand contract passed (${expectedHashes.size} exact assets, no per-demo changes).`);