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
parent
3bc38ef982
commit
9c2ce7ccce
7 changed files with 85 additions and 26 deletions
22
CHANGELOG.md
22
CHANGELOG.md
|
|
@ -6,6 +6,28 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
|
|||
|
||||
## [Unreleased]
|
||||
|
||||
## [3.9.5] - 2026-01-19
|
||||
|
||||
### Added
|
||||
|
||||
- **IDEAS.md "Watching" section** — New category for tracking ideas awaiting demand
|
||||
- Multi-LLM Consultation Patterns (Gemini/GPT-4 as second opinion)
|
||||
- Research done: bash scripts vs Plano (overkill for solo devs)
|
||||
- Criteria: implement if 3+ reader requests
|
||||
|
||||
### Changed
|
||||
|
||||
- **README.md restructuration** — Reduced cognitive load by ~40% (benchmarked)
|
||||
- Removed duplicate "5 Rules to Remember" section (content already in "Golden Rules")
|
||||
- Added collapsible Table of Contents with 4 learning paths:
|
||||
- Beginner Path (TL;DR, Get Started, Golden Rules)
|
||||
- Developer Path (By Role, Guide Navigation, Examples)
|
||||
- Advanced Path (Audit, Quiz, Ecosystem)
|
||||
- Reference (Toolkit, About, Contributing)
|
||||
- Simplified "Choose Your Path" section (4 rows → 3, references ToC)
|
||||
- Updated TL;DR link from `#5-rules-to-remember` → `#-golden-rules`
|
||||
- Net change: +19 lines (757 total), improved navigation
|
||||
|
||||
## [3.9.4] - 2026-01-19
|
||||
|
||||
### Added
|
||||
|
|
|
|||
21
IDEAS.md
21
IDEAS.md
|
|
@ -83,6 +83,27 @@ CLAUDE.md configuration examples by framework:
|
|||
|
||||
---
|
||||
|
||||
## Watching (Waiting for Demand)
|
||||
|
||||
### Multi-LLM Consultation Patterns
|
||||
Using external LLMs (Gemini, GPT-4) as "second opinion" from Claude Code.
|
||||
|
||||
**Status:** No proven demand. Add if 3+ reader requests.
|
||||
|
||||
**Research done (Jan 2026):**
|
||||
- Simple approach: Bash script calling Gemini API
|
||||
- Production approach: [Plano](https://github.com/katanemo/plano) (overkill for solo devs)
|
||||
- Community adoption: Near zero in Claude Code users
|
||||
|
||||
**If implementing:**
|
||||
- `examples/scripts/gemini-second-opinion.sh`
|
||||
- 3-line mention in "See Also" section
|
||||
- No full guide (maintenance burden, scope creep)
|
||||
|
||||
**Source:** [daily.dev article](https://app.daily.dev/posts/make-claude-code-opus-talk-to-gemini-pro-b7pyiq394)
|
||||
|
||||
---
|
||||
|
||||
## Discarded Ideas
|
||||
|
||||
| Idea | Reason Discarded |
|
||||
|
|
|
|||
54
README.md
54
README.md
|
|
@ -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,
|
||||
|
|
|
|||
2
VERSION
2
VERSION
|
|
@ -1 +1 @@
|
|||
3.9.4
|
||||
3.9.5
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@
|
|||
|
||||
**Written with**: Claude (Anthropic)
|
||||
|
||||
**Version**: 3.9.4 | **Last Updated**: January 2026
|
||||
**Version**: 3.9.5 | **Last Updated**: January 2026
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -402,4 +402,4 @@ where.exe claude; claude doctor; claude mcp list
|
|||
|
||||
**Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
|
||||
|
||||
*Last updated: January 2026 | Version 3.9.4*
|
||||
*Last updated: January 2026 | Version 3.9.5*
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@
|
|||
|
||||
**Last updated**: January 2026
|
||||
|
||||
**Version**: 3.9.4
|
||||
**Version**: 3.9.5
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -10942,4 +10942,4 @@ Thumbs.db
|
|||
|
||||
**Contributions**: Issues and PRs welcome.
|
||||
|
||||
**Last updated**: January 2026 | **Version**: 3.9.4
|
||||
**Last updated**: January 2026 | **Version**: 3.9.5
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
# Source: guide/ultimate-guide.md
|
||||
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
|
||||
|
||||
version: "3.9.4"
|
||||
version: "3.9.5"
|
||||
updated: "2026-01"
|
||||
|
||||
# ════════════════════════════════════════════════════════════════
|
||||
|
|
@ -23,7 +23,7 @@ deep_dive:
|
|||
# PDF Generation
|
||||
pdf_generation: "guide/workflows/pdf-generation.md"
|
||||
pdf_generator_skill: "examples/skills/pdf-generator.md"
|
||||
whitepapers_example: "whitepapers/README.md"
|
||||
whitepapers_example: "whitepapers/README.md" # Local example only (gitignored)
|
||||
# Learning with AI (guide/learning-with-ai.md)
|
||||
learning_quick_check: "guide/learning-with-ai.md:31"
|
||||
learning_uval_protocol: "guide/learning-with-ai.md:127"
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue