From ee5791668a31d5249c0d411b916e4bc4b0160bdc Mon Sep 17 00:00:00 2001 From: Florian BRUNIAUX Date: Sat, 24 Jan 2026 17:40:54 +0100 Subject: [PATCH] docs: add SE-CoVe plugin example + resource evaluation workflow (v3.11.6) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- CHANGELOG.md | 44 ++++++ README.md | 14 +- VERSION | 2 +- examples/plugins/se-cove.md | 106 ++++++++++++++ guide/architecture.md | 14 ++ guide/cheatsheet.md | 4 +- .../claude-code-architecture-overview.jpeg | Bin 0 -> 43389 bytes guide/ultimate-guide.md | 138 +++++++++++++++++- machine-readable/reference.yaml | 40 +++-- 9 files changed, 342 insertions(+), 20 deletions(-) create mode 100644 examples/plugins/se-cove.md create mode 100644 guide/images/claude-code-architecture-overview.jpeg diff --git a/CHANGELOG.md b/CHANGELOG.md index 51c5b76..70cdc6b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,50 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). +## [3.11.6] - 2026-01-24 + +### Added + +- **First plugin example: SE-CoVe (Chain-of-Verification)** (`examples/plugins/se-cove.md`) + - Software Engineering adaptation of Meta's Chain-of-Verification methodology for Claude Code + - Research foundation: Meta AI paper (arXiv:2309.11495), ACL 2024 Findings + - 5-stage pipeline: Baseline → Planner → Executor → Synthesizer → Output + - Critical innovation: Verifier operates without draft code access (prevents confirmation bias) + - Performance metrics from research (Llama 65B): +23-112% accuracy depending on task, ~2x token cost + - When to use: Critical code review, architectural decisions, complex debugging (when correctness > speed) + - When NOT to use: Trivial changes, tight token budgets, exploratory coding + - Installation via `/plugin marketplace add vertti/se-cove-claude-plugin` then `/plugin install chain-of-verification` + - Limitations documented: Reduces hallucinations (not eliminates), model-specific (Llama 65B tested), task-dependent performance + - Plugin System gap filled: First concrete example for Section 8.5 (previously theoretical docs only) + - Sources: [GitHub repo](https://github.com/vertti/se-cove-claude-plugin) v1.1.1, [arXiv paper](https://arxiv.org/abs/2309.11495), [ACL Anthology](https://aclanthology.org/2024.findings-acl.212/) + +- **Plugin system YAML index entries** (`machine-readable/reference.yaml:124-132`) + - `plugins_system: 6863` (existing section reference) + - `plugins_commands: 6876` (command table reference) + - `plugins_marketplace: 6890` (marketplace management reference) + - `plugins_recommended: "examples/plugins/"` (new directory) + - `plugins_se_cove: "examples/plugins/se-cove.md"` + - `chain_of_verification: "guide/methodologies.md:165"` (methodology reference) + - `chain_of_verification_paper: "https://arxiv.org/abs/2309.11495"` + - `chain_of_verification_acl: "https://aclanthology.org/2024.findings-acl.212/"` + +- **Resource evaluation documentation** (`claudedocs/resource-evaluations/2026-01-24-se-cove-plugin.md`) + - Complete evaluation workflow: Fetch → Gap Analysis → Technical Writer Challenge → Fact-Check (Perplexity) → Documentation + - Fact-check findings: Marketing claim "28% improvement" contextualized (task-specific: 23-112%, omitted 2x cost and -26% output) + - Curation policy established: Academic validation + Claims fact-checked + Trade-offs disclosed + - Approach B (Neutral Academic) validated: Cite paper metrics, not marketing claims + - Template for future plugin evaluations (reusable workflow) + - Tools used: WebFetch (LinkedIn, GitHub, arXiv), Perplexity Pro (paper verification), Task (technical-writer challenge) + - Confidence assessment: High (methodology), Medium (generalization), Low (marketing accuracy) + +### Changed + +- **README.md**: Templates count 82 → 83 (added SE-CoVe plugin) + - Badge updated: `Templates-82` → `Templates-83` + - "Examples Library" section updated (line 228) + - Ecosystem table updated (line 377) + - New **Plugins** subsection added after Skills (line 238) + ## [3.11.5] - 2026-01-23 ### Added diff --git a/README.md b/README.md index ad634e6..d0c2cb0 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@

Stars - Templates + Templates Quiz

@@ -64,7 +64,7 @@ Save as `CLAUDE.md` in your project root. Claude reads it automatically. **The problem**: Awesome-lists give links, not learning paths. Official docs are dense. Tutorials get outdated in weeks. -**This guide**: Structured learning path with 82 copy-paste templates, from first install to advanced workflows. +**This guide**: Structured learning path with 83 copy-paste templates, from first install to advanced workflows. **Reading time**: Quick Start ~15 min. Full guide ~3 hours (most read by section). @@ -225,7 +225,7 @@ claude-code-ultimate-guide/
-Examples Library (82 templates) +Examples Library (83 templates) **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) ⭐ @@ -235,6 +235,8 @@ claude-code-ultimate-guide/ **Skills** (1): [Claudeception](https://github.com/blader/Claudeception) — Meta-skill that auto-generates skills from session discoveries ⭐ +**Plugins** (1): [SE-CoVe](./examples/plugins/se-cove.md) — Chain-of-Verification for independent code review (Meta AI, ACL 2024) + **Utility Scripts**: [session-search.sh](./examples/scripts/session-search.sh), [audit-scan.sh](./examples/scripts/audit-scan.sh) **GitHub Actions**: [claude-pr-auto-review.yml](./examples/github-actions/claude-pr-auto-review.yml), [claude-security-review.yml](./examples/github-actions/claude-security-review.yml), [claude-issue-triage.yml](./examples/github-actions/claude-issue-triage.yml) @@ -361,7 +363,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv **Status**: Research preview (Pro $20/mo or Max $100-200/mo, macOS only, **VPN incompatible**) -**Archive**: Historical versions available in git history (pre-v3.11.5) +**Archive**: Historical versions available in git history (pre-v3.11.6)
@@ -372,7 +374,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv | Repository | Purpose | Audience | |------------|---------|----------| -| **[Claude Code Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)** *(this repo)* | Comprehensive documentation (13K lines, 82 templates) | Developers | +| **[Claude Code Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)** *(this repo)* | Comprehensive documentation (13K lines, 83 templates) | Developers | | **[Claude Cowork Guide](https://github.com/FlorianBruniaux/claude-cowork-guide)** | Non-technical usage (67 prompts, 5 workflows) | Knowledge workers | | **Code Landing** *(to be deployed)* | Marketing site for Claude Code guide | Discovery | | **Cowork Landing** *(to be deployed)* | Marketing site for Cowork guide | Discovery | @@ -431,7 +433,7 @@ Licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). --- -*Version 3.11.5 | January 2026 | Crafted with Claude* +*Version 3.11.6 | January 2026 | Crafted with Claude*