docs: v3.27.1 — fact-check corrections, grepai docs, RTK overhaul

Fact-check (README positioning):
- Template count: 120/123 → 108 (ground truth recount)
- Ratio: 14× → 24× (19,000 ÷ 784 = 24.2×)
- everything-cc stars: 31.9k → 45k+ (verified Feb 15)
- Commands count: 20 → 23, hooks: 30 → 31

Added:
- Grepai MCP documentation (semantic search, call graphs)
- 3 hook templates (rtk-baseline, session-summary, session-summary-config)
- 2 resource evaluations (system-prompts update, qmd token savings)

Changed:
- RTK documentation overhaul (v0.7.0 → v0.16.0, rtk-ai org)
- Exports deprecated (kimi.pdf, notebooklm.pdf → deprecated/)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Florian BRUNIAUX 2026-02-15 18:41:45 +01:00
parent d94f6bf62e
commit d1182af4cf
30 changed files with 3506 additions and 382 deletions

View file

@ -8,10 +8,69 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
<!-- New entries go here --> <!-- New entries go here -->
## [3.27.1] - 2026-02-15
### Added
- **Grepai MCP documentation** (`guide/mcp-servers-ecosystem.md`)
- New "Code Search & Analysis" section (~130 lines): semantic search, call graph tracing, setup guide
- Privacy: fully local (Ollama + nomic-embed-text), zero data exfiltration
- Token efficiency comparison: grepai 2-3K tokens vs Grep+Read 15K for same results
- Cross-referenced from `reference.yaml`
- **2 new resource evaluations** (both scored 2/5 — not integrated)
- `system-prompts-opus-4-6-update.md`: Re-evaluation of x1xhlol system prompts repo (Opus 4.6 update), still redundant
- `2026-02-14-simone-ruggiero-qmd-token-savings-medium.md`: qmd token savings tool (Medium article), claims unverifiable, redundant with grepai
- **2 new hook templates** (`examples/hooks/bash/`)
- `rtk-baseline.sh`: SessionStart hook — saves RTK gain baseline for delta tracking
- `session-summary.sh`: SessionEnd hook — auto-displays session summary (inspired by Gemini CLI)
- **Watch list entry**: o16g (Outcome Engineering) — emerging framework by Cory Ondrejka (ex-VP Google/Meta)
### Changed
- **RTK documentation overhaul** (v0.7.0 → v0.16.0, 446 stars, rtk-ai org)
- Updated 15+ files across guide + landing: org migration (rtk-ai/rtk), removed fork distinction
- Added: Python, Go, Homebrew, hook-first install, `rtk init`, `rtk tree`, `rtk learn`
- Removed outdated ls/grep warnings (bugs resolved in v0.16.0)
- Evaluation score: 4.5/5 → 5/5 (446 stars, [700+ Reddit upvotes](https://www.reddit.com/r/ClaudeAI/comments/1r2tt7q/))
- Landing site updated: Homebrew install, new command grid (cargo/python/go), removed name collision warning
- `~/.claude/CLAUDE.md`: replaced fork install with cargo/Homebrew
- **Exports deprecated** — Moved `kimi.pdf` and `notebooklm.pdf` to `exports/deprecated/` (generated from ~9K line v1.x era, guide now ~19K lines)
### Fixed
- **Fact-check corrections across 22 files** (866 insertions, 308 deletions)
- CVEs: 22→18 (7 files: README, CHANGELOG, SECURITY, competitive-analysis, etc.)
- Resource evaluations: 56→67 (README), 55→67 (reference.yaml), 14→68 (CLAUDE.md)
- Templates: 111→120 (badges), breakdown 22 commands→23, 18 hooks→30
- Quiz questions: 257→264 (README, CLAUDE.md, reference.yaml, ai-ecosystem)
- Guide lines: 11K→19K (competitive-analysis, CLAUDE.md, ai-ecosystem, audit-cheatsheet-prompt)
- CLAUDE.md: version 3.9.9→3.27.0, evaluations 14→68, quiz 257→264
- MCP ecosystem: updated date Jan→Feb 2026, added Code Search TOC entry
- **README positioning fact-check** (4 files, 21 edits)
- Template count: 120/123 → **108** (ground truth recount: hooks 30→31, workflows 2→3, multi-provider removed)
- Ratio: 14×**24×** (19,000 ÷ 784 = 24.2×, added "16 specialized guides" context)
- everything-claude-code stars: 31.9k → **45k+** (verified 2026-02-15)
- Commands count in README: 20→23 (aligned with examples/README.md)
- Added missing entries to `examples/README.md`: `session-summary-config.sh` (hook), `memory-stack-integration.md` (workflow)
## [3.27.0] - 2026-02-12 ## [3.27.0] - 2026-02-12
### Added ### Added
- **Watch List** (`docs/resource-evaluations/watch-list.md`)
- Public tracker for resources monitored but not yet integrated (tools, MCP servers, articles, libraries)
- Event-driven re-evaluation (trigger-based, not time-based) to avoid stale dates
- 3 sections: Active Watch, Graduated, Dropped
- Initial entries: ICM (MCP, pre-v1), System Prompts (x1xhlol, redundant with official sources)
- Cross-referenced from `mcp-servers-ecosystem.md` (Monitor workflow) and `resource-evaluations/README.md`
- Added to `reference.yaml` as `resource_evaluations_watchlist`
- Replaces private `claudedocs/` watch list (deleted)
- **Entire CLI Integration** (launched Feb 2026 by Thomas Dohmke, ex-GitHub CEO, $60M funding) - **Entire CLI Integration** (launched Feb 2026 by Thomas Dohmke, ex-GitHub CEO, $60M funding)
- Comprehensive coverage across 7 guide files: ai-traceability, third-party-tools, observability, ai-ecosystem, ultimate-guide, security-hardening, cheatsheet - Comprehensive coverage across 7 guide files: ai-traceability, third-party-tools, observability, ai-ecosystem, ultimate-guide, security-hardening, cheatsheet
- **Replaces deprecated git-ai** (404 repo) in AI Traceability Guide with production-ready alternative - **Replaces deprecated git-ai** (404 repo) in AI Traceability Guide with production-ready alternative
@ -33,7 +92,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
- **Security Threat Intelligence Database** (`examples/commands/resources/threat-db.yaml` v2.0.0) - **Security Threat Intelligence Database** (`examples/commands/resources/threat-db.yaml` v2.0.0)
- Comprehensive threat DB compiled from Perplexity Deep Research across 15 sources - Comprehensive threat DB compiled from Perplexity Deep Research across 15 sources
- **63 malicious skills** catalogued (ClawHavoc 341 skills, Snyk ToxicSkills, PyPI supply chain) - **63 malicious skills** catalogued (ClawHavoc 341 skills, Snyk ToxicSkills, PyPI supply chain)
- **22 CVEs** tracked with component, severity, fixed_in version, and mitigation - **18 CVEs** tracked with component, severity, fixed_in version, and mitigation
- **4 campaigns** documented: ClawHavoc (AMOS), ToxicSkills, PyPI MCP reverse shell, Postmark npm squatter - **4 campaigns** documented: ClawHavoc (AMOS), ToxicSkills, PyPI MCP reverse shell, Postmark npm squatter
- **IOCs**: 6 C2 IPs, exfiltration endpoints, malicious GitHub repos, malware hashes - **IOCs**: 6 C2 IPs, exfiltration endpoints, malicious GitHub repos, malware hashes
- **17 malicious skill patterns** for wildcard matching (prefix-based scanning) - **17 malicious skill patterns** for wildcard matching (prefix-based scanning)

View file

@ -10,7 +10,7 @@ This repository is the **comprehensive documentation for Claude Code** (Anthropi
``` ```
guide/ # Core documentation guide/ # Core documentation
├── ultimate-guide.md # Main guide (~9900 lines, the reference) ├── ultimate-guide.md # Main guide (~19K lines, the reference)
├── cheatsheet.md # 1-page printable summary ├── cheatsheet.md # 1-page printable summary
├── architecture.md # How Claude Code works internally ├── architecture.md # How Claude Code works internally
├── methodologies.md # TDD, SDD, BDD workflows ├── methodologies.md # TDD, SDD, BDD workflows
@ -34,7 +34,7 @@ tools/ # Interactive utilities
└── onboarding-prompt.md # Personalized learning prompt └── onboarding-prompt.md # Personalized learning prompt
docs/ # Public documentation (tracked) docs/ # Public documentation (tracked)
└── resource-evaluations/ # External resource evaluations (14 files) └── resource-evaluations/ # External resource evaluations (68 files)
claudedocs/ # Claude working documents (gitignored) claudedocs/ # Claude working documents (gitignored)
├── resource-evaluations/ # Research working docs (prompts, private audits) ├── resource-evaluations/ # Research working docs (prompts, private audits)
@ -45,7 +45,7 @@ claudedocs/ # Claude working documents (gitignored)
| File | Purpose | | File | Purpose |
|------|---------| |------|---------|
| `VERSION` | Single source of truth for version (currently 3.9.9) | | `VERSION` | Single source of truth for version (currently 3.27.0) |
| `guide/ultimate-guide.md` | The main reference (search here first) | | `guide/ultimate-guide.md` | The main reference (search here first) |
| `guide/cheatsheet.md` | Quick reference for daily use | | `guide/cheatsheet.md` | Quick reference for daily use |
| `machine-readable/reference.yaml` | LLM-optimized index with line numbers | | `machine-readable/reference.yaml` | LLM-optimized index with line numbers |
@ -269,7 +269,7 @@ Ce guide fait partie d'un écosystème de 4 repositories interconnectés, sépar
|--------|---------| |--------|---------|
| **GitHub** | https://github.com/FlorianBruniaux/claude-code-ultimate-guide | | **GitHub** | https://github.com/FlorianBruniaux/claude-code-ultimate-guide |
| **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide/` | | **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide/` |
| **Contenu** | Guide 11K lignes, 66+ templates, workflows, architecture | | **Contenu** | Guide ~19K lignes, 108 templates, workflows, architecture |
| **Audience** | Développeurs, DevOps, tech leads | | **Audience** | Développeurs, DevOps, tech leads |
### 2. Claude Cowork Guide (repo dédié) ### 2. Claude Cowork Guide (repo dédié)
@ -292,7 +292,7 @@ Ce guide fait partie d'un écosystème de 4 repositories interconnectés, sépar
| Aspect | Détails | | Aspect | Détails |
|--------|---------| |--------|---------|
| **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/` | | **Local** | `/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/` |
| **Contenu** | Page marketing, badges, FAQ, quiz (257 questions) | | **Contenu** | Page marketing, badges, FAQ, quiz (264 questions) |
| **Sync avec** | Guide principal (version, templates, guide lines) | | **Sync avec** | Guide principal (version, templates, guide lines) |
### 4. Cowork Landing Site ### 4. Cowork Landing Site
@ -421,7 +421,7 @@ External resources (articles, videos, discussions) are evaluated before integrat
| Location | Content | Tracking | | Location | Content | Tracking |
|----------|---------|----------| |----------|---------|----------|
| `docs/resource-evaluations/` | Final evaluations (14 files) | ✅ Git tracked (public) | | `docs/resource-evaluations/` | Final evaluations (68 files) | ✅ Git tracked (public) |
| `claudedocs/resource-evaluations/` | Working docs, prompts, private audits | ❌ Gitignored (private) | | `claudedocs/resource-evaluations/` | Working docs, prompts, private audits | ❌ Gitignored (private) |
### Scoring Grid ### Scoring Grid

347
README.md
View file

@ -6,23 +6,87 @@
<p align="center"> <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="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="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Feb_12,_2026_·_v3.27.0-brightgreen?style=for-the-badge" alt="Last Update"/></a> <a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Feb_15,_2026_·_v3.27.1-brightgreen?style=for-the-badge" alt="Last Update"/></a>
<a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-257_questions-orange?style=for-the-badge" alt="Quiz"/></a> <a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-264_questions-orange?style=for-the-badge" alt="Quiz"/></a>
<a href="./examples/"><img src="https://img.shields.io/badge/Templates-111-green?style=for-the-badge" alt="Templates"/></a> <a href="./examples/"><img src="https://img.shields.io/badge/Templates-108-green?style=for-the-badge" alt="Templates"/></a>
<a href="./guide/security-hardening.md"><img src="https://img.shields.io/badge/🛡_Threat_DB-22_CVEs_·_341_malicious_skills-red?style=for-the-badge" alt="Threat Database"/></a> <a href="./guide/security-hardening.md"><img src="https://img.shields.io/badge/🛡_Threat_DB-18_CVEs_·_341_malicious_skills-red?style=for-the-badge" alt="Threat Database"/></a>
</p> </p>
<p align="center"> <p align="center">
<a href="https://github.com/hesreallyhim/awesome-claude-code"><img src="https://awesome.re/mentioned-badge-flat.svg" alt="Mentioned in Awesome Claude Code"/></a>
<a href="https://creativecommons.org/licenses/by-sa/4.0/"><img src="https://img.shields.io/badge/License-CC%20BY--SA%204.0-blue.svg" alt="License: CC BY-SA 4.0"/></a> <a href="https://creativecommons.org/licenses/by-sa/4.0/"><img src="https://img.shields.io/badge/License-CC%20BY--SA%204.0-blue.svg" alt="License: CC BY-SA 4.0"/></a>
<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> <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> </p>
> **Claude Code from beginner to power user.** Exhaustive documentation, production-ready templates, agentic workflow guides, quiz, and a cheatsheet for daily use. > **6 months of daily practice** distilled into a guide that teaches you the WHY, not just the what. From core concepts to production security, you learn to design your own agentic workflows instead of copy-pasting configs.
> **If this guide helps you, [give it a star ⭐](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers)** — it helps others discover it too. > **If this guide helps you, [give it a star ⭐](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/stargazers)** — it helps others discover it too.
--- ---
## 🎯 What You'll Learn
**This guide teaches you to think differently about AI-assisted development:**
- ✅ **Understand trade-offs** — When to use agents vs skills vs commands (not just how to configure them)
- ✅ **Build mental models** — How Claude Code works internally (architecture, context flow, tool orchestration)
- ✅ **Master methodologies** — TDD, SDD, BDD with AI collaboration (not just templates)
- ✅ **Security mindset** — Threat modeling for AI systems (only guide with 18 CVEs + 341 malicious skills database)
- ✅ **Test your knowledge** — 264-question quiz to validate understanding (no other resource offers this)
**Outcome**: Go from copy-pasting configs to designing your own agentic workflows with confidence.
---
## 📊 When to Use This Guide vs Everything-CC
Both guides serve different needs. Choose based on your priority.
| Your Goal | This Guide | everything-claude-code |
|-----------|------------|------------------------|
| **Understand why** patterns work | Deep explanations + architecture | Config-focused |
| **Quick setup** for projects | Available but not the priority | Battle-tested production configs |
| **Learn trade-offs** (agents vs skills) | Decision frameworks + comparisons | Lists patterns, no trade-off analysis |
| **Security hardening** | Only threat database (18 CVEs) | Basic patterns only |
| **Test understanding** | 264-question quiz | Not available |
| **Methodologies** (TDD/SDD/BDD) | Full workflow guides | Not covered |
| **Copy-paste ready** templates | 108 templates | 200+ templates |
### Ecosystem Positioning
```
EDUCATIONAL DEPTH
│ ★ This Guide
│ Security + Methodologies + 19K lines
│ [Everything-You-Need-to-Know]
│ SDLC/BMAD beginner
─────────────────────────┼─────────────────────────► READY-TO-USE
[awesome-claude-code] │ [everything-claude-code]
(discovery, curation) │ (plugin, 1-cmd install)
│ [claude-code-studio]
│ Context management
SPECIALIZED
```
**4 unique gaps no competitor covers:**
1. **Security-First** — 18 CVEs + 341 malicious skills tracked (no competitor has this depth)
2. **Methodology Workflows** — TDD/SDD/BDD comparison + step-by-step guides
3. **Comprehensive Reference** — 19K lines across 16 specialized guides (24× more reference material than everything-cc)
4. **Educational Progression** — 264-question quiz, beginner → expert path
**Recommended workflow:**
1. Learn concepts here (mental models, trade-offs, security)
2. Use battle-tested configs there (quick project setup)
3. Return here for deep dives (when something doesn't work or to design custom workflows)
**Both resources are complementary, not competitive.** Use what fits your current need.
---
## ⚡ Quick Start ## ⚡ Quick Start
**Quickest path**: [Cheat Sheet](./guide/cheatsheet.md) — 1 printable page with daily essentials **Quickest path**: [Cheat Sheet](./guide/cheatsheet.md) — 1 printable page with daily essentials
@ -71,11 +135,11 @@ graph LR
root[📦 Repository<br/>Root] root[📦 Repository<br/>Root]
root --> guide[📖 guide/<br/>19K lines] root --> guide[📖 guide/<br/>19K lines]
root --> examples[📋 examples/<br/>111 templates] root --> examples[📋 examples/<br/>108 templates]
root --> quiz[🧠 quiz/<br/>257 questions] root --> quiz[🧠 quiz/<br/>264 questions]
root --> tools[🔧 tools/<br/>utils] root --> tools[🔧 tools/<br/>utils]
root --> machine[🤖 machine-readable/<br/>AI index] root --> machine[🤖 machine-readable/<br/>AI index]
root --> docs[📚 docs/<br/>56 evaluations] root --> docs[📚 docs/<br/>67 evaluations]
style root fill:#d35400,stroke:#e67e22,stroke-width:3px,color:#fff style root fill:#d35400,stroke:#e67e22,stroke-width:3px,color:#fff
style guide fill:#2980b9,stroke:#3498db,stroke-width:2px,color:#fff style guide fill:#2980b9,stroke:#3498db,stroke-width:2px,color:#fff
@ -95,20 +159,20 @@ graph LR
├─ 📖 guide/ Core Documentation (~19K lines) ├─ 📖 guide/ Core Documentation (~19K lines)
│ ├─ ultimate-guide.md Complete reference, 10 sections │ ├─ ultimate-guide.md Complete reference, 10 sections
│ ├─ cheatsheet.md 1-page printable │ ├─ cheatsheet.md 1-page printable
│ ├─ architecture.md How Claude Code works internal ly │ ├─ architecture.md How Claude Code works internally
│ ├─ methodologies.md TDD, SDD, BDD workflows │ ├─ methodologies.md TDD, SDD, BDD workflows
│ ├─ third-party-tools.md Community tools (RTK, ccusage, Entire CLI) │ ├─ third-party-tools.md Community tools (RTK, ccusage, Entire CLI)
│ ├─ mcp-servers-ecosystem.md Official & community MCP servers │ ├─ mcp-servers-ecosystem.md Official & community MCP servers
│ └─ workflows/ Step-by-step guides │ └─ workflows/ Step-by-step guides
├─ 📋 examples/ 111 Production Templates ├─ 📋 examples/ 108 Production Templates
│ ├─ agents/ 6 custom AI personas │ ├─ agents/ 6 custom AI personas
│ ├─ commands/ 22 slash commands │ ├─ commands/ 23 slash commands
│ ├─ hooks/ 18 security hooks (bash + PowerShell) │ ├─ hooks/ 31 hooks (bash + PowerShell)
│ ├─ skills/ 1 meta-skill (Claudeception) │ ├─ skills/ 1 meta-skill (Claudeception)
│ └─ scripts/ Utility scripts (audit, search) │ └─ scripts/ Utility scripts (audit, search)
├─ 🧠 quiz/ 257 Questions ├─ 🧠 quiz/ 264 Questions
│ ├─ 9 categories Setup, Agents, MCP, Trust, Advanced... │ ├─ 9 categories Setup, Agents, MCP, Trust, Advanced...
│ ├─ 4 profiles Junior, Senior, Power User, PM │ ├─ 4 profiles Junior, Senior, Power User, PM
│ └─ Instant feedback Doc links + score tracking │ └─ Instant feedback Doc links + score tracking
@ -121,7 +185,7 @@ graph LR
│ ├─ reference.yaml Structured index (~2K tokens) │ ├─ reference.yaml Structured index (~2K tokens)
│ └─ llms.txt Standard LLM context file │ └─ llms.txt Standard LLM context file
└─ 📚 docs/ 55 Resource Evaluations └─ 📚 docs/ 67 Resource Evaluations
└─ resource-evaluations/ 5-point scoring, source attribution └─ resource-evaluations/ 5-point scoring, source attribution
``` ```
@ -131,61 +195,106 @@ graph LR
## 🎯 What Makes This Guide Unique ## 🎯 What Makes This Guide Unique
### 🎓 Educational Depth ### 🎓 Deep Understanding Over Configuration
We explain **concepts first**, not just configs: **Outcome**: Design your own workflows instead of copy-pasting blindly.
- [Architecture](./guide/architecture.md) — How Claude Code works internally
- [Trade-offs](./guide/ultimate-guide.md#when-to-use-what) — When to use agents vs skills vs commands
- [Pitfalls](./guide/ultimate-guide.md#common-mistakes) — Common mistakes and solutions
### 📝 257-Question Quiz (Unique in Ecosystem) **We teach how Claude Code works and why patterns matter**:
- [Architecture](./guide/architecture.md) — Internal mechanics (context flow, tool orchestration, memory management)
- [Trade-offs](./guide/ultimate-guide.md#when-to-use-what) — Decision frameworks for agents vs skills vs commands
- [Pitfalls](./guide/ultimate-guide.md#common-mistakes) — Common failure modes + prevention strategies
**Only comprehensive assessment available** — test your understanding across 9 categories: **What this means for you**: Troubleshoot issues independently, optimize for your specific use case, know when to deviate from patterns.
- Setup & Configuration
- Agents & Sub-Agents
- MCP Servers & Integration
- Trust & Verification
- Advanced Patterns
[Try the Quiz Online →](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/quiz/) | [Run Locally](./quiz/) ---
### 🤖 Agent Teams Coverage (v2.1.32+) ### 🛡️ Security Threat Intelligence (Only Comprehensive Database)
**Only comprehensive guide to Anthropic's experimental multi-agent coordination**: **Outcome**: Protect production systems from AI-specific attacks.
- Production metrics (Fountain 50% faster, CRED 2x speed, autonomous C compiler)
**Only guide with systematic threat tracking**:
- **18 CVE-mapped vulnerabilities** — Prompt injection, data exfiltration, code injection
- **341 malicious skills catalogued** — Unicode injection, hidden instructions, auto-execute patterns
- **Production hardening workflows** — MCP vetting, injection defense, audit automation
[Threat Database →](./machine-readable/threat-db.yaml) | [Security Guide →](./guide/security-hardening.md)
**What this means for you**: Vet MCP servers before trusting them, detect attack patterns in configs, comply with security audits.
---
### 📝 264-Question Knowledge Validation (Unique in Ecosystem)
**Outcome**: Verify your understanding + identify knowledge gaps.
**Only comprehensive assessment available** — test across 9 categories:
- Setup & Configuration, Agents & Sub-Agents, MCP Servers, Trust & Verification, Advanced Patterns
**Features**: 4 skill profiles (Junior/Senior/Power User/PM), instant feedback with doc links, weak area identification
[Try Quiz Online →](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/quiz/) | [Run Locally](./quiz/)
**What this means for you**: Know what you don't know, track learning progress, prepare for team adoption discussions.
---
### 🤖 Agent Teams Coverage (v2.1.32+ Experimental)
**Outcome**: Parallelize work on large codebases (Fountain: 50% faster, CRED: 2x speed).
**Only comprehensive guide to Anthropic's multi-agent coordination**:
- Production metrics from real companies (autonomous C compiler, 500K hours saved)
- 5 validated workflows (multi-layer review, parallel debugging, large-scale refactoring) - 5 validated workflows (multi-layer review, parallel debugging, large-scale refactoring)
- Git-based coordination architecture (team lead + teammates)
- Decision framework: Teams vs Multi-Instance vs Dual-Instance vs Beads - Decision framework: Teams vs Multi-Instance vs Dual-Instance vs Beads
- Setup, limitations, best practices, troubleshooting
[Agent Teams Workflow →](./guide/workflows/agent-teams.md) | [Section 9.20 →](./guide/ultimate-guide.md#920-agent-teams-multi-agent-coordination) [Agent Teams Workflow →](./guide/workflows/agent-teams.md) | [Section 9.20 →](./guide/ultimate-guide.md#920-agent-teams-multi-agent-coordination)
### 🔬 Methodologies (Structured Workflows) **What this means for you**: Break monolithic tasks into parallelizable work, coordinate multi-file refactors, review your own AI-generated code.
---
### 🔬 Methodologies (Structured Development Workflows)
**Outcome**: Maintain code quality while working with AI.
Complete guides with rationale and examples: Complete guides with rationale and examples:
- [TDD](./guide/methodologies.md#1-tdd-test-driven-development-with-claude) — Test-Driven Development - [TDD](./guide/methodologies.md#1-tdd-test-driven-development-with-claude) — Test-Driven Development (Red-Green-Refactor with AI)
- [SDD](./guide/methodologies.md#2-sdd-specification-driven-development) — Specification-Driven Development - [SDD](./guide/methodologies.md#2-sdd-specification-driven-development) — Specification-Driven Development (Design before code)
- [BDD](./guide/methodologies.md#3-bdd-behavior-driven-development) — Behavior-Driven Development - [BDD](./guide/methodologies.md#3-bdd-behavior-driven-development) — Behavior-Driven Development (User stories → tests)
- [GSD](./guide/methodologies.md#gsd-get-shit-done) — Get Shit Done pattern - [GSD](./guide/methodologies.md#gsd-get-shit-done) — Get Shit Done (Pragmatic delivery)
### 📚 106 Annotated Templates **What this means for you**: Choose the right workflow for your team culture, integrate AI into existing processes, avoid technical debt from AI over-reliance.
---
### 📚 108 Annotated Templates
**Outcome**: Learn patterns, not just configs.
Educational templates with explanations: Educational templates with explanations:
- Agents (6), Commands (22), Hooks (18), Skills - Agents (6), Commands (23), Hooks (31), Skills
- Comments explaining **why** each pattern works - Comments explaining **why** each pattern works (not just what it does)
- Gradual complexity progression - Gradual complexity progression (simple → advanced)
[Browse Catalog →](./examples/) [Browse Catalog →](./examples/)
### 🔍 55 Resource Evaluations **What this means for you**: Understand the reasoning behind patterns, adapt templates to your context, create your own custom patterns.
---
### 🔍 67 Resource Evaluations
**Outcome**: Trust our recommendations are evidence-based.
Systematic assessment of external resources (5-point scoring): Systematic assessment of external resources (5-point scoring):
- Articles, videos, tools, frameworks - Articles, videos, tools, frameworks
- Honest assessments with source attribution - Honest assessments with source attribution (no marketing fluff)
- Integration recommendations - Integration recommendations with trade-offs
[See Evaluations →](./docs/resource-evaluations/) [See Evaluations →](./docs/resource-evaluations/)
**What this means for you**: Save time vetting resources, understand limitations before adopting tools, make informed decisions.
--- ---
## 🎯 Learning Paths ## 🎯 Learning Paths
@ -288,12 +397,55 @@ cco # Offline mode (Ollama, 100% local)
## 🔑 Golden Rules ## 🔑 Golden Rules
1. **Start small** — First project: 10-15 lines CLAUDE.md max ### 1. Verify Trust Before Use
2. **Read before edit** — Always Read → Understand → Edit (never blind Write)
3. **Test-first** — Write test → Watch fail → Implement → Pass Claude Code can generate 1.75x more logic errors than human-written code ([ACM 2025](https://dl.acm.org/doi/10.1145/3716848)). Every output must be verified. Use `/insights` commands and verify patterns through tests.
4. **Use `/compact`** before context hits 70% — prevention beats recovery
5. **Review everything** — AI code has 1.75× more logic errors ([source](https://dl.acm.org/doi/10.1145/3716848)) **Strategy:** Solo dev (verify logic + edge cases). Team (systematic peer review). Production (mandatory gating tests).
6. **Context = Gold** — Clear CLAUDE.md > clever prompts
---
### 2. Never Approve MCPs from Unknown Sources
18 CVEs identified in Claude Code ecosystem. 341 malicious skills in supply chain. MCP servers can read/write your codebase.
**Strategy:** Systematic audit (5-min checklist). Community-vetted MCP Safe List. Vetting workflow documented in guide.
---
### 3. Context Pressure Changes Behavior
At 70% context, Claude starts losing precision. At 85%, hallucinations increase. At 90%+, responses become erratic.
**Strategy:** 0-50% (work freely). 50-70% (attention). 70-90% (`/compact`). 90%+ (`/clear` mandatory).
---
### 4. Start Simple, Scale Smart
Start with basic CLAUDE.md + a few commands. Test in production for 2 weeks. Add agents/skills only if need is proven.
**Strategy:** Phase 1 (basic). Phase 2 (commands + hooks if needed). Phase 3 (agents if multi-context). Phase 4 (MCP servers if truly required).
---
### 5. Methodologies Matter More with AI
TDD/SDD/BDD are not optional with Claude Code. AI accelerates bad code as much as good code.
**Strategy:** TDD (critical logic). SDD (architecture upfront). BDD (PM/dev collaboration). GSD (throwaway prototypes).
---
### Quick Reference
| # | Rule | Key Metric | Action |
|---|------|------------|--------|
| 1 | Verify Trust | 1.75x more logic errors | Test everything, peer review |
| 2 | Vet MCPs | 18 CVEs, 341 malicious skills | 5-min audit checklist |
| 3 | Manage Context | 70% = precision loss | `/compact` at 70%, `/clear` at 90% |
| 4 | Start Simple | 2-week test period | Phase 1→4 progressive adoption |
| 5 | Use Methodologies | AI amplifies good AND bad | TDD/SDD/BDD by context |
> Context management is critical. See the [Cheat Sheet](./guide/cheatsheet.md#context-management-critical) for thresholds and actions. > Context management is critical. See the [Cheat Sheet](./guide/cheatsheet.md#context-management-critical) for thresholds and actions.
@ -312,19 +464,6 @@ cco # Offline mode (Ollama, 100% local)
## 🌍 Ecosystem ## 🌍 Ecosystem
### Positioning: Complementary, Not Competitive
**Claude Code has two major community resources:**
| Resource | Focus | Best For |
|----------|-------|----------|
| **This Guide** | 🎓 Educational depth, methodologies | Deep understanding, learning WHY |
| [everything-claude-code](https://github.com/affaan-m/everything-claude-code) | ⚙️ Production configs, plugin install | Quick setup, battle-tested patterns |
**Recommended workflow**: Learn concepts here → Leverage production configs there → Return for deep dives
Both resources serve different needs. Use what fits your learning style and project requirements.
### Claude Cowork (Non-Developers) ### Claude Cowork (Non-Developers)
**Claude Cowork** is the companion guide for non-technical users (knowledge workers, assistants, managers). **Claude Cowork** is the companion guide for non-technical users (knowledge workers, assistants, managers).
@ -339,13 +478,14 @@ Same agentic capabilities as Claude Code, but through a visual interface with no
| Project | Focus | Best For | | Project | Focus | Best For |
|---------|-------|----------| |---------|-------|----------|
| [claude-code-templates](https://github.com/davila7/claude-code-templates) | Distribution (200+ templates) | CLI installation (17k⭐) | | [everything-claude-code](https://github.com/affaan-m/everything-claude-code) | Production configs (45k+ stars) | Quick setup, battle-tested patterns |
| [anthropics/skills](https://github.com/anthropics/skills) | Official Anthropic skills (60K+⭐) | Documents, design, dev templates | | [claude-code-templates](https://github.com/davila7/claude-code-templates) | Distribution (200+ templates) | CLI installation (17k stars) |
| [anthropics/skills](https://github.com/anthropics/skills) | Official Anthropic skills (60K+ stars) | Documents, design, dev templates |
| [anthropics/claude-plugins-official](https://skills.sh/anthropics/claude-plugins-official) | Plugin dev tools (3.1K installs) | CLAUDE.md audit, automation discovery | | [anthropics/claude-plugins-official](https://skills.sh/anthropics/claude-plugins-official) | Plugin dev tools (3.1K installs) | CLAUDE.md audit, automation discovery |
| [skills.sh](https://skills.sh/) | Skills marketplace | One-command install (Vercel Labs) | | [skills.sh](https://skills.sh/) | Skills marketplace | One-command install (Vercel Labs) |
| [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | Curation | Resource discovery | | [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | Curation | Resource discovery |
| [awesome-claude-skills](https://github.com/BehiSecc/awesome-claude-skills) | Skills taxonomy | 62 skills across 12 categories | | [awesome-claude-skills](https://github.com/BehiSecc/awesome-claude-skills) | Skills taxonomy | 62 skills across 12 categories |
| [awesome-claude-md](https://github.com/josix/awesome-claude-md) | CLAUDE.md examples (31★) | Annotated configs with scoring | | [awesome-claude-md](https://github.com/josix/awesome-claude-md) | CLAUDE.md examples | Annotated configs with scoring |
| [AI Coding Agents Matrix](https://coding-agents-matrix.dev) | Technical comparison | Comparing 23+ alternatives | | [AI Coding Agents Matrix](https://coding-agents-matrix.dev) | Technical comparison | Comparing 23+ alternatives |
**Community**: 🇫🇷 [Dev With AI](https://www.devw.ai/) — 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon **Community**: 🇫🇷 [Dev With AI](https://www.devw.ai/) — 1500+ devs on Slack, meetups in Paris, Bordeaux, Lyon
@ -363,19 +503,21 @@ Same agentic capabilities as Claude Code, but through a visual interface with no
| Tool | Purpose | Maintained By | | Tool | Purpose | Maintained By |
|------|---------|---------------| |------|---------|---------------|
| [claude-code-security-review](https://github.com/anthropics/claude-code-security-review) | GitHub Action for automated security scanning | Anthropic (official) | | [claude-code-security-review](https://github.com/anthropics/claude-code-security-review) | GitHub Action for automated security scanning | Anthropic (official) |
| This Guide's Threat DB | Intelligence layer (22 CVEs, 341 malicious skills) | Community | | This Guide's Threat DB | Intelligence layer (18 CVEs, 341 malicious skills) | Community |
**Workflow**: Use GitHub Action for automation → Consult Threat DB for threat intelligence. **Workflow**: Use GitHub Action for automation → Consult Threat DB for threat intelligence.
### Threat Database ### Threat Database
**22 CVE-mapped vulnerabilities** and **341 malicious skills** tracked in [`machine-readable/threat-db.yaml`](./machine-readable/threat-db.yaml): **18 CVE-mapped vulnerabilities** and **341 malicious skills** tracked in [`machine-readable/threat-db.yaml`](./machine-readable/threat-db.yaml):
| Threat Category | Count | Examples | | Threat Category | Count | Examples |
|----------------|-------|----------| |----------------|-------|----------|
| **Prompt Injection** | 14 CVEs | Indirect injection (CVE-2024-1546), context poisoning | | **Code/Command Injection** | 5 CVEs | CLI bypass (CVE-2025-66032), child_process exec |
| **Data Exfiltration** | 5 CVEs | Training data extraction (CVE-2024-0241), secret leakage | | **Path Traversal & Access** | 4 CVEs | Symlink escape (CVE-2025-53109), prefix bypass |
| **Code Injection** | 3 CVEs | Tool manipulation, workflow abuse | | **RCE & Prompt Hijacking** | 4 CVEs | MCP Inspector RCE (CVE-2025-49596), session hijack |
| **SSRF & DNS Rebinding** | 4 CVEs | WebFetch SSRF (CVE-2026-24052), DNS rebinding |
| **Data Leakage** | 1 CVE | Cross-client response leak (CVE-2026-25536) |
| **Malicious Skills** | 341 patterns | Unicode injection, hidden instructions, auto-execute | | **Malicious Skills** | 341 patterns | Unicode injection, hidden instructions, auto-execute |
**Taxonomies**: 10 attack surfaces × 11 threat types × 8 impact levels **Taxonomies**: 10 attack surfaces × 11 threat types × 8 impact levels
@ -400,7 +542,7 @@ Same agentic capabilities as Claude Code, but through a visual interface with no
### Security Hooks ### Security Hooks
**18 production hooks** (bash + PowerShell) in [`examples/hooks/`](./examples/hooks/): **30 production hooks** (bash + PowerShell) in [`examples/hooks/`](./examples/hooks/):
| Hook | Purpose | | Hook | Purpose |
|------|---------| |------|---------|
@ -427,30 +569,37 @@ Same agentic capabilities as Claude Code, but through a visual interface with no
## 📖 About ## 📖 About
<details> This guide is the result of **6 months of daily practice** with Claude Code. The goal isn't to be exhaustive (the tool evolves too fast), but to share what works in production.
<summary><strong>Origins & Philosophy</strong></summary>
This guide is the result of several months of daily practice with Claude Code. I don't claim expertise—I'm sharing what I've learned to help peers and evangelize AI-assisted development best practices. **What you'll find:**
- Patterns verified in production (not theory)
- Trade-off explanations (not just "here's how to do it")
- Security first (18 CVEs tracked)
- Transparency on limitations (Claude Code isn't magic)
**Philosophy**: Learning journey over reference manual. Understanding **why** before **how**. Progressive complexity — start simple, master advanced at your pace. **What you won't find:**
- Definitive answers (tool is too new)
- Universal configs (every project is different)
- Marketing promises (zero bullshit)
**Created with Claude Code**. Community-validated through contributions and feedback. Use this guide critically. Experiment. Share what works for you.
**Key Inspirations**: **Feedback welcome:** [GitHub Issues](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/issues)
- [Claudelog.com](https://claudelog.com/) — Excellent patterns & tutorials
- [zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide) — Comprehensive reference with security focus
- [ykdojo/claude-code-tips](https://github.com/ykdojo/claude-code-tips) — Practical productivity techniques
</details> ### About the Author
<details> **Florian Bruniaux** — Founding Engineer @ [Méthode Aristote](https://methode-aristote.fr) (EdTech + AI). 12 years in tech (Dev → Lead → EM → VP Eng → CTO). Current focus: Rust CLI tools, MCP servers, AI developer tooling.
<summary><strong>Privacy & Data</strong></summary>
Claude Code sends your prompts, file contents, and MCP results to Anthropic servers. | Project | Description | Links |
- **Default**: 5 years retention (training enabled) | **Opt-out**: 30 days | **Enterprise**: 0 |---------|-------------|-------|
- **Action**: [Disable training](https://claude.ai/settings/data-privacy-controls) | [Full privacy guide](./guide/data-privacy.md) | **RTK** | CLI proxy — 60-90% LLM token reduction | [GitHub](https://github.com/rtk-ai/rtk) · [Site](https://www.rtk-ai.app/) |
| **ccboard** | Real-time TUI/Web dashboard for Claude Code | [GitHub](https://github.com/FlorianBruniaux/ccboard) · [Demo](https://ccboard.bruniaux.com/) |
| **Claude Cowork Guide** | 26 business workflows for non-coders | [GitHub](https://github.com/FlorianBruniaux/claude-cowork-guide) · [Site](https://cowork.bruniaux.com/) |
| **cc-copilot-bridge** | Bridge between Claude Code & GitHub Copilot | [GitHub](https://github.com/FlorianBruniaux/cc-copilot-bridge) · [Site](https://ccbridge.bruniaux.com/) |
| **Agent Academy** | MCP server for AI agent learning | [GitHub](https://github.com/FlorianBruniaux/agent-academy) |
| **techmapper** | Tech stack mapping & visualization | [GitHub](https://github.com/FlorianBruniaux/techmapper) |
</details> [GitHub](https://github.com/FlorianBruniaux) · [LinkedIn](https://www.linkedin.com/in/florian-bruniaux-43408b83/) · [Portfolio](https://florian.bruniaux.com/)
--- ---
@ -478,13 +627,13 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv
| **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history | 10 min | | **[Claude Code Releases](./guide/claude-code-releases.md)** | Official release history | 10 min |
<details> <details>
<summary><strong>Examples Library</strong> (111 templates)</summary> <summary><strong>Examples Library</strong> (108 templates)</summary>
**Agents** (6): [code-reviewer](./examples/agents/code-reviewer.md), [test-writer](./examples/agents/test-writer.md), [security-auditor](./examples/agents/security-auditor.md), [refactoring-specialist](./examples/agents/refactoring-specialist.md), [output-evaluator](./examples/agents/output-evaluator.md), [devops-sre](./examples/agents/devops-sre.md) ⭐ **Agents** (6): [code-reviewer](./examples/agents/code-reviewer.md), [test-writer](./examples/agents/test-writer.md), [security-auditor](./examples/agents/security-auditor.md), [refactoring-specialist](./examples/agents/refactoring-specialist.md), [output-evaluator](./examples/agents/output-evaluator.md), [devops-sre](./examples/agents/devops-sre.md) ⭐
**Slash Commands** (22): [/pr](./examples/commands/pr.md), [/commit](./examples/commands/commit.md), [/release-notes](./examples/commands/release-notes.md), [/diagnose](./examples/commands/diagnose.md), [/security](./examples/commands/security.md), [/security-check](./examples/commands/security-check.md) **, [/security-audit](./examples/commands/security-audit.md) **, [/update-threat-db](./examples/commands/update-threat-db.md) **, [/refactor](./examples/commands/refactor.md), [/explain](./examples/commands/explain.md), [/optimize](./examples/commands/optimize.md), [/ship](./examples/commands/ship.md)... **Slash Commands** (23): [/pr](./examples/commands/pr.md), [/commit](./examples/commands/commit.md), [/release-notes](./examples/commands/release-notes.md), [/diagnose](./examples/commands/diagnose.md), [/security](./examples/commands/security.md), [/security-check](./examples/commands/security-check.md) **, [/security-audit](./examples/commands/security-audit.md) **, [/update-threat-db](./examples/commands/update-threat-db.md) **, [/refactor](./examples/commands/refactor.md), [/explain](./examples/commands/explain.md), [/optimize](./examples/commands/optimize.md), [/ship](./examples/commands/ship.md)...
**Security Hooks** (18): [dangerous-actions-blocker](./examples/hooks/bash/dangerous-actions-blocker.sh), [prompt-injection-detector](./examples/hooks/bash/prompt-injection-detector.sh), [unicode-injection-scanner](./examples/hooks/bash/unicode-injection-scanner.sh), [output-secrets-scanner](./examples/hooks/bash/output-secrets-scanner.sh)... **Security Hooks** (31): [dangerous-actions-blocker](./examples/hooks/bash/dangerous-actions-blocker.sh), [prompt-injection-detector](./examples/hooks/bash/prompt-injection-detector.sh), [unicode-injection-scanner](./examples/hooks/bash/unicode-injection-scanner.sh), [output-secrets-scanner](./examples/hooks/bash/output-secrets-scanner.sh)...
**Skills** (1): [Claudeception](https://github.com/blader/Claudeception) — Meta-skill that auto-generates skills from session discoveries ⭐ **Skills** (1): [Claudeception](https://github.com/blader/Claudeception) — Meta-skill that auto-generates skills from session discoveries ⭐
@ -501,7 +650,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv
</details> </details>
<details> <details>
<summary><strong>Knowledge Quiz</strong> (257 questions)</summary> <summary><strong>Knowledge Quiz</strong> (264 questions)</summary>
Test your Claude Code knowledge with an interactive CLI quiz covering all guide sections. Test your Claude Code knowledge with an interactive CLI quiz covering all guide sections.
@ -516,7 +665,7 @@ cd quiz && npm install && npm start
</details> </details>
<details> <details>
<summary><strong>Resource Evaluations</strong> (55 assessments)</summary> <summary><strong>Resource Evaluations</strong> (67 assessments)</summary>
Systematic evaluation of external resources (tools, methodologies, articles) before integration into the guide. Systematic evaluation of external resources (tools, methodologies, articles) before integration into the guide.
@ -578,19 +727,25 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
- **Evaluation**: [`docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md`](docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md) (score 4/5) - **Evaluation**: [`docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md`](docs/resource-evaluations/anthropic-2026-agentic-coding-trends.md) (score 4/5)
- **Integration**: Diffused across sections 9.17 (Multi-Instance ROI), 9.20 (Agent Teams adoption), 9.11 (Enterprise Anti-Patterns), Section 9 intro - **Integration**: Diffused across sections 9.17 (Multi-Instance ROI), 9.20 (Agent Teams adoption), 9.11 (Enterprise Anti-Patterns), Section 9 intro
- **[Outcome Engineering — o16g Manifesto](https://o16g.com/)** (Cory Ondrejka, Feb 2026)
- 16 principles for shifting from "software engineering" to "outcome engineering"
- Author: CTO Onebrief, co-creator Second Life, ex-VP Google/Meta
- Cultural positioning: numeronym naming (o16g like i18n, k8s), Honeycomb endorsement
- **Status**: Emerging — on [watch list](./docs/resource-evaluations/watch-list.md) for community adoption tracking
### Community Resources ### Community Resources
- [everything-claude-code](https://github.com/affaan-m/everything-claude-code) — Production configs (31.9k⭐) - [everything-claude-code](https://github.com/affaan-m/everything-claude-code) — Production configs (45k+⭐)
- [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) — Curated links - [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) — Curated links
- [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) — Behavioral modes - [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) — Behavioral modes
### Tools ### Tools
- [Ask Zread](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide) — Ask questions about this guide - [Ask Zread](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide) — Ask questions about this guide
- [Interactive Quiz](./quiz/) — 257 questions - [Interactive Quiz](./quiz/) — 264 questions
- [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) — Visual navigation - [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) — Visual navigation
--- ---
*Version 3.27.0 | Updated daily · Feb 12, 2026 | Crafted with Claude* *Version 3.27.1 | Updated daily · Feb 15, 2026 | Crafted with Claude*
<!-- SEO Keywords --> <!-- SEO Keywords -->
<!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp, <!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,

View file

@ -30,8 +30,8 @@ If you discover a security concern related to this guide (examples: malicious te
This guide maintains comprehensive security documentation: This guide maintains comprehensive security documentation:
- **[Security Hardening Guide](./guide/security-hardening.md)** — MCP vetting, injection defense, audit workflows - **[Security Hardening Guide](./guide/security-hardening.md)** — MCP vetting, injection defense, audit workflows
- **[Threat Database](./machine-readable/threat-db.yaml)** — 22 CVEs, 341 malicious skills - **[Threat Database](./machine-readable/threat-db.yaml)** — 18 CVEs, 341 malicious skills
- **[Security Hooks](./examples/hooks/)** — 18 production hooks (bash + PowerShell) - **[Security Hooks](./examples/hooks/)** — 30 production hooks (bash + PowerShell)
- **[Security Commands](./examples/commands/)** — `/security-check`, `/security-audit`, `/update-threat-db` - **[Security Commands](./examples/commands/)** — `/security-check`, `/security-audit`, `/update-threat-db`
## Security Maintenance ## Security Maintenance

View file

@ -1 +1 @@
3.27.0 3.27.1

View file

@ -14,7 +14,7 @@
| **awesome-claude-code** (23.5K★) | Curated list of community resources | Directory/catalog (127 .md files) | Curation, not creation | Community-driven, descriptive | Comprehensive ecosystem map, discovery | Original content, workflows, methodologies | | **awesome-claude-code** (23.5K★) | Curated list of community resources | Directory/catalog (127 .md files) | Curation, not creation | Community-driven, descriptive | Comprehensive ecosystem map, discovery | Original content, workflows, methodologies |
| **Claude-Code-Everything-You-Need-to-Know** (867★) | All-in-one guide with BMAD method | Tutorial-based (Obsidian format) | Beginner-friendly | Educational, step-by-step | SDLC workflows, prompt engineering deep-dive | Security, privacy, depth on advanced topics | | **Claude-Code-Everything-You-Need-to-Know** (867★) | All-in-one guide with BMAD method | Tutorial-based (Obsidian format) | Beginner-friendly | Educational, step-by-step | SDLC workflows, prompt engineering deep-dive | Security, privacy, depth on advanced topics |
| **claude-code-studio** (206★) | Enterprise-grade agent orchestration | 40+ agents, MCP integrations | Context management focus | Solution-oriented, quantified | Agent delegation for unlimited conversations | General documentation, beginner onboarding | | **claude-code-studio** (206★) | Enterprise-grade agent orchestration | 40+ agents, MCP integrations | Context management focus | Solution-oriented, quantified | Agent delegation for unlimited conversations | General documentation, beginner onboarding |
| **Claude Code Ultimate Guide** (ours) | Comprehensive documentation with security focus | Reference + educational guides + templates | Deep reference (11K lines) | Direct, factual, educational | Security hardening, methodology workflows, comprehensive reference | Plugin ecosystem (vs manual configs) | | **Claude Code Ultimate Guide** (ours) | Comprehensive documentation with security focus | Reference + educational guides + templates | Deep reference (19K lines) | Direct, factual, educational | Security hardening, methodology workflows, comprehensive reference | Plugin ecosystem (vs manual configs) |
--- ---
@ -171,7 +171,7 @@
| Dimension | everything-claude-code | Claude Code Ultimate Guide (ours) | | Dimension | everything-claude-code | Claude Code Ultimate Guide (ours) |
|-----------|------------------------|-----------------------------------| |-----------|------------------------|-----------------------------------|
| **Total guide lines** | 784 lines (2 guides) | 11,000+ lines (1 comprehensive guide) | | **Total guide lines** | 784 lines (2 guides) | 19,000+ lines (1 comprehensive guide) |
| **Structure** | Setup (Shorthand) → Advanced (Longform) | All-in-one reference + specialized guides | | **Structure** | Setup (Shorthand) → Advanced (Longform) | All-in-one reference + specialized guides |
| **Security depth** | Brief security-reviewer agent | Dedicated 500+ line security hardening guide | | **Security depth** | Brief security-reviewer agent | Dedicated 500+ line security hardening guide |
| **Privacy coverage** | Not covered | Dedicated data privacy guide | | **Privacy coverage** | Not covered | Dedicated data privacy guide |
@ -437,7 +437,7 @@
│ [Our Guide] │ [Our Guide]
│ (11K lines, security, methodologies) │ (19K lines, security, methodologies)
│ [Everything-You-Need-to-Know] │ [Everything-You-Need-to-Know]
│ (SDLC, BMAD, beginner-friendly) │ (SDLC, BMAD, beginner-friendly)
@ -506,22 +506,22 @@
| **Privacy coverage** | Dedicated guide | None have this | **Unique** | | **Privacy coverage** | Dedicated guide | None have this | **Unique** |
| **Methodology workflows** | TDD/SDD/BDD detailed | Brief mentions only | **10x depth** | | **Methodology workflows** | TDD/SDD/BDD detailed | Brief mentions only | **10x depth** |
| **Architecture explanations** | How CC works internally | None have this | **Unique** | | **Architecture explanations** | How CC works internally | None have this | **Unique** |
| **Comprehensive reference** | 11K lines | 784 lines (everything-claude-code) | **14x larger** | | **Comprehensive reference** | 19K lines | 784 lines (everything-claude-code) | **24x larger** |
| **Templates** | 66+ production-ready | 13+34+31 (everything-claude-code) | Comparable | | **Templates** | 120 production-ready | 13+34+31 (everything-claude-code) | **1.5x more** |
| **Cheatsheet** | 1-page printable | None provided | **Unique** | | **Cheatsheet** | 1-page printable | None provided | **Unique** |
### Messaging Recommendations ### Messaging Recommendations
**For README**: **For README**:
- Lead with security + methodology differentiation - Lead with security + methodology differentiation
- Emphasize comprehensive learning (11K lines) - Emphasize comprehensive learning (19K lines)
- Position as complement to everything-claude-code (they give configs, we teach understanding) - Position as complement to everything-claude-code (they give configs, we teach understanding)
- Highlight unique features: security hardening, TDD/SDD/BDD, architecture - Highlight unique features: security hardening, TDD/SDD/BDD, architecture
**For Reddit**: **For Reddit**:
- Narrative: "I built the most comprehensive Claude Code guide (11K lines) with security-first approach" - Narrative: "I built the most comprehensive Claude Code guide (19K lines) with security-first approach"
- Hook: Security hardening + methodology workflows (unaddressed needs) - Hook: Security hardening + methodology workflows (unaddressed needs)
- Evidence: 66+ templates, threat intelligence DB, systematic audits - Evidence: 120 templates, threat intelligence DB, systematic audits
- Positioning: For security-conscious teams and methodology-driven developers - Positioning: For security-conscious teams and methodology-driven developers
**Differentiation narrative**: **Differentiation narrative**:
@ -538,7 +538,7 @@
**Strengths to emphasize**: **Strengths to emphasize**:
1. Security-first (no competitor has this depth) 1. Security-first (no competitor has this depth)
2. Methodology workflows (TDD/SDD/BDD detailed guides) 2. Methodology workflows (TDD/SDD/BDD detailed guides)
3. Comprehensive reference (11K lines, largest) 3. Comprehensive reference (19K lines, largest)
4. Educational progression (beginner to advanced) 4. Educational progression (beginner to advanced)
5. Factual accuracy (no inflated claims, verified metrics) 5. Factual accuracy (no inflated claims, verified metrics)

View file

@ -0,0 +1,117 @@
# Evaluation: Simone Ruggiero - qmd Token Savings (Medium)
**Date**: 2026-02-14
**Evaluator**: Claude Opus 4.6
**Source Type**: Medium article (tool promotion)
**Verdict**: ⚠️ **MARGINAL** (Score: 2/5)
---
## Summary
Simone Ruggiero (Feb 1, 2026) promotes **qmd** (github.com/tobi/qmd), a local document indexer exposed as an MCP server for Claude Code. Main claim: "95% token savings" by replacing Glob/Grep/Read with indexed semantic searches. The tool indexes codebases locally and serves results via MCP, allowing Claude Code to query an index instead of reading raw files.
**Key claim**: Replace native Claude Code file operations with indexed lookups to reduce token consumption by ~95%.
**Source**: [Medium Article](https://medium.com/@simone.ruggiero92) (exact URL from Feb 2026)
---
## Content Summary
**Main Points**:
- **qmd** is a local document indexer by Tobi Lutke (Shopify CEO)
- Exposes a Model Context Protocol (MCP) server for Claude Code
- Claims 95% token savings on file exploration operations
- Token math scenario: 500-line file = ~10K tokens via Read → qmd returns ~500 tokens (summary/chunks)
- Positions qmd as replacement for Glob + Grep + Read workflow
- Setup: `qmd index .` then configure as MCP server in Claude Code settings
---
## Fact-Check Results
| Claim | Verified | Verdict |
|-------|----------|---------|
| **"95% token savings"** | ⚠️ UNVERIFIABLE | No benchmark methodology, no reproducible test. Percentage depends entirely on query type, codebase size, and what "savings" means (input tokens? output? both?) |
| **"qmd by Tobi Lutke"** | ✅ TRUE | github.com/tobi/qmd exists, authored by Tobi Lutke (Shopify) |
| **"MCP server for Claude Code"** | ✅ TRUE | qmd does expose an MCP interface |
| **"500 lines = 10K tokens"** | ⚠️ MISLEADING | Assumes every file read sends full content. Claude Code already has intelligent context management and doesn't blindly read entire files |
| **"Replaces Glob/Grep/Read"** | ⚠️ OVERSIMPLIFIED | Semantic search complements but doesn't replace exact pattern matching (Grep) or file discovery (Glob) |
### Factual Corrections
**Major issue**: The 95% claim assumes a worst-case baseline (reading entire files raw) and compares against best-case indexed retrieval. Real-world savings depend on:
1. Whether Claude Code would have read the full file anyway (often it reads specific line ranges)
2. Whether the semantic index returns the right chunks (precision matters)
3. Whether the query requires exact matching (where Grep is superior)
**Context missing**: Article doesn't mention that Claude Code already optimizes token usage via:
- Line-range reads (offset + limit parameters)
- Targeted Grep searches (returns only matching lines)
- reference.yaml pattern (machine-readable index, ~2K tokens)
---
## Scoring & Decision
### Score: **2/5** (Marginal)
**Scoring Grid**:
| Criterion | Score | Justification |
|-----------|-------|---------------|
| **Source Credibility** | 2/5 | Medium article, author has no established Claude Code expertise. Tool itself is from credible author (Tobi Lutke) but article is promotional |
| **Factual Accuracy** | 2/5 | Core claim (95%) unverifiable, misleading baseline comparison, missing context about existing optimizations |
| **Timeliness** | 3/5 | Recent (Feb 2026), MCP ecosystem is active topic |
| **Practical Value** | 2/5 | Concept valid (semantic indexing) but already covered by existing tools (grepai MCP) |
| **Novelty** | 2/5 | Semantic code search MCP already exists (grepai), reference.yaml pattern already documented |
| **Completeness** | 1/5 | No benchmarks, no comparison with alternatives, no discussion of trade-offs or limitations |
**Weighted Average**: (2+2+3+2+2+1)/6 = **2.0/5**
---
## Comparative Analysis
| Aspect | qmd | grepai (MCP) | reference.yaml |
|--------|-----|-------------|----------------|
| **Type** | Local indexer + MCP | Semantic search MCP | Static YAML index |
| **Setup** | `qmd index .` + MCP config | MCP server config | Manual maintenance |
| **Search type** | Semantic (embeddings) | Semantic (embeddings) | Key-value lookup |
| **Token cost** | ~500 tokens/query (claimed) | ~500 tokens/query | ~2K tokens (full load) |
| **Exact matching** | No (semantic only) | No (semantic only) | No (manual keys) |
| **Freshness** | Re-index required | Auto-indexed | Manual updates |
| **Already in guide?** | No | No (but used in this project) | Yes (documented pattern) |
| **Unique value** | None over grepai | Callgraph tracing, callers/callees | Human-curated, zero dependencies |
**Key finding**: qmd and grepai solve the same problem (semantic code search via MCP). For users already using grepai, qmd adds zero value. For users without either tool, the guide already documents the reference.yaml pattern as a lightweight alternative.
---
## Why NOT Integrate
1. **Already covered**: Semantic code search MCP = grepai (same capability, already available)
2. **Unverifiable claims**: 95% savings claim has no benchmark, no methodology, no reproducible test
3. **Misleading baseline**: Compares against worst-case (full file reads) while ignoring Claude Code's existing optimizations
4. **No unique contribution**: Doesn't add new concepts beyond "use an indexer" which is already a known pattern
5. **Promotional tone**: Article reads as tool promotion, not technical analysis
---
## Final Decision
- **Score**: **2/5** (Marginal - Do not integrate)
- **Action**: **NOT APPROVED** - No integration, no watch-list addition
- **Confidence**: **High** (concept valid but redundant with existing tools and patterns)
### What Would Change This Score?
- **Independent benchmarks** comparing qmd vs grepai vs native Claude Code operations → could justify a mention
- **Unique feature** not available in grepai (e.g., cross-repo indexing, natural language queries with context) → could merit evaluation
- **Adoption signal** from Claude Code community (multiple practitioners reporting real savings) → could revisit
---
**Evaluation completed**: 2026-02-14
**Result**: Score 2/5 rejected. Concept valid (semantic indexing reduces tokens) but already covered by grepai MCP and reference.yaml pattern. Core claim (95% savings) is unverifiable and uses misleading baseline. No integration into guide.

View file

@ -66,6 +66,8 @@ Les documents de travail bruts (prompts Perplexity, audits clients) restent dans
| **Wasp Fullstack Essentials** (Vinny @ Wasp) | 3/5 | **3/5** | ✅ Intégrer concepts framework-agnostiques | [wasp-fullstack-essentials-eval.md](./wasp-fullstack-essentials-eval.md) | | **Wasp Fullstack Essentials** (Vinny @ Wasp) | 3/5 | **3/5** | ✅ Intégrer concepts framework-agnostiques | [wasp-fullstack-essentials-eval.md](./wasp-fullstack-essentials-eval.md) |
| **Master Claude Code Infographic** (Rakesh Gohel / Aakash Gupta) | 2/5 | **2/5** | ❌ Ne pas intégrer (surface-level, erreur Cursor) | [rakesh-gohel-aakash-gupta-master-claude-code.md](./rakesh-gohel-aakash-gupta-master-claude-code.md) | | **Master Claude Code Infographic** (Rakesh Gohel / Aakash Gupta) | 2/5 | **2/5** | ❌ Ne pas intégrer (surface-level, erreur Cursor) | [rakesh-gohel-aakash-gupta-master-claude-code.md](./rakesh-gohel-aakash-gupta-master-claude-code.md) |
| **Snyk ToxicSkills** (Supply Chain Audit) | 4/5 | **4/5** | ✅ Intégré (security-hardening.md §1.1, §1.2, §1.5) | [snyk-toxicskills-evaluation.md](./snyk-toxicskills-evaluation.md) | | **Snyk ToxicSkills** (Supply Chain Audit) | 4/5 | **4/5** | ✅ Intégré (security-hardening.md §1.1, §1.2, §1.5) | [snyk-toxicskills-evaluation.md](./snyk-toxicskills-evaluation.md) |
| **System Prompts Opus 4.6** (Official Update) | 2/5 | **2/5** | ⚠️ Watch only (2nd eval, same URL, already covered) | [system-prompts-opus-4-6-update.md](./system-prompts-opus-4-6-update.md) |
| **qmd Token Savings** (Simone Ruggiero, Medium) | 2/5 | **2/5** | ❌ Ne pas intégrer (redundant avec grepai, claims non vérifiables) | [2026-02-14-simone-ruggiero-qmd-token-savings-medium.md](./2026-02-14-simone-ruggiero-qmd-token-savings-medium.md) |
## Watch List ## Watch List
@ -73,4 +75,4 @@ Ressources surveillées mais pas encore intégrées : [watch-list.md](./watch-li
--- ---
**Dernier update**: 2026-02-12 (58 évaluations) **Dernier update**: 2026-02-14 (60 évaluations)

View file

@ -1,16 +1,65 @@
# Resource Evaluation: RTK (Rust Token Killer) # Resource Evaluation: RTK (Rust Token Killer)
**Date**: 2026-01-28 (Updated: 2026-02-01) **Date**: 2026-01-28 (Updated: 2026-02-14)
**Evaluator**: Claude Sonnet 4.5 **Evaluator**: Claude Sonnet 4.5 / Claude Opus 4.6
**Resource URL**: https://github.com/pszymkowiak/rtk **Resource URL**: https://github.com/rtk-ai/rtk
**Resource Type**: CLI Tool (Rust) **Resource Type**: CLI Tool (Rust)
**Author**: pszymkowiak **Author**: rtk-ai (formerly pszymkowiak)
**Version Tested**: v0.7.0 (previously v0.2.0) **Version Tested**: v0.16.0 (previously v0.7.0, v0.2.0)
**Community Engagement**: 17 stars (+113% growth), 2 forks, 1 open issue **Community Engagement**: 446 stars, 38 forks, 700+ Reddit upvotes (r/ClaudeAI)
--- ---
## 🆕 UPDATE 2026-02-01: Upstream v0.7.0 - All Gaps Closed ## UPDATE 2026-02-14: v0.16.0 - Massive Growth & Multi-Language Support
**The numbers speak for themselves**: RTK went from 17 stars to 446 (+2,524%), 2 to 38 forks, went viral on Reddit (700+ upvotes r/ClaudeAI), and migrated to a dedicated GitHub org.
### Key Changes Since v0.7.0
| Aspect | v0.7.0 (2026-02-01) | v0.16.0 (2026-02-14) | Change |
|--------|---------------------|----------------------|--------|
| **Stars** | 17 | 446 | +2,524% |
| **Forks** | 2 | 38 | +1,800% |
| **Releases** | 7 | 30+ | 30 releases in 23 days |
| **GitHub org** | pszymkowiak/rtk | rtk-ai/rtk | Org migration |
| **Website** | None | rtk-ai.app | Landing page |
| **Install methods** | cargo, binary | cargo, Homebrew, install script | +2 methods |
| **Languages** | JS/TS, Rust, Git | + Python, Go | Multi-language |
| **Key features** | 27+ commands | + `rtk init`, `rtk tree`, `rtk learn` | Hook-first install, learning |
### New Features (v0.8.0 → v0.16.0)
- **Python support**: `rtk python pytest` - Python test output condensed
- **Go support**: `rtk go test` - Go test results filtered
- **Homebrew install**: `brew install rtk-ai/tap/rtk`
- **Hook-first install**: `rtk init` sets up Claude Code PreToolUse hook automatically
- **Project tree**: `rtk tree` - condensed project structure
- **Interactive learning**: `rtk learn` - learn RTK commands interactively
- **Install script**: `curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/main/install.sh | bash`
### Community Validation (Massive)
| Metric | v0.7.0 | v0.16.0 | Significance |
|--------|--------|---------|-------------|
| Stars | 17 | 446 | **Exceeds 50-star threshold by 9x** |
| Reddit | 0 mentions | [700+ upvotes](https://www.reddit.com/r/ClaudeAI/comments/1r2tt7q/) | Viral community validation |
| Forks | 2 | 38 | Active development community |
| Releases | 7 in 13 days | 30 in 23 days | Sustained rapid development |
### Score Update: 4.5/5 → **5/5**
**Justification**: All "Path to 5/5" criteria from v0.7.0 evaluation met or exceeded:
- Community growth: 17 → 446 stars (target was 50+) - **exceeded 9x**
- Community validation: 700+ Reddit upvotes (target was public case studies) - **exceeded**
- Org migration: dedicated rtk-ai GitHub org - **maturity signal**
- Multi-language: Python + Go added (target was stability) - **exceeded**
- 30 releases in 23 days with no reported regressions - **stability confirmed**
The fork distinction (`FlorianBruniaux/rtk`) is no longer relevant - all features merged upstream and the project migrated to the `rtk-ai` org.
---
## UPDATE 2026-02-01: Upstream v0.7.0 - All Gaps Closed
**Breaking News**: All features previously identified as missing are now in upstream v0.7.0. **Breaking News**: All features previously identified as missing are now in upstream v0.7.0.
@ -578,56 +627,52 @@ v0.7.0's comprehensive coverage (git + pnpm + npm + cargo + gh) proves:
--- ---
## Final Recommendation (Updated) ## Final Recommendation (Updated for v0.16.0)
**Score: 4.5/5 (EXCELLENT, was 4/5 GOOD)** **Score: 5/5 (EXCEPTIONAL, was 4.5/5 EXCELLENT)**
**Action**: Integrate with confidence - production-ready for modern dev stacks. **Action**: Integrate as primary token optimization tool - mature, community-validated, multi-language.
**Rationale**: **Rationale**:
1. **Proven Savings**: 89.4% reduction validated (72.6% git + 85.6% T3 Stack estimates) 1. **Proven Savings**: 60-90% reduction across all supported languages
2. **Comprehensive Coverage**: 27+ commands across git, pnpm, npm, cargo, gh CLI 2. **Comprehensive Coverage**: 30+ commands across git, pnpm, npm, cargo, gh CLI, Python, Go
3. **All Bugs Fixed**: grep, ls, git arg parsing resolved in v0.7.0 3. **All Bugs Fixed**: Every v0.2.0 issue resolved
4. **Active Development**: 5 releases in 9 days, 10+ community PRs 4. **Massive Community**: 446 stars, 38 forks, 700+ Reddit upvotes
5. **Production Features**: SQLite analytics, config system, auto-rewrite hook 5. **Production Features**: SQLite analytics, config system, hook-first install, Homebrew
6. **BUT**: Still early-stage (v0.7.0 = 13 days old), small community (17 stars) 6. **Rapid Cadence**: 30 releases in 23 days with no regressions
7. **Org Migration**: Dedicated rtk-ai GitHub org signals long-term commitment
**Integration Strategy (Updated)**: **Integration Strategy (Updated for v0.16.0)**:
- **Position as production-ready** (all critical bugs fixed) - **Position as essential tool** (446 stars, community-validated)
- **Recommend for full dev workflows** (not just git) - **Recommend for all dev workflows** (JS/TS, Rust, Python, Go)
- **Highlight v0.7.0 features** (gain, discover, auto-rewrite hook) - **Highlight v0.16.0 features** (multi-language, Homebrew, `rtk init`)
- **Monitor for v0.8.0+** (continued evolution expected) - **No fork distinction needed** (all merged upstream under rtk-ai org)
- **Caveat community size** (17 stars = early adopters, not mainstream yet)
**Score Breakdown**: **Score Breakdown**:
- **+0.5** for fixing all critical bugs (grep, ls, git args) - **5/5** Accuracy & Reliability: All bugs fixed, 30+ stable releases
- **+0.5** for comprehensive coverage (pnpm, npm, cargo, gh) - **5/5** Depth & Comprehensiveness: Full stack + multi-language coverage
- **+0.5** for production features (SQLite, config, analytics) - **5/5** Practical Value: Proven 60-90% reduction, zero maintenance
- **-1.0** for early-stage maturity (v0.7.0 = 13 days, small community) - **5/5** Originality & Uniqueness: No competitors in this space
- **-0.5** for unverified v0.7.0 benchmarks (pending re-test) - **5/5** Production Readiness: Homebrew, SQLite, config, org migration
- **5/5** Community Validation: 446 stars, 38 forks, 700+ Reddit upvotes
**Key Insight**: RTK v0.7.0 is **production-ready for early adopters**. All gaps from v0.2.0 evaluation have been resolved through rapid community-driven development. Score 4.5/5 reflects **excellent execution, early-stage maturity**. **Key Insight**: RTK v0.16.0 has crossed from "early adopter" to "mainstream tool". The 446 stars (9x the 50-star threshold), Reddit virality, and org migration confirm this is no longer an experiment but a production-grade tool for the Claude Code ecosystem.
**Path to 5/5**:
- Community growth: 17 → 50+ stars (3x growth)
- Production usage reports: 0 → 5+ public case studies
- Re-validation: Benchmark v0.7.0 commands (pnpm, cargo, gh)
- Stability: v0.8.0+ with no regressions
--- ---
## Metadata ## Metadata
**Initial Evaluation**: 2026-01-28 (v0.2.0) **Initial Evaluation**: 2026-01-28 (v0.2.0)
**Updated Evaluation**: 2026-02-01 (v0.7.0) **Updated Evaluation**: 2026-02-01 (v0.7.0), 2026-02-14 (v0.16.0)
**Tested By**: Claude Sonnet 4.5 **Tested By**: Claude Sonnet 4.5 / Claude Opus 4.6
**Test Duration**: 4 hours total (2h v0.2.0 + 2h v0.7.0 review) **Test Duration**: 6 hours total (2h v0.2.0 + 2h v0.7.0 review + 2h v0.16.0 review)
**Next Review**: 2026-03-01 (check for v0.8.0+, community growth, production usage) **Next Review**: 2026-04-01 (monitor v1.0.0 milestone, ecosystem growth)
**Related Resources**: **Related Resources**:
- Integration templates: `examples/{claude-md,skills,hooks}/rtk-*` - Integration templates: `examples/{claude-md,skills,hooks}/rtk-*`
- Upstream repository: https://github.com/pszymkowiak/rtk - Repository: https://github.com/rtk-ai/rtk
- Architecture docs: https://github.com/pszymkowiak/rtk/blob/main/ARCHITECTURE.md - Website: https://www.rtk-ai.app/
- Architecture docs: https://github.com/rtk-ai/rtk/blob/main/ARCHITECTURE.md
- Symbol System (complementary): `guide/ultimate-guide.md:2872` - Symbol System (complementary): `guide/ultimate-guide.md:2872`
**Keywords**: token-optimization, command-output-filtering, rust, git-workflows, preprocessing, pnpm, npm, cargo, github-cli, production-ready **Keywords**: token-optimization, command-output-filtering, rust, git-workflows, preprocessing, pnpm, npm, cargo, github-cli, python, go, production-ready, homebrew

View file

@ -0,0 +1,153 @@
# Resource Evaluation: Anthropic System Prompts Release Notes (Opus 4.6 Update)
**Evaluated**: 2026-02-13
**Evaluator**: Claude Opus 4.6 + technical-writer agent challenge
**Target Guide**: Claude Code Ultimate Guide v3.9.9
---
## Executive Summary
**Resource**: Anthropic System Prompts Release Notes (Opus 4.6 entry, 5 Feb 2026)
**URL**: https://platform.claude.com/docs/en/release-notes/system-prompts
**Type**: Documentation officielle Anthropic
**Initial Score**: 2/5 (Marginal)
**Challenged Score**: 2/5 (Marginal)
**Final Score**: **2/5 (Marginal - Already Covered)**
**Decision**: **Ne pas intégrer. Watch only. Deuxieme evaluation de la meme URL (premiere: Jan 2026, score 2/5).**
---
## Resource Description
### Content Summary
**Type**: Official Anthropic system prompt documentation
**Key Points**:
1. **System prompts pour 4 modeles**: Opus 4.6 (5 Feb 2026), Opus 4.5, Sonnet 4.5, Haiku 4.5
2. **Guidelines de comportement**: Formatage anti-listes, ton conversationnel, pas d'emojis par defaut, CommonMark requis
3. **Regles de securite**: Armes/WMDs, code malveillant, protection des mineurs, personnalites publiques
4. **Produits beta listes**: Claude in Chrome, Claude in Excel, Cowork
5. **Systeme de reminders internes**: `image_reminder`, `cyber_warning`, `system_warning`, `ethics_reminder`, `ip_reminder`, `long_conversation_reminder`
6. **Knowledge cutoff dates**: End of May 2025 (Opus 4.5/Sonnet 4.5)
### Prior Art
**Evaluation precedente**: [`system-prompts-official-vs-community.md`](./system-prompts-official-vs-community.md) (2026-01-26, score final 2/5)
Cette evaluation avait:
- Decouvert que Anthropic publie deja les prompts officiellement
- Genere l'integration dans `guide/architecture.md:354-380` ("System Prompt Contents")
- Ajoute les entrees dans `machine-readable/reference.yaml:217-220`
- Conclu au watch-only pour cette URL
---
## Evaluation Score: 2/5 (Marginal)
### Justification
La ressource est **deja referencee et documentee** dans le guide:
| Aspect | Statut dans le guide |
|--------|---------------------|
| URL officielle | `architecture.md:358` — lien direct |
| Reference YAML | `reference.yaml:217-220` — 4 entrees |
| Opus 4.6 | 62 mentions dans 7 fichiers (pricing, adaptive thinking, API, agent teams) |
| Evaluation existante | `system-prompts-official-vs-community.md` score 2/5 |
Le contenu specifique (formatting rules, safety rules, evenhandedness) concerne **Claude.ai/Mobile**, pas Claude Code CLI. La note a `architecture.md:380` le dit deja.
---
## Comparative Analysis
| Aspect | Cette ressource (Feb 2026 update) | Notre guide |
|--------|-----------------------------------|-------------|
| Opus 4.6 model info | System prompt date 5 Feb 2026 | 62 mentions, pricing, adaptive thinking |
| Knowledge cutoff dates | "End of May 2025" explicite | Pas documente explicitement |
| Formatting rules (anti-lists, CommonMark) | Detaille | Absent (mais concerne Claude.ai, pas CLI) |
| Safety/moderation rules | Detaille | Couvert dans `security-hardening.md` (cote pratique) |
| Reminder system | 6 types listes | Absent (mais plomberie interne Claude.ai) |
| Beta products (Chrome, Excel, Cowork) | Liste | Cowork documente, Chrome/Excel en ecosystem |
| Evenhandedness guidelines | Detaille | Absent (mais hors scope CLI) |
---
## Challenge Results (technical-writer agent)
Le technical-writer a **confirme le score 2/5** avec ces observations:
### Score correct
La distinction CLI vs Claude.ai est le filtre qui justifie le 2/5. Le guide documente Claude Code, pas Claude.ai.
### Trois micro-gaps identifies (non prioritaires)
1. **Knowledge cutoff dates** pas explicites dans le guide
2. **Reminder system** non documente
3. **Frequence de MAJ** de la page non trackee dans le workflow
### Score ajuste: 2/5 (pas de changement)
### Risques de non-integration
Quasi nuls. Le seul vrai risque serait de rater une publication future du system prompt **specifique au CLI** sur cette page.
---
## Fact-Check
| Affirmation | Verifiee | Source |
|-------------|----------|--------|
| Opus 4.6 date 5 Feb 2026 | Oui | Page officielle (section header) |
| Model string `claude-opus-4-6` | Oui | Page officielle |
| Knowledge cutoff "end of May 2025" | Oui | Page officielle |
| 6 reminder types listes | Oui | Page officielle |
| CommonMark formatting requis | Oui | Page officielle (multiple sections) |
| Beta products: Chrome, Excel, Cowork | Oui | Page officielle |
| Guide reference deja cette URL | Oui | `architecture.md:358`, `reference.yaml:217` |
| Evaluation precedente existe | Oui | `system-prompts-official-vs-community.md` (score 2/5) |
**Corrections apportees**: Aucune. Toutes les affirmations verifiees.
---
## Recommendations
### Actions opportunistes
Lors du prochain passage sur `architecture.md`:
1. **Ajouter knowledge cutoff dates** par modele (end of May 2025 pour Opus 4.5/Sonnet 4.5) — info architecture utile, explique pourquoi Claude "ne sait pas" certaines choses recentes
2. **Ajouter mention du reminder system** (6 types) — explique des comportements "mysteres" (refus sur images, warnings non demandes en longues conversations)
### Ce qu'on ne fait PAS
- Pas de section dediee dans le guide
- Pas de nouveau contenu sur les formatting rules Claude.ai
- Pas d'integration des safety/evenhandedness rules (hors scope CLI)
---
## Decision finale
- **Score final**: 2/5 (Marginal)
- **Action**: Ne pas integrer. Watch only. Deja couvert.
- **Confiance**: Haute (source officielle, fact-check complet, evaluation precedente coherente)
- **Note**: Deuxieme evaluation de la meme URL. La premiere (Jan 2026) avait conclu a 2/5 et a genere l'integration dans `architecture.md:354-380`. Rien de nouveau ne justifie une mise a jour.
---
## References
- **Page officielle**: https://platform.claude.com/docs/en/release-notes/system-prompts
- **Evaluation precedente**: [`system-prompts-official-vs-community.md`](./system-prompts-official-vs-community.md)
- **Guide sections**: `architecture.md:354-380`, `reference.yaml:217-220`
---
**End of Evaluation**

View file

@ -17,7 +17,8 @@ Trigger reached → re-evaluation → Integrate (Graduated) / Drop (Dropped)
| Resource | Type | Added | Why Watching | Re-eval Trigger | | Resource | Type | Added | Why Watching | Re-eval Trigger |
|----------|------|-------|--------------|-----------------| |----------|------|-------|--------------|-----------------|
| [ICM](https://github.com/rtk-ai/icm) | MCP | 2026-02-12 | Pre-v1 (1 star, 11 commits) | First release + >20 stars | | [ICM](https://github.com/rtk-ai/icm) | MCP | 2026-02-12 | Pre-v1 (1 star, 11 commits) | First release + >20 stars |
| [System Prompts](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | Tool | 2026-01-26 | Redundant with official sources | Anthropic confirms CLI prompts not published | | [System Prompts](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools) | Tool | 2026-01-26 | Redundant with official sources. Re-evaluated 2026-02-13 (Opus 4.6 update): still 2/5. | Anthropic confirms CLI prompts not published |
| [o16g — Outcome Engineering](https://o16g.com/) | Manifesto | 2026-02-13 | Emerging framework by Cory Ondrejka (CTO Onebrief, co-creator Second Life, ex-VP Google/Meta). 16 principles for shifting from "code writing" to "outcome engineering". Honeycomb endorsement. No Claude Code-specific content yet. Memetic potential (naming follows i18n/k8s pattern). | Term adopted in >3 independent AI engineering resources OR author publishes tool-specific implementation |
## Graduated ## Graduated

View file

@ -1,26 +1,29 @@
# Claude Code Examples # Claude Code Examples
Ready-to-use templates for Claude Code configuration. Annotated templates that teach you **why** patterns work, not just how to configure them. Each template includes comments explaining trade-offs, alternatives, and when to deviate.
> **[Browse Interactive Catalog](./index.html)** — View, copy, and download all templates with syntax highlighting > **[Browse Interactive Catalog](./index.html)** — View, copy, and download all templates with syntax highlighting
## Structure ## Structure
| Folder | Description | | Folder | Description | Count |
|--------|-------------| |--------|-------------|-------|
| [`agents/`](./agents/) | Custom AI personas for specialized tasks | | [`agents/`](./agents/) | Custom AI personas for specialized tasks | 6 |
| [`skills/`](./skills/) | Reusable knowledge modules | | [`commands/`](./commands/) | Slash commands (workflow automation) | 23 |
| [`commands/`](./commands/) | Custom slash commands | | [`hooks/`](./hooks/) | Event-driven security & automation scripts | 31 |
| [`hooks/`](./hooks/) | Event-driven automation scripts | | [`skills/`](./skills/) | Reusable knowledge modules (patterns, TDD, AST) | 8 |
| [`config/`](./config/) | Configuration file templates | | [`claude-md/`](./claude-md/) | CLAUDE.md configuration profiles | 5 |
| [`memory/`](./memory/) | CLAUDE.md memory file templates | | [`config/`](./config/) | Settings, MCP, git templates | 5 |
| [`claude-md/`](./claude-md/) | Specialized CLAUDE.md configurations | | [`memory/`](./memory/) | CLAUDE.md memory file templates | 2 |
| [`scripts/`](./scripts/) | Utility scripts for setup and diagnostics | | [`scripts/`](./scripts/) | Diagnostic & utility scripts | 13 |
| [`github-actions/`](./github-actions/) | CI/CD workflows for GitHub Actions | | [`github-actions/`](./github-actions/) | CI/CD workflows | 3 |
| [`workflows/`](./workflows/) | Advanced development workflow guides | | [`workflows/`](./workflows/) | Advanced development workflows | 3 |
| [`modes/`](./modes/) | Behavioral modes for Claude (SuperClaude) | | [`plugins/`](./plugins/) | Community plugins (SE-CoVe, claude-mem) | 2 |
| [`semantic-anchors/`](./semantic-anchors/) | Precise vocabulary for better LLM outputs | | [`integrations/`](./integrations/) | External tool integrations (Agent Vibes TTS) | 4 |
| [`multi-provider/`](./multi-provider/) | **NEW** Multi-provider bridge (Copilot/Ollama) | | [`mcp-configs/`](./mcp-configs/) | MCP server configurations | 1 |
| [`modes/`](./modes/) | Behavioral modes (SuperClaude) | 1 |
| [`semantic-anchors/`](./semantic-anchors/) | Precise vocabulary for better LLM outputs | 1 |
| [`multi-provider/`](./multi-provider/) | Multi-provider bridge → [dedicated repo](https://github.com/FlorianBruniaux/cc-copilot-bridge) | — |
## Quick Start ## Quick Start
@ -44,7 +47,8 @@ Ready-to-use templates for Claude Code configuration.
## Templates Index ## Templates Index
### Agents ### Agents (6)
| File | Purpose | Model | | File | Purpose | Model |
|------|---------|-------| |------|---------|-------|
| [code-reviewer.md](./agents/code-reviewer.md) | Thorough code review | Sonnet | | [code-reviewer.md](./agents/code-reviewer.md) | Thorough code review | Sonnet |
@ -54,15 +58,21 @@ Ready-to-use templates for Claude Code configuration.
| [output-evaluator.md](./agents/output-evaluator.md) | LLM-as-a-Judge quality gate | Haiku | | [output-evaluator.md](./agents/output-evaluator.md) | LLM-as-a-Judge quality gate | Haiku |
| [devops-sre.md](./agents/devops-sre.md) | Infrastructure troubleshooting with FIRE framework | Sonnet | | [devops-sre.md](./agents/devops-sre.md) | Infrastructure troubleshooting with FIRE framework | Sonnet |
### Skills ### Skills (8)
| File | Purpose | | File | Purpose |
|------|---------| |------|---------|
| [design-patterns/](./skills/design-patterns/) | Detect and analyze GoF design patterns with stack-aware suggestions | | [design-patterns/](./skills/design-patterns/) | Detect and analyze GoF design patterns with stack-aware suggestions |
| [tdd-workflow.md](./skills/tdd-workflow.md) | Test-Driven Development process | | [tdd-workflow.md](./skills/tdd-workflow.md) | Test-Driven Development process |
| [security-checklist.md](./skills/security-checklist.md) | OWASP Top 10 security checks | | [security-checklist.md](./skills/security-checklist.md) | OWASP Top 10 security checks |
| [pdf-generator.md](./skills/pdf-generator.md) | Professional PDF generation (Quarto/Typst) | | [pdf-generator.md](./skills/pdf-generator.md) | Professional PDF generation (Quarto/Typst) |
| [voice-refine/](./skills/voice-refine/) | Writing voice refinement with before/after examples |
| [ast-grep-patterns.md](./skills/ast-grep-patterns.md) | AST-based code search patterns |
| [rtk-optimizer/](./skills/rtk-optimizer/) | RTK token optimization analysis |
| [audit-agents-skills/](./skills/audit-agents-skills/) | Quality audit for agents, skills, and commands |
### Commands (23)
### Commands
| File | Trigger | Purpose | | File | Trigger | Purpose |
|------|---------|---------| |------|---------|---------|
| [commit.md](./commands/commit.md) | `/commit` | Conventional commit messages | | [commit.md](./commands/commit.md) | `/commit` | Conventional commit messages |
@ -74,58 +84,115 @@ Ready-to-use templates for Claude Code configuration.
| [git-worktree.md](./commands/git-worktree.md) | `/git-worktree` | Isolated git worktree setup | | [git-worktree.md](./commands/git-worktree.md) | `/git-worktree` | Isolated git worktree setup |
| [diagnose.md](./commands/diagnose.md) | `/diagnose` | Interactive troubleshooting assistant (FR/EN) | | [diagnose.md](./commands/diagnose.md) | `/diagnose` | Interactive troubleshooting assistant (FR/EN) |
| [validate-changes.md](./commands/validate-changes.md) | `/validate-changes` | LLM-as-a-Judge pre-commit validation | | [validate-changes.md](./commands/validate-changes.md) | `/validate-changes` | LLM-as-a-Judge pre-commit validation |
| [learn/quiz.md](./commands/learn/quiz.md) | `/learn:quiz` | Self-testing for learning concepts |
| [learn/teach.md](./commands/learn/teach.md) | `/learn:teach` | Step-by-step concept explanations |
| [learn/alternatives.md](./commands/learn/alternatives.md) | `/learn:alternatives` | Compare different approaches |
| [catchup.md](./commands/catchup.md) | `/catchup` | Restore context after /clear | | [catchup.md](./commands/catchup.md) | `/catchup` | Restore context after /clear |
| [security.md](./commands/security.md) | `/security` | Quick OWASP security audit | | [security.md](./commands/security.md) | `/security` | Quick OWASP security audit |
| [security-check.md](./commands/security-check.md) | `/security-check` | Config scan vs known threats (~30s) |
| [security-audit.md](./commands/security-audit.md) | `/security-audit` | Full 6-phase audit with score /100 |
| [update-threat-db.md](./commands/update-threat-db.md) | `/update-threat-db` | Research & update threat intelligence |
| [audit-agents-skills.md](./commands/audit-agents-skills.md) | `/audit-agents-skills` | Quality audit for .claude/ config |
| [sandbox-status.md](./commands/sandbox-status.md) | `/sandbox-status` | Sandbox isolation status check |
| [refactor.md](./commands/refactor.md) | `/refactor` | SOLID-based code improvements | | [refactor.md](./commands/refactor.md) | `/refactor` | SOLID-based code improvements |
| [explain.md](./commands/explain.md) | `/explain` | Code explanations (3 depth levels) | | [explain.md](./commands/explain.md) | `/explain` | Code explanations (3 depth levels) |
| [optimize.md](./commands/optimize.md) | `/optimize` | Performance analysis and roadmap | | [optimize.md](./commands/optimize.md) | `/optimize` | Performance analysis and roadmap |
| [ship.md](./commands/ship.md) | `/ship` | Pre-deploy checklist | | [ship.md](./commands/ship.md) | `/ship` | Pre-deploy checklist |
| [learn/quiz.md](./commands/learn/quiz.md) | `/learn:quiz` | Self-testing for learning concepts |
| [learn/teach.md](./commands/learn/teach.md) | `/learn:teach` | Step-by-step concept explanations |
| [learn/alternatives.md](./commands/learn/alternatives.md) | `/learn:alternatives` | Compare different approaches |
### Hooks (31)
Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 monitoring hooks.
**Security Hooks** (12 bash):
### Hooks
| File | Event | Purpose | | File | Event | Purpose |
|------|-------|---------| |------|-------|---------|
| [dangerous-actions-blocker.sh](./hooks/bash/dangerous-actions-blocker.sh) | PreToolUse | Block dangerous commands/edits | | [dangerous-actions-blocker.sh](./hooks/bash/dangerous-actions-blocker.sh) | PreToolUse | Block `rm -rf`, force-push, production ops |
| [security-check.*](./hooks/) | PreToolUse | Block secrets in commands | | [prompt-injection-detector.sh](./hooks/bash/prompt-injection-detector.sh) | PreToolUse | Detect injection patterns in prompts |
| [prompt-injection-detector.sh](./hooks/bash/prompt-injection-detector.sh) | PreToolUse | Detect injection attempts (+ANSI, null bytes) | | [unicode-injection-scanner.sh](./hooks/bash/unicode-injection-scanner.sh) | PreToolUse | Detect zero-width, RTL override, ANSI escape |
| [unicode-injection-scanner.sh](./hooks/bash/unicode-injection-scanner.sh) | PreToolUse | Detect zero-width, RTL, ANSI escape | | [repo-integrity-scanner.sh](./hooks/bash/repo-integrity-scanner.sh) | PreToolUse | Scan README/package.json for hidden injection |
| [repo-integrity-scanner.sh](./hooks/bash/repo-integrity-scanner.sh) | PreToolUse | Scan README/package.json for injection | | [security-check.sh](./hooks/bash/security-check.sh) | PreToolUse | Block secrets in commands |
| [sandbox-validation.sh](./hooks/bash/sandbox-validation.sh) | PreToolUse | Validate sandbox isolation |
| [file-guard.sh](./hooks/bash/file-guard.sh) | PreToolUse | Protect sensitive files from modification |
| [permission-request.sh](./hooks/bash/permission-request.sh) | PreToolUse | Explicit permission flow for risky ops |
| [mcp-config-integrity.sh](./hooks/bash/mcp-config-integrity.sh) | SessionStart | Verify MCP config hash (CVE protection) | | [mcp-config-integrity.sh](./hooks/bash/mcp-config-integrity.sh) | SessionStart | Verify MCP config hash (CVE protection) |
| [output-secrets-scanner.sh](./hooks/bash/output-secrets-scanner.sh) | PostToolUse | Detect secrets + env leakage | | [claudemd-scanner.sh](./hooks/bash/claudemd-scanner.sh) | SessionStart | Detect CLAUDE.md injection attacks |
| [auto-format.*](./hooks/) | PostToolUse | Auto-format after edits | | [output-secrets-scanner.sh](./hooks/bash/output-secrets-scanner.sh) | PostToolUse | Prevent API keys/tokens in Claude responses |
| [notification.sh](./hooks/bash/notification.sh) | Notification | Contextual macOS sound alerts | | [pre-commit-secrets.sh](./hooks/bash/pre-commit-secrets.sh) | Git hook | Block secrets from entering commits |
**Productivity Hooks** (8):
| File | Event | Purpose |
|------|-------|---------|
| [auto-format.sh](./hooks/bash/auto-format.sh) | PostToolUse | Auto-format after edits (Prettier, Black, go fmt) |
| [auto-checkpoint.sh](./hooks/bash/auto-checkpoint.sh) | PostToolUse | Auto-checkpoint work at intervals |
| [typecheck-on-save.sh](./hooks/bash/typecheck-on-save.sh) | PostToolUse | Run TypeScript checks on save |
| [test-on-change.sh](./hooks/bash/test-on-change.sh) | PostToolUse | Run tests on file changes |
| [rtk-auto-wrapper.sh](./hooks/bash/rtk-auto-wrapper.sh) | PreToolUse | Auto-wrap commands with RTK for token savings |
| [rtk-baseline.sh](./hooks/bash/rtk-baseline.sh) | SessionStart | Save RTK baseline for session savings tracking |
| [setup-init.sh](./hooks/bash/setup-init.sh) | SessionStart | Initialize session environment |
| [subagent-stop.sh](./hooks/bash/subagent-stop.sh) | Stop | Clean up sub-agent resources |
**Monitoring Hooks** (5):
| File | Event | Purpose |
|------|-------|---------|
| [output-validator.sh](./hooks/bash/output-validator.sh) | PostToolUse | Heuristic output validation | | [output-validator.sh](./hooks/bash/output-validator.sh) | PostToolUse | Heuristic output validation |
| [session-logger.sh](./hooks/bash/session-logger.sh) | PostToolUse | Log operations for monitoring | | [session-logger.sh](./hooks/bash/session-logger.sh) | PostToolUse | Log operations for monitoring |
| [pre-commit-evaluator.sh](./hooks/bash/pre-commit-evaluator.sh) | Git hook | LLM-as-a-Judge pre-commit | | [session-summary.sh](./hooks/bash/session-summary.sh) | SessionEnd | Display session stats (duration, tools, cost, RTK savings) |
| [session-summary-config.sh](./hooks/bash/session-summary-config.sh) | CLI tool | Configure session-summary sections and display |
| [learning-capture.sh](./hooks/bash/learning-capture.sh) | Stop | Prompt for daily learning capture | | [learning-capture.sh](./hooks/bash/learning-capture.sh) | Stop | Prompt for daily learning capture |
| [privacy-warning.sh](./hooks/bash/privacy-warning.sh) | PostToolUse | Warn on potential privacy leaks |
> **See [hooks/README.md](./hooks/README.md) for complete documentation and security hardening patterns** **Notification & TTS** (3):
| File | Event | Purpose |
|------|-------|---------|
| [notification.sh](./hooks/bash/notification.sh) | Notification | Contextual macOS sound alerts |
| [tts-selective.sh](./hooks/bash/tts-selective.sh) | PostToolUse | Text-to-speech for selected outputs |
| [pre-commit-evaluator.sh](./hooks/bash/pre-commit-evaluator.sh) | Git hook | LLM-as-a-Judge pre-commit |
**PowerShell** (2):
| File | Event | Purpose |
|------|-------|---------|
| [security-check.ps1](./hooks/powershell/security-check.ps1) | PreToolUse | Block secrets in commands |
| [auto-format.ps1](./hooks/powershell/auto-format.ps1) | PostToolUse | Auto-format after edits |
> **See [hooks/README.md](./hooks/README.md) for full documentation, configuration examples, and security hardening patterns**
### Config (5)
### Config
| File | Purpose | | File | Purpose |
|------|---------| |------|---------|
| [settings.json](./config/settings.json) | Hooks configuration | | [settings.json](./config/settings.json) | Hooks configuration |
| [mcp.json](./config/mcp.json) | MCP servers setup | | [mcp.json](./config/mcp.json) | MCP servers setup |
| [.gitignore-claude](./config/.gitignore-claude) | Git ignore patterns | | [.gitignore-claude](./config/.gitignore-claude) | Git ignore patterns |
| [CONTRIBUTING-ai-disclosure.md](./config/CONTRIBUTING-ai-disclosure.md) | AI disclosure template for CONTRIBUTING.md |
| [PULL_REQUEST_TEMPLATE-ai.md](./config/PULL_REQUEST_TEMPLATE-ai.md) | PR template with AI attribution |
### Memory (2)
### Memory
| File | Purpose | | File | Purpose |
|------|---------| |------|---------|
| [CLAUDE.md.project-template](./memory/CLAUDE.md.project-template) | Team project memory | | [CLAUDE.md.project-template](./memory/CLAUDE.md.project-template) | Team project memory |
| [CLAUDE.md.personal-template](./memory/CLAUDE.md.personal-template) | Personal global memory | | [CLAUDE.md.personal-template](./memory/CLAUDE.md.personal-template) | Personal global memory |
### CLAUDE.md Configurations ### CLAUDE.md Configurations (5)
| File | Purpose | | File | Purpose |
|------|---------| |------|---------|
| [learning-mode.md](./claude-md/learning-mode.md) | Learning-focused development configuration | | [learning-mode.md](./claude-md/learning-mode.md) | Learning-focused development configuration |
| [devops-sre.md](./claude-md/devops-sre.md) | DevOps/SRE project configuration | | [devops-sre.md](./claude-md/devops-sre.md) | DevOps/SRE project configuration |
| [product-designer.md](./claude-md/product-designer.md) | Product designer workflow configuration |
| [tts-enabled.md](./claude-md/tts-enabled.md) | Text-to-speech enabled configuration |
| [rtk-optimized.md](./claude-md/rtk-optimized.md) | RTK token-optimized configuration |
> **See [guide/learning-with-ai.md](../guide/learning-with-ai.md) for learning mode documentation** > **See [guide/learning-with-ai.md](../guide/learning-with-ai.md) for learning mode documentation**
> **See [guide/devops-sre.md](../guide/devops-sre.md) for DevOps/SRE guide** > **See [guide/devops-sre.md](../guide/devops-sre.md) for DevOps/SRE guide**
### Scripts ### Scripts (13)
| File | Purpose | Output | | File | Purpose | Output |
|------|---------|--------| |------|---------|--------|
| [audit-scan.sh](./scripts/audit-scan.sh) | Fast setup audit scanner | JSON / Human | | [audit-scan.sh](./scripts/audit-scan.sh) | Fast setup audit scanner | JSON / Human |
@ -135,12 +202,17 @@ Ready-to-use templates for Claude Code configuration.
| [clean-reinstall-claude.ps1](./scripts/clean-reinstall-claude.ps1) | Clean reinstall procedure (Windows) | Human | | [clean-reinstall-claude.ps1](./scripts/clean-reinstall-claude.ps1) | Clean reinstall procedure (Windows) | Human |
| [session-stats.sh](./scripts/session-stats.sh) | Analyze session logs & costs | JSON / Human | | [session-stats.sh](./scripts/session-stats.sh) | Analyze session logs & costs | JSON / Human |
| [session-search.sh](./scripts/session-search.sh) | Fast session search & resume | Human | | [session-search.sh](./scripts/session-search.sh) | Fast session search & resume | Human |
| [fresh-context-loop.sh](./scripts/fresh-context-loop.sh) | Auto-restart sessions at context limits | Human |
| [bridge.py](./scripts/bridge.py) | Plan bridging between sessions | JSON |
| [migrate-arguments-syntax.sh](./scripts/migrate-arguments-syntax.sh) | Migrate v1 → v2 argument syntax (bash) | Human |
| [migrate-arguments-syntax.ps1](./scripts/migrate-arguments-syntax.ps1) | Migrate v1 → v2 argument syntax (PowerShell) | Human |
| [rtk-benchmark.sh](./scripts/rtk-benchmark.sh) | Benchmark RTK token savings | Human |
| [sync-claude-config.sh](./scripts/sync-claude-config.sh) | Sync Claude config across machines | Human |
> **Usage**: `./audit-scan.sh` for human output, `./audit-scan.sh --json` for JSON output > **See [scripts/README.md](./scripts/README.md) for detailed usage**
>
> **Session search**: `./session-search.sh "keyword"` to find past conversations, outputs ready-to-use `claude --resume` commands ### GitHub Actions (3)
### GitHub Actions
| File | Trigger | Purpose | | File | Trigger | Purpose |
|------|---------|---------| |------|---------|---------|
| [claude-pr-auto-review.yml](./github-actions/claude-pr-auto-review.yml) | PR open/update | Auto code review with inline comments | | [claude-pr-auto-review.yml](./github-actions/claude-pr-auto-review.yml) | PR open/update | Auto code review with inline comments |
@ -149,19 +221,45 @@ Ready-to-use templates for Claude Code configuration.
> **See [github-actions/README.md](./github-actions/README.md) for setup instructions and customization** > **See [github-actions/README.md](./github-actions/README.md) for setup instructions and customization**
### Workflows ### Workflows (3)
| File | Purpose | | File | Purpose |
|------|---------| |------|---------|
| [database-branch-setup.md](./workflows/database-branch-setup.md) | Isolated feature dev with database branches (Neon/PlanetScale) | | [database-branch-setup.md](./workflows/database-branch-setup.md) | Isolated feature dev with database branches (Neon/PlanetScale) |
| [memory-stack-integration.md](./workflows/memory-stack-integration.md) | Multi-day workflow with memory tools (claude-mem + Serena + grepai) |
| [remotion-quickstart.md](./workflows/remotion-quickstart.md) | Video generation workflow with Remotion |
### Plugins (2)
| File | Purpose |
|------|---------|
| [se-cove.md](./plugins/se-cove.md) | Chain-of-Verification for independent code review (Meta AI, ACL 2024) |
| [claude-mem.md](./plugins/claude-mem.md) | Persistent memory management plugin |
### Integrations (1)
| Tool | Purpose |
|------|---------|
| [Agent Vibes TTS](./integrations/agent-vibes/) | Text-to-speech narration for Claude Code responses |
> **See [agent-vibes/README.md](./integrations/agent-vibes/README.md) for installation and voice catalog**
### MCP Configs (1)
| File | Purpose |
|------|---------|
| [figma.json](./mcp-configs/figma.json) | Figma MCP server configuration |
### Modes (1)
### Modes
| File | Purpose | Activation | | File | Purpose | Activation |
|------|---------|------------| |------|---------|------------|
| [MODE_Learning.md](./modes/MODE_Learning.md) | Just-in-time explanations | `--learn` flag | | [MODE_Learning.md](./modes/MODE_Learning.md) | Just-in-time explanations | `--learn` flag |
> **See [modes/README.md](./modes/README.md) for installation and SuperClaude framework reference** > **See [modes/README.md](./modes/README.md) for installation and SuperClaude framework reference**
### Semantic Anchors ### Semantic Anchors (1)
| File | Purpose | | File | Purpose |
|------|---------| |------|---------|
| [anchor-catalog.md](./semantic-anchors/anchor-catalog.md) | Comprehensive catalog of precise technical terms for prompting | | [anchor-catalog.md](./semantic-anchors/anchor-catalog.md) | Comprehensive catalog of precise technical terms for prompting |
@ -172,11 +270,9 @@ Ready-to-use templates for Claude Code configuration.
| Tool | Purpose | | Tool | Purpose |
|------|---------| |------|---------|
| [cc-copilot-bridge](./multi-provider/) | Bridge GitHub Copilot to Claude Code CLI for free access to 25+ AI models | | [cc-copilot-bridge](./multi-provider/) | Bridge GitHub Copilot to Claude Code CLI for flat-rate access |
> 🔗 **Moved to dedicated repository**: [github.com/FlorianBruniaux/cc-copilot-bridge](https://github.com/FlorianBruniaux/cc-copilot-bridge) > Moved to dedicated repository: [github.com/FlorianBruniaux/cc-copilot-bridge](https://github.com/FlorianBruniaux/cc-copilot-bridge)
>
> Turn your $10/month GitHub Copilot Pro+ subscription into unlimited Claude Code access with 25+ models (GPT-4.1, Claude Opus/Sonnet/Haiku, Gemini). Includes Ollama local mode for offline/private development.
--- ---

View file

@ -14,10 +14,29 @@ Always use RTK wrapper for these high-verbosity commands:
### File Operations (69.4% avg reduction) ### File Operations (69.4% avg reduction)
- `rtk find "*.md" .` instead of `find . -name "*.md"` - `rtk find "*.md" .` instead of `find . -name "*.md"`
- `rtk read <file>` instead of `cat <file>` (for large files >10K lines) - `rtk read <file>` instead of `cat <file>` (for large files >10K lines)
- `rtk ls .` instead of `ls -la`
- `rtk grep "pattern"` instead of `grep -r "pattern"`
### DO NOT use RTK for: ### JS/TS Stack (70-90% reduction)
- `ls` (worse output: -274% token increase) - `rtk vitest run` instead of `pnpm test`
- `grep` (buggy as of v0.2.0) - `rtk pnpm list` instead of `pnpm list`
- `rtk pnpm outdated` instead of `pnpm outdated`
- `rtk prisma migrate status` instead of `pnpm prisma migrate status`
### Rust Toolchain (80-90% reduction)
- `rtk cargo test` instead of `cargo test`
- `rtk cargo build` instead of `cargo build`
- `rtk cargo clippy` instead of `cargo clippy`
### Python (90% reduction)
- `rtk python pytest` instead of `pytest`
### Go (90% reduction)
- `rtk go test` instead of `go test`
### GitHub CLI (79-87% reduction)
- `rtk gh pr view <num>` instead of `gh pr view <num>`
- `rtk gh pr checks <num>` instead of `gh pr checks <num>`
## Token Savings Target ## Token Savings Target
@ -26,13 +45,22 @@ Always use RTK wrapper for these high-verbosity commands:
## Installation ## Installation
RTK is installed system-wide: `/usr/local/bin/rtk` ```bash
# Homebrew (macOS/Linux)
brew install rtk-ai/tap/rtk
# Cargo (all platforms)
cargo install rtk
# Hook-first install
rtk init
```
## Verification ## Verification
Check RTK availability: Check RTK availability:
```bash ```bash
rtk --version # Should show: rtk 0.2.0 rtk --version # Should show: rtk 0.16.0+
``` ```
## When NOT to use RTK ## When NOT to use RTK
@ -43,4 +71,4 @@ rtk --version # Should show: rtk 0.2.0
## Automation ## Automation
Use RTK automatically via hook (see `.claude/hooks/bash/rtk-wrapper.sh`) Use RTK automatically via hook (see `.claude/hooks/bash/rtk-wrapper.sh`) or `rtk init` for hook-first setup.

View file

@ -15,7 +15,25 @@ Hooks are scripts that execute automatically on Claude Code events. They enable
| [claudemd-scanner.sh](./bash/claudemd-scanner.sh) | SessionStart | Detect CLAUDE.md injection attacks | Bash | | [claudemd-scanner.sh](./bash/claudemd-scanner.sh) | SessionStart | Detect CLAUDE.md injection attacks | Bash |
| [output-secrets-scanner.sh](./bash/output-secrets-scanner.sh) | PostToolUse | Detect secrets + env leakage in tool outputs | Bash | | [output-secrets-scanner.sh](./bash/output-secrets-scanner.sh) | PostToolUse | Detect secrets + env leakage in tool outputs | Bash |
| [auto-format.sh](./bash/auto-format.sh) | PostToolUse | Auto-format after edits | Bash | | [auto-format.sh](./bash/auto-format.sh) | PostToolUse | Auto-format after edits | Bash |
| [rtk-baseline.sh](./bash/rtk-baseline.sh) | SessionStart | Save RTK baseline for session savings tracking | Bash |
| [session-summary.sh](./bash/session-summary.sh) | SessionEnd | Full session analytics (15 configurable sections) | Bash |
| [session-summary-config.sh](./bash/session-summary-config.sh) | CLI tool | Configure session-summary sections, order, preview | Bash |
| [learning-capture.sh](./bash/learning-capture.sh) | Stop | Prompt for daily learning capture | Bash | | [learning-capture.sh](./bash/learning-capture.sh) | Stop | Prompt for daily learning capture | Bash |
| [sandbox-validation.sh](./bash/sandbox-validation.sh) | PreToolUse | Validate sandbox isolation | Bash |
| [file-guard.sh](./bash/file-guard.sh) | PreToolUse | Protect sensitive files from modification | Bash |
| [permission-request.sh](./bash/permission-request.sh) | PreToolUse | Explicit permission flow for risky ops | Bash |
| [rtk-auto-wrapper.sh](./bash/rtk-auto-wrapper.sh) | PreToolUse | Auto-wrap commands with RTK for token savings | Bash |
| [setup-init.sh](./bash/setup-init.sh) | SessionStart | Initialize session environment | Bash |
| [auto-checkpoint.sh](./bash/auto-checkpoint.sh) | PostToolUse | Auto-checkpoint work at intervals | Bash |
| [typecheck-on-save.sh](./bash/typecheck-on-save.sh) | PostToolUse | Run TypeScript checks on save | Bash |
| [test-on-change.sh](./bash/test-on-change.sh) | PostToolUse | Run tests on file changes | Bash |
| [output-validator.sh](./bash/output-validator.sh) | PostToolUse | Heuristic output validation | Bash |
| [session-logger.sh](./bash/session-logger.sh) | PostToolUse | Log operations for monitoring | Bash |
| [privacy-warning.sh](./bash/privacy-warning.sh) | PostToolUse | Warn on potential privacy leaks | Bash |
| [tts-selective.sh](./bash/tts-selective.sh) | PostToolUse | Text-to-speech for selected outputs | Bash |
| [subagent-stop.sh](./bash/subagent-stop.sh) | Stop | Clean up sub-agent resources | Bash |
| [pre-commit-secrets.sh](./bash/pre-commit-secrets.sh) | Git hook | Block secrets from entering commits | Bash |
| [pre-commit-evaluator.sh](./bash/pre-commit-evaluator.sh) | Git hook | LLM-as-a-Judge pre-commit validation | Bash |
| [notification.sh](./bash/notification.sh) | Notification | Contextual macOS sound alerts | Bash (macOS) | | [notification.sh](./bash/notification.sh) | Notification | Contextual macOS sound alerts | Bash (macOS) |
| [security-check.ps1](./powershell/security-check.ps1) | PreToolUse | Block secrets in commands | PowerShell | | [security-check.ps1](./powershell/security-check.ps1) | PreToolUse | Block secrets in commands | PowerShell |
| [auto-format.ps1](./powershell/auto-format.ps1) | PostToolUse | Auto-format after edits | PowerShell | | [auto-format.ps1](./powershell/auto-format.ps1) | PostToolUse | Auto-format after edits | PowerShell |
@ -245,6 +263,141 @@ Complements `security-check.sh` by scanning tool **outputs** (not inputs) for le
## Productivity Hooks ## Productivity Hooks
### rtk-baseline.sh
**Event**: `SessionStart`
Captures RTK cumulative stats at session start for delta tracking. Paired with `session-summary.sh` which computes per-session RTK savings at session end.
**Configuration**:
```json
{
"hooks": {
"SessionStart": [{
"hooks": [{
"type": "command",
"command": "~/.claude/hooks/rtk-baseline.sh",
"timeout": 5000
}]
}]
}
}
```
### session-summary.sh (v3)
**Event**: `SessionEnd`
Full session analytics with 15 configurable sections, CLI config tool, and JSONL logging.
**Sections** (all configurable via env vars or config file):
| Section | Default | Description |
|---------|---------|-------------|
| `meta` | always | Session ID, name, branch |
| `duration` | always | Wall time, active time, turns, exit reason |
| `tools` | always | Tool calls breakdown (OK/ERR) |
| `errors` | on | Error details grouped by tool |
| `files` | on | Files read/edited/created with top edited |
| `features` | on | MCP servers, agents, skills, teams, plan mode |
| `git` | on | Git diff summary (+/- lines, files changed) |
| `loc` | on | Lines of code written via Edit/Write |
| `models` | always | Model usage (requests, tokens) |
| `cache` | always | Cache hit rate |
| `cost` | always | Estimated cost (ccusage or pricing table) |
| `rtk` | on | RTK token savings (delta from session start) |
| `ratio` | on | Conversation ratio (interactive/auto turns) |
| `thinking` | off | Thinking blocks count |
| `context` | off | Context window estimate (peak %) |
**Log File**: `~/.claude/logs/session-summaries.jsonl` (structured JSONL with all metrics)
**Configuration Priority**: `env vars (SESSION_SUMMARY_*)` > `config file (~/.config/session-summary/config.sh)` > `defaults`
**Environment Variables**:
| Variable | Default | Description |
|----------|---------|-------------|
| `NO_COLOR` | - | Disable ANSI colors |
| `SESSION_SUMMARY_SKIP` | `0` | Set to `1` to disable summary |
| `SESSION_SUMMARY_LOG` | `~/.claude/logs` | Override log directory |
| `SESSION_SUMMARY_FILES` | `1` | Files section toggle |
| `SESSION_SUMMARY_RTK` | `auto` | `auto` / `1` / `0` |
| `SESSION_SUMMARY_GIT` | `1` | Git diff toggle |
| `SESSION_SUMMARY_ERRORS` | `1` | Error details toggle |
| `SESSION_SUMMARY_LOC` | `1` | Lines of code toggle |
| `SESSION_SUMMARY_RATIO` | `1` | Conversation ratio toggle |
| `SESSION_SUMMARY_FEATURES` | `1` | Features used toggle |
| `SESSION_SUMMARY_THINKING` | `0` | Thinking blocks toggle |
| `SESSION_SUMMARY_CONTEXT` | `0` | Context estimate toggle |
| `SESSION_SUMMARY_SECTIONS` | (all) | Comma-separated section order |
**CLI Config Tool** (`session-summary-config.sh`):
```bash
session-summary-config show # Current config with section status
session-summary-config set git=0 # Disable a section
session-summary-config set thinking=1 # Enable a section
session-summary-config reset # Reset to defaults
session-summary-config sections # Show section order
session-summary-config sections "meta,duration,tools,cost" # Minimal output
session-summary-config preview # Demo output with current config
session-summary-config install # Install hooks in settings.json
session-summary-config log 5 # Last 5 session summaries
```
**Requirements**:
- `jq` (required for JSON parsing)
- `ccusage` (optional, for accurate cost calculation)
- `rtk` (optional, for token savings tracking)
**Example Output** (all sections enabled):
```
═══ Session Summary ═══════════════════
ID: abc-123-def-456...
Name: Fix session summary hook
Branch: main
Duration: Wall 5m 28s | Active 1m 33s | 12 turns | Exit: user
Tool Calls: 29 (OK 27 / ERR 2)
Edit: 13 Bash: 8 Read: 6 Grep: 1 Glob: 1
Errors: 2
Bash: "command not found: rtk" (x1)
Edit: "old_string not unique" (x1)
Files: 3 read · 2 edited · 1 created
session-summary.sh (8 edits), settings.json (3 edits)
Features: MCP (perplexity x4, chrome x12) · Agents (Explore x3, Plan x1) · Skills (commit)
Git: +142 -37 lines · 4 files changed
Code: +87 -12 net (via Edit/Write)
Model Usage Reqs Input Output
claude-opus-4-6 59 93K 628
Cache: 85% hit rate (3.9M read / 322K created)
Est. Cost: $0.045
RTK Savings: 24 cmds · ~12.4K tokens saved (73%)
Turns: 12 (8 interactive · 4 auto) · Avg 6.7s/turn
═══════════════════════════════════════
```
**Configuration**:
```json
{
"hooks": {
"SessionEnd": [{
"hooks": [{
"type": "command",
"command": "~/.claude/hooks/session-summary.sh"
}]
}]
}
}
```
**Quick Install**: `~/.claude/hooks/session-summary-config.sh install` (copies hooks + updates settings.json)
### auto-format.sh / auto-format.ps1 ### auto-format.sh / auto-format.ps1
**Event**: `PostToolUse` (Edit, Write) **Event**: `PostToolUse` (Edit, Write)

View file

@ -18,6 +18,8 @@
# }] # }]
# } # }
# } # }
#
# Or use `rtk init` for automatic hook setup.
# Check if RTK is installed # Check if RTK is installed
if ! command -v rtk &> /dev/null; then if ! command -v rtk &> /dev/null; then
@ -39,6 +41,15 @@ declare -A RTK_COMMANDS=(
["git status"]="76.0" ["git status"]="76.0"
["git diff"]="55.9" ["git diff"]="55.9"
["find"]="76.3" ["find"]="76.3"
["cargo test"]="90.0"
["cargo build"]="80.0"
["cargo clippy"]="80.0"
["pnpm list"]="82.0"
["pnpm outdated"]="90.0"
["pnpm test"]="90.0"
["python pytest"]="90.0"
["python -m pytest"]="90.0"
["go test"]="90.0"
) )
# Check if command matches RTK-optimizable pattern # Check if command matches RTK-optimizable pattern
@ -48,7 +59,7 @@ for cmd in "${!RTK_COMMANDS[@]}"; do
# Suggest RTK wrapper # Suggest RTK wrapper
cat << EOF cat << EOF
💡 RTK Optimization Available RTK Optimization Available
Command: $COMMAND Command: $COMMAND
Suggested: rtk $COMMAND Suggested: rtk $COMMAND
@ -66,19 +77,5 @@ EOF
fi fi
done done
# Check for commands that should NOT use RTK
if [[ "$COMMAND" == "ls"* ]] && [[ "$COMMAND" == "rtk "* ]]; then
cat << EOF
⚠️ RTK Not Recommended
Command: $COMMAND
Issue: RTK ls produces worse output (-274% token increase)
Suggestion: Use plain 'ls' instead
Blocking RTK usage for this command.
EOF
exit 2 # Block the command
fi
# Continue with original command # Continue with original command
exit 0 exit 0

View file

@ -0,0 +1,39 @@
#!/bin/bash
# .claude/hooks/rtk-baseline.sh
# Event: SessionStart
# Save RTK gain baseline for session-summary.sh delta tracking
#
# This hook captures RTK's cumulative stats at session start.
# At session end, session-summary.sh reads this baseline, captures current stats,
# and computes the delta to show per-session RTK savings.
#
# Configuration:
# SESSION_SUMMARY_RTK=0 - Force disable (skip baseline capture)
# SESSION_SUMMARY_RTK=1 - Force enable
# (default: auto-detect if rtk is in PATH)
#
# Place in: ~/.claude/hooks/rtk-baseline.sh
# Register in: ~/.claude/settings.json under SessionStart event
set -euo pipefail
RTK_ENABLED="${SESSION_SUMMARY_RTK:-auto}"
# Auto-detect RTK availability
if [[ "$RTK_ENABLED" == "auto" ]]; then
command -v rtk &>/dev/null && RTK_ENABLED=1 || RTK_ENABLED=0
fi
# Skip if disabled or RTK not available
if [[ "$RTK_ENABLED" != "1" ]]; then
exit 0
fi
# Build baseline file path (must match session-summary.sh)
baseline_key=$(echo "${CLAUDE_PROJECT_DIR:-$(pwd)}" | tr '/' '-')
baseline_file="/tmp/rtk-baseline${baseline_key}.txt"
# Capture current RTK cumulative stats
rtk gain > "$baseline_file" 2>/dev/null || true
exit 0

View file

@ -0,0 +1,473 @@
#!/bin/bash
# session-summary-config.sh
# CLI configuration tool for session-summary.sh hook
# Manages section toggles, section order, and provides utility commands
#
# Usage:
# session-summary-config show # Show current config with section status
# session-summary-config set KEY=VALUE # Set a config value (e.g., git=1, errors=0)
# session-summary-config reset # Reset to defaults
# session-summary-config sections # Show current section order
# session-summary-config sections "a,b,c" # Set section order
# session-summary-config preview # Show demo output with current config
# session-summary-config install # Install hooks in ~/.claude/settings.json
# session-summary-config log [n] # Show last n session summaries (default: 5)
#
# Config file: ~/.config/session-summary/config.sh
set -euo pipefail
CONFIG_DIR="${HOME}/.config/session-summary"
CONFIG_FILE="${CONFIG_DIR}/config.sh"
LOG_DIR="${HOME}/.claude/logs"
LOG_FILE="${LOG_DIR}/session-summaries.jsonl"
HOOKS_DIR="${HOME}/.claude/hooks"
# ANSI colors
if [[ -z "${NO_COLOR:-}" ]]; then
BOLD=$'\033[1m'
DIM=$'\033[2m'
CYAN=$'\033[36m'
GREEN=$'\033[32m'
YELLOW=$'\033[33m'
RED=$'\033[31m'
RESET=$'\033[0m'
else
BOLD='' DIM='' CYAN='' GREEN='' YELLOW='' RED='' RESET=''
fi
# Defaults (must match session-summary.sh)
declare -A DEFAULTS=(
[LOG_DIR]="$HOME/.claude/logs"
[SKIP]=0
[FILES]=1
[RTK]=auto
[GIT]=1
[ERRORS]=1
[LOC]=1
[RATIO]=1
[FEATURES]=1
[THINKING]=0
[CONTEXT]=0
[SECTIONS]="meta,duration,tools,errors,files,features,git,loc,models,cache,cost,rtk,ratio,thinking,context"
)
# Section descriptions
declare -A SECTION_DESC=(
[meta]="Session ID, name, branch"
[duration]="Wall time, active time, turns, exit reason"
[tools]="Tool calls breakdown (OK/ERR)"
[errors]="Error details by tool"
[files]="Files read/edited/created"
[features]="MCP servers, agents, skills, teams"
[git]="Git diff summary (+/- lines)"
[loc]="Lines of code via Edit/Write"
[models]="Model usage (reqs, tokens)"
[cache]="Cache hit rate"
[cost]="Estimated session cost"
[rtk]="RTK token savings"
[ratio]="Conversation ratio (interactive/auto)"
[thinking]="Thinking blocks count"
[context]="Context window estimate"
)
# Section toggle keys (maps section name to config key)
declare -A SECTION_KEYS=(
[meta]="" [duration]="" [tools]="" [models]="" [cache]="" [cost]=""
[files]="FILES"
[git]="GIT"
[errors]="ERRORS"
[loc]="LOC"
[rtk]="RTK"
[ratio]="RATIO"
[features]="FEATURES"
[thinking]="THINKING"
[context]="CONTEXT"
)
# Load current config values
load_current_config() {
declare -gA CURRENT
for key in "${!DEFAULTS[@]}"; do
CURRENT[$key]="${DEFAULTS[$key]}"
done
if [[ -f "$CONFIG_FILE" ]]; then
while IFS='=' read -r key value; do
key=$(echo "$key" | tr -d '[:space:]')
value=$(echo "$value" | tr -d '[:space:]' | sed 's/^"//;s/"$//')
[[ -z "$key" || "$key" == \#* ]] && continue
CURRENT[$key]="$value"
done < "$CONFIG_FILE"
fi
}
# Write config file
write_config() {
mkdir -p "$CONFIG_DIR"
{
echo "# Session Summary Configuration"
echo "# Generated by session-summary-config.sh"
echo "# $(date -u +"%Y-%m-%dT%H:%M:%SZ")"
echo ""
for key in LOG_DIR SKIP FILES RTK GIT ERRORS LOC RATIO FEATURES THINKING CONTEXT SECTIONS; do
if [[ -n "${CURRENT[$key]+x}" ]]; then
if [[ "$key" == "SECTIONS" || "$key" == "LOG_DIR" ]]; then
echo "${key}=\"${CURRENT[$key]}\""
else
echo "${key}=${CURRENT[$key]}"
fi
fi
done
} > "$CONFIG_FILE"
}
# ═══════════════════════════════════════════════════════════════════════════
# Subcommands
# ═══════════════════════════════════════════════════════════════════════════
cmd_show() {
load_current_config
echo "${BOLD}Session Summary Configuration${RESET}"
echo ""
echo "${DIM}Config file:${RESET} $CONFIG_FILE"
[[ -f "$CONFIG_FILE" ]] && echo "${DIM}Status:${RESET} ${GREEN}exists${RESET}" || echo "${DIM}Status:${RESET} ${YELLOW}not created (using defaults)${RESET}"
echo ""
echo "${BOLD}Sections:${RESET}"
echo ""
# Parse current section order
IFS=',' read -ra ordered_sections <<< "${CURRENT[SECTIONS]}"
for section in "${ordered_sections[@]}"; do
section=$(echo "$section" | tr -d ' ')
local key="${SECTION_KEYS[$section]:-}"
local desc="${SECTION_DESC[$section]:-}"
local status
if [[ -z "$key" ]]; then
# Always-on section
status="${GREEN}always on${RESET}"
else
local val="${CURRENT[$key]:-${DEFAULTS[$key]:-0}}"
if [[ "$val" == "1" ]]; then
status="${GREEN}on${RESET}"
elif [[ "$val" == "auto" ]]; then
status="${CYAN}auto${RESET}"
else
status="${DIM}off${RESET}"
fi
fi
printf " %-12s %-8s %s\n" "$section" "[$status]" "${DIM}${desc}${RESET}"
done
echo ""
echo "${BOLD}Settings:${RESET}"
echo " ${DIM}LOG_DIR:${RESET} ${CURRENT[LOG_DIR]}"
echo " ${DIM}SKIP:${RESET} ${CURRENT[SKIP]}"
echo ""
echo "${DIM}Priority: env vars (SESSION_SUMMARY_*) > config file > defaults${RESET}"
}
cmd_set() {
load_current_config
for arg in "$@"; do
if [[ "$arg" != *"="* ]]; then
echo "${RED}Error: Invalid format '$arg'. Use KEY=VALUE (e.g., git=1, errors=0)${RESET}" >&2
exit 1
fi
local key="${arg%%=*}"
local value="${arg#*=}"
# Normalize key to uppercase
key=$(echo "$key" | tr '[:lower:]' '[:upper:]')
# Validate key
if [[ -z "${DEFAULTS[$key]+x}" ]]; then
echo "${RED}Error: Unknown key '$key'. Valid keys: ${!DEFAULTS[*]}${RESET}" >&2
exit 1
fi
CURRENT[$key]="$value"
echo "${GREEN}Set${RESET} $key=$value"
done
write_config
echo ""
echo "${DIM}Config saved to $CONFIG_FILE${RESET}"
}
cmd_reset() {
load_current_config
for key in "${!DEFAULTS[@]}"; do
CURRENT[$key]="${DEFAULTS[$key]}"
done
write_config
echo "${GREEN}Config reset to defaults${RESET}"
echo "${DIM}Saved to $CONFIG_FILE${RESET}"
}
cmd_sections() {
load_current_config
if [[ $# -eq 0 ]]; then
# Show current order
echo "${BOLD}Current section order:${RESET}"
echo " ${CURRENT[SECTIONS]}"
echo ""
echo "${DIM}Available sections:${RESET}"
echo " ${!SECTION_DESC[*]}" | tr ' ' '\n' | sort | tr '\n' ',' | sed 's/,$/\n/'
echo ""
echo "${DIM}Usage: session-summary-config sections \"meta,duration,tools,files,...\"${RESET}"
else
# Set new order
CURRENT[SECTIONS]="$1"
write_config
echo "${GREEN}Section order updated:${RESET} $1"
fi
}
cmd_preview() {
load_current_config
echo ""
echo "${BOLD}═══ Session Summary (Preview) ═════════${RESET}"
IFS=',' read -ra sections <<< "${CURRENT[SECTIONS]}"
for section in "${sections[@]}"; do
section=$(echo "$section" | tr -d ' ')
local key="${SECTION_KEYS[$section]:-}"
local enabled=true
if [[ -n "$key" ]]; then
local val="${CURRENT[$key]:-${DEFAULTS[$key]:-0}}"
[[ "$val" != "1" && "$val" != "auto" ]] && enabled=false
fi
$enabled || continue
case "$section" in
meta)
echo "${DIM}ID:${RESET} a1b2c3d4-e5f6-78..."
echo "${DIM}Name:${RESET} Example session"
echo "${DIM}Branch:${RESET} main"
;;
duration)
echo "${DIM}Duration:${RESET} Wall 5m 28s | Active 1m 33s | 12 turns | Exit: user"
;;
tools)
echo "${DIM}Tool Calls:${RESET} 29 ${GREEN}(OK 27 / ERR 2)${RESET}"
echo " ${CYAN}Edit:${RESET} 13 ${CYAN}Bash:${RESET} 8 ${CYAN}Read:${RESET} 6 ${CYAN}Grep:${RESET} 1 ${CYAN}Glob:${RESET} 1"
;;
errors)
echo "${DIM}Errors:${RESET} ${RED}2${RESET}"
echo " Bash: \"command not found: rtk\" (x1)"
echo " Edit: \"old_string not unique\" (x1)"
;;
files)
echo "${DIM}Files:${RESET} 3 read · 2 edited · 1 created"
echo " session-summary.sh (8 edits), settings.json (3 edits)"
;;
features)
echo "${DIM}Features:${RESET} MCP (perplexity x4, chrome x12) · Agents (Explore x3, Plan x1) · Skills (commit)"
;;
git)
echo "${DIM}Git:${RESET} ${GREEN}+142${RESET} ${RED}-37${RESET} lines · 4 files changed"
;;
loc)
echo "${DIM}Code:${RESET} ${GREEN}+87${RESET} ${RED}-12${RESET} net (via Edit/Write)"
;;
models)
echo "${DIM}Model Usage${RESET} Reqs Input Output"
printf "${CYAN}%-20s${RESET} %4d %7s %6s\n" "claude-opus-4-6" 59 "93K" "628"
;;
cache)
echo "Cache: 85% hit rate (3.9M read / 322K created)"
;;
cost)
echo "Est. Cost: ${GREEN}\$0.045${RESET}"
;;
rtk)
echo "RTK Savings: 24 cmds · ~12.4K tokens saved (73%)"
echo " git status(8), git diff(5), ls(4)"
;;
ratio)
echo "${DIM}Turns:${RESET} 12 (8 interactive · 4 auto) · Avg 6.7s/turn"
;;
thinking)
echo "${DIM}Thinking:${RESET} 12 blocks"
;;
context)
echo "${DIM}Context:${RESET} ~78% peak (est.) · Model limit: 200K"
;;
esac
done
echo "${BOLD}═══════════════════════════════════════${RESET}"
}
cmd_install() {
local settings_file="${HOME}/.claude/settings.json"
echo "${BOLD}Installing session-summary hooks...${RESET}"
echo ""
# Copy hook files
mkdir -p "$HOOKS_DIR"
local script_dir
script_dir=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
local src_summary="${script_dir}/session-summary.sh"
local src_baseline="${script_dir}/rtk-baseline.sh"
local src_config="${script_dir}/session-summary-config.sh"
if [[ -f "$src_summary" ]]; then
cp "$src_summary" "$HOOKS_DIR/session-summary.sh"
chmod +x "$HOOKS_DIR/session-summary.sh"
echo " ${GREEN}Copied${RESET} session-summary.sh → $HOOKS_DIR/"
else
echo " ${YELLOW}Skipped${RESET} session-summary.sh (not found at $src_summary)"
fi
if [[ -f "$src_baseline" ]]; then
cp "$src_baseline" "$HOOKS_DIR/rtk-baseline.sh"
chmod +x "$HOOKS_DIR/rtk-baseline.sh"
echo " ${GREEN}Copied${RESET} rtk-baseline.sh → $HOOKS_DIR/"
fi
if [[ -f "$src_config" ]]; then
cp "$src_config" "$HOOKS_DIR/session-summary-config.sh"
chmod +x "$HOOKS_DIR/session-summary-config.sh"
echo " ${GREEN}Copied${RESET} session-summary-config.sh → $HOOKS_DIR/"
fi
echo ""
# Update settings.json
if ! command -v jq &>/dev/null; then
echo "${RED}Error: jq required for settings.json update. Install: brew install jq${RESET}" >&2
exit 1
fi
local hook_session_end='{
"hooks": [{
"type": "command",
"command": "~/.claude/hooks/session-summary.sh"
}]
}'
local hook_session_start='{
"hooks": [{
"type": "command",
"command": "~/.claude/hooks/rtk-baseline.sh",
"timeout": 5000
}]
}'
if [[ -f "$settings_file" ]]; then
local tmp
tmp=$(mktemp)
# Add/update SessionEnd hook
jq --argjson hook "$hook_session_end" '
.hooks.SessionEnd = (
[(.hooks.SessionEnd // [])[] | select(.hooks[0].command | test("session-summary") | not)] + [$hook]
)
' "$settings_file" > "$tmp"
# Add/update SessionStart hook (rtk-baseline) if RTK available
if command -v rtk &>/dev/null; then
jq --argjson hook "$hook_session_start" '
.hooks.SessionStart = (
[(.hooks.SessionStart // [])[] | select(.hooks[0].command | test("rtk-baseline") | not)] + [$hook]
)
' "$tmp" > "${tmp}.2" && mv "${tmp}.2" "$tmp"
fi
mv "$tmp" "$settings_file"
echo " ${GREEN}Updated${RESET} $settings_file"
else
# Create new settings.json
local hooks_obj="{\"SessionEnd\": [$hook_session_end]"
if command -v rtk &>/dev/null; then
hooks_obj+=", \"SessionStart\": [$hook_session_start]"
fi
hooks_obj+="}"
echo "{\"hooks\": $hooks_obj}" | jq '.' > "$settings_file"
echo " ${GREEN}Created${RESET} $settings_file"
fi
echo ""
echo "${GREEN}Installation complete.${RESET}"
echo "${DIM}Session summary will appear on next session exit.${RESET}"
}
cmd_log() {
local count="${1:-5}"
if [[ ! -f "$LOG_FILE" ]]; then
echo "${YELLOW}No session summaries found at $LOG_FILE${RESET}"
exit 0
fi
echo "${BOLD}Last $count session summaries:${RESET}"
echo ""
tail -n "$count" "$LOG_FILE" | jq -r '
"═══ \(.session_name // "Unnamed") ═══",
" ID: \(.session_id[:16])... Branch: \(.git_branch) Exit: \(.exit_reason // "unknown")",
" Duration: \((.duration_wall_ms / 1000 / 60) | floor)m Turns: \(.turns) Cost: $\(.cost_usd | tostring[:5])",
" Tools: \(.tool_calls | to_entries | map("\(.key):\(.value)") | join(", "))",
" Errors: \(.tool_errors) Cache: \(.cache_hit_rate)%",
""
' 2>/dev/null || echo "${RED}Error parsing log file${RESET}"
}
cmd_help() {
echo "${BOLD}session-summary-config${RESET} - Configure session-summary.sh hook"
echo ""
echo "${BOLD}Usage:${RESET}"
echo " session-summary-config ${CYAN}show${RESET} Show current config"
echo " session-summary-config ${CYAN}set${RESET} KEY=VALUE Set a config value"
echo " session-summary-config ${CYAN}reset${RESET} Reset to defaults"
echo " session-summary-config ${CYAN}sections${RESET} Show section order"
echo " session-summary-config ${CYAN}sections${RESET} \"a,b,c\" Set section order"
echo " session-summary-config ${CYAN}preview${RESET} Demo output with current config"
echo " session-summary-config ${CYAN}install${RESET} Install hooks + settings.json"
echo " session-summary-config ${CYAN}log${RESET} [n] Show last n summaries (default: 5)"
echo ""
echo "${BOLD}Config keys:${RESET}"
echo " files, git, errors, loc, rtk, ratio, features, thinking, context"
echo " skip, log_dir, sections"
echo ""
echo "${BOLD}Examples:${RESET}"
echo " session-summary-config set git=0 # Disable git diff"
echo " session-summary-config set thinking=1 # Enable thinking blocks"
echo " session-summary-config set rtk=auto # Auto-detect RTK"
echo " session-summary-config sections \"meta,duration,tools,cost\" # Minimal output"
}
# ═══════════════════════════════════════════════════════════════════════════
# Main
# ═══════════════════════════════════════════════════════════════════════════
case "${1:-help}" in
show) cmd_show ;;
set) shift; cmd_set "$@" ;;
reset) cmd_reset ;;
sections) shift; cmd_sections "$@" ;;
preview) cmd_preview ;;
install) cmd_install ;;
log) shift; cmd_log "$@" ;;
help|--help|-h) cmd_help ;;
*)
echo "${RED}Unknown command: $1${RESET}" >&2
echo ""
cmd_help
exit 1
;;
esac

File diff suppressed because it is too large Load diff

View file

@ -4,13 +4,13 @@
set -e set -e
echo "🚀 RTK Benchmark - T3 Stack Edition" echo "RTK Benchmark - T3 Stack Edition"
echo "====================================" echo "===================================="
echo "" echo ""
# Check RTK installation # Check RTK installation
if ! command -v rtk &> /dev/null; then if ! command -v rtk &> /dev/null; then
echo "❌ RTK not found. Install from: https://github.com/pszymkowiak/rtk" echo "RTK not found. Install from: https://github.com/rtk-ai/rtk"
exit 1 exit 1
fi fi
@ -56,16 +56,16 @@ benchmark() {
reduction="N/A" reduction="N/A"
fi fi
status="" status="OK"
if [ "$rtk_chars" -eq 0 ] || [ "$reduction" = "N/A" ]; then if [ "$rtk_chars" -eq 0 ] || [ "$reduction" = "N/A" ]; then
status="" status="FAIL"
reduction="N/A" reduction="N/A"
fi fi
else else
rtk_chars="N/A" rtk_chars="N/A"
rtk_tokens="N/A" rtk_tokens="N/A"
reduction="N/A" reduction="N/A"
status="🚫 Not supported" status="Not tested"
fi fi
# Write to results file # Write to results file
@ -78,7 +78,7 @@ echo "|---------|------------------|-------------------|-------------|----------
# Git commands # Git commands
echo "" echo ""
echo "📊 Git Commands" echo "Git Commands"
echo "===============" echo "==============="
benchmark "git log -20" "git log -20" "rtk git log -- -20" benchmark "git log -20" "git log -20" "rtk git log -- -20"
benchmark "git status" "git status" "rtk git status" benchmark "git status" "git status" "rtk git status"
@ -86,55 +86,74 @@ benchmark "git diff HEAD~1" "git diff HEAD~1" "rtk git diff HEAD~1"
# Find commands # Find commands
echo "" echo ""
echo "📊 Find Commands" echo "Find Commands"
echo "================" echo "================"
benchmark "find src/ -name '*.ts'" "find src/ -name '*.ts' 2>/dev/null || echo ''" "rtk find '*.ts' src/ 2>/dev/null || echo ''" benchmark "find src/ -name '*.ts'" "find src/ -name '*.ts' 2>/dev/null || echo ''" "rtk find '*.ts' src/ 2>/dev/null || echo ''"
benchmark "find src/ -name '*.tsx'" "find src/ -name '*.tsx' 2>/dev/null || echo ''" "rtk find '*.tsx' src/ 2>/dev/null || echo ''" benchmark "find src/ -name '*.tsx'" "find src/ -name '*.tsx' 2>/dev/null || echo ''" "rtk find '*.tsx' src/ 2>/dev/null || echo ''"
# pnpm commands # pnpm commands
echo "" echo ""
echo "📊 pnpm Commands (unsupported)" echo "pnpm Commands"
echo "==============================" echo "=============================="
benchmark "pnpm list --depth=0" "pnpm list --depth=0 2>&1" "" benchmark "pnpm list --depth=0" "pnpm list --depth=0 2>&1" "rtk pnpm list 2>&1"
benchmark "pnpm outdated" "pnpm outdated 2>&1 || echo 'All packages up-to-date'" "" benchmark "pnpm outdated" "pnpm outdated 2>&1 || echo 'All packages up-to-date'" "rtk pnpm outdated 2>&1 || echo 'All packages up-to-date'"
# Test framework # Test framework
echo "" echo ""
echo "📊 Test Framework (unsupported)" echo "Test Framework"
echo "===============================" echo "==============================="
benchmark "pnpm test (first 50 lines)" "pnpm test 2>&1 | head -50" "" benchmark "pnpm test (first 50 lines)" "pnpm test 2>&1 | head -50" "rtk vitest run 2>&1 | head -50"
# TypeScript # TypeScript
echo "" echo ""
echo "📊 TypeScript Compiler (unsupported)" echo "TypeScript Compiler"
echo "====================================" echo "===================================="
benchmark "pnpm tsc --noEmit" "pnpm tsc --noEmit 2>&1 || echo 'No errors'" "" benchmark "pnpm tsc --noEmit" "pnpm tsc --noEmit 2>&1 || echo 'No errors'" "rtk tsc 2>&1 || echo 'No errors'"
# Prisma # Prisma
echo "" echo ""
echo "📊 Prisma (unsupported)" echo "Prisma"
echo "=======================" echo "======================="
benchmark "pnpm prisma migrate status" "pnpm prisma migrate status 2>&1" "" benchmark "pnpm prisma migrate status" "pnpm prisma migrate status 2>&1" "rtk prisma migrate status 2>&1"
# Build # Build
echo "" echo ""
echo "📊 Build Tools (unsupported)" echo "Build Tools"
echo "============================" echo "============================"
benchmark "pnpm build (first 30 lines)" "pnpm build 2>&1 | head -30" "" benchmark "pnpm build (first 30 lines)" "pnpm build 2>&1 | head -30" "rtk next 2>&1 | head -30"
# Cargo (Rust projects)
echo ""
echo "Cargo (Rust)"
echo "============================"
benchmark "cargo test" "cargo test 2>&1 || echo 'No Cargo.toml'" "rtk cargo test 2>&1 || echo 'No Cargo.toml'"
benchmark "cargo build" "cargo build 2>&1 || echo 'No Cargo.toml'" "rtk cargo build 2>&1 || echo 'No Cargo.toml'"
# Python
echo ""
echo "Python"
echo "============================"
benchmark "pytest" "python -m pytest 2>&1 || echo 'No pytest'" "rtk python pytest 2>&1 || echo 'No pytest'"
# Go
echo ""
echo "Go"
echo "============================"
benchmark "go test" "go test ./... 2>&1 || echo 'No go.mod'" "rtk go test 2>&1 || echo 'No go.mod'"
echo "" >> "$RESULTS_FILE" echo "" >> "$RESULTS_FILE"
echo "---" >> "$RESULTS_FILE" echo "---" >> "$RESULTS_FILE"
echo "" >> "$RESULTS_FILE" echo "" >> "$RESULTS_FILE"
echo "**Legend**:" >> "$RESULTS_FILE" echo "**Legend**:" >> "$RESULTS_FILE"
echo "- ✅ Works: RTK filtering successful" >> "$RESULTS_FILE" echo "- OK: RTK filtering successful" >> "$RESULTS_FILE"
echo "- ❌ Broken: RTK returned error or 0 bytes" >> "$RESULTS_FILE" echo "- FAIL: RTK returned error or 0 bytes" >> "$RESULTS_FILE"
echo "- 🚫 Not supported: RTK doesn't handle this command" >> "$RESULTS_FILE" echo "- Not tested: Command not benchmarked with RTK" >> "$RESULTS_FILE"
echo "" >> "$RESULTS_FILE" echo "" >> "$RESULTS_FILE"
echo "**Token estimation**: chars / 4 ≈ tokens (rough approximation)" >> "$RESULTS_FILE" echo "**Token estimation**: chars / 4 ~ tokens (rough approximation)" >> "$RESULTS_FILE"
echo "" echo ""
echo "✅ Benchmark complete!" echo "Benchmark complete!"
echo "📄 Results saved to: $RESULTS_FILE" echo "Results saved to: $RESULTS_FILE"
echo "" echo ""
echo "📊 Summary:" echo "Summary:"
cat "$RESULTS_FILE" | grep "^|" | tail -n +2 cat "$RESULTS_FILE" | grep "^|" | tail -n +2

View file

@ -18,18 +18,35 @@ tags: [optimization, tokens, efficiency, git]
## Supported Commands ## Supported Commands
### ✅ High-Value (>70% reduction) ### Git (>70% reduction)
- `git log``rtk git log` (92.3% reduction) - `git log``rtk git log` (92.3% reduction)
- `git status``rtk git status` (76.0% reduction) - `git status``rtk git status` (76.0% reduction)
- `find``rtk find` (76.3% reduction) - `find``rtk find` (76.3% reduction)
### Medium-Value (50-70% reduction) ### Medium-Value (50-70% reduction)
- `git diff``rtk git diff` (55.9% reduction) - `git diff``rtk git diff` (55.9% reduction)
- `cat <large-file>``rtk read <file>` (62.5% reduction) - `cat <large-file>``rtk read <file>` (62.5% reduction)
### ❌ Not Recommended ### JS/TS Stack (70-90% reduction)
- `ls` (worse with RTK: -274%) - `pnpm list``rtk pnpm list` (82% reduction)
- `grep` (buggy in v0.2.0) - `pnpm test` / `vitest run``rtk vitest run` (90% reduction)
### Rust Toolchain (80-90% reduction)
- `cargo test``rtk cargo test` (90% reduction)
- `cargo build``rtk cargo build` (80% reduction)
- `cargo clippy``rtk cargo clippy` (80% reduction)
### Python & Go (90% reduction)
- `pytest``rtk python pytest` (90% reduction)
- `go test``rtk go test` (90% reduction)
### GitHub CLI (79-87% reduction)
- `gh pr view``rtk gh pr view` (87% reduction)
- `gh pr checks``rtk gh pr checks` (79% reduction)
### File Operations
- `ls``rtk ls` (condensed output)
- `grep``rtk grep` (filtered output)
## Activation Examples ## Activation Examples
@ -43,16 +60,16 @@ tags: [optimization, tokens, efficiency, git]
Before first use, verify RTK is installed: Before first use, verify RTK is installed:
```bash ```bash
rtk --version # Should output: rtk 0.2.0 rtk --version # Should output: rtk 0.16.0+
``` ```
If not installed: If not installed:
```bash ```bash
curl -fsSL "https://github.com/pszymkowiak/rtk/releases/latest/download/rtk-aarch64-apple-darwin.tar.gz" -o rtk.tar.gz # Homebrew (macOS/Linux)
tar -xzf rtk.tar.gz brew install rtk-ai/tap/rtk
sudo mv rtk /usr/local/bin/
sudo chmod +x /usr/local/bin/rtk # Cargo (all platforms)
rm rtk.tar.gz cargo install rtk
``` ```
## Usage Pattern ## Usage Pattern
@ -74,7 +91,7 @@ Optional: Track cumulative savings across session:
```bash ```bash
# At session end # At session end
rtk gain # Shows total token savings for session rtk gain # Shows total token savings for session (SQLite-backed)
``` ```
## Edge Cases ## Edge Cases
@ -91,8 +108,10 @@ Enable via CLAUDE.md:
Use RTK (Rust Token Killer) for high-verbosity commands: Use RTK (Rust Token Killer) for high-verbosity commands:
- git operations (log, status, diff) - git operations (log, status, diff)
- file finding - package managers (pnpm, npm)
- large file reading - build tools (cargo, go)
- test frameworks (vitest, pytest)
- file finding and reading
``` ```
## Metrics (Verified) ## Metrics (Verified)
@ -108,18 +127,18 @@ Based on real-world testing:
## Limitations ## Limitations
- RTK v0.2.0 (8 stars on GitHub, low adoption) - 446 stars on GitHub, actively maintained (30 releases in 23 days)
- Some commands buggy (grep returns empty) - Not suitable for interactive commands
- ls command worse with RTK (-274% increase) - Rapid development cadence (check for breaking changes)
- Requires manual installation (not on npm/brew yet)
## Recommendation ## Recommendation
**Use RTK for**: git workflows, file finding, large file reading **Use RTK for**: git workflows, file operations, test frameworks, build tools, package managers
**Skip RTK for**: ls, grep, small outputs, quick exploration **Skip RTK for**: small outputs, quick exploration, interactive commands
## References ## References
- RTK GitHub: https://github.com/pszymkowiak/rtk - RTK GitHub: https://github.com/rtk-ai/rtk
- RTK Website: https://www.rtk-ai.app/
- Evaluation: `docs/resource-evaluations/rtk-evaluation.md` - Evaluation: `docs/resource-evaluations/rtk-evaluation.md`
- CLAUDE.md template: `examples/claude-md/rtk-optimized.md` - CLAUDE.md template: `examples/claude-md/rtk-optimized.md`

View file

@ -1,19 +1,27 @@
# Exported Formats # Exported Formats
Alternative formats generated from the main guide. ## Status: Deprecated
## Contents The PDF exports in `deprecated/` were generated from an earlier version of the guide (~9K lines, v1.x era). The guide has since grown to **~19K lines across 10 sections** — these exports no longer reflect the current content.
| File | Description | Best For | **Source of truth**: [`guide/ultimate-guide.md`](../guide/ultimate-guide.md)
|------|-------------|----------|
| [notebooklm.pdf](./notebooklm.pdf) | Visual overview generated by NotebookLM | Quick visual scan (~20 min) |
| [kimi.pdf](./kimi.pdf) | Full text PDF export | Offline reading |
## Notes ## Deprecated Files
- These files are **generated outputs**, not source content | File | Description | Status |
- The source of truth is [`guide/ultimate-guide.md`](../guide/ultimate-guide.md) |------|-------------|--------|
- PDFs may lag behind the latest guide updates | [notebooklm.pdf](deprecated/notebooklm.pdf) | Visual overview generated by NotebookLM | Outdated (v1.x) |
| [kimi.pdf](deprecated/kimi.pdf) | Full text PDF export via Kimi | Outdated (v1.x) |
## Planned
Fresh exports are needed to match the current guide (v3.27.0+):
- **PDF** — Full guide export (Quarto/Typst pipeline via [`pdf-generator` skill](../examples/skills/pdf-generator.md))
- **NotebookLM** — Updated visual overview
- **EPUB** — For e-reader consumption (requested)
Contributions welcome. See [CONTRIBUTING.md](../CONTRIBUTING.md).
--- ---

View file

@ -22,6 +22,8 @@
- [11. AI Coding Agents Matrix](#11-ai-coding-agents-matrix) - [11. AI Coding Agents Matrix](#11-ai-coding-agents-matrix)
- [11.1 Goose: Open-Source Alternative (Block)](#111-goose-open-source-alternative-block) - [11.1 Goose: Open-Source Alternative (Block)](#111-goose-open-source-alternative-block)
- [11.2 Practitioner Insights](#112-practitioner-insights) - [11.2 Practitioner Insights](#112-practitioner-insights)
- [11.3 When to Build vs Use](#113-when-to-build-vs-use)
- [11.4 Skills Distribution Platforms](#114-skills-distribution-platforms)
- [12. Context Packing Tools](#12-context-packing-tools) - [12. Context Packing Tools](#12-context-packing-tools)
- [Appendix: Ready-to-Use Prompts](#appendix-ready-to-use-prompts) - [Appendix: Ready-to-Use Prompts](#appendix-ready-to-use-prompts)
- [Alternative Providers (Community Workarounds)](#alternative-providers-community-workarounds) - [Alternative Providers (Community Workarounds)](#alternative-providers-community-workarounds)
@ -1987,8 +1989,8 @@ An **interactive comparison matrix** of 23 AI coding agents across 11 technical
|-------------------|---------------------| |-------------------|---------------------|
| "Which agents exist?" | "How to use Claude Code effectively?" | | "Which agents exist?" | "How to use Claude Code effectively?" |
| Feature comparison (11 criteria) | Workflows, architecture, TDD/SDD methodologies | | Feature comparison (11 criteria) | Workflows, architecture, TDD/SDD methodologies |
| 23 agents × shallow | 1 agent × deep (11K lines) | | 23 agents × shallow | 1 agent × deep (19K lines) |
| Technical specs | Practical templates (66+), quiz (257 questions) | | Technical specs | Practical templates (120), quiz (264 questions) |
**Use case**: Use Matrix to **discover and compare** → Choose Claude Code → Use this guide to **master it**. **Use case**: Use Matrix to **discover and compare** → Choose Claude Code → Use this guide to **master it**.
@ -2310,9 +2312,112 @@ External resources from experienced practitioners that validate and extend the p
**Caveat**: Performance metrics reported (-63% LCP, -33% LOC) are attributable to the Nuxt 3 migration, not Claude Code. The productivity trajectory is the transferable insight. Article is self-published by the team (no third-party validation). **Caveat**: Performance metrics reported (-63% LCP, -33% LOC) are attributable to the Nuxt 3 migration, not Claude Code. The productivity trajectory is the transferable insight. Article is self-published by the team (no third-party validation).
### Outcome Engineering — o16g Manifesto (Cory Ondrejka)
**URL**: [o16g.com](https://o16g.com/)
**Author credentials**:
- CTO at Onebrief (military command AI platform)
- Co-creator of Second Life (Linden Lab CTO)
- Former VP Google Experience (1,500+ engineers, advisor to Sundar Pichai)
- Former VP Mobile Engineering at Meta
- Published: February 13, 2026
**Content summary**: Philosophical manifesto proposing 16 principles for shifting from "software engineering" to "outcome engineering" — prioritizing measurable results over code output. Organized in two parts:
1. **Goals** (1-8): Human intent guides agents, verified reality over metrics, budget-based management replacing backlogs, creation over tedium, map context before dispatch, build aggressively to test hypotheses, analyze failures as learning artifacts
2. **Building** (9-16): Agent orchestration, constitutional encoding, knowledge graphs, priority systems, documentation, continuous improvement, risk gates, outcome auditing
**Cultural positioning**: The naming "o16g" follows the numeronym pattern (i18n, k8s, a11y) — designed for community adoption. Honeycomb cited it in their 10-year manifesto. Talent500 picked up the term on publication day. Posted on Hacker News. Positions itself as a successor framework to software engineering for the agentic era, comparable in ambition to the Agile Manifesto (2001) for its era.
**Alignment with this guide**:
| o16g Concept | This Guide Reference |
|--------------|---------------------|
| Engineer → outcome architect | Mental Model: orchestrator pattern (ultimate-guide.md:2360) |
| Risk gates blocking delivery | Production Safety rules (production-safety.md) |
| Agent orchestration principles | Agent Teams (workflows/agent-teams.md) |
| Map context before dispatch | CLAUDE.md + Plan Mode (Sections 3.1, 2.3) |
| Verified reality over metrics | Trust Calibration (ultimate-guide.md:1039) |
**Value**: Not a Claude Code-specific resource — no commands, configurations, or actionable patterns. Value is cultural: a credible industry leader articulating the philosophical shift that underpins all patterns in this guide. If "outcome engineering" gains traction as a term (like "vibe coding" did), this manifesto is the primary source.
**Status**: Emerging (day-1 publication). On watch list for community adoption tracking.
--- ---
## 11.3 Skills Distribution Platforms ## 11.3 When to Build vs Use
For most developers, Claude Code CLI provides the right balance of power and simplicity. But understanding when to use pre-built agents versus building custom agents helps you choose the right tool for your needs.
### Pre-Built Agents
**Claude Code, Cursor, Windsurf, Goose**: Ready-to-use CLI or GUI tools optimized for coding workflows. Install and start working immediately.
**Use when**:
- You need a coding assistant now
- Standard workflows (implementation, debugging, refactoring)
- Want managed updates and community support
- Prefer fixed costs (subscriptions) over usage-based pricing
### Agent Builder Frameworks
**Google ADK, LangChain, Vercel AI SDK**: Code-first toolkits for building custom agents from scratch.
**Key features**:
- **Multi-LLM support**: Use Claude, GPT, Gemini, or local models (often via unified APIs)
- **MCP-compatible**: Consume the same MCP servers as Claude Code (3,000+ available)
- **Custom workflows**: Design agent behavior for domain-specific tasks
- **Embedable**: Integrate agents into your applications
**Use when**:
- Building a product around AI agents (not just using one)
- Need multi-LLM fallback strategies (e.g., Claude for code, GPT for other tasks)
- Require custom execution flows beyond coding assistance
- Want full control over prompts, memory, and orchestration
| Framework | Focus | Claude Support | Maturity |
|-----------|-------|----------------|----------|
| **[Google ADK](https://google.github.io/adk-docs/)** | Multi-language (TypeScript, Python, Go, Java) | ✅ Native | Production (17.6K⭐, Renault/Box) |
| **[LangChain](https://python.langchain.com/)** | Python/JS ecosystem, largest community | ✅ Via `@anthropic-ai/sdk` | Mature (100K+⭐) |
| **[Vercel AI SDK](https://sdk.vercel.ai/)** | Edge/streaming, React-first | ✅ Native provider | Active (15K+⭐) |
### Direct API
**Anthropic API, OpenAI API**: Raw LLM access without agent scaffolding.
**Use when**:
- Building simple chatbots or single-purpose bots
- Maximum flexibility, minimal dependencies
- You're handling tool calls, memory, and orchestration yourself
### Decision Tree
```
Need coding assistant? → Claude Code
Building agent product? → ADK/LangChain
Simple chatbot only? → Direct API
Multi-LLM required? → Framework (ADK/LangChain)
Custom workflow logic? → Framework
Standard dev tasks? → Pre-built agent
```
### MCP: The Common Standard
All frameworks (Claude Code, ADK, LangChain) support the **Model Context Protocol** (MCP). This means:
- MCP servers you build work across tools
- 3,000+ MCP servers available ecosystem-wide
- Tools, prompts, and resources are portable
**Example**: A `mcp-server-github` works with Claude Code, ADK-built agents, and LangChain agents identically.
**Resources**:
- [MCP Specification](https://modelcontextprotocol.io)
- [MCP Servers Ecosystem](https://github.com/modelcontextprotocol/servers)
- [This guide's MCP coverage](../guide/ultimate-guide.md#mcp-servers) (Section 6)
---
## 11.4 Skills Distribution Platforms
For discovering and distributing agent skills beyond local creation: For discovering and distributing agent skills beyond local creation:

View file

@ -6,7 +6,7 @@
**Written with**: Claude (Anthropic) **Written with**: Claude (Anthropic)
**Version**: 3.27.0 | **Last Updated**: February 2026 **Version**: 3.27.1 | **Last Updated**: February 2026
--- ---
@ -518,7 +518,7 @@ where.exe claude; claude doctor; claude mcp list
| Tool | Purpose | Install | | Tool | Purpose | Install |
|------|---------|---------| |------|---------|---------|
| **ccusage** | Cost tracking & reports | `bunx ccusage daily` | | **ccusage** | Cost tracking & reports | `bunx ccusage daily` |
| **RTK** | Token reduction (60-90%) | `cargo install rtk` | | **RTK** | Token reduction (60-90%) | `brew install rtk-ai/tap/rtk` or `cargo install rtk` · [Site](https://www.rtk-ai.app/) |
| **claude-code-viewer** | Session history UI | `npx @kimuson/claude-code-viewer` | | **claude-code-viewer** | Session history UI | `npx @kimuson/claude-code-viewer` |
| **Entire CLI** | Session checkpoints + governance | [entire.io](https://entire.io) (Feb 2026) | | **Entire CLI** | Session checkpoints + governance | [entire.io](https://entire.io) (Feb 2026) |
@ -538,4 +538,4 @@ where.exe claude; claude doctor; claude mcp list
**Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude **Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
*Last updated: February 2026 | Version 3.27.0* *Last updated: February 2026 | Version 3.27.1*

View file

@ -1,6 +1,6 @@
# MCP Servers Ecosystem # MCP Servers Ecosystem
**Last updated**: January 2026 • **Next review**: February 2026 **Last updated**: February 2026 • **Next review**: March 2026
This guide covers validated community MCP servers beyond the official Anthropic servers. All servers listed have been evaluated for production readiness, maintenance activity, and security. This guide covers validated community MCP servers beyond the official Anthropic servers. All servers listed have been evaluated for production readiness, maintenance activity, and security.
@ -13,6 +13,7 @@ This guide covers validated community MCP servers beyond the official Anthropic
- [Browser Automation](#browser-automation) - [Browser Automation](#browser-automation)
- [DevOps & Infrastructure](#devops--infrastructure) - [DevOps & Infrastructure](#devops--infrastructure)
- [Security & Code Analysis](#security--code-analysis) - [Security & Code Analysis](#security--code-analysis)
- [Code Search & Analysis](#code-search--analysis)
- [Documentation & Knowledge](#documentation--knowledge) - [Documentation & Knowledge](#documentation--knowledge)
- [Project Management](#project-management) - [Project Management](#project-management)
- [Orchestration](#orchestration) - [Orchestration](#orchestration)
@ -700,6 +701,136 @@ Result: [VULNERABLE] SQL injection detected at line 2.
--- ---
### Code Search & Analysis
#### Grepai MCP
**Community server** for semantic code search and call graph analysis via local Ollama embeddings. Searches code by intent ("payment flow", "auth logic") instead of exact patterns, and traces function call relationships.
**Repository**: [yoanbernabeu/grepai](https://github.com/yoanbernabeu/grepai)
**License**: MIT
**Status**: Active development
**Privacy**: Fully local (Ollama + nomic-embed-text), no data leaves your machine
**Use Case**: Developer needs to understand unfamiliar codebase → grepai finds relevant code by natural language description and maps function dependencies, without reading entire files.
**Key Features**:
| Capability | Details |
|------------|---------|
| `grepai_search` | Semantic search by natural language query (e.g., "error handling middleware") |
| `grepai_trace_callers` | Find all functions that call a given symbol |
| `grepai_trace_callees` | Find all functions called by a given symbol |
| `grepai_trace_graph` | Full call graph (callers + callees) with configurable depth |
| `grepai_index_status` | Health check: indexed files, chunks, configuration |
**Token Efficiency**:
| Workflow | Tokens | Verdict |
|----------|--------|---------|
| Grep + Read files (brute force) | ~15K | Noisy, lots of irrelevant context |
| grepai search + trace | ~4K | Targeted, relevant results only |
| grepai alone (no follow-up) | ~2-3K | Fast discovery |
**Setup**:
```bash
# Install grepai
curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh
# Install Ollama + embedding model
brew install ollama
ollama pull nomic-embed-text
# Initialize in your project
cd /path/to/project
grepai init # Choose: ollama, nomic-embed-text, gob
# Index your codebase
grepai index
# Optional: watch for file changes (auto-reindex)
grepai watch
```
**Claude Code Configuration**:
```bash
claude mcp add grepai -- grepai mcp
```
**`.mcp.json` (project-scoped)**:
```json
{
"mcpServers": {
"grepai": {
"command": "grepai",
"args": ["mcp"]
}
}
}
```
**Example Usage**:
```
User: "Find the authentication flow in this codebase"
Claude: [Uses grepai_search query="authentication flow" limit=5]
Result: 3 relevant files with line numbers and similarity scores
- src/auth/middleware.ts:12-45 (0.89)
- src/routes/login.ts:8-32 (0.85)
- src/utils/jwt.ts:1-28 (0.78)
User: "What calls the validateToken function?"
Claude: [Uses grepai_trace_callers symbol="validateToken"]
Result: Call graph showing 4 callers across 3 files
- authMiddleware → validateToken
- refreshHandler → validateToken
- wsAuthGuard → validateToken
- testHelper → validateToken
```
**Quality Score**: **7.8/10** ⭐⭐⭐⭐
| Dimension | Score | Notes |
|-----------|-------|-------|
| Maintenance | 8/10 | Active development, responsive maintainer |
| Documentation | 7/10 | Good README, MCP integration docs |
| Tests | 7/10 | CI present, growing coverage |
| Performance | 8/10 | Fast local embeddings (~2s search), no network latency |
| Adoption | 9/10 | Growing community, production use in Claude Code setups |
**Limitations & Workarounds**:
| Limitation | Workaround |
|------------|-----------|
| Requires Ollama running locally | `brew services start ollama` (auto-start) |
| Index can become stale | Use `grepai watch` for auto-reindex |
| Not ideal for exact pattern matching | Use native Grep tool for regex patterns |
| Embedding model download (~270MB) | One-time `ollama pull nomic-embed-text` |
**Alternatives**:
| Server | Advantage | Disadvantage |
|--------|-----------|--------------|
| **Grepai** | Local, private, semantic + call graphs | Requires Ollama setup |
| Native Grep | Instant, exact patterns | No semantic understanding |
| GitHub Code Search | Cloud-based, cross-repo | Requires GitHub, no call graphs |
**Cross-reference**: See [ultimate-guide.md — MCP Servers: Grepai](./ultimate-guide.md) for detailed usage patterns, prompt strategies, and integration with other MCP servers.
**Resources**:
- **GitHub**: https://github.com/yoanbernabeu/grepai
- **Ollama**: https://ollama.com
- **Embedding Model**: nomic-embed-text (nomic-ai)
---
### Documentation & Knowledge ### Documentation & Knowledge
#### Context7 MCP #### Context7 MCP
@ -1103,6 +1234,7 @@ Servers evaluated but not included in the validated list:
| **Browser Automation** | 3 (Playwright, Browserbase, Chrome DevTools) | Testing, debugging, data extraction | | **Browser Automation** | 3 (Playwright, Browserbase, Chrome DevTools) | Testing, debugging, data extraction |
| **DevOps/Infrastructure** | 2 (Vercel, Kubernetes) | Deployment, cluster management | | **DevOps/Infrastructure** | 2 (Vercel, Kubernetes) | Deployment, cluster management |
| **Security/Code Analysis** | 1 (Semgrep) | Vulnerability scanning, secure coding | | **Security/Code Analysis** | 1 (Semgrep) | Vulnerability scanning, secure coding |
| **Code Search/Analysis** | 1 (Grepai) | Semantic search, call graph analysis |
| **Documentation/Knowledge** | 1 (Context7) | API reference, code examples | | **Documentation/Knowledge** | 1 (Context7) | API reference, code examples |
| **Project Management** | 1 (Linear) | Issue tracking, sprint planning | | **Project Management** | 1 (Linear) | Issue tracking, sprint planning |
| **Orchestration** | 1 (MCP-Compose) | Multi-server management | | **Orchestration** | 1 (MCP-Compose) | Multi-server management |
@ -1110,12 +1242,12 @@ Servers evaluated but not included in the validated list:
### Maintainer Types ### Maintainer Types
- **Official Servers** (6): Playwright (Microsoft), Browserbase, Semgrep, Context7, Kubernetes (Red Hat), Chrome DevTools (Anthropic) - **Official Servers** (6): Playwright (Microsoft), Browserbase, Semgrep, Context7, Kubernetes (Red Hat), Chrome DevTools (Anthropic)
- **Community Servers** (3): Linear, Vercel, MCP-Compose (well-designed, actively maintained) - **Community Servers** (4): Linear, Vercel, MCP-Compose, Grepai (well-designed, actively maintained)
--- ---
**Last updated**: January 2026 **Last updated**: February 2026
**Next review**: February 2026 **Next review**: March 2026
**Maintainer**: Claude Code Ultimate Guide Team **Maintainer**: Claude Code Ultimate Guide Team
--- ---

View file

@ -85,27 +85,25 @@ A Python TUI for visual token burn-rate tracking. Displays charts showing consum
### RTK (Rust Token Killer) ### RTK (Rust Token Killer)
A CLI proxy that filters command outputs **before** they reach Claude's context. A CLI proxy that filters command outputs **before** they reach Claude's context. 446 stars, 38 forks, 700+ upvotes on r/ClaudeAI.
| Attribute | Details | | Attribute | Details |
|-----------|---------| |-----------|---------|
| **Source** | [GitHub: pszymkowiak/rtk](https://github.com/pszymkowiak/rtk) (upstream stable) | | **Source** | [GitHub: rtk-ai/rtk](https://github.com/rtk-ai/rtk) |
| **Fork** | [GitHub: FlorianBruniaux/rtk](https://github.com/FlorianBruniaux/rtk) (extended features) | | **Website** | [rtk-ai.app](https://www.rtk-ai.app/) |
| **Install** | `cargo install rtk` or binary download | | **Install** | `brew install rtk-ai/tap/rtk` or `cargo install rtk` |
| **Language** | Rust (standalone binary) | | **Language** | Rust (standalone binary) |
| **Version** | v0.2.0+ (upstream), v0.4.0+ (fork) | | **Version** | v0.16.0 |
**Key features**: **Key features**:
- `rtk git log` (92% reduction), `rtk git status` (76% reduction), `rtk git diff` (56% reduction) - `rtk git log` (92% reduction), `rtk git status` (76% reduction), `rtk git diff` (56% reduction)
- `rtk vitest run`, `rtk prisma`, `rtk pnpm` (fork only, 70-90% reduction) - `rtk vitest run`, `rtk prisma`, `rtk pnpm` (70-90% reduction)
- `rtk gain` - token savings analytics - `rtk python pytest`, `rtk go test` (multi-language support)
- `rtk discover` - find missed optimization opportunities (fork only) - `rtk cargo test/build/clippy` (Rust toolchain)
- `rtk init` - hook-first install, `rtk tree` - project structure, `rtk learn` - interactive learning
**Two versions:** - `rtk gain` - token savings analytics (SQLite tracking)
- `rtk discover` - find missed optimization opportunities
- **Upstream** (pszymkowiak): Stable, git/find/cat focus, minimal dependencies
- **Fork** (FlorianBruniaux): Adds JS/TS stack support (vitest, pnpm, prisma), bug fixes (grep, ls), analytics
**When to choose RTK vs ccusage/ccburn**: **When to choose RTK vs ccusage/ccburn**:
@ -113,7 +111,7 @@ A CLI proxy that filters command outputs **before** they reach Claude's context.
- ccusage/ccburn **monitor** it (postprocessing) - ccusage/ccburn **monitor** it (postprocessing)
- Use both together for maximum efficiency - Use both together for maximum efficiency
**Limitations**: Early-stage project. Upstream has grep/ls bugs (fixed in fork). Not suitable for interactive commands or very small outputs. **Limitations**: Rapid development cadence (30 releases in 23 days). Not suitable for interactive commands or very small outputs.
> **Cross-ref**: Full docs at [ultimate-guide.md Section 9](./ultimate-guide.md#command-output-optimization-with-rtk) > **Cross-ref**: Full docs at [ultimate-guide.md Section 9](./ultimate-guide.md#command-output-optimization-with-rtk)

View file

@ -10,7 +10,7 @@
**Last updated**: January 2026 **Last updated**: January 2026
**Version**: 3.27.0 **Version**: 3.27.1
--- ---
@ -4283,7 +4283,7 @@ The `.claude/` folder is your project's Claude Code directory for memory, settin
| Personal preferences | `CLAUDE.md` | ❌ Gitignore | | Personal preferences | `CLAUDE.md` | ❌ Gitignore |
| Personal permissions | `settings.local.json` | ❌ Gitignore | | Personal permissions | `settings.local.json` | ❌ Gitignore |
### 3.27.0 Version Control & Backup ### 3.27.1 Version Control & Backup
**Problem**: Without version control, losing your Claude Code configuration means hours of manual reconfiguration across agents, skills, hooks, and MCP servers. **Problem**: Without version control, losing your Claude Code configuration means hours of manual reconfiguration across agents, skills, hooks, and MCP servers.
@ -8158,6 +8158,191 @@ Fix implementation or update tests.
Claude sees these messages immediately and can iterate without manual test runs. Claude sees these messages immediately and can iterate without manual test runs.
### Example 3: Session Summary Hook
**Event**: `Stop`
Display comprehensive session statistics when Claude Code ends, inspired by Gemini CLI's session summary feature.
#### The Problem
After a long Claude Code session, you might wonder:
- How much time did I spend?
- How many API requests did Claude make?
- Which tools did I use most?
- What did this session cost?
Without session tracking, this information is buried in JSONL files that are hard to parse manually.
#### The Solution
A Stop hook that automatically displays a formatted summary with:
- Session metadata (ID, auto-generated name, git branch)
- Duration breakdown (wall time vs active Claude time)
- Tool usage statistics with success/error counts
- Model usage per model (requests, input/output tokens, cache stats)
- Estimated cost (via ccusage or built-in pricing table)
#### Implementation
**File**: `examples/hooks/bash/session-summary.sh`
**Requirements**:
- `jq` (required for JSON parsing)
- `ccusage` (optional, for accurate cost calculation via Claude Code Usage tool)
- bash 3.2+ (macOS compatible)
**Configuration**:
```json
{
"hooks": {
"Stop": [{
"hooks": [{
"type": "command",
"command": "$CLAUDE_PROJECT_DIR/.claude/hooks/session-summary.sh"
}]
}]
}
}
```
**Environment Variables**:
| Variable | Default | Description |
|----------|---------|-------------|
| `NO_COLOR` | - | Disable ANSI colors |
| `SESSION_SUMMARY_LOG` | `~/.claude/logs` | Override log directory |
| `SESSION_SUMMARY_SKIP` | `0` | Set to `1` to disable summary |
#### Example Output
```
═══ Session Summary ═══════════════════
ID: abc-123-def-456
Name: Security hardening v3.26
Branch: main
Duration: Wall 1h 34m | Active 14m 24s
Tool Calls: 47 (OK 45 / ERR 2)
Read: 12 Bash: 10 Edit: 8 Write: 6
Grep: 5 Glob: 4 WebSearch: 2
Model Usage Reqs Input Output
claude-sonnet-4-5 42 493.9K 2.5K
claude-haiku-4-5 5 12.4K 46
Cache: 1.2M read / 45.3K created
Est. Cost: $0.74
═══════════════════════════════════════
```
#### Data Sources
The hook extracts data from two locations:
**1. Session JSONL file** (`~/.claude/projects/{encoded-path}/{session-id}.jsonl`):
- API requests count
- Token usage per model
- Tool calls (extracted from assistant messages)
- Tool errors (from tool_result with is_error: true)
- Turn durations (system messages with subtype: turn_duration)
- Wall time (first to last timestamp)
**2. Sessions index** (`~/.claude/projects/{encoded-path}/sessions-index.json`):
- Session summary (auto-generated by Claude)
- Git branch
- Message count
#### Log File
Session summaries are also logged to `~/.claude/logs/session-summaries.jsonl` for historical analysis:
```json
{
"timestamp": "2026-02-13T10:30:00Z",
"session_id": "abc-123-def",
"session_name": "Security hardening v3.26",
"git_branch": "main",
"project": "/path/to/project",
"duration_wall_ms": 5640000,
"duration_active_ms": 864000,
"api_requests": 47,
"tool_calls": {"Read": 12, "Bash": 10, "Edit": 8},
"tool_errors": 2,
"models": {
"claude-sonnet-4-5-20250929": {
"requests": 42,
"input": 493985,
"output": 2505,
"cache_read": 1200000,
"cache_create": 45300
}
},
"total_tokens": {
"input": 506458,
"output": 2551,
"cache_read": 1200000,
"cache_create": 45300
},
"cost_usd": 0.74
}
```
#### Performance
- **Execution time**: <2s for sessions up to 100MB
- **Memory**: Streaming JSONL processing via `jq reduce inputs` (memory-bounded)
- **Impact**: Runs at session end (doesn't block during work)
#### Cost Calculation
**Priority 1**: ccusage tool (accurate, if available)
```bash
ccusage session --id <session-id> --json --offline
```
**Fallback**: Built-in pricing table (as of 2026-02)
| Model | Input (per 1M tokens) | Output (per 1M tokens) |
|-------|----------------------|------------------------|
| claude-opus-4-6 | $15.00 | $75.00 |
| claude-sonnet-4-5 | $3.00 | $15.00 |
| claude-haiku-4-5 | $0.80 | $4.00 |
#### Edge Cases Handled
- **Empty sessions** (0 API requests): Displays minimal summary
- **Missing JSONL file**: Falls back to sessions-index.json
- **ccusage unavailable**: Uses pricing table fallback
- **No turn_duration entries**: Shows wall time only
- **Very large sessions** (500MB+): Streams with jq (memory safe)
#### Installation
```bash
# Copy hook
cp examples/hooks/bash/session-summary.sh .claude/hooks/
chmod +x .claude/hooks/session-summary.sh
# Add to settings.json (see Configuration above)
# Test it
echo '{"session_id":"test","cwd":"'$(pwd)'"}' | .claude/hooks/session-summary.sh
```
#### Comparison with Gemini CLI
| Feature | Gemini CLI | Claude Code (with this hook) |
|---------|------------|------------------------------|
| Session summary | ✅ Built-in | ✅ Via hook |
| Duration tracking | ✅ Wall + active | ✅ Wall + active |
| Tool calls breakdown | ✅ Yes | ✅ Yes (with success/error) |
| Model usage | ✅ Requests + tokens | ✅ Requests + tokens + cache |
| Cost estimation | ✅ Yes | ✅ ccusage or pricing table |
| Structured logging | ❌ No | ✅ JSONL for analysis |
--- ---
# 8. MCP Servers # 8. MCP Servers
@ -13169,59 +13354,70 @@ You: "Fix typos in auth.ts, user.ts, and api.ts"
### Command Output Optimization with RTK ### Command Output Optimization with RTK
**RTK (Rust Token Killer)** filters bash command outputs **before** they reach Claude's context, achieving 70-90% token reduction across git, testing, and development workflows. **RTK (Rust Token Killer)** filters bash command outputs **before** they reach Claude's context, achieving 60-90% token reduction across git, testing, and development workflows. 446 stars, 38 forks, 700+ upvotes on r/ClaudeAI.
**Two Repositories:** **Repository:** [rtk-ai/rtk](https://github.com/rtk-ai/rtk) | **Website:** [rtk-ai.app](https://www.rtk-ai.app/)
- **Upstream** (stable): [pszymkowiak/rtk](https://github.com/pszymkowiak/rtk) - Core git/find/cat optimizations
- **Fork** (extended): [FlorianBruniaux/rtk](https://github.com/FlorianBruniaux/rtk) - Adds JS/TS tooling (vitest, pnpm, prisma) + analytics
**Installation:** **Installation:**
```bash ```bash
# Option 1: Stable upstream (cargo) # Option 1: Homebrew (macOS/Linux)
brew install rtk-ai/tap/rtk
# Option 2: Cargo (all platforms)
cargo install rtk cargo install rtk
# Option 2: Extended fork with all features # Option 3: Install script
git clone https://github.com/FlorianBruniaux/rtk.git curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/main/install.sh | bash
cd rtk && git checkout feat/all-features
cargo install --path . --force
# Option 3: Binary (macOS ARM64)
curl -fsSL "https://github.com/pszymkowiak/rtk/releases/latest/download/rtk-aarch64-apple-darwin.tar.gz" -o rtk.tar.gz && tar -xzf rtk.tar.gz && sudo mv rtk /usr/local/bin/ && rm rtk.tar.gz
# Verify installation # Verify installation
rtk --version # v0.4.0+ (fork) or v0.2.0+ (upstream) rtk --version # v0.16.0+
``` ```
**Proven Token Savings (Benchmarked):** **Proven Token Savings (Benchmarked on v0.2.0):**
| Command | Baseline | RTK | Reduction | | Command | Baseline | RTK | Reduction |
|---------|----------|-----|-----------| |---------|----------|-----|-----------|
| `rtk git log` | 13,994 chars | 1,076 chars | **92.3%** | | `rtk git log` | 13,994 chars | 1,076 chars | **92.3%** |
| `rtk git status` | 100 chars | 24 chars | **76.0%** | | `rtk git status` | 100 chars | 24 chars | **76.0%** |
| `rtk git diff` | 15,815 chars | 6,982 chars | **55.9%** | | `rtk git diff` | 15,815 chars | 6,982 chars | **55.9%** |
| `rtk vitest run` (fork) | ~50,000 chars | ~5,000 chars | **90.0%** | | `rtk vitest run` | ~50,000 chars | ~5,000 chars | **90.0%** |
| `rtk pnpm list` (fork) | ~8,000 chars | ~2,400 chars | **70.0%** | | `rtk pnpm list` | ~8,000 chars | ~2,400 chars | **70.0%** |
| `rtk cat CHANGELOG.md` | 163,587 chars | 61,339 chars | **62.5%** | | `rtk cat CHANGELOG.md` | 163,587 chars | 61,339 chars | **62.5%** |
**Average: 70-90% token reduction depending on commands** **Average: 60-90% token reduction depending on commands**
**Usage Pattern:** **Key Features (v0.16.0):**
```bash ```bash
# Git operations (both versions) # Git operations
rtk git log rtk git log
rtk git status rtk git status
rtk git diff HEAD~1 rtk git diff HEAD~1
# JS/TS Stack (fork only) # JS/TS Stack
rtk vitest run # Test results condensed rtk vitest run # Test results condensed
rtk pnpm list # Dependency tree optimized rtk pnpm list # Dependency tree optimized
rtk prisma migrate status # Migration status filtered rtk prisma migrate status # Migration status filtered
# Analytics (fork only) # Python
rtk gain # Show token savings stats rtk python pytest # Python test output condensed
# Go
rtk go test # Go test results filtered
# Rust
rtk cargo test # Cargo test output condensed
rtk cargo build # Build output filtered
rtk cargo clippy # Lints grouped by severity
# Project Setup & Learning
rtk init # Initialize RTK in a project (hook-first install)
rtk tree # Project structure condensed
rtk learn # Interactive RTK learning
# Analytics
rtk gain # Token savings dashboard (SQLite tracking)
rtk discover # Find missed optimization opportunities rtk discover # Find missed optimization opportunities
``` ```
@ -13236,53 +13432,42 @@ rtk discover # Find missed optimization opportunities
**Integration Strategies:** **Integration Strategies:**
1. **CLAUDE.md instruction** (manual wrapper): 1. **Hook-first install** (recommended):
```bash
rtk init # Sets up PreToolUse hook automatically
```
2. **CLAUDE.md instruction** (manual wrapper):
```markdown ```markdown
## Token Optimization ## Token Optimization
Use RTK for git operations: Use RTK for all supported commands:
- `rtk git log` (92.3% reduction) - `rtk git log` (92.3% reduction)
- `rtk git status` (76.0% reduction) - `rtk git status` (76.0% reduction)
- `rtk git diff` (55.9% reduction) - `rtk git diff` (55.9% reduction)
``` ```
2. **Skill** (auto-suggestion): 3. **Skill** (auto-suggestion):
- Template: `examples/skills/rtk-optimizer/SKILL.md` - Template: `examples/skills/rtk-optimizer/SKILL.md`
- Detects high-verbosity commands - Detects high-verbosity commands
- Suggests RTK wrapper automatically - Suggests RTK wrapper automatically
3. **Hook** (automatic wrapper): 4. **Hook** (automatic wrapper):
- Template: `examples/hooks/bash/rtk-auto-wrapper.sh` - Template: `examples/hooks/bash/rtk-auto-wrapper.sh`
- PreToolUse hook intercepts bash commands - PreToolUse hook intercepts bash commands
- Applies RTK wrapper when beneficial - Applies RTK wrapper when beneficial
**Fork Features (feat/all-features):**
- ✅ `rtk vitest` - Test output condensed (90% reduction)
- ✅ `rtk pnpm` - Package manager output optimized
- ✅ `rtk prisma` - Database migration status filtered
- ✅ `rtk gain` - Token savings analytics dashboard
- ✅ `rtk discover` - Missed optimization opportunity finder
- ✅ Bug fixes: `grep` and `ls` now work correctly
**Upstream Limitations (v0.2.0):**
- ⚠️ `grep` bug (returns empty output) - **Fixed in fork**
- ⚠️ `ls` produces worse output - **Fixed in fork**
- ⚠️ No JS/TS tooling support - **Added in fork**
**Recommendation:** **Recommendation:**
- ✅ **Fork**: Full-stack JS/TS projects, testing workflows, analytics needs - ✅ **Use RTK**: Full-stack projects (JS/TS, Rust, Python, Go), testing workflows, analytics
- ✅ **Upstream**: Git-only workflows, minimal dependencies, stable releases
- ❌ **Skip RTK**: Small outputs (<100 chars), quick exploration, interactive commands - ❌ **Skip RTK**: Small outputs (<100 chars), quick exploration, interactive commands
**See also:** **See also:**
- Evaluation: `docs/resource-evaluations/rtk-evaluation.md` - Evaluation: `docs/resource-evaluations/rtk-evaluation.md`
- Templates: `examples/{claude-md,skills,hooks}/rtk-*` - Templates: `examples/{claude-md,skills,hooks}/rtk-*`
- Upstream: https://github.com/pszymkowiak/rtk - GitHub: https://github.com/rtk-ai/rtk
- Fork (extended): https://github.com/FlorianBruniaux/rtk - Website: https://www.rtk-ai.app/
- Third-party tools comparison: `guide/third-party-tools.md#rtk-rust-token-killer` - Third-party tools comparison: `guide/third-party-tools.md#rtk-rust-token-killer`
### Cost Tracking ### Cost Tracking
@ -15384,7 +15569,7 @@ llms.txt is a lightweight standard for making documentation discoverable to LLMs
``` ```
# Claude Code Ultimate Guide # Claude Code Ultimate Guide
Complete guide for Anthropic's Claude Code CLI (11,000+ lines, 66+ templates) Complete guide for Anthropic's Claude Code CLI (19,000+ lines, 120 templates)
## Quick Start ## Quick Start
- Installation: guide/ultimate-guide.md#installation (line 450) - Installation: guide/ultimate-guide.md#installation (line 450)
@ -19367,4 +19552,4 @@ We'll evaluate and add it to this section if it meets quality criteria.
**Contributions**: Issues and PRs welcome. **Contributions**: Issues and PRs welcome.
**Last updated**: January 2026 | **Version**: 3.27.0 **Last updated**: January 2026 | **Version**: 3.27.1

View file

@ -3,7 +3,7 @@
# Source: guide/ultimate-guide.md # Source: guide/ultimate-guide.md
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code # Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
version: "3.27.0" version: "3.27.1"
updated: "2026-02-09" updated: "2026-02-09"
# ════════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════════
@ -48,19 +48,18 @@ deep_dive:
bridge_schema: "examples/scripts/bridge-plan-schema.json" bridge_schema: "examples/scripts/bridge-plan-schema.json"
bridge_guide: "guide/ultimate-guide.md:14079" bridge_guide: "guide/ultimate-guide.md:14079"
# Cost optimization - RTK (Rust Token Killer) # Cost optimization - RTK (Rust Token Killer)
rtk_upstream: "https://github.com/pszymkowiak/rtk" rtk_upstream: "https://github.com/rtk-ai/rtk"
rtk_fork_extended: "https://github.com/FlorianBruniaux/rtk" rtk_website: "https://www.rtk-ai.app/"
rtk_evaluation: "docs/resource-evaluations/rtk-evaluation.md" rtk_evaluation: "docs/resource-evaluations/rtk-evaluation.md"
rtk_guide: "guide/ultimate-guide.md:11084" rtk_guide: "guide/ultimate-guide.md:13355"
rtk_third_party: "guide/third-party-tools.md:86" rtk_third_party: "guide/third-party-tools.md:86"
rtk_claude_md: "examples/claude-md/rtk-optimized.md" rtk_claude_md: "examples/claude-md/rtk-optimized.md"
rtk_skill: "examples/skills/rtk-optimizer/SKILL.md" rtk_skill: "examples/skills/rtk-optimizer/SKILL.md"
rtk_hook: "examples/hooks/bash/rtk-auto-wrapper.sh" rtk_hook: "examples/hooks/bash/rtk-auto-wrapper.sh"
rtk_pr_proposals: "claudedocs/rtk-pr-proposals.md" rtk_purpose: "Command output filtering before LLM context (60-90% avg reduction)"
rtk_purpose: "Command output filtering before LLM context (72.6% avg reduction)" rtk_version_tested: "v0.16.0"
rtk_version_tested: "v0.2.0" rtk_score: "5/5"
rtk_score: "4/5" rtk_installation: "cargo install rtk or brew install rtk-ai/tap/rtk"
rtk_installation: "Binary download (GitHub releases)"
# PDF Generation # PDF Generation
pdf_generation: "guide/workflows/pdf-generation.md" pdf_generation: "guide/workflows/pdf-generation.md"
pdf_generator_skill: "examples/skills/pdf-generator.md" pdf_generator_skill: "examples/skills/pdf-generator.md"
@ -173,7 +172,7 @@ deep_dive:
third_party_toad: "https://github.com/batrachianai/toad" third_party_toad: "https://github.com/batrachianai/toad"
third_party_conductor: "https://docs.conductor.build" third_party_conductor: "https://docs.conductor.build"
# Configuration Management & Backup (Added 2026-02-02) # Configuration Management & Backup (Added 2026-02-02)
config_management_guide: "guide/ultimate-guide.md:4085" # Section 3.27.0 config_management_guide: "guide/ultimate-guide.md:4085" # Section 3.27.1
config_hierarchy: "guide/ultimate-guide.md:4095" # Global → Project → Local precedence config_hierarchy: "guide/ultimate-guide.md:4095" # Global → Project → Local precedence
config_git_strategy_project: "guide/ultimate-guide.md:4110" # What to commit in .claude/ config_git_strategy_project: "guide/ultimate-guide.md:4110" # What to commit in .claude/
config_git_strategy_global: "guide/ultimate-guide.md:4133" # Version control ~/.claude/ config_git_strategy_global: "guide/ultimate-guide.md:4133" # Version control ~/.claude/
@ -424,7 +423,7 @@ deep_dive:
gsd_note: "Overlap with existing patterns (Ralph Loop, Gas Town, BMAD)" gsd_note: "Overlap with existing patterns (Ralph Loop, Gas Town, BMAD)"
# Resource Evaluations (added 2026-01-26, updated 2026-02-07) # Resource Evaluations (added 2026-01-26, updated 2026-02-07)
resource_evaluations_directory: "docs/resource-evaluations/" resource_evaluations_directory: "docs/resource-evaluations/"
resource_evaluations_count: 55 resource_evaluations_count: 67
resource_evaluations_methodology: "docs/resource-evaluations/README.md" resource_evaluations_methodology: "docs/resource-evaluations/README.md"
resource_evaluations_watchlist: "docs/resource-evaluations/watch-list.md" resource_evaluations_watchlist: "docs/resource-evaluations/watch-list.md"
resource_evaluations_appendix: "guide/ultimate-guide.md:15034" resource_evaluations_appendix: "guide/ultimate-guide.md:15034"
@ -450,6 +449,11 @@ deep_dive:
practitioner_insights: "guide/ai-ecosystem.md:1209" practitioner_insights: "guide/ai-ecosystem.md:1209"
practitioner_dave_van_veen: "guide/ai-ecosystem.md:1213" practitioner_dave_van_veen: "guide/ai-ecosystem.md:1213"
practitioner_matteo_collina: "guide/ai-ecosystem.md:1243" practitioner_matteo_collina: "guide/ai-ecosystem.md:1243"
# Outcome Engineering (o16g) - Emerging manifesto (2026-02-13)
outcome_engineering_o16g: "guide/ai-ecosystem.md:2314"
outcome_engineering_url: "https://o16g.com/"
outcome_engineering_author: "Cory Ondrejka (CTO Onebrief, co-creator Second Life, ex-VP Google/Meta)"
outcome_engineering_status: "Emerging - on watch list for community adoption"
practitioner_collina_source: "https://adventures.nodeland.dev/archive/the-human-in-the-loop/" practitioner_collina_source: "https://adventures.nodeland.dev/archive/the-human-in-the-loop/"
practitioner_steinberger: "guide/ai-ecosystem.md:1997" practitioner_steinberger: "guide/ai-ecosystem.md:1997"
practitioner_steinberger_source: "https://steipete.me/posts/2025/shipping-at-inference-speed" practitioner_steinberger_source: "https://steipete.me/posts/2025/shipping-at-inference-speed"
@ -687,6 +691,7 @@ deep_dive:
ai_ecosystem_context_packing: "guide/ai-ecosystem.md:1208" ai_ecosystem_context_packing: "guide/ai-ecosystem.md:1208"
ai_ecosystem_multi_ide_sync: "guide/ai-ecosystem.md:1256" ai_ecosystem_multi_ide_sync: "guide/ai-ecosystem.md:1256"
agents_md_support_status: "guide/ai-ecosystem.md:1322" agents_md_support_status: "guide/ai-ecosystem.md:1322"
ai_ecosystem_build_vs_use: "guide/ai-ecosystem.md:2346" # Section 11.3 - When to Build vs Use (ADK, LangChain, Vercel AI SDK)
# Architecture Diagrams as Context (advanced pattern) - Added 2026-01-25 # Architecture Diagrams as Context (advanced pattern) - Added 2026-01-25
architecture_diagrams_input: "guide/ai-ecosystem.md:1379" architecture_diagrams_input: "guide/ai-ecosystem.md:1379"
architecture_diagrams_mcp_tools: architecture_diagrams_mcp_tools:
@ -733,10 +738,10 @@ deep_dive:
myths_tasks_api_autonomous: 15301 myths_tasks_api_autonomous: 15301
myths_100x_faster: 15340 myths_100x_faster: 15340
myths_reliable_sources: 15388 myths_reliable_sources: 15388
# Quiz System (257 questions, 15 categories) # Quiz System (264 questions, 15 categories)
quiz_overview: "quiz/README.md" quiz_overview: "quiz/README.md"
quiz_file: "quiz/questions.json" quiz_file: "quiz/questions.json"
quiz_count: 257 quiz_count: 264
quiz_categories: 15 quiz_categories: 15
quiz_beginner: "quiz/categories/basics,commands,shortcuts,reference" quiz_beginner: "quiz/categories/basics,commands,shortcuts,reference"
quiz_beginner_count: 60 quiz_beginner_count: 60
@ -1084,7 +1089,7 @@ rules:
ecosystem: ecosystem:
this_guide: this_guide:
focus: "Education - Learn & master" focus: "Education - Learn & master"
unique: ["architecture docs", "TDD/SDD methodologies", "257-question quiz", "YAML index"] unique: ["architecture docs", "TDD/SDD methodologies", "264-question quiz", "YAML index"]
complementary: complementary:
claude_code_templates: claude_code_templates:
url: "github.com/davila7/claude-code-templates" url: "github.com/davila7/claude-code-templates"
@ -1109,8 +1114,8 @@ ecosystem:
url: "github.com/affaan-m/everything-claude-code" url: "github.com/affaan-m/everything-claude-code"
author: "Affaan Mustafa (Anthropic hackathon winner - Zenith project)" author: "Affaan Mustafa (Anthropic hackathon winner - Zenith project)"
focus: "Production configs - Battle-tested from 10+ months intensive use" focus: "Production configs - Battle-tested from 10+ months intensive use"
stars: "31.9k" stars: "45k+"
verified: "2026-01-27" verified: "2026-02-15"
created: "2026-01-18" created: "2026-01-18"
unique: ["hookify (conversational hooks)", "pass@k metrics", "Plugin ecosystem", "Sandboxed subagents", "Strategic compaction skills"] unique: ["hookify (conversational hooks)", "pass@k metrics", "Plugin ecosystem", "Sandboxed subagents", "Strategic compaction skills"]
evaluation: "docs/resource-evaluations/015-everything-claude-code-github-repo.md" evaluation: "docs/resource-evaluations/015-everything-claude-code-github-repo.md"
@ -1166,7 +1171,7 @@ ecosystem:
local: "/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/" local: "/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/"
purpose: "Marketing site for Claude Code guide" purpose: "Marketing site for Claude Code guide"
audience: "Developers discovering the guide" audience: "Developers discovering the guide"
features: ["badges (version, templates, lines)", "quiz (257 questions)", "FAQ", "cross-links to Cowork"] features: ["badges (version, templates, lines)", "quiz (264 questions)", "FAQ", "cross-links to Cowork"]
sync_with: "Guide Code (version, templates count, guide lines)" sync_with: "Guide Code (version, templates count, guide lines)"
cowork_landing: cowork_landing:
local: "/Users/florianbruniaux/Sites/perso/claude-cowork-guide-landing/" local: "/Users/florianbruniaux/Sites/perso/claude-cowork-guide-landing/"
@ -1180,7 +1185,7 @@ ecosystem:
- "Cross-links modified → Update all 4 repos" - "Cross-links modified → Update all 4 repos"
history: history:
- date: "2026-01-20" - date: "2026-01-20"
event: "Code Landing sync v3.27.0, 66 templates, cross-links" event: "Code Landing sync v3.27.1, 66 templates, cross-links"
commit: "5b5ce62" commit: "5b5ce62"
- date: "2026-01-20" - date: "2026-01-20"
event: "Cowork Landing fix (paths, README, UI badges)" event: "Cowork Landing fix (paths, README, UI badges)"
@ -1192,7 +1197,7 @@ ecosystem:
onboarding_matrix_meta: onboarding_matrix_meta:
version: "2.0.0" version: "2.0.0"
last_updated: "2026-02-05" last_updated: "2026-02-05"
aligned_with_guide: "3.27.0" aligned_with_guide: "3.27.1"
changelog: changelog:
- version: "2.0.0" - version: "2.0.0"
date: "2026-02-05" date: "2026-02-05"
@ -1220,7 +1225,7 @@ onboarding_matrix:
core: [rules, sandbox_native_guide, commands] core: [rules, sandbox_native_guide, commands]
time_budget: "5 min" time_budget: "5 min"
topics_max: 3 topics_max: 3
note: "SECURITY FIRST - sandbox before commands (v3.27.0 critical fix)" note: "SECURITY FIRST - sandbox before commands (v3.27.1 critical fix)"
beginner_15min: beginner_15min:
core: [rules, sandbox_native_guide, workflow, essential_commands] core: [rules, sandbox_native_guide, workflow, essential_commands]
@ -1305,7 +1310,7 @@ onboarding_matrix:
- default: agent_validation_checklist - default: agent_validation_checklist
time_budget: "60 min" time_budget: "60 min"
topics_max: 6 topics_max: 6
note: "Dual-instance pattern for quality workflows (v3.27.0)" note: "Dual-instance pattern for quality workflows (v3.27.1)"
learn_security: learn_security:
intermediate_30min: intermediate_30min:
@ -1316,7 +1321,7 @@ onboarding_matrix:
- default: permission_modes - default: permission_modes
time_budget: "30 min" time_budget: "30 min"
topics_max: 4 topics_max: 4
note: "NEW goal (v3.27.0) - Security-focused learning path" note: "NEW goal (v3.27.1) - Security-focused learning path"
power_60min: power_60min:
core: [sandbox_native_guide, mcp_secrets_management, security_hardening] core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
@ -1341,7 +1346,7 @@ onboarding_matrix:
core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode] core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
time_budget: "60 min" time_budget: "60 min"
topics_max: 6 topics_max: 6
note: "Security foundation + core workflow (v3.27.0 sandbox added)" note: "Security foundation + core workflow (v3.27.1 sandbox added)"
intermediate_120min: intermediate_120min:
core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers] core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]

View file

@ -405,7 +405,7 @@ The Claude Code cheatsheet serves as the benchmark. Here's what makes it the gol
### Quality Characteristics ### Quality Characteristics
- **Density**: 527 lines condenses 11,000+ lines (20:1 ratio) - **Density**: 527 lines condenses 19,000+ lines (36:1 ratio)
- **Scannability**: Every section uses tables, code blocks, or numbered lists - **Scannability**: Every section uses tables, code blocks, or numbered lists
- **Actionability**: Every entry answers "what do I type?" not "what is this?" - **Actionability**: Every entry answers "what do I type?" not "what is this?"
- **Cross-format**: MD (source) + PDF (print) + HTML (landing, with dark theme + print CSS) - **Cross-format**: MD (source) + PDF (print) + HTML (landing, with dark theme + print CSS)