claude-code-ultimate-guide/docs/resource-evaluations/070-claude-code-best-practice-dot-claude-eval.md
Florian BRUNIAUX 155b07a589 feat: threat-db v2.4.0 + MCP guide section + resource evals + ci
## threat-db v2.4.0
- CVE-2026-27735: path traversal in mcp-server-git git_add (CVSS 6.4)
- Campaign: Clinejection (Cline CLI 2.3.0 supply chain, 4000 downloads)
- T012: AI Recommendation Poisoning (Microsoft research, 50+ prompts)
- 3 new sources (NVD, Snyk, Microsoft Security Blog, Hacker News)

## guide/ultimate-guide.md
- New section "This Guide as an MCP Server" (§10) — installation,
  tools list, dev mode, usage examples, slash commands

## docs/resource-evaluations
- eval #070: claude-code-best-practice .claude/ config (score 4/5)
- eval #071: Steven Ge technical writing workflow (score TBD)
- eval #072: Rippletide AI reliability platform (score 2/5, watch only)
- 2026-02-26: boristane SDLC dead post evaluation
- README: count 60→72 evals, add #072 entry

## ci + config
- .github/workflows/trigger-landing-deploy.yml — auto-trigger landing
  rebuild on push to main (guide content changes)
- .gitignore: add .claude/agents/ exception + mcp-server/dist/ ignore

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-28 21:35:03 +01:00

5 KiB

Resource Evaluation: .claude/ Config — shanraisshan/claude-code-best-practice

Date: 2026-02-26 Evaluator: Claude (Sonnet 4.6) Source: Repo cloné localement (analyse directe) Path: /Users/florianbruniaux/Sites/perso/claude-code-best-practice/.claude/ Type: Configuration de référence (agents, skills, commands, hooks, settings)


Summary

Configuration .claude/ exemplaire d'un repo de best practices Claude Code. 2 agents, 6 skills (dont 3 "presentation" auto-évolutives), 1 command, 1 système de hooks Python centralisé couvrant 16 événements, et un settings.json avec personnalisations avancées.

Points clés:

  • Pattern "self-evolving agent": presentation-curator met à jour ses propres skills après chaque exécution (Step 5 dans le prompt)
  • Architecture Command → Agent → Skills: /weather-orchestrator → agent weather → skills préchargées, pattern nommé et complet
  • Hook architecture centralisée: 1 script Python pour 16 événements + config layering shared/local JSON
  • allowed-tools: Bash(agent-browser:*): wildcard scoping d'outil pour skill — pattern plus avancé que le format space-delimited documenté
  • Settings avancés: spinnerVerbs (mode replace), spinnerTipsOverride (excludeDefault:true), plansDirectory, enableAllProjectMcpServers

Evaluation Scoring

Criterion Score Notes
Relevance 5/5 Configuration Claude Code réelle, patterns avancés non documentés
Originality 5/5 Self-evolving agent = pattern inédit dans notre guide
Authority 3/5 Repo communautaire (non Anthropic), mais patterns vérifiables
Accuracy 4/5 Patterns fonctionnels (vérifiables), settings vérifiés contre releases.md
Actionability 5/5 Code directement intégrable comme exemples dans le guide

Overall Score: 4/5 (High Value)


Gap Analysis

Absents du guide (ultimate-guide.md)

Pattern Gap Level Localisation actuelle
Self-evolving agent (agent met à jour ses skills) HIGH — pattern inédit Absent
Command → Agent → Skills (nommé + exemplifié) MEDIUM — pattern implicite seulement Absent comme pattern nommé
allowed-tools: Bash(tool:*) wildcard dans skills HIGH — seul format space-delimited documenté guide/ultimate-guide.md:6343
spinnerVerbs + spinnerTipsOverride + excludeDefault MEDIUM — dans releases.md seulement guide/claude-code-releases.md:323
Hooks: 1 script Python central + config layering MEDIUM — hooks de base couverts, pas ce pattern Absent
plansDirectory LOW — dans releases.md seulement guide/claude-code-releases.md:110
enableAllProjectMcpServers LOW Absent

Déjà couverts dans le guide

Pattern Localisation
memory: project/user/local ultimate-guide.md:5646 (corrigé dans eval 069)
isolation: worktree ultimate-guide.md:14277
background: true ultimate-guide.md:5798
Skills context: fork Sections agents/skills
Hooks basiques (PreToolUse, PostToolUse) Section hooks

Recommendations

Priorité 1 — High: Documenter le pattern "Self-Evolving Agent"

  • Où: guide/ultimate-guide.md section agents (~ligne 5800)
  • Comment: Nouveau sous-pattern avec exemple presentation-curator (Step 5 du prompt)
  • Valeur: Pattern inédit qui différencie notre guide

Priorité 2 — High: Documenter allowed-tools: Bash(tool:*) wildcard pour skills

  • Où: guide/ultimate-guide.md:6343 (section allowed-tools skills)
  • Comment: Ajouter syntaxe wildcard + exemple agent-browser
  • Note: Plus puissant que space-delimited, permet scoping granulaire

Priorité 3 — Medium: Nommer et documenter "Command → Agent → Skills"

  • Où: Section architecture / workflows agents
  • Comment: Ajouter le pattern comme archetype nommé avec diagramme

Priorité 4 — Low: Compléter settings dans ultimate-guide

  • spinnerVerbs avec mode replace/add + excludeDefault
  • plansDirectory avec exemple
  • enableAllProjectMcpServers

Fact-Check

Affirmation Vérifiée Source
spinnerVerbs avec mode: replace est un setting officiel guide/claude-code-releases.md:323
plansDirectory est un setting officiel guide/claude-code-releases.md:110
16 hook events officiels examples/hooks/README.md, HOOKS-README
allowed-tools supporte la syntaxe wildcard Bash(tool:*) code.claude.com/docs/en/skills (official)
Self-evolving agent pattern (agent met à jour ses skills) Code présent dans presentation-curator.md Step 5

Corrections: Aucune — tous les patterns sont vérifiables directement dans les fichiers.


Decision

  • Score final: 4/5 (High Value)
  • Action: Intégrer — 2 patterns à haute valeur ajoutée (self-evolving agent + allowed-tools wildcard)
  • Confiance: Haute