diff --git a/CHANGELOG.md b/CHANGELOG.md
index 387d58f..1369c3f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,70 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased]
+## [3.9.4] - 2026-01-19
+
+### Added
+
+- **Session Teleportation documentation** — New Section 9.16 in Ultimate Guide (~105 lines)
+ - Evolution timeline (2.0.24 → 2.1.0)
+ - Commands reference (`%`, `--teleport`, `/teleport`, `/tasks`, `/remote-env`, `Ctrl+B`)
+ - Prerequisites (GitHub App, clean git state, same account)
+ - Workflow example with step-by-step
+ - Environment support table (CLI, VS Code, Cursor, Web, iOS)
+ - Current limitations (research preview, unidirectional, GitHub only)
+ - Troubleshooting table
+ - Best practices
+ - Environment variables (`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`)
+- Updated Section 9 Recap with "Advanced Workflows" category
+- Updated `guide/cheatsheet.md` with teleportation commands
+ - Essential Commands: `/teleport`, `/tasks`, `/remote-env`
+ - Keyboard Shortcuts: `Ctrl+B`
+ - CLI Flags: `--teleport`
+- Updated `machine-readable/reference.yaml`
+ - New `session_teleportation` deep_dive entry
+ - Commands: `/teleport`, `/tasks`, `/remote-env`
+ - Shortcuts: `Ctrl+B`
+ - CLI: `--teleport`
+ - Line numbers updated for sections after 9.15
+
+## [3.9.3] - 2026-01-19
+
+### Added
+
+- **Claude Cowork documentation** — Complete guide for the new agentic desktop feature
+ - `guide/cowork.md` (NEW, ~460 lines) — Full documentation
+ - Architecture overview (local-first, sub-agents, no code execution)
+ - Comparison: Claude Code vs Cowork vs Projects
+ - 5 detailed use cases (file org, expenses, reports, travel, meetings)
+ - Security best practices (no official docs exist yet)
+ - Developer ↔ Non-Developer workflow patterns
+ - Known issues & troubleshooting
+ - Availability & roadmap
+ - `guide/ai-ecosystem.md` Section 9 (~90 lines) — Condensed integration guide
+ - Quick comparison table
+ - When to use what decision flow
+ - Security considerations summary
+ - Cross-reference to full guide
+ - `guide/ultimate-guide.md` — Cowork subsection in Section 11
+ - Comparison table and collaboration pattern
+ - Table of Contents updated
+ - `machine-readable/reference.yaml` — 8 new deep_dive entries for Cowork
+ - Updated `guide/README.md` navigation table
+ - Updated main `README.md` AI Ecosystem entry
+
+## [3.9.2] - 2026-01-19
+
+### Added
+
+- **Alternative Providers section** in `guide/ai-ecosystem.md` (~55 lines)
+ - Documents existence of community workarounds (ANTHROPIC_BASE_URL, etc.)
+ - Clear disclaimer: not tested, not recommended, not supported
+ - Reasons to avoid: feature degradation, ToS risks, no support
+ - Better alternatives table: Aider for local models, Continue.dev for multi-provider
+ - External reading pointers (no step-by-step instructions intentionally)
+ - Updated Table of Contents
+ - Added `ai_ecosystem_alternative_providers` reference in `reference.yaml`
+
## [3.9.1] - 2026-01-19
### Added
diff --git a/README.md b/README.md
index ef9dfd5..0d742d0 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,8 @@
-
-
+
+
@@ -185,7 +185,8 @@ curl -sL https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-
**What's inside**: Decision trees, command reference, context zones, MCP servers, agent templates, troubleshooting—optimized for machine consumption. Points to line numbers in the [full guide](./guide/ultimate-guide.md) for deep dives.
-### 🔬 Deep Audit (Personalized Recommendations)
+
+🔬 Deep Audit (Personalized Recommendations)
Get a comprehensive, **context-aware** audit that analyzes your project's README, CLAUDE.md files, and business domain to provide tailored recommendations:
@@ -242,6 +243,8 @@ Based on ALL this context, provide:
**Want maximum depth?** Use [tools/audit-prompt.md](./tools/audit-prompt.md) (thinking is enabled by default with Opus 4.5)
+
+
### 🧠 Knowledge Quiz
Test your Claude Code knowledge with an interactive CLI quiz. **227 curated questions** covering all 14 guide sections, with immediate feedback and documentation links.
@@ -397,28 +400,11 @@ Weak Areas (< 75%):
| **[Data Privacy](./guide/data-privacy.md)** | Data retention and privacy guide | ~10 minutes |
| **[Security Hardening](./guide/security-hardening.md)** | MCP vetting, injection defense, CVEs | ~25 minutes |
| **[Observability](./guide/observability.md)** | Session monitoring and cost tracking | ~15 minutes |
-| **[AI Ecosystem](./guide/ai-ecosystem.md)** | Complementary tools (Perplexity, Gemini, Kimi) | ~25 minutes |
+| **[AI Ecosystem](./guide/ai-ecosystem.md)** | Complementary tools (Perplexity, Gemini, Kimi, Cowork) | ~25 minutes |
| **[LLM Reference](./machine-readable/reference.yaml)** | Machine-optimized index (~2K tokens) | For Claude/AI assistants |
| **[Setup Audit](./tools/audit-prompt.md)** | Optimize your configuration | ~10 minutes |
| **[Examples Library](./examples/)** | Production-ready templates | Browse as needed |
-### 🇫🇷 Whitepapers (French)
-
-8 standalone documents covering Claude Code from zero to production (~185 pages total):
-
-| # | Title | Audience | Pages |
-|---|-------|----------|-------|
-| **[#0](./whitepapers/00-introduction-serie.qmd)** | De Zéro à Productif | Everyone | ~8 |
-| **[#1](./whitepapers/01-prompts-efficaces.qmd)** | Prompts qui Marchent | Dev Junior/Senior | ~12 |
-| **[#2](./whitepapers/02-personnalisation.qmd)** | Personnaliser Claude | Senior/Power | ~15 |
-| **[#3](./whitepapers/03-securite.qmd)** | Sécurité en Production | DevSecOps/TechLead | ~15 |
-| **[#4](./whitepapers/04-architecture.qmd)** | L'Architecture Démystifiée | Architects | ~12 |
-| **[#5](./whitepapers/05-equipe.qmd)** | Déployer en Équipe | TechLead/PM | ~12 |
-| **[#6](./whitepapers/06-privacy.qmd)** | Privacy & Compliance | Compliance/Legal | ~10 |
-| **[#7](./whitepapers/07-guide-reference.qmd)** | Guide de Référence Complet | Everyone | ~100 |
-
-> **Reading paths by profile**: Junior (WP #0→#1, 25 min) | Senior (#0→#1→#2→#3, 1h15) | Tech Lead (#0→#5→#3→#2, 1h15)
-
Alternative Formats (Interactive AI, PDFs)
@@ -433,7 +419,7 @@ Weak Areas (< 75%):
```
claude-code-ultimate-guide/
├── guide/ # 📖 Core documentation
-│ ├── ultimate-guide.md # Complete reference (~10300 lines)
+│ ├── ultimate-guide.md # Complete reference (~10900 lines)
│ ├── cheatsheet.md # 1-page printable reference
│ ├── architecture.md # How Claude Code works internally
│ ├── adoption-approaches.md # Team implementation strategies
@@ -469,15 +455,10 @@ claude-code-ultimate-guide/
│ ├── github-actions/ # CI/CD workflows
│ ├── config/ # Configuration templates
│ ├── memory/ # CLAUDE.md templates
+│ ├── mcp-configs/ # MCP server configurations
│ ├── modes/ # Behavioral modes (SuperClaude)
│ └── workflows/ # Advanced workflow guides
│
-├── whitepapers/ # 🇫🇷 French whitepaper series (8 docs, ~185 pages)
-│ ├── 00-introduction-serie.qmd
-│ ├── 01-prompts-efficaces.qmd
-│ ├── ...
-│ └── 07-guide-reference.qmd
-│
└── quiz/ # 🧠 Interactive knowledge quiz (227 questions)
```
@@ -487,7 +468,8 @@ claude-code-ultimate-guide/
Copy-paste templates from [`examples/`](./examples/) for immediate use:
-### Slash Commands
+
+Slash Commands (15 commands)
| Command | Purpose | Highlights |
|---------|---------|------------|
@@ -507,6 +489,8 @@ Copy-paste templates from [`examples/`](./examples/) for immediate use:
| [/optimize](./examples/commands/optimize.md) | Performance analysis | Runtime, memory, bundle |
| [/ship](./examples/commands/ship.md) | Pre-deploy checklist | Tests, security, migrations |
+
+
### Utility Scripts
| Script | Purpose | Performance |
@@ -515,7 +499,8 @@ Copy-paste templates from [`examples/`](./examples/) for immediate use:
| [audit-scan.sh](./examples/scripts/audit-scan.sh) | Setup audit scanner | ~2s |
| [update-cc-releases.sh](./scripts/update-cc-releases.sh) | Check for new Claude Code releases | ~1s |
-### Security & Automation Hooks
+
+Security & Automation Hooks (8 highlighted, 15 total)
| Hook | Event | Purpose |
|------|-------|---------|
@@ -528,7 +513,9 @@ Copy-paste templates from [`examples/`](./examples/) for immediate use:
| [notification.sh](./examples/hooks/bash/notification.sh) | Notification | macOS sound alerts |
| [auto-format.sh](./examples/hooks/bash/auto-format.sh) | PostToolUse | Auto-format with Prettier |
-**[See All 14 Hooks](./examples/hooks/)** — Includes session-logger, security-check, claudemd-scanner, and more
+**[See All 15 Hooks](./examples/hooks/)** — Includes session-logger, security-check, claudemd-scanner, and more
+
+
### GitHub Actions (CI/CD)
@@ -630,7 +617,8 @@ Found an error? Have a suggestion? See [CONTRIBUTING.md](./CONTRIBUTING.md) for
---
-## 📚 Related Resources
+
+📚 Related Resources
### Complementary Guides
@@ -655,6 +643,8 @@ Found an error? Have a suggestion? See [CONTRIBUTING.md](./CONTRIBUTING.md) for
- [Claude Code Docs](https://docs.anthropic.com/en/docs/claude-code) — Anthropic official reference
+
+
---
## 🌐 Ecosystem & Positioning
@@ -743,7 +733,7 @@ Get notified about major updates, new templates, and Claude Code best practices:
---
-*Version 3.9.1 | January 2026 | Crafted with Claude*
+*Version 3.9.4 | January 2026 | Crafted with Claude*