Florian BRUNIAUX
|
257f2ff65d
|
docs: add search tools guides and ast-grep patterns
New documentation:
- guide/search-tools-cheatsheet.md: Quick reference for Grep/Glob/Read tools
- guide/workflows/README.md: Workflows directory index
- examples/skills/ast-grep-patterns.md: AST-based code search patterns
Updated:
- guide/architecture.md: MCP architecture visual diagram section
Co-Authored-By: Claude <noreply@anthropic.com>
|
2026-01-25 18:47:29 +01:00 |
|
Florian BRUNIAUX
|
68e738b5e0
|
fix: correct indentation in architecture.md MCP section
Co-Authored-By: Claude <noreply@anthropic.com>
|
2026-01-25 13:49:17 +01:00 |
|
Florian BRUNIAUX
|
29f778daf7
|
docs: update template count badge (82 → 83)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2026-01-25 13:30:40 +01:00 |
|
Florian BRUNIAUX
|
ee5791668a
|
docs: add SE-CoVe plugin example + resource evaluation workflow (v3.11.6)
- First plugin example: SE-CoVe (Chain-of-Verification, Meta AI ACL 2024)
- Academic approach: cite paper metrics, not marketing claims
- Performance table: +23-112% accuracy (task-dependent, trade-offs disclosed)
- Resource evaluation template established (Perplexity fact-check workflow)
- Curation policy: Academic validation + Claims verified + Costs transparent
- Templates count: 82 → 83
- Architecture diagram added (visual overview of Claude Code internals)
Files:
- examples/plugins/se-cove.md (new plugin documentation)
- claudedocs/resource-evaluations/2026-01-24-se-cove-plugin.md (evaluation report)
- README.md, CHANGELOG.md, VERSION, reference.yaml (version bump 3.11.5 → 3.11.6)
- guide/architecture.md + image (visual overview)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
2026-01-24 17:40:54 +01:00 |
|
Florian BRUNIAUX
|
ace62f2f84
|
docs: add MCP Tool Search documentation (v3.11.2)
Add comprehensive documentation for MCP Tool Search (lazy loading):
- New section in guide/architecture.md with ASCII flow diagram
- Documents 85% token reduction and accuracy improvements
- Configuration guide for ENABLE_TOOL_SEARCH=auto:N syntax
- Simon Willison quote on context pollution resolution
Enriched release notes:
- v2.1.7: Added stats and Anthropic blog link
- v2.1.9: Added auto:N examples and cross-reference
Fixed template count: 83 → 82 (actual count)
Sources: Anthropic Engineering blog, Scott Spence, Perplexity verification
Co-Authored-By: Claude <noreply@anthropic.com>
|
2026-01-22 21:56:20 +01:00 |
|
Florian BRUNIAUX
|
fd17414abb
|
docs: add AI productivity research, trust calibration, and exploration workflow
## New Content
### Trust & Verification (ultimate-guide.md)
- Section 1.7 "Trust Calibration: When and How Much to Verify" (~155 lines)
- Research-backed stats (ACM, Veracode, CodeRabbit, Cortex.io)
- Verification spectrum by code type
- Solo vs Team strategies with workflow diagrams
- "Prove It Works" checklist
- New pitfall: "Trust AI output without proportional verification"
- CLAUDE.md size guideline: 4-8KB optimal, >16K degrades coherence
### AI Productivity (learning-with-ai.md)
- Section "The Reality of AI Productivity" (~55 lines)
- Productivity curve phases (Wow Effect → Targeted Gains → Plateau)
- High-gain vs low/negative-gain task categorization
- Team success factors
- Productivity trajectory table by pattern (Dependent/Avoidant/Augmented)
- 5 new sources (GitHub, McKinsey, Stack Overflow, Uplevel, DORA)
### Session Limits (architecture.md)
- "Session Degradation Limits" section
- Turn limits (15-25), token thresholds (80-100K)
- Success rates by scope (1-3 files: ~85%, 8+ files: ~40%)
### Exploration Workflow
- NEW: guide/workflows/exploration-workflow.md
- Anti-anchoring prompts, 3-5 approaches pattern
- iterative-refinement.md: Script Generation Workflow (3-7 iteration pattern)
- anchor-catalog.md: Anti-Anchoring Techniques, Exploration/Iteration Prompts
### Reference Updates
- adoption-approaches.md: Empirical data section
- reference.yaml: New deep_dive entries, updated line numbers
Sources: MetalBear engineering blog, arXiv studies, Addy Osmani (Jan 2026)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
|
2026-01-19 19:16:33 +01:00 |
|
Florian BRUNIAUX
|
f9044e2deb
|
feat(docs): add architecture deep-dive documentation v3.4.0
Add comprehensive technical documentation explaining Claude Code internals:
- NEW: guide/architecture.md (~800 lines) - Complete architecture deep-dive
- Master Loop (while tool_call), Tool Arsenal, Context Management
- Sub-Agent Architecture, Permission System, MCP Integration
- Edit Tool mechanics, Session persistence, Philosophy comparison
- 5 ASCII diagrams, source confidence tiers (Tier 1/2/3)
- guide/ultimate-guide.md: Add Section 2.7 "Under the Hood" summary
- guide/cheatsheet.md: Add "Under the Hood (Quick Facts)" section
- machine-readable/reference.yaml: Add architecture index + deep_dive refs
- Update all navigation links across repository
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
|
2026-01-14 21:29:46 +01:00 |
|