diff --git a/CHANGELOG.md b/CHANGELOG.md index 1369c3f..9014272 100644 --- a/CHANGELOG.md +++ b/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 diff --git a/IDEAS.md b/IDEAS.md index ec02dc9..38bd8c7 100644 --- a/IDEAS.md +++ b/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 | diff --git a/README.md b/README.md index 0d742d0..f7b7a7d 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@

Stars Lines - Templates + Templates Quiz

@@ -16,6 +16,31 @@ Ask Zread

+
+πŸ“‘ Table of Contents + +**πŸ†• 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 + +
+ --- ## ⚑ 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 |
πŸ“‹ Minimal CLAUDE.md Template (click to expand & copy) @@ -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*