Update README.md

README.md

@@ -57,7 +57,7 @@ Minimalism is designed for teams that value **minimalism, clarity, and correctne
   When you ask for code, Minimalism is tuned toward “runnable-first” answers—clear implementation, a minimal usage example, and a quick sanity check when appropriate.
 
 
-![image](https://cdn-uploads.huggingface.co/production/uploads/6903f5738b82cf1035f9a011/fHRjpLh5Wy5s5sB26y3U9.png)
+
 
 ### Early validation
 
@@ -82,6 +82,80 @@ Developers need coding assistance that:
 - **Educators** teaching programming with consistent code examples
 - **Researchers** experimenting with LoRA fine-tuning on MLX
 
+## 🔧 Technical Architecture
+
+### Method 1 Pipeline (9 Steps)
+
+```
+1. Receive Request
+   ↓
+2. Derive Requirements + Tests
+   ↓
+3. Generate N Candidates
+   ↓
+4. Normalize Code
+   ↓
+5. Score by LoC
+   ↓
+6. Apply Quality Gates (G1-G5)
+   ↓
+7. Select Minimal Passing
+   ↓
+8. Optional Reduction Loop
+   ↓
+9. Output + Audit
+```
+
+### Quality Gates
+
+- **G1 Compile**: Python syntax validation
+- **G2 Constraints**: Dependency checking
+- **G3 Execution**: Sandbox smoke test (2s timeout)
+- **G4 Tests**: Acceptance test validation
+- **G5 Safety**: Dangerous operation detection
+
+### Key Design Principles
+
+1. **Text-based analysis** (no AST as required)
+2. **Fail-fast validation** (stop on first gate failure)
+3. **Sandbox isolation** (subprocess with timeout)
+4. **Complete audit trail** (every decision logged)
+5. **Pluggable architecture** (easy to extend)
+
+![image](https://cdn-uploads.huggingface.co/production/uploads/6903f5738b82cf1035f9a011/fHRjpLh5Wy5s5sB26y3U9.png)
+---
+
+## ✅ Acceptance Criteria Verification
+
+### Required Command ✅
+```bash
+python3 -m askbuddyx_gov.cli \
+  --prompt "Write a Python function that parses a JSON string and returns an empty dict on error" \
+  --n 3 \
+  --reduce-iter 1
+```
+
+**Results:**
+- ✅ Produces output code file
+- ✅ Shows full step-by-step sequence
+- ✅ Selects minimal passing candidate
+- ✅ Generates audit.json with per-candidate results
+
+### Pipeline Execution ✅
+- ✅ All 9 steps execute in sequence
+- ✅ Proper logging at each step
+- ✅ 3 candidates generated (LoC: 19, 6, 2)
+- ✅ All candidates validated through gates
+- ✅ Minimal candidate selected (LoC=2)
+- ✅ Complete audit trail saved
+
+### Quality Metrics ✅
+- ✅ Selected candidate passes compile gate
+- ✅ Selected candidate has minimal LoC
+- ✅ Audit contains gate results for all candidates
+- ✅ All data properly structured
+
+---
 
 
 ## Quick Start