155b07a589
## 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>
105 lines
No EOL
5 KiB
Markdown
105 lines
No EOL
5 KiB
Markdown
# 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 |