docs: add IDEAS.md Watching section + README restructure (v3.9.5)

- Add "Watching (Waiting for Demand)" section to IDEAS.md
  - Track Multi-LLM Consultation Patterns research
  - Criteria: implement if 3+ requests
- Restructure README.md (~40% cognitive load reduction)
  - Collapsible ToC with 4 learning paths
  - Remove duplicate "5 Rules" section
- Version bump to 3.9.5

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-01-19 16:43:20 +01:00
parent 3bc38ef982
commit 9c2ce7ccce
7 changed files with 85 additions and 26 deletions

View file

@ -7,7 +7,7 @@
<p align="center">
<a href="https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers"><img src="https://img.shields.io/github/stars/FlorianBruniaux/claude-code-ultimate-guide?style=for-the-badge" alt="Stars"/></a>
<a href="#"><img src="https://img.shields.io/badge/Lines-10,900+-blueviolet?style=for-the-badge" alt="Lines"/></a>
<a href="./examples/"><img src="https://img.shields.io/badge/Templates-61-green?style=for-the-badge" alt="Templates"/></a>
<a href="./examples/"><img src="https://img.shields.io/badge/Templates-65-green?style=for-the-badge" alt="Templates"/></a>
<a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-227_questions-orange?style=for-the-badge" alt="Quiz"/></a>
</p>
@ -16,6 +16,31 @@
<a href="https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="Ask Zread"/></a>
</p>
<details>
<summary><strong>📑 Table of Contents</strong></summary>
**🆕 Beginner Path**
- [TL;DR](#-tldr-under-5-minutes) — Quick reference
- [Get Started](#get-started-in-60-seconds) — First steps
- [Golden Rules](#-golden-rules) — 5 principles
**👨‍💻 Developer Path**
- [By Role](#-by-role-tailored-learning-paths) — Junior/Senior/Power User
- [Guide Navigation](#-guide-navigation) — Section index
- [Examples](#-production-ready-examples) — Templates
**🚀 Advanced Path**
- [Audit Setup](#-audit-your-setup) — Check configuration
- [Quiz](#-knowledge-quiz) — Test knowledge
- [Ecosystem](#-ecosystem--positioning) — Complementary tools
**📚 Reference**
- [Complete Toolkit](#-complete-toolkit) — Full documentation
- [About](#-about-this-guide) — Philosophy & origins
- [Contributing](#-contributing) — How to help
</details>
---
## ⚡ TL;DR (Under 5 Minutes)
@ -26,7 +51,7 @@
|-----------|---------|------|
| **Quick reference** | [Cheat Sheet](./guide/cheatsheet.md) | 2 min |
| **Starter CLAUDE.md** | Copy below ↓ | 30 sec |
| **Key principles** | [5 Rules](#5-rules-to-remember) | 1 min |
| **Key principles** | [Golden Rules](#-golden-rules) | 1 min |
<details>
<summary><strong>📋 Minimal CLAUDE.md Template (click to expand & copy)</strong></summary>
@ -105,24 +130,15 @@ Claude asks 2-4 questions then guides you through personalized content based on
---
## 5 Rules to Remember
1. **Review diffs** before accepting changes
2. **`/compact` at 70%** context usage (check with `/status`)
3. **Be specific**: WHAT + WHERE + HOW + VERIFY
4. **Plan Mode first** for risky/complex tasks (Shift+Tab×2)
5. **Create CLAUDE.md** for every project
---
## Choose Your Path
| I want to... | Go here |
|--------------|---------|
| Learn step by step | Run the onboarding command above |
| Find something specific | [Guide Navigation](#-guide-navigation) |
| Test my knowledge | [Quiz](./quiz/) |
| Fix a problem | [Troubleshooting](./guide/ultimate-guide.md#troubleshooting) |
> **New here?** Use the [Table of Contents](#-table-of-contents) above or pick:
| Profile | Start here |
|---------|------------|
| **Beginner** | [Get Started](#get-started-in-60-seconds) → [Golden Rules](#-golden-rules) |
| **Experienced** | [By Role](#-by-role-tailored-learning-paths) → [Examples](#-production-ready-examples) |
| **Troubleshooting** | [Troubleshooting](./guide/ultimate-guide.md#troubleshooting) |
---
@ -733,7 +749,7 @@ Get notified about major updates, new templates, and Claude Code best practices:
---
*Version 3.9.4 | January 2026 | Crafted with Claude*
*Version 3.9.5 | January 2026 | Crafted with Claude*
<!-- SEO Keywords -->
<!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,