Skip to content

Commit 8f1dcec

Browse files
docs: update guide content, examples, tools, and reference files
- guide/ultimate-guide.md — content updates - guide/workflows/README.md, guide/README.md — navigation improvements - guide/diagrams/ — diagram updates (context/sessions, config, MCP ecosystem) - guide/third-party-tools.md — additions - examples/README.md, hooks/README.md, scripts/README.md — examples updates - examples/skills/pr-triage/SKILL.md — expanded skill - machine-readable/reference.yaml — reference sync - tools/audit-prompt.md, tools/onboarding-prompt.md — tooling updates - docs/for-cto.md, docs/for-tech-leads.md, docs/resource-evaluations/README.md — doc updates - .gitignore — gitignore update Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 9c02214 commit 8f1dcec

File tree

19 files changed

+639
-104
lines changed

19 files changed

+639
-104
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ __pycache__/
3232

3333
# Personal notes & temp files
3434
to-ignore/
35+
docs/drafts/
3536
.grepai/
3637
whitepapers/
3738
claudedocs/

docs/for-cto.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Full breakdown: WP06 — Privacy & GDPR Compliance *(whitepaper, coming soon)* (
2929

3030
### Threat landscape
3131

32-
This is the only public resource tracking AI coding tool CVEs: **24 vulnerabilities and 655 malicious skills catalogued**. Key vectors relevant to enterprise:
32+
This is the only public resource tracking AI coding tool vulnerabilities: **15 vulnerabilities and 655 malicious skills catalogued**. Key vectors relevant to enterprise:
3333

3434
- Prompt injection via untrusted file content (e.g. malicious comments in dependencies)
3535
- Supply chain attacks via MCP servers (treat like npm packages)

docs/for-tech-leads.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ See [Guide Ch.7.4 — Security Hooks](../guide/ultimate-guide.md#74-security-hoo
6666

6767
## Security posture overview
6868

69-
This guide maintains the **only public threat database for Claude Code**: 24 CVEs and 655 malicious skills catalogued. Key risks for teams:
69+
This guide maintains the **only public threat database for Claude Code**: 15 vulnerabilities and 655 malicious skills catalogued. Key risks for teams:
7070

7171
- **Prompt injection** via untrusted file content or MCP servers
7272
- **Overly permissive settings**`allowedTools: ["*"]` in production

docs/resource-evaluations/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,4 +77,4 @@ Ressources surveillées mais pas encore intégrées : [watch-list.md](./watch-li
7777

7878
---
7979

80-
**Dernier update**: 2026-02-28 (72 évaluations)
80+
**Dernier update**: 2026-03-09 (115 évaluations)

examples/README.md

Lines changed: 70 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -14,18 +14,21 @@ Annotated templates that teach you **why** patterns work, not just how to config
1414

1515
| Folder | Description | Count |
1616
|--------|-------------|-------|
17-
| [`agents/`](./agents/) | Custom AI personas for specialized tasks | 9 |
18-
| [`commands/`](./commands/) | Slash commands (workflow automation) | 26 |
19-
| [`hooks/`](./hooks/) | Event-driven security & automation scripts | 31 |
20-
| [`skills/`](./skills/) | Reusable knowledge modules — [9 on SkillHub](https://skills.palebluedot.live/owner/FlorianBruniaux) | 15 |
21-
| [`claude-md/`](./claude-md/) | CLAUDE.md configuration profiles | 6 |
22-
| [`config/`](./config/) | Settings, MCP, git templates | 5 |
17+
| [`agents/`](./agents/) | Custom AI personas for specialized tasks | 14 + 2 collections |
18+
| [`commands/`](./commands/) | Slash commands (workflow automation) | 31 |
19+
| [`hooks/`](./hooks/) | Event-driven security & automation scripts | 34 |
20+
| [`skills/`](./skills/) | Reusable knowledge modules — [9 on SkillHub](https://skills.palebluedot.live/owner/FlorianBruniaux) | 17 |
21+
| [`claude-md/`](./claude-md/) | CLAUDE.md configuration profiles | 7 |
22+
| [`config/`](./config/) | Settings, MCP, git templates | 8 |
2323
| [`memory/`](./memory/) | CLAUDE.md memory file templates | 2 |
24-
| [`scripts/`](./scripts/) | Diagnostic & utility scripts | 13 |
24+
| [`rules/`](./rules/) | Behavioral rules for common review patterns | 5 |
25+
| [`scripts/`](./scripts/) | Diagnostic & utility scripts | 16 |
26+
| [`team-config/`](./team-config/) | Team onboarding templates | 3 |
27+
| [`templates/`](./templates/) | Session and workflow templates | 1 |
2528
| [`github-actions/`](./github-actions/) | CI/CD workflows | 4 |
2629
| [`workflows/`](./workflows/) | Advanced development workflows | 3 |
2730
| [`plugins/`](./plugins/) | Community plugins (SE-CoVe, claude-mem) | 2 |
28-
| [`integrations/`](./integrations/) | External tool integrations (Agent Vibes TTS) | 4 |
31+
| [`integrations/`](./integrations/) | External tool integrations (Agent Vibes TTS) | 1 |
2932
| [`mcp-configs/`](./mcp-configs/) | MCP server configurations | 1 |
3033
| [`modes/`](./modes/) | Behavioral modes (SuperClaude) | 1 |
3134
| [`semantic-anchors/`](./semantic-anchors/) | Precise vocabulary for better LLM outputs | 1 |
@@ -53,7 +56,7 @@ Annotated templates that teach you **why** patterns work, not just how to config
5356
5457
## Templates Index
5558

56-
### Agents (9)
59+
### Agents (16)
5760

5861
| File | Purpose | Model |
5962
|------|---------|-------|
@@ -66,8 +69,15 @@ Annotated templates that teach you **why** patterns work, not just how to config
6669
| [planner.md](./agents/planner.md) | Strategic planning — read-only, before implementation | Opus |
6770
| [implementer.md](./agents/implementer.md) | Mechanical execution — bounded scope | Haiku |
6871
| [architecture-reviewer.md](./agents/architecture-reviewer.md) | Architecture & design review — read-only | Opus |
72+
| [adr-writer.md](./agents/adr-writer.md) | Architecture Decision Record generator — read-only | Opus |
73+
| [integration-reviewer.md](./agents/integration-reviewer.md) | Runtime integration validator — read-only | Sonnet |
74+
| [plan-challenger.md](./agents/plan-challenger.md) | Adversarial plan review across 5 dimensions — read-only | Sonnet |
75+
| [planning-coordinator.md](./agents/planning-coordinator.md) | Synthesis agent for dynamic research teams — read-only | Sonnet |
76+
| [security-patcher.md](./agents/security-patcher.md) | Apply security patches from audit findings — proposes for review | Sonnet |
77+
| [analytics-with-eval/](./agents/analytics-with-eval/) | Collection: analytics agent + evaluation hooks ||
78+
| [cyber-defense/](./agents/cyber-defense/) | Collection: anomaly detector, log ingestor, risk classifier, threat reporter ||
6979

70-
### Skills (15) — [9 on SkillHub](https://skills.palebluedot.live/owner/FlorianBruniaux)
80+
### Skills (17) — [9 on SkillHub](https://skills.palebluedot.live/owner/FlorianBruniaux)
7181

7282
| File | Purpose |
7383
|------|---------|
@@ -84,10 +94,12 @@ Annotated templates that teach you **why** patterns work, not just how to config
8494
| [ccboard/](./skills/ccboard/) | Comprehensive TUI/Web dashboard for Claude Code monitoring |
8595
| [guide-recap/](./skills/guide-recap/) | Transform CHANGELOG entries into social content (LinkedIn, Twitter/X, Slack) |
8696
| [release-notes-generator/](./skills/release-notes-generator/) | Generate release notes in 3 formats from git commits |
87-
| [pr-triage/](./skills/pr-triage/) | 3-phase PR backlog management (audit, deep review, validated comments) |
97+
| [pr-triage/](./skills/pr-triage/) | 4-phase PR backlog management (audit, deep review, validated comments, worktree setup) |
8898
| [issue-triage/](./skills/issue-triage/) | 3-phase issue backlog management (audit, deep analysis, validated actions) |
99+
| [cyber-defense-team/](./skills/cyber-defense-team/) | Multi-agent cyber defense team orchestration |
100+
| [talk-pipeline/](./skills/talk-pipeline/) | 6-stage pipeline: raw material to slides via Kimi |
89101

90-
### Commands (26)
102+
### Commands (31)
91103

92104
| File | Trigger | Purpose |
93105
|------|---------|---------|
@@ -117,12 +129,17 @@ Annotated templates that teach you **why** patterns work, not just how to config
117129
| [learn/quiz.md](./commands/learn/quiz.md) | `/learn:quiz` | Self-testing for learning concepts |
118130
| [learn/teach.md](./commands/learn/teach.md) | `/learn:teach` | Step-by-step concept explanations |
119131
| [learn/alternatives.md](./commands/learn/alternatives.md) | `/learn:alternatives` | Compare different approaches |
132+
| [audit-codebase.md](./commands/audit-codebase.md) | `/audit-codebase` | Codebase health audit scoring 7 categories |
133+
| [plan-start.md](./commands/plan-start.md) | `/plan-start` | 5-phase planning: PRD analysis, design review, technical decisions, research team, metrics |
134+
| [plan-execute.md](./commands/plan-execute.md) | `/plan-execute` | Execute validated plan: worktree isolation, TDD scaffolding, parallel agents, PR creation |
135+
| [plan-validate.md](./commands/plan-validate.md) | `/plan-validate` | 2-layer plan validation: structural checks + specialist agents, auto-fix issues |
136+
| [review-plan.md](./commands/review-plan.md) | `/review-plan` | Structured plan review across 4 axes before writing code |
120137

121-
### Hooks (31)
138+
### Hooks (34)
122139

123140
Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 monitoring hooks.
124141

125-
**Security Hooks** (12 bash):
142+
**Security Hooks** (13 bash):
126143

127144
| File | Event | Purpose |
128145
|------|-------|---------|
@@ -138,8 +155,9 @@ Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 m
138155
| [claudemd-scanner.sh](./hooks/bash/claudemd-scanner.sh) | SessionStart | Detect CLAUDE.md injection attacks |
139156
| [output-secrets-scanner.sh](./hooks/bash/output-secrets-scanner.sh) | PostToolUse | Prevent API keys/tokens in Claude responses |
140157
| [pre-commit-secrets.sh](./hooks/bash/pre-commit-secrets.sh) | Git hook | Block secrets from entering commits |
158+
| [security-gate.sh](./hooks/bash/security-gate.sh) | PreToolUse | Detect vulnerable code patterns before writing to source files |
141159

142-
**Productivity Hooks** (8):
160+
**Productivity Hooks** (10):
143161

144162
| File | Event | Purpose |
145163
|------|-------|---------|
@@ -151,8 +169,10 @@ Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 m
151169
| [rtk-baseline.sh](./hooks/bash/rtk-baseline.sh) | SessionStart | Save RTK baseline for session savings tracking |
152170
| [setup-init.sh](./hooks/bash/setup-init.sh) | SessionStart | Initialize session environment |
153171
| [subagent-stop.sh](./hooks/bash/subagent-stop.sh) | Stop | Clean up sub-agent resources |
172+
| [auto-rename-session.sh](./hooks/bash/auto-rename-session.sh) | SessionEnd | AI-powered session title generation (Haiku) |
173+
| [velocity-governor.sh](./hooks/bash/velocity-governor.sh) | PreToolUse | Rate-limit tool calls to avoid API throttling |
154174

155-
**Monitoring Hooks** (5):
175+
**Monitoring Hooks** (6):
156176

157177
| File | Event | Purpose |
158178
|------|-------|---------|
@@ -180,7 +200,7 @@ Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 m
180200

181201
> **See [hooks/README.md](./hooks/README.md) for full documentation, configuration examples, and security hardening patterns**
182202
183-
### Config (5)
203+
### Config (8)
184204

185205
| File | Purpose |
186206
|------|---------|
@@ -189,6 +209,9 @@ Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 m
189209
| [.gitignore-claude](./config/.gitignore-claude) | Git ignore patterns |
190210
| [CONTRIBUTING-ai-disclosure.md](./config/CONTRIBUTING-ai-disclosure.md) | AI disclosure template for CONTRIBUTING.md |
191211
| [PULL_REQUEST_TEMPLATE-ai.md](./config/PULL_REQUEST_TEMPLATE-ai.md) | PR template with AI attribution |
212+
| [sandbox-native.json](./config/sandbox-native.json) | Native Claude Code sandbox configuration |
213+
| [settings-personalization.json](./config/settings-personalization.json) | UI personalization: spinner verbs, custom tips carousel |
214+
| [settings.local.json.example](./config/settings.local.json.example) | Local overrides example (gitignored) |
192215

193216
### Memory (2)
194217

@@ -197,7 +220,7 @@ Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 m
197220
| [CLAUDE.md.project-template](./memory/CLAUDE.md.project-template) | Team project memory |
198221
| [CLAUDE.md.personal-template](./memory/CLAUDE.md.personal-template) | Personal global memory |
199222

200-
### CLAUDE.md Configurations (6)
223+
### CLAUDE.md Configurations (7)
201224

202225
| File | Purpose |
203226
|------|---------|
@@ -207,11 +230,12 @@ Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 m
207230
| [tts-enabled.md](./claude-md/tts-enabled.md) | Text-to-speech enabled configuration |
208231
| [rtk-optimized.md](./claude-md/rtk-optimized.md) | RTK token-optimized configuration |
209232
| [session-naming.md](./claude-md/session-naming.md) | Auto-rename sessions with descriptive titles for parallel work |
233+
| [design-reference-file.md](./claude-md/design-reference-file.md) | Brand-book and UI kit context for consistent UI generation |
210234

211235
> **See [guide/learning-with-ai.md](../guide/learning-with-ai.md) for learning mode documentation**
212236
> **See [guide/devops-sre.md](../guide/devops-sre.md) for DevOps/SRE guide**
213237
214-
### Scripts (13)
238+
### Scripts (16)
215239

216240
| File | Purpose | Output |
217241
|------|---------|--------|
@@ -222,15 +246,42 @@ Security-first: 12 security hooks, 8 productivity hooks, 5 automation hooks, 5 m
222246
| [clean-reinstall-claude.ps1](./scripts/clean-reinstall-claude.ps1) | Clean reinstall procedure (Windows) | Human |
223247
| [session-stats.sh](./scripts/session-stats.sh) | Analyze session logs & costs | JSON / Human |
224248
| [session-search.sh](./scripts/session-search.sh) | Fast session search & resume | Human |
249+
| [cc-sessions.py](./scripts/cc-sessions.py) | Advanced session search with incremental indexing | Human |
225250
| [fresh-context-loop.sh](./scripts/fresh-context-loop.sh) | Auto-restart sessions at context limits | Human |
226251
| [bridge.py](./scripts/bridge.py) | Plan bridging between sessions | JSON |
252+
| [bridge-plan-schema.json](./scripts/bridge-plan-schema.json) | JSON Schema for bridge plan v1 format ||
227253
| [migrate-arguments-syntax.sh](./scripts/migrate-arguments-syntax.sh) | Migrate v1 → v2 argument syntax (bash) | Human |
228254
| [migrate-arguments-syntax.ps1](./scripts/migrate-arguments-syntax.ps1) | Migrate v1 → v2 argument syntax (PowerShell) | Human |
229255
| [rtk-benchmark.sh](./scripts/rtk-benchmark.sh) | Benchmark RTK token savings | Human |
230256
| [sync-claude-config.sh](./scripts/sync-claude-config.sh) | Sync Claude config across machines | Human |
257+
| [sonnetplan.sh](./scripts/sonnetplan.sh) | Alias to run Claude with Sonnet instead of Opus (cost optimization) | Human |
231258

232259
> **See [scripts/README.md](./scripts/README.md) for detailed usage**
233260
261+
### Rules (5)
262+
263+
| File | Purpose |
264+
|------|---------|
265+
| [architecture-review.md](./rules/architecture-review.md) | Rules for architecture review sessions |
266+
| [code-quality-review.md](./rules/code-quality-review.md) | Rules for code quality review sessions |
267+
| [first-principles.md](./rules/first-principles.md) | First-principles reasoning rules |
268+
| [performance-review.md](./rules/performance-review.md) | Rules for performance review sessions |
269+
| [test-review.md](./rules/test-review.md) | Rules for test review sessions |
270+
271+
### Team Config (3)
272+
273+
| File | Purpose |
274+
|------|---------|
275+
| [claude-skeleton.md](./team-config/claude-skeleton.md) | Minimal CLAUDE.md skeleton for new team members |
276+
| [profile-template.yaml](./team-config/profile-template.yaml) | Profile assembly template for multi-tool teams |
277+
| [sync-script.ts](./team-config/sync-script.ts) | Sync Claude config across team machines |
278+
279+
### Templates (1)
280+
281+
| File | Purpose |
282+
|------|---------|
283+
| [session-handoff-lorenz.md](./templates/session-handoff-lorenz.md) | Session handoff template for context continuity |
284+
234285
### GitHub Actions (4)
235286

236287
| File | Trigger | Purpose |

examples/hooks/README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,9 @@ Hooks are scripts that execute automatically on Claude Code events. They enable
4141
| [pre-commit-secrets.sh](./bash/pre-commit-secrets.sh) | Git hook | Block secrets from entering commits | Bash |
4242
| [pre-commit-evaluator.sh](./bash/pre-commit-evaluator.sh) | Git hook | LLM-as-a-Judge pre-commit validation | Bash |
4343
| [notification.sh](./bash/notification.sh) | Notification | Contextual macOS sound alerts | Bash (macOS) |
44+
| [auto-rename-session.sh](./bash/auto-rename-session.sh) | SessionEnd | AI-powered session title generation via Haiku | Bash |
45+
| [security-gate.sh](./bash/security-gate.sh) | PreToolUse | Detect vulnerable code patterns before writing to source files | Bash |
46+
| [velocity-governor.sh](./bash/velocity-governor.sh) | PreToolUse | Rate-limit tool calls to avoid API throttling | Bash |
4447
| [security-check.ps1](./powershell/security-check.ps1) | PreToolUse | Block secrets in commands | PowerShell |
4548
| [auto-format.ps1](./powershell/auto-format.ps1) | PostToolUse | Auto-format after edits | PowerShell |
4649

examples/scripts/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,12 @@ Utility scripts for Claude Code power users.
2020
| `cc-sessions.py` | Advanced session search with incremental indexing (Python) |
2121
| `session-stats.sh` | Statistics about Claude Code sessions |
2222
| `bridge.py` | Bridge: Claude Code → doobidoo → LM Studio |
23+
| `bridge-plan-schema.json` | JSON Schema for bridge plan v1 format |
24+
| `migrate-arguments-syntax.sh` | Migrate v1 → v2 slash command argument syntax (bash) |
25+
| `migrate-arguments-syntax.ps1` | Migrate v1 → v2 slash command argument syntax (PowerShell) |
26+
| `rtk-benchmark.sh` | Benchmark RTK token savings vs raw commands |
27+
| `sync-claude-config.sh` | Sync Claude config files across machines |
28+
| `sonnetplan.sh` | Run Claude with Sonnet replacing Opus (cost optimization alias) |
2329

2430
---
2531

0 commit comments

Comments
 (0)