Fix all internal links to use README.md instead of directory paths

artvandelay · artvandelay · commit cdfb812d6197 · 2025-10-07T16:37:08.000+05:30
- Fix complete agent links in INDEX.md and other files
- Update all pattern directory links to point to README.md
- Fix emoji configuration to use material.extensions instead of deprecated materialx
- Resolves broken navigation links throughout documentation
diff --git a/docs/learning-material/00-READ-ME-FIRST.md b/docs/learning-material/00-READ-ME-FIRST.md
@@ -18,10 +18,10 @@ This is a **comprehensive learning resource** for building intelligent AI agents
 → Open [`INDEX.md`](./INDEX.md)
 
 ### 🔴 Want Production Patterns?
-→ Open [`16-sandbox-escalation/`](./16-sandbox-escalation/) ⭐ **NEW!**
+→ Open [`16-sandbox-escalation/`](./16-sandbox-escalation/README.md) ⭐ **NEW!**
 
 ### 💻 Just Want Code?
-→ Open [`complete-agent-example/complete_agent.py`](./complete-agent-example/complete_agent.py)
+→ Open [`complete-agent-example/complete_agent.py`](./complete-agent-example/README.mdcomplete_agent.py)
 
 ---
 
@@ -88,10 +88,10 @@ I've added **3 sophisticated patterns** extracted from Codex's production codeba
 | **Understand the structure** | [`START_HERE.md`](./START_HERE.md) |
 | **Navigate all content** | [`INDEX.md`](./INDEX.md) |
 | **Learn basic patterns** | [`CODEX_PATTERNS_SUMMARY.md`](./CODEX_PATTERNS_SUMMARY.md) |
-| **Learn ADVANCED patterns** ⭐ | [`16-sandbox-escalation/`](./16-sandbox-escalation/) |
+| **Learn ADVANCED patterns** ⭐ | [`16-sandbox-escalation/`](./16-sandbox-escalation/README.md) |
 | **Practice coding** | [`EXERCISES.md`](./EXERCISES.md) |
 | **See directory layout** | [`STRUCTURE.md`](./STRUCTURE.md) |
-| **Study complete agent** | [`complete-agent-example/`](./complete-agent-example/) |
+| **Study complete agent** | [`complete-agent-example/`](./complete-agent-example/README.md) |
 
 ---
 
@@ -154,7 +154,7 @@ After completing these materials, you'll be able to:
 - 🟢 **New to agents?** → [`START_HERE.md`](./START_HERE.md)
 - 🟡 **Some experience?** → [`INDEX.md`](./INDEX.md)
 - 🔴 **Experienced?** → [`CODEX_PATTERNS_SUMMARY.md`](./CODEX_PATTERNS_SUMMARY.md)
-- 🔥 **Want production patterns?** → [`16-sandbox-escalation/`](./16-sandbox-escalation/) ⭐
+- 🔥 **Want production patterns?** → [`16-sandbox-escalation/`](./16-sandbox-escalation/README.md) ⭐
 
 ### Step 2: Set Up (5 minutes)
 ```bash
@@ -274,8 +274,8 @@ You'll know you've mastered the material when you can:
 1. 🟢 **Beginner** → [`START_HERE.md`](./START_HERE.md)
 2. 🟡 **Intermediate** → [`INDEX.md`](./INDEX.md)  
 3. 🔴 **Advanced** → [`CODEX_PATTERNS_SUMMARY.md`](./CODEX_PATTERNS_SUMMARY.md)
-4. 🔥 **Production** → [`16-sandbox-escalation/README.md`](./16-sandbox-escalation/README.md) ⭐
-5. 💻 **Just code** → [`complete-agent-example/complete_agent.py`](./complete-agent-example/complete_agent.py)
+4. 🔥 **Production** → [`16-sandbox-escalation/README.md`](./16-sandbox-escalation/README.mdREADME.md) ⭐
+5. 💻 **Just code** → [`complete-agent-example/complete_agent.py`](./complete-agent-example/README.mdcomplete_agent.py)
 
 ---
 
diff --git a/docs/learning-material/01-prompt-chaining/README.md b/docs/learning-material/01-prompt-chaining/README.md
@@ -149,5 +149,5 @@ See the example files:
 
 ---
 
-**Next**: [Pattern 2: Routing →](../02-routing/)
+**Next**: [Pattern 2: Routing →](../02-routing/README.mdREADME.md)
 
diff --git a/docs/learning-material/02-routing/README.md b/docs/learning-material/02-routing/README.md
@@ -148,5 +148,5 @@ See the example files:
 
 ---
 
-**Next**: [Pattern 3: Parallelization →](../03-parallelization/)
+**Next**: [Pattern 3: Parallelization →](../03-parallelization/README.mdREADME.md)
 
diff --git a/docs/learning-material/03-parallelization/README.md b/docs/learning-material/03-parallelization/README.md
@@ -181,5 +181,5 @@ See the example files:
 
 ---
 
-**Next**: [Pattern 8: Memory Management →](../08-memory-management/)
+**Next**: [Pattern 8: Memory Management →](../08-memory-management/README.mdREADME.md)
 
diff --git a/docs/learning-material/05-tool-use/README.md b/docs/learning-material/05-tool-use/README.md
@@ -224,5 +224,5 @@ See the example files:
 
 ---
 
-**Next**: [Pattern 8: Memory Management →](../08-memory-management/)
+**Next**: [Pattern 8: Memory Management →](../08-memory-management/README.mdREADME.md)
 
diff --git a/docs/learning-material/16-sandbox-escalation/README.md b/docs/learning-material/16-sandbox-escalation/README.md
@@ -216,4 +216,4 @@ Key classes:
 
 ---
 
-**Next**: [Pattern 17: Turn Diff Tracking →](../17-turn-diff-tracking/)
+**Next**: [Pattern 17: Turn Diff Tracking →](../17-turn-diff-tracking/README.mdREADME.md)
diff --git a/docs/learning-material/17-turn-diff-tracking/README.md b/docs/learning-material/17-turn-diff-tracking/README.md
@@ -229,4 +229,4 @@ Key methods:
 
 ---
 
-**Next**: [Pattern 18: Rollout System →](../18-rollout-system/)
+**Next**: [Pattern 18: Rollout System →](../18-rollout-system/README.mdREADME.md)
diff --git a/docs/learning-material/18-rollout-system/README.md b/docs/learning-material/18-rollout-system/README.md
@@ -198,4 +198,4 @@ Key features:
 
 ---
 
-**Next**: [Complete Agent Example →](../complete-agent-example/)
+**Next**: [Complete Agent Example →](../complete-agent-example/README.mdREADME.md)
diff --git a/docs/learning-material/CODEX_PATTERNS_SUMMARY.md b/docs/learning-material/CODEX_PATTERNS_SUMMARY.md
@@ -466,5 +466,5 @@ Use Codex as a reference implementation when building your own agentic systems.
 
 ---
 
-**Ready to build your own agent?** Start with the [Complete Agent Example](./complete-agent-example/) to see these patterns in action! 🚀
+**Ready to build your own agent?** Start with the [Complete Agent Example](./complete-agent-example/README.md) to see these patterns in action! 🚀
 
diff --git a/docs/learning-material/FINAL_SUMMARY.md b/docs/learning-material/FINAL_SUMMARY.md
@@ -314,7 +314,7 @@ You now have:
 → [CODEX_PATTERNS_SUMMARY.md](./CODEX_PATTERNS_SUMMARY.md)
 
 ### Just Code
-→ [complete-agent-example/complete_agent.py](./complete-agent-example/complete_agent.py)
+→ [complete-agent-example/complete_agent.py](./complete-agent-example/README.mdcomplete_agent.py)
 
 ---
 
diff --git a/docs/learning-material/INDEX.md b/docs/learning-material/INDEX.md
@@ -8,7 +8,7 @@
 |----------|-------------|-------|
 | **[README](./README.md)** | Overview and getting started | Beginner |
 | **[Pattern Summary](./CODEX_PATTERNS_SUMMARY.md)** | Comprehensive pattern analysis | All Levels |
-| **[Complete Agent](./complete-agent-example/)** | Production-ready implementation | Advanced |
+| **[Complete Agent](./complete-agent-example/README.mdREADME.md)** | Production-ready implementation | Advanced |
 
 ---
 
@@ -18,43 +18,43 @@
 
 **Week 1: Fundamentals**
 ```
-Day 1-2: [Pattern 1: Prompt Chaining](./01-prompt-chaining/)
+Day 1-2: [Pattern 1: Prompt Chaining](./01-prompt-chaining/README.mdREADME.md)
          → Run pattern_simple.py
          → Read Codex examples in README
          → Experiment with pattern_advanced.py
 
-Day 3-4: [Pattern 5: Tool Use](./05-tool-use/)
+Day 3-4: [Pattern 5: Tool Use](./05-tool-use/README.mdREADME.md)
          → Understand function calling
          → Explore safety mechanisms
          → Build your own tool
 
-Day 5-7: [Pattern 8: Memory Management](./08-memory-management/)
+Day 5-7: [Pattern 8: Memory Management](./08-memory-management/README.mdREADME.md)
          → Study conversation history
          → Implement state persistence
          → Practice session management
 ```
 
 **Week 2: Intermediate Patterns**
 ```
-Day 1-2: [Pattern 2: Routing](./02-routing/)
+Day 1-2: [Pattern 2: Routing](./02-routing/README.mdREADME.md)
          → Classification and dispatch
          → Build a tool router
          → Dynamic handler registration
 
-Day 3-5: [Pattern 12: Exception Handling](./12-exception-handling/)
+Day 3-5: [Pattern 12: Exception Handling](./12-exception-handling/README.mdREADME.md)
          → Retry logic with backoff
          → Error recovery strategies
          → Graceful degradation
 
-Day 6-7: [Pattern 13: Human-in-the-Loop](./13-human-in-the-loop/)
+Day 6-7: [Pattern 13: Human-in-the-Loop](./13-human-in-the-loop/README.mdREADME.md)
          → Approval workflows
          → Policy systems
          → User control patterns
 ```
 
 **Week 3: Integration**
 ```
-Day 1-7: [Complete Agent Example](./complete-agent-example/)
+Day 1-7: [Complete Agent Example](./complete-agent-example/README.mdREADME.md)
          → Study complete_agent.py
          → Run example scenarios
          → Modify and extend
diff --git a/docs/learning-material/QUICKSTART.md b/docs/learning-material/QUICKSTART.md
@@ -103,14 +103,14 @@ Choose your path based on your experience level:
 
 ### 🟢 Beginner Path (Week 1-2)
 
-**Day 1-2**: [Pattern 1: Prompt Chaining](./01-prompt-chaining/)
+**Day 1-2**: [Pattern 1: Prompt Chaining](./01-prompt-chaining/README.md)
 ```bash
 cd 01-prompt-chaining
 python pattern_simple.py    # Basic
 python pattern_advanced.py  # Advanced
 ```
 
-**Day 3-4**: [Pattern 5: Tool Use](./05-tool-use/)
+**Day 3-4**: [Pattern 5: Tool Use](./05-tool-use/README.md)
 ```bash
 cd 05-tool-use
 python pattern_simple.py
@@ -125,23 +125,23 @@ python pattern_simple.py
 
 ### 🟡 Intermediate Path (Week 2-3)
 
-**Day 1-2**: [Pattern 2: Routing](./02-routing/)
+**Day 1-2**: [Pattern 2: Routing](./02-routing/README.md)
 ```bash
 cd 02-routing
 python pattern_simple.py
 ```
 
-**Day 3-4**: [Pattern 8: Memory Management](./08-memory-management/)
+**Day 3-4**: [Pattern 8: Memory Management](./08-memory-management/README.md)
 
-**Day 5-7**: [Pattern 12: Exception Handling](./12-exception-handling/)
+**Day 5-7**: [Pattern 12: Exception Handling](./12-exception-handling/README.md)
 
 ### 🔴 Advanced Path (Week 3-4)
 
-**Day 1-2**: [Pattern 3: Parallelization](./03-parallelization/)
+**Day 1-2**: [Pattern 3: Parallelization](./03-parallelization/README.md)
 
-**Day 3-4**: [Pattern 18: Guardrails/Safety](./18-guardrails-safety/)
+**Day 3-4**: [Pattern 18: Guardrails/Safety](./18-guardrails-safety/README.md)
 
-**Day 5-7**: [Complete Agent Example](./complete-agent-example/)
+**Day 5-7**: [Complete Agent Example](./complete-agent-example/README.md)
 
 ---
 
@@ -369,7 +369,7 @@ If you checked all boxes, you're ready to dive deeper! 🎉
 
 ---
 
-**Ready?** Start with [Pattern 1: Prompt Chaining →](./01-prompt-chaining/)
+**Ready?** Start with [Pattern 1: Prompt Chaining →](./01-prompt-chaining/README.md)
 
 Happy Learning! 🎓
 
diff --git a/docs/learning-material/README.md b/docs/learning-material/README.md
@@ -152,5 +152,5 @@ Educational materials for learning purposes. See main Codex repository for licen
 
 ---
 
-**Ready to learn?** Start with [Pattern 1: Prompt Chaining](./01-prompt-chaining/)! 🚀
+**Ready to learn?** Start with [Pattern 1: Prompt Chaining](./01-prompt-chaining/README.md)! 🚀
 
diff --git a/docs/learning-material/START_HERE.md b/docs/learning-material/START_HERE.md
@@ -152,7 +152,7 @@ DESTINATION: Build Production Agents! 🎉
 - **Yes** → Go to Q2
 
 ### Q2: Have you used function calling / tools?
-- **No** → Start with 🟡 [05-tool-use/](./05-tool-use/)
+- **No** → Start with 🟡 [05-tool-use/](./05-tool-use/README.md)
 - **Yes** → Go to Q3
 
 ### Q3: Have you built production agents?
@@ -348,7 +348,7 @@ A: Beginner: 1-2 weeks | Intermediate: 2-3 weeks | Advanced: 4-6 weeks
 | 🟢 **Beginner** | [QUICKSTART.md](./QUICKSTART.md) | 10 min | Get running |
 | 🟡 **Intermediate** | [INDEX.md](./INDEX.md) | 20 min | Navigate content |
 | 🔴 **Advanced** | [CODEX_PATTERNS_SUMMARY.md](./CODEX_PATTERNS_SUMMARY.md) | 30 min | Deep analysis |
-| 💻 **Just Code** | [complete-agent-example/complete_agent.py](./complete-agent-example/complete_agent.py) | 2 hours | Study implementation |
+| 💻 **Just Code** | [complete-agent-example/complete_agent.py](./complete-agent-example/README.mdcomplete_agent.py) | 2 hours | Study implementation |
 
 ---
 
@@ -428,7 +428,7 @@ So what are you waiting for?
 | **Reference** | [CODEX_PATTERNS_SUMMARY.md](./CODEX_PATTERNS_SUMMARY.md) |
 | **Structure** | [STRUCTURE.md](./STRUCTURE.md) |
 | **Summary** | [FINAL_SUMMARY.md](./FINAL_SUMMARY.md) |
-| **Code** | [complete-agent-example/](./complete-agent-example/) |
+| **Code** | [complete-agent-example/](./complete-agent-example/README.md) |
 
 ---
 
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -81,8 +81,8 @@ markdown_extensions:
   - pymdownx.caret
   - pymdownx.details
   - pymdownx.emoji:
-      emoji_generator: !!python/name:materialx.emoji.to_svg
-      emoji_index: !!python/name:materialx.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
   - pymdownx.highlight:
       anchor_linenums: true
       line_spans: __span

Original file line number	Diff line number	Diff line change
`@@ -149,5 +149,5 @@ See the example files:`
`149`	`149`
`150`	`150`	`---`
`151`	`151`
`152`		`-Next: [Pattern 2: Routing →](../02-routing/)`
	`152`	`+Next: [Pattern 2: Routing →](../02-routing/README.mdREADME.md)`
`153`	`153`
Original file line number	Diff line number	Diff line change
`@@ -148,5 +148,5 @@ See the example files:`
`148`	`148`
`149`	`149`	`---`
`150`	`150`
`151`		`-Next: [Pattern 3: Parallelization →](../03-parallelization/)`
	`151`	`+Next: [Pattern 3: Parallelization →](../03-parallelization/README.mdREADME.md)`
`152`	`152`
Original file line number	Diff line number	Diff line change
`@@ -181,5 +181,5 @@ See the example files:`
`181`	`181`
`182`	`182`	`---`
`183`	`183`
`184`		`-Next: [Pattern 8: Memory Management →](../08-memory-management/)`
	`184`	`+Next: [Pattern 8: Memory Management →](../08-memory-management/README.mdREADME.md)`
`185`	`185`
Original file line number	Diff line number	Diff line change
`@@ -224,5 +224,5 @@ See the example files:`
`224`	`224`
`225`	`225`	`---`
`226`	`226`
`227`		`-Next: [Pattern 8: Memory Management →](../08-memory-management/)`
	`227`	`+Next: [Pattern 8: Memory Management →](../08-memory-management/README.mdREADME.md)`
`228`	`228`
Original file line number	Diff line number	Diff line change
`@@ -216,4 +216,4 @@ Key classes:`
`216`	`216`
`217`	`217`	`---`
`218`	`218`
`219`		`-Next: [Pattern 17: Turn Diff Tracking →](../17-turn-diff-tracking/)`
	`219`	`+Next: [Pattern 17: Turn Diff Tracking →](../17-turn-diff-tracking/README.mdREADME.md)`
Original file line number	Diff line number	Diff line change
`@@ -229,4 +229,4 @@ Key methods:`
`229`	`229`
`230`	`230`	`---`
`231`	`231`
`232`		`-Next: [Pattern 18: Rollout System →](../18-rollout-system/)`
	`232`	`+Next: [Pattern 18: Rollout System →](../18-rollout-system/README.mdREADME.md)`
Original file line number	Diff line number	Diff line change
`@@ -198,4 +198,4 @@ Key features:`
`198`	`198`
`199`	`199`	`---`
`200`	`200`
`201`		`-Next: [Complete Agent Example →](../complete-agent-example/)`
	`201`	`+Next: [Complete Agent Example →](../complete-agent-example/README.mdREADME.md)`
Original file line number	Diff line number	Diff line change
`@@ -466,5 +466,5 @@ Use Codex as a reference implementation when building your own agentic systems.`
`466`	`466`
`467`	`467`	`---`
`468`	`468`
`469`		`-Ready to build your own agent? Start with the [Complete Agent Example](./complete-agent-example/) to see these patterns in action! 🚀`
	`469`	`+Ready to build your own agent? Start with the [Complete Agent Example](./complete-agent-example/README.md) to see these patterns in action! 🚀`
`470`	`470`