Skip to content

Commit ca69a1a

Browse files
release: v3.35.0 — workflows, hook, threat-db, GitHub Actions CI
New workflow guides (RPI, changelog-fragments, github-actions), smart-suggest UserPromptSubmit hook, LLM variance known-issue, threat-db v2.7.0, desloppify, cc-sessions discover documentation, prompt-caching verification script. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent b0698bf commit ca69a1a

File tree

9 files changed

+41
-47
lines changed

9 files changed

+41
-47
lines changed

CHANGELOG.md

Lines changed: 17 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -6,45 +6,39 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
66

77
## [Unreleased]
88

9-
### Added
10-
11-
- **`guide/workflows/github-actions.md`** — New workflow guide (5 production-ready patterns using `anthropics/claude-code-action`, 6.2k stars, v1.0). Covers: (1) on-demand PR review via `@claude` mention, (2) automatic review on every push, (3) issue triage and labeling, (4) security-focused review on sensitive path changes, (5) scheduled weekly repo health check. Includes setup via `/install-github-app`, authentication alternatives (OAuth vs API key), cost control (concurrency limits, token caps), and fork safety (`pull_request_target` vs `pull_request`).
12-
13-
- **`guide/ultimate-guide.md`** — Two additions: (1) Cross-reference callout to `github-actions.md` in the CI/CD section. (2) New "Fighting Vibe Code Degradation" subsection covering **desloppify** ([github.com/peteromallet/desloppify](https://github.com/peteromallet/desloppify)): a community tool that installs a prioritized fix-loop as a Claude Code skill, scanning for dead code, duplication, and structural issues until a quality score target is hit.
14-
15-
- **`examples/commands/resources/threat-db.yaml`** — Updated to v2.7.0 (2026-03-13). Added 5 new threat intelligence sources: CVE-2026-26118 Azure MCP Server SSRF (THN/Tenable), OpenClaw agentic AI risk analysis (ReversingLabs), Taskflow Agent open-source vulnerability scanner (GitHub Security Lab), OpenAI Codex Security research preview, and DryRun Security research on AI coding agents introducing vulnerabilities in 87% of PRs.
9+
## [3.35.0] - 2026-03-13
1610

17-
- **`CLAUDE.md`**Added "Behavioral Rules" section: 5 rules derived from observed friction patterns (always update CHANGELOG.md, exhaustive first-pass analysis, use absolute paths, closing checklist, bias toward action).
11+
### Added
1812

19-
- **`examples/scripts/test-prompt-caching.ts`**Standalone TypeScript script (zero deps, native fetch) to verify Anthropic prompt caching is active on any API key. Runs 3 identical calls and checks write/read metrics. Documents 4 production gotchas not in official docs: (1) `anthropic-beta: prompt-caching-2024-07-31` header is required even for Claude 4.x, (2) effective token threshold for Claude 4.x is ~2048+ not the documented 1024, (3) cached tokens are excluded from `input_tokens`, (4) new nested `cache_creation` object format with `ephemeral_5m_input_tokens` and `ephemeral_1h_input_tokens`. Usage: `ANTHROPIC_API_KEY=sk-ant-... npx tsx test-prompt-caching.ts`.
13+
- **`guide/workflows/github-actions.md`**5 production-ready patterns for GitHub Actions CI/CD with `anthropics/claude-code-action` (6.2k stars, v1.0): on-demand PR review via `@claude` mention, automatic review on every push, issue triage and labeling, security-focused review on sensitive paths (`auth/**`, `payments/**`), scheduled weekly repo health check. Includes cost control table (Haiku vs Sonnet per pattern), concurrency setup, fork safety (`pull_request_target` guard), Bedrock/Vertex auth alternatives. Cross-linked from guide §9.3 and `guide/workflows/README.md`.
2014

21-
- **`CLAUDE.md` Behavioral Rules section**New `## Behavioral Rules` section with 5 rules derived from observed session friction patterns (via `/insights` analysis): (1) always update `CHANGELOG.md` after any modification, (2) be exhaustive on first pass for audits and reviews, (3) use absolute paths in reports and documentation, (4) closing checklist confirming files changed + changelog + commit hash, (5) bias toward action — no extended planning loops without deliverables.
15+
- **`guide/workflows/rpi.md`**RPI: Research → Plan → Implement. 3-phase feature development with explicit GO gates: Research → `RESEARCH.md`, Plan → `PLAN.md`, Implement → working code. Slash command templates (`/rpi:research`, `/rpi:plan`, `/rpi:implement`), worked example (rate limiting on Express API), and comparison matrix vs Plan-Driven, TDD, Spec-First. Best for features where discovering a wrong assumption late is expensive.
2216

23-
### Added
17+
- **`guide/workflows/changelog-fragments.md`** — Changelog Fragments workflow: one YAML fragment per PR, written at implementation time, validated by CI, assembled at release. 3-layer enforcement: CLAUDE.md workflow rule + `UserPromptSubmit` hook (3-tier: enforcement → discovery → contextual) + independent CI migration check. Documents the `UserPromptSubmit` tier pattern as a reusable architecture for any mandatory workflow step.
2418

25-
- **Desloppify tool**New subsection "Fighting Vibe Code Degradation" in §9.8 (Vibe Coding). Documents `desloppify` ([peteromallet/desloppify](https://github.com/peteromallet/desloppify)), a community tool that installs a fix-loop workflow directly into Claude Code as a skill (`desloppify update-skill claude`) and runs a scan → next → fix → resolve loop to systematically improve code quality. Includes install snippet, the loop commands, and an early-stage status note with token cost caveat. Tagged early-stage (released February 2026, ~2K stars, no production-scale feedback yet).
19+
- **`examples/hooks/bash/smart-suggest.sh`**`UserPromptSubmit` behavioral coach hook: Tier 0 enforcement (changelog fragment required before PR, plan-before-code), Tier 1 discovery (test-loop, retex, dupes, monitoring loop, security audit, release), Tier 2 contextual (code review, debugging, architecture, session resume). Max 1 suggestion per prompt, dedup guard, ROI logging to `~/.claude/logs/smart-suggest.jsonl`, silent exit on no match.
2620

27-
- **`guide/workflows/github-actions.md`**New workflow guide (5 production-ready patterns for GitHub Actions CI/CD with `anthropics/claude-code-action`, 6.2k stars, v1.0). Covers: (1) interactive PR review via `@claude` mention, (2) automatic review on push, (3) issue triage and labeling, (4) security-focused review triggered on sensitive paths (`auth/**`, `payments/**`), (5) scheduled weekly repo health check. Includes cost control table (Haiku vs Sonnet per pattern), concurrency setup to prevent parallel runs, fork safety guard for public repos, and Bedrock/Vertex authentication alternatives. Cross-linked from section 9.3 of the main guide and added to `guide/workflows/README.md`.
21+
- **`guide/core/known-issues.md`**"LLM Day-to-Day Performance Variance" section: session-to-session quality variance (shorter responses, conservative suggestions, edge-case refusals) documented as expected behavior, not a bug. 4 root causes: probabilistic inference, MoE routing variance, infrastructure variance, context sensitivity. Observable signals table and ruling-out checklist.
2822

29-
- **`guide/workflows/README.md`**: Added GitHub Actions Workflows entry to Development Workflows section with description, key topics, and "when to use" guidance.
23+
- **`examples/scripts/test-prompt-caching.ts`** — Standalone TypeScript script (zero deps, native fetch) to verify Anthropic prompt caching on any API key. Runs 3 identical calls, checks write/read metrics. Documents 4 undocumented production gotchas: `anthropic-beta: prompt-caching-2024-07-31` header required for Claude 4.x, effective threshold ~2048+ tokens, cached tokens excluded from `input_tokens`, new nested `cache_creation` object format.
3024

31-
- **`guide/workflows/rpi.md`**New workflow guide (RPI: Research → Plan → Implement). 3-phase feature development pattern with explicit validation gates: Research produces `RESEARCH.md`, Plan produces `PLAN.md`, Implement produces working code. Each gate requires explicit GO before the next phase. Includes slash command templates (`/rpi:research`, `/rpi:plan`, `/rpi:implement`), a worked example (adding rate limiting to an Express API), and comparison matrix vs Plan-Driven, TDD, and Spec-First. Best for features where discovering a wrong assumption late is expensive.
25+
- **`cc-sessions discover` documentation**"Session Pattern Discovery" subsection in §2.x: `discover` subcommand n-gram mode (local, ~3s) vs `--llm` mode (semantic via `claude --print`), 20% rule decision framework (CLAUDE.md rule / skill / command), install instructions. Cross-reference added after the 20% rule callout in §5.1.
3226

33-
- **`guide/workflows/changelog-fragments.md`**New workflow guide for the Changelog Fragments pattern: one YAML fragment per PR, written at implementation time, validated by CI, assembled automatically at release. Covers 3-layer enforcement: (1) CLAUDE.md workflow rule for autonomous fragment creation, (2) `UserPromptSubmit` hook with 3-tier priority (enforcement → discovery → contextual), (3) independent CI migration check job. Includes the `UserPromptSubmit` tier pattern as a reusable hook architecture for any mandatory workflow step.
27+
- **`examples/scripts/cc-sessions.py`**Synced from 498-line stale copy to full 1225-line version from `~/bin/cc-sessions`: complete `discover` subcommand, incremental cache, Jaccard deduplication, all filtering logic. GitHub source header added.
3428

35-
- **`examples/hooks/bash/smart-suggest.sh`**New `UserPromptSubmit` hook implementing the 3-tier behavioral coach pattern: Tier 0 enforcement (changelog fragment required before PR, plan-before-code), Tier 1 discovery (test-loop, retex, dupes, monitoring, security, release), Tier 2 contextual (code review, debugging, architecture, session resume). Max 1 suggestion per prompt (first match wins), dedup guard, ROI logging to `~/.claude/logs/smart-suggest.jsonl`, silent exit on no match.
29+
- **GitHub repo [FlorianBruniaux/cc-sessions](https://github.com/FlorianBruniaux/cc-sessions)**v1.0.0 published with curl install instructions.
3630

37-
- **`guide/core/known-issues.md`** — New section "LLM Day-to-Day Performance Variance": documents session-to-session output quality variance (shorter responses, conservative suggestions, edge-case refusals) as expected behavior, not a bug. Explains the 4 root causes (probabilistic inference, MoE routing variance, infrastructure variance, context sensitivity) and provides an observable signals table. Includes a practical checklist for ruling out controllable factors before concluding "the model degraded."
31+
### Updated
3832

39-
- **`cc-sessions discover` documentation**New subsection "Session Pattern Discovery" in §2.x (Session Management) covering the `discover` subcommand: n-gram mode (local, free, ~3s for 12 projects) vs `--llm` mode (semantic analysis via `claude --print`). Includes example output, the 20% rule decision framework (CLAUDE.md rule / skill / command categorization), and install instructions. Cross-reference added after the 20% rule callout in §5.1.
33+
- **`guide/ultimate-guide.md`**Two additions: cross-reference callout to `github-actions.md` in CI/CD section; "Fighting Vibe Code Degradation" subsection covering desloppify ([peteromallet/desloppify](https://github.com/peteromallet/desloppify)) — scan → next → fix → resolve loop as a Claude Code skill, early-stage (Feb 2026, ~2K stars), token cost caveat.
4034

41-
- **`examples/scripts/cc-sessions.py` synced**Updated from 498-line stale copy to the full 1225-line version from `~/bin/cc-sessions`. Includes the complete `discover` subcommand (n-gram analysis + `--llm` mode), incremental discover cache, Jaccard deduplication, and all filtering logic. GitHub source header added.
35+
- **`examples/commands/resources/threat-db.yaml`**v2.7.0 (2026-03-13). +5 threat sources: CVE-2026-26118 Azure MCP Server SSRF (THN/Tenable), OpenClaw agentic AI risk (ReversingLabs), Taskflow Agent scanner (GitHub Security Lab), OpenAI Codex Security research preview, DryRun Security 87% vulnerability rate in AI-built PRs.
4236

43-
- **`examples/scripts/README.md`**Updated cc-sessions entry: added `discover` subcommand examples (n-gram and `--llm`), GitHub repo link ([FlorianBruniaux/cc-sessions](https://github.com/FlorianBruniaux/cc-sessions)), and curl install instructions.
37+
- **`CLAUDE.md`**"Behavioral Rules" section: 5 rules from observed session friction: always update CHANGELOG.md, exhaustive first pass, absolute paths, closing checklist, bias toward action.
4438

45-
- **`machine-readable/reference.yaml`**Added `cc_sessions_github` and `cc_sessions_discover` entries alongside the updated `cc_sessions_script` comment.
39+
- **`examples/scripts/README.md`**cc-sessions entry updated with `discover` subcommand examples, GitHub repo link, curl install instructions.
4640

47-
- **GitHub repo created**: [FlorianBruniaux/cc-sessions](https://github.com/FlorianBruniaux/cc-sessions)v1.0.0 release tagged and published.
41+
- **`machine-readable/reference.yaml`**Added `cc_sessions_github`, `cc_sessions_discover`, `changelog_fragments_*`, `smart_suggest_hook`, `rpi_*` entries.
4842

4943
## [3.34.11] - 2026-03-13
5044

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
<p align="center">
88
<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>
9-
<a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Mar_11,_2026_·_v3.34.3-brightgreen?style=for-the-badge" alt="Last Update"/></a>
9+
<a href="./CHANGELOG.md"><img src="https://img.shields.io/badge/Updated-Mar_13,_2026_·_v3.35.0-brightgreen?style=for-the-badge" alt="Last Update"/></a>
1010
<a href="./quiz/"><img src="https://img.shields.io/badge/Quiz-271_questions-orange?style=for-the-badge" alt="Quiz"/></a>
1111
<a href="./examples/"><img src="https://img.shields.io/badge/Templates-204-green?style=for-the-badge" alt="Templates"/></a>
1212
<a href="./guide/security/security-hardening.md"><img src="https://img.shields.io/badge/🛡️_Threat_DB-15_vulnerabilities_·_655_malicious_skills-red?style=for-the-badge" alt="Threat Database"/></a>
@@ -872,7 +872,7 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
872872

873873
---
874874

875-
*Version 3.34.3 | Updated daily · Mar 11, 2026 | Crafted with Claude*
875+
*Version 3.35.0 | Updated daily · Mar 13, 2026 | Crafted with Claude*
876876

877877
<!-- SEO Keywords -->
878878
<!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,

VERSION

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
3.34.3
1+
3.35.0

guide/cheatsheet.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ tags: [cheatsheet, reference]
1212

1313
**Written with**: Claude (Anthropic)
1414

15-
**Version**: 3.34.3 | **Last Updated**: February 2026
15+
**Version**: 3.35.0 | **Last Updated**: February 2026
1616

1717
---
1818

@@ -639,4 +639,4 @@ Speed: `rg` (~20ms) → Serena (~100ms) → ast-grep (~200ms) → grepai (~500ms
639639

640640
**Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
641641

642-
*Last updated: February 2026 | Version 3.34.3*
642+
*Last updated: February 2026 | Version 3.35.0*

guide/ultimate-guide.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ tags: [guide, reference, workflows, agents, hooks, mcp, security]
1616

1717
**Last updated**: January 2026
1818

19-
**Version**: 3.34.3
19+
**Version**: 3.35.0
2020

2121
---
2222

@@ -5156,7 +5156,7 @@ The `.claude/` folder is your project's Claude Code directory for memory, settin
51565156
| Personal preferences | `CLAUDE.md` | ❌ Gitignore |
51575157
| Personal permissions | `settings.local.json` | ❌ Gitignore |
51585158

5159-
### 3.34.3 Version Control & Backup
5159+
### 3.35.0 Version Control & Backup
51605160

51615161
**Problem**: Without version control, losing your Claude Code configuration means hours of manual reconfiguration across agents, skills, hooks, and MCP servers.
51625162

@@ -23186,4 +23186,4 @@ We'll evaluate and add it to this section if it meets quality criteria.
2318623186

2318723187
**Contributions**: Issues and PRs welcome.
2318823188

23189-
**Last updated**: January 2026 | **Version**: 3.34.3
23189+
**Last updated**: January 2026 | **Version**: 3.35.0

llms-full.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,12 @@
1010

1111
- Title: Claude Code Ultimate Guide
1212
- Author: Florian Bruniaux (Founding Engineer @ Méthode Aristote)
13-
- Version: 3.34.4
14-
- Last Updated: March 12, 2026
13+
- Version: 3.35.0
14+
- Last Updated: March 13, 2026
1515
- License: CC BY-SA 4.0
1616
- Repository: https://github.com/FlorianBruniaux/claude-code-ultimate-guide
1717
- Landing: https://cc.bruniaux.com
18-
- Lines of Documentation: 22,900+
18+
- Lines of Documentation: 23,100+
1919
- Production Templates: 204
2020
- Quiz Questions: 311
2121
- Whitepapers: 9 titles (FR + EN)

llms.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@
66

77
- Title: Claude Code Ultimate Guide
88
- Author: Florian Bruniaux (Founding Engineer @ Méthode Aristote)
9-
- Version: 3.34.4
10-
- Last Updated: March 12, 2026
9+
- Version: 3.35.0
10+
- Last Updated: March 13, 2026
1111
- License: CC BY-SA 4.0 (free, open source)
12-
- Lines of Documentation: 22,900+
12+
- Lines of Documentation: 23,100+
1313
- Production Templates: 204
1414
- Quiz Questions: 311
1515

machine-readable/llms.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@
66

77
- Title: Claude Code Ultimate Guide
88
- Author: Florian Bruniaux (Founding Engineer @ Méthode Aristote)
9-
- Version: 3.34.4
10-
- Last Updated: March 12, 2026
9+
- Version: 3.35.0
10+
- Last Updated: March 13, 2026
1111
- License: CC BY-SA 4.0 (free, open source)
12-
- Lines of Documentation: 22,900+
12+
- Lines of Documentation: 23,100+
1313
- Production Templates: 204
1414
- Quiz Questions: 311
1515

machine-readable/reference.yaml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# Source: guide/ultimate-guide.md
44
# Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
55

6-
version: "3.34.9"
6+
version: "3.35.0"
77
updated: "2026-03-13"
88

99
# ════════════════════════════════════════════════════════════════
@@ -1578,7 +1578,7 @@ ecosystem:
15781578
- "Cross-links modified → Update all 4 repos"
15791579
history:
15801580
- date: "2026-01-20"
1581-
event: "Code Landing sync v3.34.3, 66 templates, cross-links"
1581+
event: "Code Landing sync v3.35.0, 66 templates, cross-links"
15821582
commit: "5b5ce62"
15831583
- date: "2026-01-20"
15841584
event: "Cowork Landing fix (paths, README, UI badges)"
@@ -1590,7 +1590,7 @@ ecosystem:
15901590
onboarding_matrix_meta:
15911591
version: "2.1.0"
15921592
last_updated: "2026-03-09"
1593-
aligned_with_guide: "3.34.4"
1593+
aligned_with_guide: "3.35.0"
15941594
changelog:
15951595
- version: "2.1.0"
15961596
date: "2026-03-09"
@@ -1621,7 +1621,7 @@ onboarding_matrix:
16211621
core: [rules, sandbox_native_guide, commands]
16221622
time_budget: "5 min"
16231623
topics_max: 3
1624-
note: "SECURITY FIRST - sandbox before commands (v3.34.3 critical fix)"
1624+
note: "SECURITY FIRST - sandbox before commands (v3.35.0 critical fix)"
16251625

16261626
beginner_15min:
16271627
core: [rules, sandbox_native_guide, workflow, essential_commands]
@@ -1710,7 +1710,7 @@ onboarding_matrix:
17101710
- default: agent_validation_checklist
17111711
time_budget: "60 min"
17121712
topics_max: 6
1713-
note: "Dual-instance pattern for quality workflows (v3.34.3)"
1713+
note: "Dual-instance pattern for quality workflows (v3.35.0)"
17141714

17151715
learn_security:
17161716
intermediate_30min:
@@ -1721,7 +1721,7 @@ onboarding_matrix:
17211721
- default: permission_modes
17221722
time_budget: "30 min"
17231723
topics_max: 4
1724-
note: "NEW goal (v3.34.3) - Security-focused learning path"
1724+
note: "NEW goal (v3.35.0) - Security-focused learning path"
17251725

17261726
power_60min:
17271727
core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
@@ -1746,7 +1746,7 @@ onboarding_matrix:
17461746
core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
17471747
time_budget: "60 min"
17481748
topics_max: 6
1749-
note: "Security foundation + core workflow (v3.34.3 sandbox added)"
1749+
note: "Security foundation + core workflow (v3.35.0 sandbox added)"
17501750

17511751
intermediate_120min:
17521752
core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]

0 commit comments

Comments
 (0)