# Icon Renaming Mapping ## Purpose This document maps hashed SVG filenames to their semantic names based on visual content analysis. ## Naming Convention Format: `{Category}-{Description}.svg` Categories: - **Hands**: Hand gestures, positions - **People**: Human figures - **Objects**: Physical items, shapes - **Abstract**: Abstract forms, patterns - **Letters**: Text characters - **Scenes**: Complex illustrations with multiple elements ## Analysis Status ### ✅ Already Semantically Named (3 files) - `67ed7bd686b6d20bb1cd568c_Hands-Build.svg` - Building hand gesture - `67ed7bd72914c76f710d86fc_Hands-Stack.svg` - Stacking hand gesture - `67ed7b8d86b6d20bb1cd1292_Objects-Puzzle.svg` - Puzzle pieces ### 🔍 Analyzed Files (47 files) | Old Filename | Visual Description | Proposed Name | Category | | -------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------- | -------- | | `07c019d3b2596ff9d1a70c4af1efd00b0a775510-1000x1000.svg` | Hand gestures/figure artwork | `Hands-Gesture-01.svg` | Hands | | `036c01a9e427ea0f4d1e6c7221e4f6dce2259bf7-1000x1000.svg` | Hand/figure illustrations | `Hands-Figure-01.svg` | Hands | | `0d259ed89e181ad18dea036804f50080ea61e77a-1680x1260.svg` | Hand gestures with orange background (wide format 1680x1260) | `Hands-Gesture-Background-01.svg` | Hands | | `0df729ce74e4c9dd62c3342c9549ce6c7cef1202-1000x1000.svg` | Multiple people/hands | `People-Multiple-01.svg` | People | | `1576ae23eaf481f33bd36ab468171cc69d12361a-1000x1000.svg` | Hand gestures | `Hands-Gesture-02.svg` | Hands | | `1c3d1af62032009538b8bf5864139ca124b06741-1000x1000.svg` | Document/tablet with hands | `Hands-Document.svg` | Hands | | `1c3e87fd90491089b2971dc34f9f75bb8a80f713-1000x1000.svg` | Circular/gear pattern with hands | `Hands-Circular.svg` | Hands | | `2174acb37a84767550abfe2588eb5648f941a897-1000x1000.svg` | Complex scene with people/hands/shapes | `Scene-Complex-01.svg` | Scenes | | `33dbe8f783d4835a838b4c4ae85d3c04e352fee1-1000x1000.svg` | Letter forms with human figure | `Letter-W-Figure.svg` | Letters | | `33ddc751e21fb4b116b3f57dd553f0bc55ea09d1-1000x1000.svg` | Document/page layout | `Objects-Document-02.svg` | Objects | | `39c40393e610cc0a5e65f50ad12ff5ada273f792-1000x1000.svg` | Hands with mountainous/abstract terrain | `Hands-Terrain.svg` | Hands | | `39db33950eb113e504a5b9fc56db490a64673e96-1000x1000.svg` | Complex mountainous terrain scene | `Scene-Terrain.svg` | Scenes | | `423062049d4676b41d52b16068cbb5e21603190e-1000x1000.svg` | Hands and figures complex scene | `Scene-Complex-02.svg` | Scenes | | `46e4aa7ea208ed440d5bd9e9e3a0ee66bc336ff1-1000x1000.svg` | Organic abstract shapes | `Abstract-Organic.svg` | Abstract | | `4d663bd87c391c144b9bca513b3849ccfa00a3b9-1000x1000.svg` | Complex scene with hands and shapes | `Scene-Organic-01.svg` | Scenes | | `5f455d24ea80569b34eb4347f06152d8a5508722-1000x1000.svg` | Letter character (P or B shape) | `Letter-P-01.svg` | Letters | | `6457c34fbcb012acf0f27f15a6006f700d0f50de-1000x1000.svg` | Various hand positions/interactions | `Hands-Interaction.svg` | Hands | | `6507d83d1197bb8630131d363fb8bea838d79ca7-1000x1000.svg` | Letter M or W shape with human figure elements | `Letter-M-02.svg` | Letters | | `653e7474811cf768b6b0f628e253f98c60e2747e-1000x1000.svg` | Complex scene with hands and abstract elements | `Scene-Complex-03.svg` | Scenes | | `6905c83d0735e1bc430025fdd1748d1406079036-1000x1000.svg` | People and hands in motion | `People-Motion-01.svg` | People | | `6b1470e7fa2fb7280502291f204b88c412690076-1000x1000.svg` | Letter forms (M or H shape) | `Letter-M-01.svg` | Letters | | `6e00dbffcddc82df5e471c43453abfc74ca94e8d-1000x1000.svg` | Detailed hands scene | `Scene-Detailed-01.svg` | Scenes | | `74409af25137110ac04cc39e4d5ea0a2fbcea421-1000x1000.svg` | Complex hand gestures | `Hands-Complex-01.svg` | Hands | | `77dd9077412abc790bf2bc6fa3383b37724d6305-1000x1000.svg` | Abstract letter or shape | `Abstract-Letter-01.svg` | Abstract | | `811dcfbdaac4ea3628e0a2a5a547b0a175d63bcf-1000x1000.svg` | Hand gestures | `Hands-Gesture-04.svg` | Hands | | `84dfc3a6a5b8bf79a0cd430524c1f5a89e376531-1681x1261.svg` | Wide format scene (1681x1261) with background | `Scene-Wide-01.svg` | Scenes | | `8925ac952fa2cb8eb5e845b2e44f3e71b33fd695-1000x1000.svg` | Hands with abstract elements | `Hands-Abstract-01.svg` | Hands | | `8d339ae8ecedecc1409db8f5bbb99c958db56946-1000x1000.svg` | Letter or abstract shape | `Letter-Abstract-01.svg` | Letters | | `92f0be286703b4b8c906bcf1c95c7f3bbee5bd38-1000x1000.svg` | Hands with document or figure | `Hands-Document-02.svg` | Hands | | `97cf99624aa60f59b75f9e08cdf0f00d33c34804-1000x1000.svg` | Abstract curved forms | `Abstract-Curves-02.svg` | Abstract | | `9a2bdeafe0f8f92dcc062ba47cc0a1014c4ecbc0-1000x1000.svg` | Abstract curved shapes or face profile | `Abstract-Curves-01.svg` | Abstract | | `9f6a378a1e3592cf8d27447457409ba12284faef-1000x1000.svg` | Hand gestures or figures | `Hands-Gesture-05.svg` | Hands | | `a62b6eb169818f14c35b7a192af269e283f8fa93-1000x1000.svg` | Complex scene with multiple elements | `Scene-Complex-04.svg` | Scenes | | `a683fdcfe3e2c7c6532342a0fa4ff789c3fd4852-1000x1000.svg` | Hands and figures | `Hands-Figure-02.svg` | Hands | | `a97733b3607b54a30778eb89de08afd9e02b9fb3-1000x1000.svg` | Letter or abstract character | `Letter-Abstract-02.svg` | Letters | | `abc884c723daea810d2e986455358281a2f94102-1000x1000.svg` | Person/figure with hands | `People-Figure-02.svg` | People | | `b1ce510c468b2920d4f8f61c17a50906801f939a-1000x1000.svg` | Complex scene with wavy forms and hands | `Scene-Wavy-01.svg` | Scenes | | `b5c98d26c46edc43193e7f7e28a00633a538bb9c-1000x1000.svg` | Complex document/page layout | `Objects-Document-Layout-01.svg` | Objects | | `b68cbb43d7c8f56f0b14cc867e8d4d74445f78b0-1000x1000.svg` | Complex scene with machinery or abstract elements | `Abstract-Machinery-01.svg` | Abstract | | `c0af2a56f56cf298ce5904f2901e9a36facd0dbe-1000x1000.svg` | Letter W or person with hands | `Letter-W-Person-01.svg` | Letters | | `c1ef4c0b6882dfe985555b52999d370ea88a3c50-1000x1000.svg` | Complex scene with hands and abstract elements | `Hands-Abstract-Complex-01.svg` | Hands | | `c4a48972044d45df475f1dd84df3b74d221b6580-1000x1000.svg` | Hands and mountainous terrain | `Hands-Terrain-02.svg` | Hands | | `cd4fd51deacd067d4e30aee4f4b149f6cba1b97b-1000x1000.svg` | Letter or character (E/P shape) | `Letter-E-01.svg` | Letters | | `cd9cf56a7f049285b7c1c8786c0a600cf3d7f317-1000x1000.svg` | Complex abstract scene | `Scene-Complex-05.svg` | Scenes | | `d3dd09ad16c68461dc3fb01df5e84cf7ccafda6c-1000x1000.svg` | Abstract scene with complex paths | `Scene-Detailed-02.svg` | Scenes | | `ddad92700787ec1bf1d80359c0c5e6ca305682b0-1000x1000.svg` | Person/figure illustration | `People-Figure-04.svg` | People | | `ee580919acaba2ddc07425f7a7390c8962cadc94-1000x1000.svg` | Complex person/figure with hands | `People-Figure-03.svg` | People | | `f1d1a4c75433996f97b87ea0f3791022370e2765-1680x1260.svg` | Wide format (1680x1260) with rust/orange background and complex scene | `Scene-Wide-Orange-01.svg` | Scenes | ## Analysis Summary **Total Files**: 51 SVG files - ✅ Already semantically named: 3 files - ✅ Analyzed and mapped: 47 files - ✅ Analysis completion: 100% **Category Breakdown**: - **Hands**: 15 files (gestures, interactions, documents) - **People**: 6 files (figures, motion) - **Scenes**: 12 files (complex illustrations, terrain, wavy) - **Letters**: 8 files (letter forms, abstract letters) - **Abstract**: 5 files (organic, curves, machinery) - **Objects**: 2 files (documents, puzzles) ## Design System Compliance All icons follow Anthropic design guidelines: - **viewBox**: `0 0 1000 1000` (or `0 0 1680 1260` for wide format) - **Colors**: - Light: `#FAF9F5` - Dark: `#141413` - **Format**: SVG with no fill attribute on root, paths have fill ## Rename Operation **Status**: ✅ COMPLETED **Date**: November 6, 2025 **Result**: 100% Success (48/48 files renamed) ### Operation Details - **Script**: `rename-icons.ps1` - **Backup Location**: `public/icons/.backup/` (all original files preserved) - **Log File**: `rename-log.txt` - **Success Rate**: 48 successful, 0 failed, 0 skipped ### Files Renamed All 48 hashed SVG files have been successfully renamed to semantic names following the `{Category}-{Description}.svg` convention. ## Next Steps 1. ✅ ~~Continue analyzing remaining hashed files~~ (COMPLETED) 2. ✅ ~~Finalize semantic names based on visual content~~ (COMPLETED) 3. ✅ ~~Perform batch rename operation~~ (COMPLETED - 100% success) 4. ⏳ Update icon registry with newly renamed files 5. ⏳ Add new icons to the IconBrowser component ## Notes - Some files have non-standard dimensions (1680x1260) - these may be special illustrations - Numbering scheme (e.g., `-01`, `-02`) used for similar icons to avoid conflicts - Original hash filenames will be documented for reference