From eb58356ac420332277702c1b843953f8619bbd5c Mon Sep 17 00:00:00 2001
From: Sparsh Sam <110058692+sparshsam@users.noreply.github.com>
Date: Fri, 3 Jul 2026 16:17:33 -0400
Subject: [PATCH] docs: update CLAUDE.md and AGENTS.md for icon generation
 session

---
 AGENTS.md | 17 +++++++++++++++++
 CLAUDE.md | 21 +++++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index aa6e914..7b4c622 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -35,6 +35,23 @@ vercel --prod --scope sparsh-sams-projects
 
 Vercel project is linked — just run from repo root. Auto-deploys on push to `main`.
 
+## 2026-07-03 — Icon Generation & Branding Session
+
+### Icon Assets
+- 115 assets generated from `wordwise_light_mode.png` via Lanczos resampling
+- Formats: Windows ICO, MSIX (11 types × 5 scales), Android mipmap, iOS `.iconset`, macOS `.icns`, Web favicons, PWA manifest icons, OG image, GitHub avatars
+- Master source: `assets/branding/wordwise_light_mode.png`
+- Generated output in: `assets/branding/` (favicons + iconset), `assets/msix/`, `assets/android/`, `assets/ios/`, `public/` (favicon.ico)
+
+### Branding Updates
+- README header: app icon via `<img>` at 72px, centered, from `assets/branding/icon.png`
+- Footer: Kovina wordmark logo (bottom-left, linked to https://kovina.org)
+
+### Favicon Fix
+- Removed `favicon.svg` — no longer supported by modern browsers reliably
+- Generated: `favicon.ico` (multi-size), `favicon-16x16.png`, `favicon-32x32.png`, `apple-touch-icon.png`
+- Updated `views/index.html` and `views/archive.html`: link tags for PNG favicons, OG meta tags with regenerated 1200×630 image
+
 ## Domains & DNS
 
 - **App**: wordwise.kovina.org
diff --git a/CLAUDE.md b/CLAUDE.md
index 7ca8fbf..4ada62e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -54,6 +54,27 @@ Response: `{ word, phonetic, definition, example, partOfSpeech, audioUrl, backgr
 
 `main` requires 1 approving review, dismisses stale reviews, enforces for admins. No force pushes or deletions.
 
+## 2026-07-03 — Icon Generation & Branding Session
+
+### Icon Assets (115 total from `wordwise_light_mode.png`)
+- **Windows**: Multi-size ICO (16×16–256×256)
+- **MSIX Store**: 11 asset types × 5 scales (50px–800px)
+- **Android**: mipmap-hdpi through xxxhdpi + adaptive icons
+- **iOS**: App icon set (20pt–1024pt)
+- **macOS**: `.iconset` (16×16–512×512@2x)
+- **Web**: favicon.ico + favicon-16×16 + favicon-32×32 + apple-touch-icon
+- **PWA**: 192×192 + 512×512 manifest icons
+- **Social**: OG image (1200×630) + GitHub avatars + header icon
+
+### Branding
+- README header: app icon (72px centered) from `assets/branding/icon.png`
+- Kovina wordmark logo added to footer (bottom-left, hyperlinked to kovina.org)
+
+### Favicon Migration (SVG -> PNG)
+- Removed `favicon.svg`, replaced with real PNG favicons generated from master source
+- Enforced PNG favicon references in `views/index.html` and `views/archive.html`
+- OG image regenerated at 1200×630
+
 ## Environment variables
 
 | Variable | Source | Purpose |