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
parent
d94f6bf62e
commit
d1182af4cf
30 changed files with 3506 additions and 382 deletions
61
CHANGELOG.md
61
CHANGELOG.md
|
|
@ -8,10 +8,69 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
|
|||
|
||||
<!-- 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
|
||||
|
||||
### 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)
|
||||
- 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
|
||||
|
|
@ -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)
|
||||
- Comprehensive threat DB compiled from Perplexity Deep Research across 15 sources
|
||||
- **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
|
||||
- **IOCs**: 6 C2 IPs, exfiltration endpoints, malicious GitHub repos, malware hashes
|
||||
- **17 malicious skill patterns** for wildcard matching (prefix-based scanning)
|
||||
|
|
|
|||
12
CLAUDE.md
12
CLAUDE.md
|
|
@ -10,7 +10,7 @@ This repository is the **comprehensive documentation for Claude Code** (Anthropi
|
|||
|
||||
```
|
||||
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
|
||||
├── architecture.md # How Claude Code works internally
|
||||
├── methodologies.md # TDD, SDD, BDD workflows
|
||||
|
|
@ -34,7 +34,7 @@ tools/ # Interactive utilities
|
|||
└── onboarding-prompt.md # Personalized learning prompt
|
||||
|
||||
docs/ # Public documentation (tracked)
|
||||
└── resource-evaluations/ # External resource evaluations (14 files)
|
||||
└── resource-evaluations/ # External resource evaluations (68 files)
|
||||
|
||||
claudedocs/ # Claude working documents (gitignored)
|
||||
├── resource-evaluations/ # Research working docs (prompts, private audits)
|
||||
|
|
@ -45,7 +45,7 @@ claudedocs/ # Claude working documents (gitignored)
|
|||
|
||||
| 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/cheatsheet.md` | Quick reference for daily use |
|
||||
| `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 |
|
||||
| **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 |
|
||||
|
||||
### 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 |
|
||||
|--------|---------|
|
||||
| **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) |
|
||||
|
||||
### 4. Cowork Landing Site
|
||||
|
|
@ -421,7 +421,7 @@ External resources (articles, videos, discussions) are evaluated before integrat
|
|||
|
||||
| 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) |
|
||||
|
||||
### Scoring Grid
|
||||
|
|
|
|||
347
README.md
347
README.md
|
|
@ -6,23 +6,87 @@
|
|||
|
||||
<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="./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="./quiz/"><img src="https://img.shields.io/badge/Quiz-257_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="./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="./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-264_questions-orange?style=for-the-badge" alt="Quiz"/></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-18_CVEs_·_341_malicious_skills-red?style=for-the-badge" alt="Threat Database"/></a>
|
||||
</p>
|
||||
|
||||
<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://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>
|
||||
|
||||
> **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.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 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
|
||||
|
||||
**Quickest path**: [Cheat Sheet](./guide/cheatsheet.md) — 1 printable page with daily essentials
|
||||
|
|
@ -71,11 +135,11 @@ graph LR
|
|||
root[📦 Repository<br/>Root]
|
||||
|
||||
root --> guide[📖 guide/<br/>19K lines]
|
||||
root --> examples[📋 examples/<br/>111 templates]
|
||||
root --> quiz[🧠 quiz/<br/>257 questions]
|
||||
root --> examples[📋 examples/<br/>108 templates]
|
||||
root --> quiz[🧠 quiz/<br/>264 questions]
|
||||
root --> tools[🔧 tools/<br/>utils]
|
||||
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 guide fill:#2980b9,stroke:#3498db,stroke-width:2px,color:#fff
|
||||
|
|
@ -95,20 +159,20 @@ graph LR
|
|||
├─ 📖 guide/ Core Documentation (~19K lines)
|
||||
│ ├─ ultimate-guide.md Complete reference, 10 sections
|
||||
│ ├─ 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
|
||||
│ ├─ third-party-tools.md Community tools (RTK, ccusage, Entire CLI)
|
||||
│ ├─ mcp-servers-ecosystem.md Official & community MCP servers
|
||||
│ └─ workflows/ Step-by-step guides
|
||||
│
|
||||
├─ 📋 examples/ 111 Production Templates
|
||||
├─ 📋 examples/ 108 Production Templates
|
||||
│ ├─ agents/ 6 custom AI personas
|
||||
│ ├─ commands/ 22 slash commands
|
||||
│ ├─ hooks/ 18 security hooks (bash + PowerShell)
|
||||
│ ├─ commands/ 23 slash commands
|
||||
│ ├─ hooks/ 31 hooks (bash + PowerShell)
|
||||
│ ├─ skills/ 1 meta-skill (Claudeception)
|
||||
│ └─ scripts/ Utility scripts (audit, search)
|
||||
│
|
||||
├─ 🧠 quiz/ 257 Questions
|
||||
├─ 🧠 quiz/ 264 Questions
|
||||
│ ├─ 9 categories Setup, Agents, MCP, Trust, Advanced...
|
||||
│ ├─ 4 profiles Junior, Senior, Power User, PM
|
||||
│ └─ Instant feedback Doc links + score tracking
|
||||
|
|
@ -121,7 +185,7 @@ graph LR
|
|||
│ ├─ reference.yaml Structured index (~2K tokens)
|
||||
│ └─ llms.txt Standard LLM context file
|
||||
│
|
||||
└─ 📚 docs/ 55 Resource Evaluations
|
||||
└─ 📚 docs/ 67 Resource Evaluations
|
||||
└─ resource-evaluations/ 5-point scoring, source attribution
|
||||
```
|
||||
|
||||
|
|
@ -131,61 +195,106 @@ graph LR
|
|||
|
||||
## 🎯 What Makes This Guide Unique
|
||||
|
||||
### 🎓 Educational Depth
|
||||
### 🎓 Deep Understanding Over Configuration
|
||||
|
||||
We explain **concepts first**, not just configs:
|
||||
- [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
|
||||
**Outcome**: Design your own workflows instead of copy-pasting blindly.
|
||||
|
||||
### 📝 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:
|
||||
- Setup & Configuration
|
||||
- Agents & Sub-Agents
|
||||
- MCP Servers & Integration
|
||||
- Trust & Verification
|
||||
- Advanced Patterns
|
||||
**What this means for you**: Troubleshoot issues independently, optimize for your specific use case, know when to deviate from 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**:
|
||||
- Production metrics (Fountain 50% faster, CRED 2x speed, autonomous C compiler)
|
||||
**Outcome**: Protect production systems from AI-specific attacks.
|
||||
|
||||
**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)
|
||||
- Git-based coordination architecture (team lead + teammates)
|
||||
- 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)
|
||||
|
||||
### 🔬 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:
|
||||
- [TDD](./guide/methodologies.md#1-tdd-test-driven-development-with-claude) — Test-Driven Development
|
||||
- [SDD](./guide/methodologies.md#2-sdd-specification-driven-development) — Specification-Driven Development
|
||||
- [BDD](./guide/methodologies.md#3-bdd-behavior-driven-development) — Behavior-Driven Development
|
||||
- [GSD](./guide/methodologies.md#gsd-get-shit-done) — Get Shit Done pattern
|
||||
- [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 (Design before code)
|
||||
- [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 (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:
|
||||
- Agents (6), Commands (22), Hooks (18), Skills
|
||||
- Comments explaining **why** each pattern works
|
||||
- Gradual complexity progression
|
||||
- Agents (6), Commands (23), Hooks (31), Skills
|
||||
- Comments explaining **why** each pattern works (not just what it does)
|
||||
- Gradual complexity progression (simple → advanced)
|
||||
|
||||
[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):
|
||||
- Articles, videos, tools, frameworks
|
||||
- Honest assessments with source attribution
|
||||
- Integration recommendations
|
||||
- Honest assessments with source attribution (no marketing fluff)
|
||||
- Integration recommendations with trade-offs
|
||||
|
||||
[See Evaluations →](./docs/resource-evaluations/)
|
||||
|
||||
**What this means for you**: Save time vetting resources, understand limitations before adopting tools, make informed decisions.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Learning Paths
|
||||
|
|
@ -288,12 +397,55 @@ cco # Offline mode (Ollama, 100% local)
|
|||
|
||||
## 🔑 Golden Rules
|
||||
|
||||
1. **Start small** — First project: 10-15 lines CLAUDE.md max
|
||||
2. **Read before edit** — Always Read → Understand → Edit (never blind Write)
|
||||
3. **Test-first** — Write test → Watch fail → Implement → Pass
|
||||
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))
|
||||
6. **Context = Gold** — Clear CLAUDE.md > clever prompts
|
||||
### 1. Verify Trust Before Use
|
||||
|
||||
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.
|
||||
|
||||
**Strategy:** Solo dev (verify logic + edge cases). Team (systematic peer review). Production (mandatory gating tests).
|
||||
|
||||
---
|
||||
|
||||
### 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.
|
||||
|
||||
|
|
@ -312,19 +464,6 @@ cco # Offline mode (Ollama, 100% local)
|
|||
|
||||
## 🌍 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** 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 |
|
||||
|---------|-------|----------|
|
||||
| [claude-code-templates](https://github.com/davila7/claude-code-templates) | Distribution (200+ templates) | CLI installation (17k⭐) |
|
||||
| [anthropics/skills](https://github.com/anthropics/skills) | Official Anthropic skills (60K+⭐) | Documents, design, dev templates |
|
||||
| [everything-claude-code](https://github.com/affaan-m/everything-claude-code) | Production configs (45k+ stars) | Quick setup, battle-tested patterns |
|
||||
| [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 |
|
||||
| [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-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 |
|
||||
|
||||
**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 |
|
||||
|------|---------|---------------|
|
||||
| [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.
|
||||
|
||||
### 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 |
|
||||
|----------------|-------|----------|
|
||||
| **Prompt Injection** | 14 CVEs | Indirect injection (CVE-2024-1546), context poisoning |
|
||||
| **Data Exfiltration** | 5 CVEs | Training data extraction (CVE-2024-0241), secret leakage |
|
||||
| **Code Injection** | 3 CVEs | Tool manipulation, workflow abuse |
|
||||
| **Code/Command Injection** | 5 CVEs | CLI bypass (CVE-2025-66032), child_process exec |
|
||||
| **Path Traversal & Access** | 4 CVEs | Symlink escape (CVE-2025-53109), prefix bypass |
|
||||
| **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 |
|
||||
|
||||
**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
|
||||
|
||||
**18 production hooks** (bash + PowerShell) in [`examples/hooks/`](./examples/hooks/):
|
||||
**30 production hooks** (bash + PowerShell) in [`examples/hooks/`](./examples/hooks/):
|
||||
|
||||
| Hook | Purpose |
|
||||
|------|---------|
|
||||
|
|
@ -427,30 +569,37 @@ Same agentic capabilities as Claude Code, but through a visual interface with no
|
|||
|
||||
## 📖 About
|
||||
|
||||
<details>
|
||||
<summary><strong>Origins & Philosophy</strong></summary>
|
||||
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.
|
||||
|
||||
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**:
|
||||
- [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
|
||||
**Feedback welcome:** [GitHub Issues](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/issues)
|
||||
|
||||
</details>
|
||||
### About the Author
|
||||
|
||||
<details>
|
||||
<summary><strong>Privacy & Data</strong></summary>
|
||||
**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.
|
||||
|
||||
Claude Code sends your prompts, file contents, and MCP results to Anthropic servers.
|
||||
- **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)
|
||||
| Project | Description | Links |
|
||||
|---------|-------------|-------|
|
||||
| **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 |
|
||||
|
||||
<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) ⭐
|
||||
|
||||
**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 ⭐
|
||||
|
||||
|
|
@ -501,7 +650,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv
|
|||
</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.
|
||||
|
||||
|
|
@ -516,7 +665,7 @@ cd quiz && npm install && npm start
|
|||
</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.
|
||||
|
||||
|
|
@ -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)
|
||||
- **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
|
||||
- [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
|
||||
- [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) — Behavioral modes
|
||||
|
||||
### Tools
|
||||
- [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
|
||||
|
||||
---
|
||||
|
||||
*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 -->
|
||||
<!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,
|
||||
|
|
|
|||
|
|
@ -30,8 +30,8 @@ If you discover a security concern related to this guide (examples: malicious te
|
|||
This guide maintains comprehensive security documentation:
|
||||
|
||||
- **[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
|
||||
- **[Security Hooks](./examples/hooks/)** — 18 production hooks (bash + PowerShell)
|
||||
- **[Threat Database](./machine-readable/threat-db.yaml)** — 18 CVEs, 341 malicious skills
|
||||
- **[Security Hooks](./examples/hooks/)** — 30 production hooks (bash + PowerShell)
|
||||
- **[Security Commands](./examples/commands/)** — `/security-check`, `/security-audit`, `/update-threat-db`
|
||||
|
||||
## Security Maintenance
|
||||
|
|
|
|||
2
VERSION
2
VERSION
|
|
@ -1 +1 @@
|
|||
3.27.0
|
||||
3.27.1
|
||||
|
|
|
|||
|
|
@ -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 |
|
||||
| **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 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) |
|
||||
|-----------|------------------------|-----------------------------------|
|
||||
| **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 |
|
||||
| **Security depth** | Brief security-reviewer agent | Dedicated 500+ line security hardening guide |
|
||||
| **Privacy coverage** | Not covered | Dedicated data privacy guide |
|
||||
|
|
@ -437,7 +437,7 @@
|
|||
▲
|
||||
│
|
||||
│ [Our Guide]
|
||||
│ (11K lines, security, methodologies)
|
||||
│ (19K lines, security, methodologies)
|
||||
│
|
||||
│ [Everything-You-Need-to-Know]
|
||||
│ (SDLC, BMAD, beginner-friendly)
|
||||
|
|
@ -506,22 +506,22 @@
|
|||
| **Privacy coverage** | Dedicated guide | None have this | **Unique** |
|
||||
| **Methodology workflows** | TDD/SDD/BDD detailed | Brief mentions only | **10x depth** |
|
||||
| **Architecture explanations** | How CC works internally | None have this | **Unique** |
|
||||
| **Comprehensive reference** | 11K lines | 784 lines (everything-claude-code) | **14x larger** |
|
||||
| **Templates** | 66+ production-ready | 13+34+31 (everything-claude-code) | Comparable |
|
||||
| **Comprehensive reference** | 19K lines | 784 lines (everything-claude-code) | **24x larger** |
|
||||
| **Templates** | 120 production-ready | 13+34+31 (everything-claude-code) | **1.5x more** |
|
||||
| **Cheatsheet** | 1-page printable | None provided | **Unique** |
|
||||
|
||||
### Messaging Recommendations
|
||||
|
||||
**For README**:
|
||||
- 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)
|
||||
- Highlight unique features: security hardening, TDD/SDD/BDD, architecture
|
||||
|
||||
**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)
|
||||
- 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
|
||||
|
||||
**Differentiation narrative**:
|
||||
|
|
@ -538,7 +538,7 @@
|
|||
**Strengths to emphasize**:
|
||||
1. Security-first (no competitor has this depth)
|
||||
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)
|
||||
5. Factual accuracy (no inflated claims, verified metrics)
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
@ -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) |
|
||||
| **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) |
|
||||
| **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
|
||||
|
||||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -1,16 +1,65 @@
|
|||
# Resource Evaluation: RTK (Rust Token Killer)
|
||||
|
||||
**Date**: 2026-01-28 (Updated: 2026-02-01)
|
||||
**Evaluator**: Claude Sonnet 4.5
|
||||
**Resource URL**: https://github.com/pszymkowiak/rtk
|
||||
**Date**: 2026-01-28 (Updated: 2026-02-14)
|
||||
**Evaluator**: Claude Sonnet 4.5 / Claude Opus 4.6
|
||||
**Resource URL**: https://github.com/rtk-ai/rtk
|
||||
**Resource Type**: CLI Tool (Rust)
|
||||
**Author**: pszymkowiak
|
||||
**Version Tested**: v0.7.0 (previously v0.2.0)
|
||||
**Community Engagement**: 17 stars (+113% growth), 2 forks, 1 open issue
|
||||
**Author**: rtk-ai (formerly pszymkowiak)
|
||||
**Version Tested**: v0.16.0 (previously v0.7.0, v0.2.0)
|
||||
**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.
|
||||
|
||||
|
|
@ -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**:
|
||||
1. **Proven Savings**: 89.4% reduction validated (72.6% git + 85.6% T3 Stack estimates)
|
||||
2. **Comprehensive Coverage**: 27+ commands across git, pnpm, npm, cargo, gh CLI
|
||||
3. **All Bugs Fixed**: grep, ls, git arg parsing resolved in v0.7.0
|
||||
4. **Active Development**: 5 releases in 9 days, 10+ community PRs
|
||||
5. **Production Features**: SQLite analytics, config system, auto-rewrite hook
|
||||
6. **BUT**: Still early-stage (v0.7.0 = 13 days old), small community (17 stars)
|
||||
1. **Proven Savings**: 60-90% reduction across all supported languages
|
||||
2. **Comprehensive Coverage**: 30+ commands across git, pnpm, npm, cargo, gh CLI, Python, Go
|
||||
3. **All Bugs Fixed**: Every v0.2.0 issue resolved
|
||||
4. **Massive Community**: 446 stars, 38 forks, 700+ Reddit upvotes
|
||||
5. **Production Features**: SQLite analytics, config system, hook-first install, Homebrew
|
||||
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)**:
|
||||
- **Position as production-ready** (all critical bugs fixed)
|
||||
- **Recommend for full dev workflows** (not just git)
|
||||
- **Highlight v0.7.0 features** (gain, discover, auto-rewrite hook)
|
||||
- **Monitor for v0.8.0+** (continued evolution expected)
|
||||
- **Caveat community size** (17 stars = early adopters, not mainstream yet)
|
||||
**Integration Strategy (Updated for v0.16.0)**:
|
||||
- **Position as essential tool** (446 stars, community-validated)
|
||||
- **Recommend for all dev workflows** (JS/TS, Rust, Python, Go)
|
||||
- **Highlight v0.16.0 features** (multi-language, Homebrew, `rtk init`)
|
||||
- **No fork distinction needed** (all merged upstream under rtk-ai org)
|
||||
|
||||
**Score Breakdown**:
|
||||
- **+0.5** for fixing all critical bugs (grep, ls, git args)
|
||||
- **+0.5** for comprehensive coverage (pnpm, npm, cargo, gh)
|
||||
- **+0.5** for production features (SQLite, config, analytics)
|
||||
- **-1.0** for early-stage maturity (v0.7.0 = 13 days, small community)
|
||||
- **-0.5** for unverified v0.7.0 benchmarks (pending re-test)
|
||||
- **5/5** Accuracy & Reliability: All bugs fixed, 30+ stable releases
|
||||
- **5/5** Depth & Comprehensiveness: Full stack + multi-language coverage
|
||||
- **5/5** Practical Value: Proven 60-90% reduction, zero maintenance
|
||||
- **5/5** Originality & Uniqueness: No competitors in this space
|
||||
- **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**.
|
||||
|
||||
**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
|
||||
**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.
|
||||
|
||||
---
|
||||
|
||||
## Metadata
|
||||
|
||||
**Initial Evaluation**: 2026-01-28 (v0.2.0)
|
||||
**Updated Evaluation**: 2026-02-01 (v0.7.0)
|
||||
**Tested By**: Claude Sonnet 4.5
|
||||
**Test Duration**: 4 hours total (2h v0.2.0 + 2h v0.7.0 review)
|
||||
**Next Review**: 2026-03-01 (check for v0.8.0+, community growth, production usage)
|
||||
**Updated Evaluation**: 2026-02-01 (v0.7.0), 2026-02-14 (v0.16.0)
|
||||
**Tested By**: Claude Sonnet 4.5 / Claude Opus 4.6
|
||||
**Test Duration**: 6 hours total (2h v0.2.0 + 2h v0.7.0 review + 2h v0.16.0 review)
|
||||
**Next Review**: 2026-04-01 (monitor v1.0.0 milestone, ecosystem growth)
|
||||
|
||||
**Related Resources**:
|
||||
- Integration templates: `examples/{claude-md,skills,hooks}/rtk-*`
|
||||
- Upstream repository: https://github.com/pszymkowiak/rtk
|
||||
- Architecture docs: https://github.com/pszymkowiak/rtk/blob/main/ARCHITECTURE.md
|
||||
- Repository: https://github.com/rtk-ai/rtk
|
||||
- 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`
|
||||
|
||||
**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
|
||||
|
|
|
|||
153
docs/resource-evaluations/system-prompts-opus-4-6-update.md
Normal file
153
docs/resource-evaluations/system-prompts-opus-4-6-update.md
Normal 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**
|
||||
|
|
@ -17,7 +17,8 @@ Trigger reached → re-evaluation → Integrate (Graduated) / Drop (Dropped)
|
|||
| 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 |
|
||||
| [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
|
||||
|
||||
|
|
|
|||
|
|
@ -1,26 +1,29 @@
|
|||
# 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
|
||||
|
||||
## Structure
|
||||
|
||||
| Folder | Description |
|
||||
|--------|-------------|
|
||||
| [`agents/`](./agents/) | Custom AI personas for specialized tasks |
|
||||
| [`skills/`](./skills/) | Reusable knowledge modules |
|
||||
| [`commands/`](./commands/) | Custom slash commands |
|
||||
| [`hooks/`](./hooks/) | Event-driven automation scripts |
|
||||
| [`config/`](./config/) | Configuration file templates |
|
||||
| [`memory/`](./memory/) | CLAUDE.md memory file templates |
|
||||
| [`claude-md/`](./claude-md/) | Specialized CLAUDE.md configurations |
|
||||
| [`scripts/`](./scripts/) | Utility scripts for setup and diagnostics |
|
||||
| [`github-actions/`](./github-actions/) | CI/CD workflows for GitHub Actions |
|
||||
| [`workflows/`](./workflows/) | Advanced development workflow guides |
|
||||
| [`modes/`](./modes/) | Behavioral modes for Claude (SuperClaude) |
|
||||
| [`semantic-anchors/`](./semantic-anchors/) | Precise vocabulary for better LLM outputs |
|
||||
| [`multi-provider/`](./multi-provider/) | **NEW** Multi-provider bridge (Copilot/Ollama) |
|
||||
| Folder | Description | Count |
|
||||
|--------|-------------|-------|
|
||||
| [`agents/`](./agents/) | Custom AI personas for specialized tasks | 6 |
|
||||
| [`commands/`](./commands/) | Slash commands (workflow automation) | 23 |
|
||||
| [`hooks/`](./hooks/) | Event-driven security & automation scripts | 31 |
|
||||
| [`skills/`](./skills/) | Reusable knowledge modules (patterns, TDD, AST) | 8 |
|
||||
| [`claude-md/`](./claude-md/) | CLAUDE.md configuration profiles | 5 |
|
||||
| [`config/`](./config/) | Settings, MCP, git templates | 5 |
|
||||
| [`memory/`](./memory/) | CLAUDE.md memory file templates | 2 |
|
||||
| [`scripts/`](./scripts/) | Diagnostic & utility scripts | 13 |
|
||||
| [`github-actions/`](./github-actions/) | CI/CD workflows | 3 |
|
||||
| [`workflows/`](./workflows/) | Advanced development workflows | 3 |
|
||||
| [`plugins/`](./plugins/) | Community plugins (SE-CoVe, claude-mem) | 2 |
|
||||
| [`integrations/`](./integrations/) | External tool integrations (Agent Vibes TTS) | 4 |
|
||||
| [`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
|
||||
|
||||
|
|
@ -44,7 +47,8 @@ Ready-to-use templates for Claude Code configuration.
|
|||
|
||||
## Templates Index
|
||||
|
||||
### Agents
|
||||
### Agents (6)
|
||||
|
||||
| File | Purpose | Model |
|
||||
|------|---------|-------|
|
||||
| [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 |
|
||||
| [devops-sre.md](./agents/devops-sre.md) | Infrastructure troubleshooting with FIRE framework | Sonnet |
|
||||
|
||||
### Skills
|
||||
### Skills (8)
|
||||
|
||||
| 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 |
|
||||
| [security-checklist.md](./skills/security-checklist.md) | OWASP Top 10 security checks |
|
||||
| [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 |
|
||||
|------|---------|---------|
|
||||
| [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 |
|
||||
| [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 |
|
||||
| [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 |
|
||||
| [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 |
|
||||
| [explain.md](./commands/explain.md) | `/explain` | Code explanations (3 depth levels) |
|
||||
| [optimize.md](./commands/optimize.md) | `/optimize` | Performance analysis and roadmap |
|
||||
| [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 |
|
||||
|------|-------|---------|
|
||||
| [dangerous-actions-blocker.sh](./hooks/bash/dangerous-actions-blocker.sh) | PreToolUse | Block dangerous commands/edits |
|
||||
| [security-check.*](./hooks/) | PreToolUse | Block secrets in commands |
|
||||
| [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, ANSI escape |
|
||||
| [repo-integrity-scanner.sh](./hooks/bash/repo-integrity-scanner.sh) | PreToolUse | Scan README/package.json for injection |
|
||||
| [dangerous-actions-blocker.sh](./hooks/bash/dangerous-actions-blocker.sh) | PreToolUse | Block `rm -rf`, force-push, production ops |
|
||||
| [prompt-injection-detector.sh](./hooks/bash/prompt-injection-detector.sh) | PreToolUse | Detect injection patterns in prompts |
|
||||
| [unicode-injection-scanner.sh](./hooks/bash/unicode-injection-scanner.sh) | PreToolUse | Detect zero-width, RTL override, ANSI escape |
|
||||
| [repo-integrity-scanner.sh](./hooks/bash/repo-integrity-scanner.sh) | PreToolUse | Scan README/package.json for hidden 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) |
|
||||
| [output-secrets-scanner.sh](./hooks/bash/output-secrets-scanner.sh) | PostToolUse | Detect secrets + env leakage |
|
||||
| [auto-format.*](./hooks/) | PostToolUse | Auto-format after edits |
|
||||
| [notification.sh](./hooks/bash/notification.sh) | Notification | Contextual macOS sound alerts |
|
||||
| [claudemd-scanner.sh](./hooks/bash/claudemd-scanner.sh) | SessionStart | Detect CLAUDE.md injection attacks |
|
||||
| [output-secrets-scanner.sh](./hooks/bash/output-secrets-scanner.sh) | PostToolUse | Prevent API keys/tokens in Claude responses |
|
||||
| [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 |
|
||||
| [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 |
|
||||
| [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 |
|
||||
|------|---------|
|
||||
| [settings.json](./config/settings.json) | Hooks configuration |
|
||||
| [mcp.json](./config/mcp.json) | MCP servers setup |
|
||||
| [.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 |
|
||||
|------|---------|
|
||||
| [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 Configurations
|
||||
### CLAUDE.md Configurations (5)
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| [learning-mode.md](./claude-md/learning-mode.md) | Learning-focused development 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/devops-sre.md](../guide/devops-sre.md) for DevOps/SRE guide**
|
||||
|
||||
### Scripts
|
||||
### Scripts (13)
|
||||
|
||||
| File | Purpose | Output |
|
||||
|------|---------|--------|
|
||||
| [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 |
|
||||
| [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 |
|
||||
| [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
|
||||
>
|
||||
> **Session search**: `./session-search.sh "keyword"` to find past conversations, outputs ready-to-use `claude --resume` commands
|
||||
> **See [scripts/README.md](./scripts/README.md) for detailed usage**
|
||||
|
||||
### GitHub Actions (3)
|
||||
|
||||
### GitHub Actions
|
||||
| File | Trigger | Purpose |
|
||||
|------|---------|---------|
|
||||
| [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**
|
||||
|
||||
### Workflows
|
||||
### Workflows (3)
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| [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 |
|
||||
|------|---------|------------|
|
||||
| [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**
|
||||
|
||||
### Semantic Anchors
|
||||
### Semantic Anchors (1)
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| [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 |
|
||||
|------|---------|
|
||||
| [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)
|
||||
>
|
||||
> 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.
|
||||
> Moved to dedicated repository: [github.com/FlorianBruniaux/cc-copilot-bridge](https://github.com/FlorianBruniaux/cc-copilot-bridge)
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -14,10 +14,29 @@ Always use RTK wrapper for these high-verbosity commands:
|
|||
### File Operations (69.4% avg reduction)
|
||||
- `rtk find "*.md" .` instead of `find . -name "*.md"`
|
||||
- `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:
|
||||
- `ls` (worse output: -274% token increase)
|
||||
- `grep` (buggy as of v0.2.0)
|
||||
### JS/TS Stack (70-90% reduction)
|
||||
- `rtk vitest run` instead of `pnpm test`
|
||||
- `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
|
||||
|
||||
|
|
@ -26,13 +45,22 @@ Always use RTK wrapper for these high-verbosity commands:
|
|||
|
||||
## 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
|
||||
|
||||
Check RTK availability:
|
||||
```bash
|
||||
rtk --version # Should show: rtk 0.2.0
|
||||
rtk --version # Should show: rtk 0.16.0+
|
||||
```
|
||||
|
||||
## When NOT to use RTK
|
||||
|
|
@ -43,4 +71,4 @@ rtk --version # Should show: rtk 0.2.0
|
|||
|
||||
## 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.
|
||||
|
|
|
|||
|
|
@ -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 |
|
||||
| [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 |
|
||||
| [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 |
|
||||
| [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) |
|
||||
| [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 |
|
||||
|
|
@ -245,6 +263,141 @@ Complements `security-check.sh` by scanning tool **outputs** (not inputs) for le
|
|||
|
||||
## 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
|
||||
|
||||
**Event**: `PostToolUse` (Edit, Write)
|
||||
|
|
|
|||
|
|
@ -18,6 +18,8 @@
|
|||
# }]
|
||||
# }
|
||||
# }
|
||||
#
|
||||
# Or use `rtk init` for automatic hook setup.
|
||||
|
||||
# Check if RTK is installed
|
||||
if ! command -v rtk &> /dev/null; then
|
||||
|
|
@ -39,6 +41,15 @@ declare -A RTK_COMMANDS=(
|
|||
["git status"]="76.0"
|
||||
["git diff"]="55.9"
|
||||
["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
|
||||
|
|
@ -48,7 +59,7 @@ for cmd in "${!RTK_COMMANDS[@]}"; do
|
|||
|
||||
# Suggest RTK wrapper
|
||||
cat << EOF
|
||||
💡 RTK Optimization Available
|
||||
RTK Optimization Available
|
||||
|
||||
Command: $COMMAND
|
||||
Suggested: rtk $COMMAND
|
||||
|
|
@ -66,19 +77,5 @@ EOF
|
|||
fi
|
||||
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
|
||||
exit 0
|
||||
|
|
|
|||
39
examples/hooks/bash/rtk-baseline.sh
Normal file
39
examples/hooks/bash/rtk-baseline.sh
Normal 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
|
||||
473
examples/hooks/bash/session-summary-config.sh
Normal file
473
examples/hooks/bash/session-summary-config.sh
Normal 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
|
||||
1335
examples/hooks/bash/session-summary.sh
Executable file
1335
examples/hooks/bash/session-summary.sh
Executable file
File diff suppressed because it is too large
Load diff
|
|
@ -4,13 +4,13 @@
|
|||
|
||||
set -e
|
||||
|
||||
echo "🚀 RTK Benchmark - T3 Stack Edition"
|
||||
echo "RTK Benchmark - T3 Stack Edition"
|
||||
echo "===================================="
|
||||
echo ""
|
||||
|
||||
# Check RTK installation
|
||||
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
|
||||
fi
|
||||
|
||||
|
|
@ -56,16 +56,16 @@ benchmark() {
|
|||
reduction="N/A"
|
||||
fi
|
||||
|
||||
status="✅"
|
||||
status="OK"
|
||||
if [ "$rtk_chars" -eq 0 ] || [ "$reduction" = "N/A" ]; then
|
||||
status="❌"
|
||||
status="FAIL"
|
||||
reduction="N/A"
|
||||
fi
|
||||
else
|
||||
rtk_chars="N/A"
|
||||
rtk_tokens="N/A"
|
||||
reduction="N/A"
|
||||
status="🚫 Not supported"
|
||||
status="Not tested"
|
||||
fi
|
||||
|
||||
# Write to results file
|
||||
|
|
@ -78,7 +78,7 @@ echo "|---------|------------------|-------------------|-------------|----------
|
|||
|
||||
# Git commands
|
||||
echo ""
|
||||
echo "📊 Git Commands"
|
||||
echo "Git Commands"
|
||||
echo "==============="
|
||||
benchmark "git log -20" "git log -20" "rtk git log -- -20"
|
||||
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
|
||||
echo ""
|
||||
echo "📊 Find Commands"
|
||||
echo "Find Commands"
|
||||
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 ''"
|
||||
|
||||
# pnpm commands
|
||||
echo ""
|
||||
echo "📊 pnpm Commands (unsupported)"
|
||||
echo "pnpm Commands"
|
||||
echo "=============================="
|
||||
benchmark "pnpm list --depth=0" "pnpm list --depth=0 2>&1" ""
|
||||
benchmark "pnpm outdated" "pnpm outdated 2>&1 || echo 'All packages up-to-date'" ""
|
||||
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'" "rtk pnpm outdated 2>&1 || echo 'All packages up-to-date'"
|
||||
|
||||
# Test framework
|
||||
echo ""
|
||||
echo "📊 Test Framework (unsupported)"
|
||||
echo "Test Framework"
|
||||
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
|
||||
echo ""
|
||||
echo "📊 TypeScript Compiler (unsupported)"
|
||||
echo "TypeScript Compiler"
|
||||
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
|
||||
echo ""
|
||||
echo "📊 Prisma (unsupported)"
|
||||
echo "Prisma"
|
||||
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
|
||||
echo ""
|
||||
echo "📊 Build Tools (unsupported)"
|
||||
echo "Build Tools"
|
||||
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 "**Legend**:" >> "$RESULTS_FILE"
|
||||
echo "- ✅ Works: RTK filtering successful" >> "$RESULTS_FILE"
|
||||
echo "- ❌ Broken: RTK returned error or 0 bytes" >> "$RESULTS_FILE"
|
||||
echo "- 🚫 Not supported: RTK doesn't handle this command" >> "$RESULTS_FILE"
|
||||
echo "- OK: RTK filtering successful" >> "$RESULTS_FILE"
|
||||
echo "- FAIL: RTK returned error or 0 bytes" >> "$RESULTS_FILE"
|
||||
echo "- Not tested: Command not benchmarked with RTK" >> "$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 "✅ Benchmark complete!"
|
||||
echo "📄 Results saved to: $RESULTS_FILE"
|
||||
echo "Benchmark complete!"
|
||||
echo "Results saved to: $RESULTS_FILE"
|
||||
echo ""
|
||||
echo "📊 Summary:"
|
||||
echo "Summary:"
|
||||
cat "$RESULTS_FILE" | grep "^|" | tail -n +2
|
||||
|
|
|
|||
|
|
@ -18,18 +18,35 @@ tags: [optimization, tokens, efficiency, git]
|
|||
|
||||
## Supported Commands
|
||||
|
||||
### ✅ High-Value (>70% reduction)
|
||||
### Git (>70% reduction)
|
||||
- `git log` → `rtk git log` (92.3% reduction)
|
||||
- `git status` → `rtk git status` (76.0% 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)
|
||||
- `cat <large-file>` → `rtk read <file>` (62.5% reduction)
|
||||
|
||||
### ❌ Not Recommended
|
||||
- `ls` (worse with RTK: -274%)
|
||||
- `grep` (buggy in v0.2.0)
|
||||
### JS/TS Stack (70-90% reduction)
|
||||
- `pnpm list` → `rtk pnpm list` (82% reduction)
|
||||
- `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
|
||||
|
||||
|
|
@ -43,16 +60,16 @@ tags: [optimization, tokens, efficiency, git]
|
|||
|
||||
Before first use, verify RTK is installed:
|
||||
```bash
|
||||
rtk --version # Should output: rtk 0.2.0
|
||||
rtk --version # Should output: rtk 0.16.0+
|
||||
```
|
||||
|
||||
If not installed:
|
||||
```bash
|
||||
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/
|
||||
sudo chmod +x /usr/local/bin/rtk
|
||||
rm rtk.tar.gz
|
||||
# Homebrew (macOS/Linux)
|
||||
brew install rtk-ai/tap/rtk
|
||||
|
||||
# Cargo (all platforms)
|
||||
cargo install rtk
|
||||
```
|
||||
|
||||
## Usage Pattern
|
||||
|
|
@ -74,7 +91,7 @@ Optional: Track cumulative savings across session:
|
|||
|
||||
```bash
|
||||
# At session end
|
||||
rtk gain # Shows total token savings for session
|
||||
rtk gain # Shows total token savings for session (SQLite-backed)
|
||||
```
|
||||
|
||||
## Edge Cases
|
||||
|
|
@ -91,8 +108,10 @@ Enable via CLAUDE.md:
|
|||
|
||||
Use RTK (Rust Token Killer) for high-verbosity commands:
|
||||
- git operations (log, status, diff)
|
||||
- file finding
|
||||
- large file reading
|
||||
- package managers (pnpm, npm)
|
||||
- build tools (cargo, go)
|
||||
- test frameworks (vitest, pytest)
|
||||
- file finding and reading
|
||||
```
|
||||
|
||||
## Metrics (Verified)
|
||||
|
|
@ -108,18 +127,18 @@ Based on real-world testing:
|
|||
|
||||
## Limitations
|
||||
|
||||
- RTK v0.2.0 (8 stars on GitHub, low adoption)
|
||||
- Some commands buggy (grep returns empty)
|
||||
- ls command worse with RTK (-274% increase)
|
||||
- Requires manual installation (not on npm/brew yet)
|
||||
- 446 stars on GitHub, actively maintained (30 releases in 23 days)
|
||||
- Not suitable for interactive commands
|
||||
- Rapid development cadence (check for breaking changes)
|
||||
|
||||
## Recommendation
|
||||
|
||||
**Use RTK for**: git workflows, file finding, large file reading
|
||||
**Skip RTK for**: ls, grep, small outputs, quick exploration
|
||||
**Use RTK for**: git workflows, file operations, test frameworks, build tools, package managers
|
||||
**Skip RTK for**: small outputs, quick exploration, interactive commands
|
||||
|
||||
## 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`
|
||||
- CLAUDE.md template: `examples/claude-md/rtk-optimized.md`
|
||||
|
|
|
|||
|
|
@ -1,19 +1,27 @@
|
|||
# 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 |
|
||||
|------|-------------|----------|
|
||||
| [notebooklm.pdf](./notebooklm.pdf) | Visual overview generated by NotebookLM | Quick visual scan (~20 min) |
|
||||
| [kimi.pdf](./kimi.pdf) | Full text PDF export | Offline reading |
|
||||
**Source of truth**: [`guide/ultimate-guide.md`](../guide/ultimate-guide.md)
|
||||
|
||||
## Notes
|
||||
## Deprecated Files
|
||||
|
||||
- These files are **generated outputs**, not source content
|
||||
- The source of truth is [`guide/ultimate-guide.md`](../guide/ultimate-guide.md)
|
||||
- PDFs may lag behind the latest guide updates
|
||||
| File | Description | Status |
|
||||
|------|-------------|--------|
|
||||
| [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).
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -22,6 +22,8 @@
|
|||
- [11. AI Coding Agents Matrix](#11-ai-coding-agents-matrix)
|
||||
- [11.1 Goose: Open-Source Alternative (Block)](#111-goose-open-source-alternative-block)
|
||||
- [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)
|
||||
- [Appendix: Ready-to-Use Prompts](#appendix-ready-to-use-prompts)
|
||||
- [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?" |
|
||||
| Feature comparison (11 criteria) | Workflows, architecture, TDD/SDD methodologies |
|
||||
| 23 agents × shallow | 1 agent × deep (11K lines) |
|
||||
| Technical specs | Practical templates (66+), quiz (257 questions) |
|
||||
| 23 agents × shallow | 1 agent × deep (19K lines) |
|
||||
| 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**.
|
||||
|
||||
|
|
@ -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).
|
||||
|
||||
### 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:
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@
|
|||
|
||||
**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 |
|
||||
|------|---------|---------|
|
||||
| **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` |
|
||||
| **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
|
||||
|
||||
*Last updated: February 2026 | Version 3.27.0*
|
||||
*Last updated: February 2026 | Version 3.27.1*
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# 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.
|
||||
|
||||
|
|
@ -13,6 +13,7 @@ This guide covers validated community MCP servers beyond the official Anthropic
|
|||
- [Browser Automation](#browser-automation)
|
||||
- [DevOps & Infrastructure](#devops--infrastructure)
|
||||
- [Security & Code Analysis](#security--code-analysis)
|
||||
- [Code Search & Analysis](#code-search--analysis)
|
||||
- [Documentation & Knowledge](#documentation--knowledge)
|
||||
- [Project Management](#project-management)
|
||||
- [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
|
||||
|
||||
#### 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 |
|
||||
| **DevOps/Infrastructure** | 2 (Vercel, Kubernetes) | Deployment, cluster management |
|
||||
| **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 |
|
||||
| **Project Management** | 1 (Linear) | Issue tracking, sprint planning |
|
||||
| **Orchestration** | 1 (MCP-Compose) | Multi-server management |
|
||||
|
|
@ -1110,12 +1242,12 @@ Servers evaluated but not included in the validated list:
|
|||
### Maintainer Types
|
||||
|
||||
- **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
|
||||
**Next review**: February 2026
|
||||
**Last updated**: February 2026
|
||||
**Next review**: March 2026
|
||||
**Maintainer**: Claude Code Ultimate Guide Team
|
||||
|
||||
---
|
||||
|
|
|
|||
|
|
@ -85,27 +85,25 @@ A Python TUI for visual token burn-rate tracking. Displays charts showing consum
|
|||
|
||||
### 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 |
|
||||
|-----------|---------|
|
||||
| **Source** | [GitHub: pszymkowiak/rtk](https://github.com/pszymkowiak/rtk) (upstream stable) |
|
||||
| **Fork** | [GitHub: FlorianBruniaux/rtk](https://github.com/FlorianBruniaux/rtk) (extended features) |
|
||||
| **Install** | `cargo install rtk` or binary download |
|
||||
| **Source** | [GitHub: rtk-ai/rtk](https://github.com/rtk-ai/rtk) |
|
||||
| **Website** | [rtk-ai.app](https://www.rtk-ai.app/) |
|
||||
| **Install** | `brew install rtk-ai/tap/rtk` or `cargo install rtk` |
|
||||
| **Language** | Rust (standalone binary) |
|
||||
| **Version** | v0.2.0+ (upstream), v0.4.0+ (fork) |
|
||||
| **Version** | v0.16.0 |
|
||||
|
||||
**Key features**:
|
||||
|
||||
- `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 gain` - token savings analytics
|
||||
- `rtk discover` - find missed optimization opportunities (fork only)
|
||||
|
||||
**Two versions:**
|
||||
|
||||
- **Upstream** (pszymkowiak): Stable, git/find/cat focus, minimal dependencies
|
||||
- **Fork** (FlorianBruniaux): Adds JS/TS stack support (vitest, pnpm, prisma), bug fixes (grep, ls), analytics
|
||||
- `rtk vitest run`, `rtk prisma`, `rtk pnpm` (70-90% reduction)
|
||||
- `rtk python pytest`, `rtk go test` (multi-language support)
|
||||
- `rtk cargo test/build/clippy` (Rust toolchain)
|
||||
- `rtk init` - hook-first install, `rtk tree` - project structure, `rtk learn` - interactive learning
|
||||
- `rtk gain` - token savings analytics (SQLite tracking)
|
||||
- `rtk discover` - find missed optimization opportunities
|
||||
|
||||
**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)
|
||||
- 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)
|
||||
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@
|
|||
|
||||
**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 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.
|
||||
|
||||
|
|
@ -8158,6 +8158,191 @@ Fix implementation or update tests.
|
|||
|
||||
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
|
||||
|
|
@ -13169,59 +13354,70 @@ You: "Fix typos in auth.ts, user.ts, and api.ts"
|
|||
|
||||
### 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:**
|
||||
|
||||
- **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
|
||||
**Repository:** [rtk-ai/rtk](https://github.com/rtk-ai/rtk) | **Website:** [rtk-ai.app](https://www.rtk-ai.app/)
|
||||
|
||||
**Installation:**
|
||||
|
||||
```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
|
||||
|
||||
# Option 2: Extended fork with all features
|
||||
git clone https://github.com/FlorianBruniaux/rtk.git
|
||||
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
|
||||
# Option 3: Install script
|
||||
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/main/install.sh | bash
|
||||
|
||||
# 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 |
|
||||
|---------|----------|-----|-----------|
|
||||
| `rtk git log` | 13,994 chars | 1,076 chars | **92.3%** |
|
||||
| `rtk git status` | 100 chars | 24 chars | **76.0%** |
|
||||
| `rtk git diff` | 15,815 chars | 6,982 chars | **55.9%** |
|
||||
| `rtk vitest run` (fork) | ~50,000 chars | ~5,000 chars | **90.0%** |
|
||||
| `rtk pnpm list` (fork) | ~8,000 chars | ~2,400 chars | **70.0%** |
|
||||
| `rtk vitest run` | ~50,000 chars | ~5,000 chars | **90.0%** |
|
||||
| `rtk pnpm list` | ~8,000 chars | ~2,400 chars | **70.0%** |
|
||||
| `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
|
||||
# Git operations (both versions)
|
||||
# Git operations
|
||||
rtk git log
|
||||
rtk git status
|
||||
rtk git diff HEAD~1
|
||||
|
||||
# JS/TS Stack (fork only)
|
||||
# JS/TS Stack
|
||||
rtk vitest run # Test results condensed
|
||||
rtk pnpm list # Dependency tree optimized
|
||||
rtk prisma migrate status # Migration status filtered
|
||||
|
||||
# Analytics (fork only)
|
||||
rtk gain # Show token savings stats
|
||||
# Python
|
||||
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
|
||||
```
|
||||
|
||||
|
|
@ -13236,53 +13432,42 @@ rtk discover # Find missed optimization opportunities
|
|||
|
||||
**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
|
||||
## Token Optimization
|
||||
|
||||
Use RTK for git operations:
|
||||
Use RTK for all supported commands:
|
||||
- `rtk git log` (92.3% reduction)
|
||||
- `rtk git status` (76.0% reduction)
|
||||
- `rtk git diff` (55.9% reduction)
|
||||
```
|
||||
|
||||
2. **Skill** (auto-suggestion):
|
||||
3. **Skill** (auto-suggestion):
|
||||
- Template: `examples/skills/rtk-optimizer/SKILL.md`
|
||||
- Detects high-verbosity commands
|
||||
- Suggests RTK wrapper automatically
|
||||
|
||||
3. **Hook** (automatic wrapper):
|
||||
4. **Hook** (automatic wrapper):
|
||||
- Template: `examples/hooks/bash/rtk-auto-wrapper.sh`
|
||||
- PreToolUse hook intercepts bash commands
|
||||
- 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:**
|
||||
|
||||
- ✅ **Fork**: Full-stack JS/TS projects, testing workflows, analytics needs
|
||||
- ✅ **Upstream**: Git-only workflows, minimal dependencies, stable releases
|
||||
- ✅ **Use RTK**: Full-stack projects (JS/TS, Rust, Python, Go), testing workflows, analytics
|
||||
- ❌ **Skip RTK**: Small outputs (<100 chars), quick exploration, interactive commands
|
||||
|
||||
**See also:**
|
||||
|
||||
- Evaluation: `docs/resource-evaluations/rtk-evaluation.md`
|
||||
- Templates: `examples/{claude-md,skills,hooks}/rtk-*`
|
||||
- Upstream: https://github.com/pszymkowiak/rtk
|
||||
- Fork (extended): https://github.com/FlorianBruniaux/rtk
|
||||
- GitHub: https://github.com/rtk-ai/rtk
|
||||
- Website: https://www.rtk-ai.app/
|
||||
- Third-party tools comparison: `guide/third-party-tools.md#rtk-rust-token-killer`
|
||||
|
||||
### Cost Tracking
|
||||
|
|
@ -15384,7 +15569,7 @@ llms.txt is a lightweight standard for making documentation discoverable to LLMs
|
|||
```
|
||||
# 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
|
||||
- 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.
|
||||
|
||||
**Last updated**: January 2026 | **Version**: 3.27.0
|
||||
**Last updated**: January 2026 | **Version**: 3.27.1
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
# Source: guide/ultimate-guide.md
|
||||
# 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"
|
||||
|
||||
# ════════════════════════════════════════════════════════════════
|
||||
|
|
@ -48,19 +48,18 @@ deep_dive:
|
|||
bridge_schema: "examples/scripts/bridge-plan-schema.json"
|
||||
bridge_guide: "guide/ultimate-guide.md:14079"
|
||||
# Cost optimization - RTK (Rust Token Killer)
|
||||
rtk_upstream: "https://github.com/pszymkowiak/rtk"
|
||||
rtk_fork_extended: "https://github.com/FlorianBruniaux/rtk"
|
||||
rtk_upstream: "https://github.com/rtk-ai/rtk"
|
||||
rtk_website: "https://www.rtk-ai.app/"
|
||||
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_claude_md: "examples/claude-md/rtk-optimized.md"
|
||||
rtk_skill: "examples/skills/rtk-optimizer/SKILL.md"
|
||||
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 (72.6% avg reduction)"
|
||||
rtk_version_tested: "v0.2.0"
|
||||
rtk_score: "4/5"
|
||||
rtk_installation: "Binary download (GitHub releases)"
|
||||
rtk_purpose: "Command output filtering before LLM context (60-90% avg reduction)"
|
||||
rtk_version_tested: "v0.16.0"
|
||||
rtk_score: "5/5"
|
||||
rtk_installation: "cargo install rtk or brew install rtk-ai/tap/rtk"
|
||||
# PDF Generation
|
||||
pdf_generation: "guide/workflows/pdf-generation.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_conductor: "https://docs.conductor.build"
|
||||
# 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_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/
|
||||
|
|
@ -424,7 +423,7 @@ deep_dive:
|
|||
gsd_note: "Overlap with existing patterns (Ralph Loop, Gas Town, BMAD)"
|
||||
# Resource Evaluations (added 2026-01-26, updated 2026-02-07)
|
||||
resource_evaluations_directory: "docs/resource-evaluations/"
|
||||
resource_evaluations_count: 55
|
||||
resource_evaluations_count: 67
|
||||
resource_evaluations_methodology: "docs/resource-evaluations/README.md"
|
||||
resource_evaluations_watchlist: "docs/resource-evaluations/watch-list.md"
|
||||
resource_evaluations_appendix: "guide/ultimate-guide.md:15034"
|
||||
|
|
@ -450,6 +449,11 @@ deep_dive:
|
|||
practitioner_insights: "guide/ai-ecosystem.md:1209"
|
||||
practitioner_dave_van_veen: "guide/ai-ecosystem.md:1213"
|
||||
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_steinberger: "guide/ai-ecosystem.md:1997"
|
||||
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_multi_ide_sync: "guide/ai-ecosystem.md:1256"
|
||||
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_input: "guide/ai-ecosystem.md:1379"
|
||||
architecture_diagrams_mcp_tools:
|
||||
|
|
@ -733,10 +738,10 @@ deep_dive:
|
|||
myths_tasks_api_autonomous: 15301
|
||||
myths_100x_faster: 15340
|
||||
myths_reliable_sources: 15388
|
||||
# Quiz System (257 questions, 15 categories)
|
||||
# Quiz System (264 questions, 15 categories)
|
||||
quiz_overview: "quiz/README.md"
|
||||
quiz_file: "quiz/questions.json"
|
||||
quiz_count: 257
|
||||
quiz_count: 264
|
||||
quiz_categories: 15
|
||||
quiz_beginner: "quiz/categories/basics,commands,shortcuts,reference"
|
||||
quiz_beginner_count: 60
|
||||
|
|
@ -1084,7 +1089,7 @@ rules:
|
|||
ecosystem:
|
||||
this_guide:
|
||||
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:
|
||||
claude_code_templates:
|
||||
url: "github.com/davila7/claude-code-templates"
|
||||
|
|
@ -1109,8 +1114,8 @@ ecosystem:
|
|||
url: "github.com/affaan-m/everything-claude-code"
|
||||
author: "Affaan Mustafa (Anthropic hackathon winner - Zenith project)"
|
||||
focus: "Production configs - Battle-tested from 10+ months intensive use"
|
||||
stars: "31.9k"
|
||||
verified: "2026-01-27"
|
||||
stars: "45k+"
|
||||
verified: "2026-02-15"
|
||||
created: "2026-01-18"
|
||||
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"
|
||||
|
|
@ -1166,7 +1171,7 @@ ecosystem:
|
|||
local: "/Users/florianbruniaux/Sites/perso/claude-code-ultimate-guide-landing/"
|
||||
purpose: "Marketing site for Claude Code 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)"
|
||||
cowork_landing:
|
||||
local: "/Users/florianbruniaux/Sites/perso/claude-cowork-guide-landing/"
|
||||
|
|
@ -1180,7 +1185,7 @@ ecosystem:
|
|||
- "Cross-links modified → Update all 4 repos"
|
||||
history:
|
||||
- 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"
|
||||
- date: "2026-01-20"
|
||||
event: "Cowork Landing fix (paths, README, UI badges)"
|
||||
|
|
@ -1192,7 +1197,7 @@ ecosystem:
|
|||
onboarding_matrix_meta:
|
||||
version: "2.0.0"
|
||||
last_updated: "2026-02-05"
|
||||
aligned_with_guide: "3.27.0"
|
||||
aligned_with_guide: "3.27.1"
|
||||
changelog:
|
||||
- version: "2.0.0"
|
||||
date: "2026-02-05"
|
||||
|
|
@ -1220,7 +1225,7 @@ onboarding_matrix:
|
|||
core: [rules, sandbox_native_guide, commands]
|
||||
time_budget: "5 min"
|
||||
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:
|
||||
core: [rules, sandbox_native_guide, workflow, essential_commands]
|
||||
|
|
@ -1305,7 +1310,7 @@ onboarding_matrix:
|
|||
- default: agent_validation_checklist
|
||||
time_budget: "60 min"
|
||||
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:
|
||||
intermediate_30min:
|
||||
|
|
@ -1316,7 +1321,7 @@ onboarding_matrix:
|
|||
- default: permission_modes
|
||||
time_budget: "30 min"
|
||||
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:
|
||||
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]
|
||||
time_budget: "60 min"
|
||||
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:
|
||||
core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]
|
||||
|
|
|
|||
|
|
@ -405,7 +405,7 @@ The Claude Code cheatsheet serves as the benchmark. Here's what makes it the gol
|
|||
|
||||
### 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
|
||||
- **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)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue