Update README.md

README.md

@@ -17,6 +17,11 @@ tags:
   - codex
   - field-notes
   - sharing-is-caring
+  - track:backyard
+  - achievement:offgrid
+  - achievement:offbrand
+  - achievement:sharing
+  - achievement:fieldnotes
 ---
 
 # 🧼 Soap Lab
@@ -78,6 +83,69 @@ explains numbers the code already calculated correctly.
 
 ## Built with
 
+- Codex for UI redesign, agentic recipe optimiser, and water hardness mode
+- Deterministic chemistry engine (SAP values from HSCG)
+- Qwen2.5-3B-Instruct via Featherless AI
+
+# 🧼 Soap Lab
+
+Plain English soap chemistry for home makers — recipes, substitutions, troubleshooting.
+
+## The idea
+
+I was asking in a soap making community what people do when they can't find an oil for 
+a recipe. Someone asked about palm oil. The answer? *"Tallow maybe?"*
+
+SoapCalc and Soapmaking Friend have been the only options for years. Both are form-based 
+tools — dropdowns, number fields, ten steps before you get an answer. Neither explains 
+anything. Soap Lab fixes that.
+
+## Track
+
+🏡 **Chapter One: Backyard AI** — built for a real home soap maker who needed 
+explanations, not just numbers.
+
+## Badges targeting
+
+- 🐜 Tiny Titan — Qwen2.5-3B-Instruct (3B parameters)
+- 🎨 Off-Brand — custom warm cream UI, visual progress bars
+- 💻 Codex — agentic optimiser and UI built with Codex
+- 📓 Field Notes — blog post linked below
+- 📡 Sharing is Caring — agent traces linked below
+
+## What it does
+
+Five modes, all plain English input:
+
+* **Recipe** — lye calculation from verified SAP values + quality scores + AI explanation
+* **Substitute** — fatty acid matching to find the closest oil replacement
+* **Goal** — skin-targeted recipe suggestions from a description
+* **Diagnose** — batch failure analysis and fix
+* **Pantry** — best recipe from whatever oils you have
+* **Optimise** — agentic 3-iteration recipe improvement loop with before/after comparison
+
+Plus: superfat slider, vegan filter, water hardness recommendations with sodium citrate amounts.
+
+## Architecture
+
+The lye calculation is **deterministic Python — not AI**. SAP values from the HSCG 
+professional standard, verified against known recipes, 33 tests passing. The model only 
+explains numbers the code already calculated correctly.
+
+## Model
+
+`Qwen/Qwen2.5-3B-Instruct` via Featherless AI — 3B parameters, Tiny Titan eligible.
+
+## Links
+
+- 📝 Blog post: https://huggingface.co/blog/build-small-hackathon/soap-lab-tallow-maybe
+- 🎬 Demo video: https://youtu.be/10OhPgMqAKo 
+- 📱 Social post: https://x.com/flower56778/status/2066095227429961777
+- 💻 GitHub: https://github.com/tammy357/soap-lab
+- 📡 Agent Traces: https://huggingface.co/datasets/tammy357/soap-lab-traces
+
+## Built with
+
 - Codex for UI redesign, agentic recipe optimiser, and water hardness mode
 - Deterministic chemistry engine (SAP values from HSCG)
 - Qwen2.5-3B-Instruct via Featherless AI