diff --git a/.context.json b/.context.json
index b937ff7..082c3de 100644
--- a/.context.json
+++ b/.context.json
@@ -10,14 +10,9 @@
     "main": {
       "notes": [
         "Shared PS1 module in dotfiles/ps1/ps1.sh is source of truth for both Linux and macOS installers.",
-        "README documents 4seasons branch, seasonal ranges, static/dynamic choice.",
+        "README documents seasonal ranges and style packs.",
         "README example image uses images/bash-pallete.png."
       ]
-    },
-    "dev": {
-      "notes": [
-        "Development branch; currently in sync with main."
-      ]
     }
   },
   "files": {
diff --git a/README.md b/README.md
index cf345a9..bbd8dd2 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,23 @@
 # Bashrc Dotfiles — Global & Portable Bash Prompt
 
-Production-ready on `main`.
+Elegant, portable, and easy-to-install Bash prompt with seasonal palettes, time-aware emoji, and clean powerline structure.
 
-Elegant, portable, and easy-to-install Bash prompt with:
+---
 
-- ✨ Two color zones
-- 🌅 Time-based emoji accents
-- 🖥️ Fallback when Nerd Fonts aren’t available
-- 📍 Shortened but informative path
-- 🔘 Status-colored prompt arrow
-- 🧠 Works on Linux, WSL, and macOS
+## ✅ Requirements (Nerd Fonts)
+
+This prompt relies on Nerd Font glyphs for the rounded separators.
+
+```bash
+bash dotfiles/install/install-nerdfont.sh
+```
+
+After install:
+
+- Set your terminal font to JetBrainsMono Nerd Font (or any Nerd Font)
+- Manual download: https://www.nerdfonts.com/font-downloads
+
+If you use a non‑Nerd font, the prompt falls back to ASCII/Unicode.
 
 ---
 
@@ -63,21 +71,6 @@ bash dotfiles/install/install-macos-user.sh
 source ~/.bashrc
 ```
 
-### 🖼️ Nerd Fonts (optional but recommended)
-
-```bash
-bash dotfiles/install/install-nerdfont.sh
-```
-
-After install:
-
-- Open your terminal settings
-- Set font to JetBrainsMono Nerd Font (or any Nerd Font)
-- Terminal must use a Nerd Font for glyphs like ``, ``, `` to render correctly
-- Manual download: https://www.nerdfonts.com/font-downloads
-
----
-
 <details>
 <summary><strong>Installer choices</strong></summary>
 
@@ -95,6 +88,17 @@ macOS:
 
 ---
 
+## ✨ Features
+
+- Two-line, powerline-style prompt
+- Seasonal palettes + time-based emoji accents
+- Smart path shortening (keeps home visible)
+- Status-colored prompt arrow
+- Works on Linux, WSL, and macOS
+- Per-user disable switch
+
+---
+
 <details>
 <summary><strong>What gets installed</strong></summary>
 
@@ -151,19 +155,6 @@ echo "Your punchline" | sudo tee /etc/ps1-punchline >/dev/null
 
 ---
 
-## 🧠 Features
-
-- **Clean, modern powerline-style prompt**
-- Zone 1: date/time/user (cool gray-blue)
-- Zone 2: host/path (turquoise / cool green)
-- Automatically switches emoji during the day
-- Smart path shortening (keeps your home dir visible)
-- Fallback to ASCII/Unicode if Nerd Fonts are not installed
-- Per-user disable support
-- Simple per-user or global install
-
----
-
 ## 🎛️ Themes & Style Packs
 
 ### 🏁 Contest Pack
@@ -223,6 +214,15 @@ Holidays pack uses themed palettes + emojis and the contest layout order:
 
 ---
 
+## 🧭 Theme Design Notes
+
+- **Aurora (seasonal):** calm hierarchy, subtle gradients, long-term readability
+- **Contest styles:** bold contrast and distinct silhouettes for instant recognition
+- **Custom pack:** experimental, high-signal variants for strong personal style
+- **Holidays:** themed colors + emojis without compromising legibility
+
+---
+
 <details>
 <summary><strong>Emoji palette</strong></summary>
 
@@ -373,26 +373,6 @@ Current combined palette reference:
 
 ---
 
-## 🔥 Why this is real high-end PS1 design
-
-- Semantic color use (identity vs location)
-- Few colors, but with meaning
-- Path is visible, but never dominant
-- Emoji is an accent, not a gimmick
-- Prompt line is calm → the command gets focus
-
-### 🎨 Color palette (notes)
-
-| Role | BG | Description |
-| --- | --- | --- |
-| Zone 1 BG | 61 | gray-blue pastel |
-| Zone 1 FG | 255 | pure white |
-| Zone 2 BG | 37 | turquoise / cool green |
-| Path FG | 194 (FG) | light green, muted |
-| Frame | 60 | darker blue |
-
----
-
 ## 🛠️ Contribution
 
 Want to help improve this project?
diff --git a/contest-styles.json b/contest-styles.json
index 5573f6e..20a17bd 100644
--- a/contest-styles.json
+++ b/contest-styles.json
@@ -1,6 +1,6 @@
 {
   "project": "Bashrc Dotfiles",
-  "branch": "dev",
+  "branch": "main",
   "purpose": "DEFCON contest + custom render pack for PS1 styles",
   "contest_pack": {
     "layout_options": [