marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
423 commits 1 branch 0 tags 20 MiB
Commit graph

31 commits

Author SHA1 Message Date
Florian BRUNIAUX
8dd202ed1c release: v3.34.1 - dynamic OG image generation workflow 
Add og-image-generation.md workflow guide and production-ready og-image-astro.ts
template. Update stats: 218 templates, 22,800+ guide lines. Bump VERSION to 3.34.1.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-11 12:09:50 +01:00
Florian BRUNIAUX
b65630641b refactor(guide): restructure guide/ into thematic subdirectories 
Reorganize 22 guide files from a flat directory into 5 thematic subdirs:
- core/ (architecture, methodologies, known-issues, claude-code-releases, visual-reference)
- security/ (security-hardening, sandbox-isolation, sandbox-native, production-safety, data-privacy)
- ecosystem/ (ai-ecosystem, mcp-servers-ecosystem, third-party-tools, remarkable-ai)
- roles/ (ai-roles, adoption-approaches, learning-with-ai, agent-evaluation)
- ops/ (devops-sre, observability, ai-traceability)

All internal links updated across ~50 files (ultimate-guide.md, workflows/,
diagrams/, README.md, docs/, tools/, examples/, machine-readable/).

Also: merge search-tools-cheatsheet.md into cheatsheet.md, rewrite guide/README.md
with H2 grouped sections, update CLAUDE.md repository structure.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-10 08:35:13 +01:00
Florian BRUNIAUX
2262d9e1f6 docs(cheatsheet): add /loop, /stats, /rename, /copy + Ctrl+F (v3.32.2) 
Cheatsheet updated with commands from Claude Code v2.1.59–v2.1.71:
- /loop [interval] [prompt] — recurring scheduler (bg polling while you work)
- /stats — usage graph, favorite model, streak
- /rename [name] — name/rename current session
- /copy — interactive picker for code blocks
- Ctrl+F — kill all background agents (double press)
- /loop added to "Features méconnues" section (v2.1.71)

Applied to both guide/cheatsheet.md and landing cheatsheet/index.astro.
Landing version synced: 3.29.2 → 3.32.2.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-09 10:44:06 +01:00
Florian BRUNIAUX
3788369839 docs: add Compound Engineering patterns + guide-reviewer agent 
4 patterns issus du plugin compound-engineering d'Every.to intégrés
dans le guide (Named Perspective Agents, Swarm vs Sequential, Skill
Quality Gates, Brainstorm-before-planning). Évaluation formelle 4/5.

- guide/ultimate-guide.md: +~90 lignes (4 insertions)
- docs/resource-evaluations/2026-03-04-compound-engineering-every-to.md
- .claude/agents/guide-reviewer.md: audit accuracy/style guide content
- CLAUDE.md: command naming conventions section
- CHANGELOG.md: entrée [Unreleased] documentant les changements

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-04 17:25:02 +01:00
Florian BRUNIAUX
8e63d84b47 docs: factual audit + reference sync — 260 findings corrected 
Parallel 6-agent audit against official Anthropic docs (llms-full.txt).
Key corrections applied across permissions, hooks, MCP, security, privacy, reference.yaml.

Highlights:
- Fix MCP config path (~/.claude.json), mcpServers key, variable substitution syntax
- Fix permission modes (5 not 3), :* syntax (×6), Stop event description
- Fix hook JSON field names (hook_event_name, tool_name, tool_input, session_id)
- Fix filesystem restriction docs (permission rules, not settings.json keys)
- Fix data-privacy: 4-tier retention, /bug 5yr warning, ZDR conditions, 5 telemetry opt-out vars
- Add official llms.txt/llms-full.txt references to CLAUDE.md + machine-readable/llms.txt
- Reference.yaml: 375 entries re-synced (92% had wrong line numbers — guide grew 15K→21K lines)
- New script: scripts/resync-reference-yaml.py for automated line number sync
- Quiz: corrected answers for hooks (07), memory settings (03), MCP servers (08)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-26 12:10:14 +01:00
Florian BRUNIAUX
6117145837 docs: integrate veille hebdo Anthropic 17-23 fev 2026 (+177 lignes guide) 
P1 - Prompt caching + env vars:
- Strategy 6 cost optimization: cache_control API, pricing (write 1.25x, read 0.1x), break-even 2 hits
- CLAUDE_CODE_DISABLE_1M_CONTEXT + CLAUDE_CODE_SIMPLE ajoutés à la table env vars principale

P2 - Model deprecations + agents:
- Warning claude-3-haiku-20240307 deprecated 19 fev / retirement 20 avril 2026
- Frontmatter fields: background: true (v2.1.49+) + isolation: worktree (v2.1.50+)
- Section Background Agents: comportement non-blocking, gestion (ctrl+f, double ESC)
- Section claude agents CLI: commande + output annoté

P3 - Worktree isolation native + security cross-ref:
- Native worktree features: --worktree flag, isolation declaratif, WorktreeCreate/WorktreeRemove hooks
- §7.4 Security Hooks: cross-ref Claude Code Security scanner (research preview)

Eval: docs/resource-evaluations/2026-02-22-veille-hebdo-anthropic-17-23-fev.md (score 3/5)
Stats: 19K → 20K lignes (20 440 total)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-23 12:59:28 +01:00
Florian BRUNIAUX
146d15e958 docs: add guide reader rebuild instructions to CLAUDE.md 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-19 15:48:08 +01:00
Florian BRUNIAUX
373b50cf77 docs: add 4 resource evaluations + tasks/lessons.md pattern (v3.27.7+) 
- Add tasks/lessons.md variant to Fresh Context Pattern section — lightweight
  self-improvement loop where Claude captures behavioral rules after corrections
- Resource evaluations (4 new, 67 → 78 total):
  - SKILLMIND/Boris Cherny workflow (2/5): self-improvement loop concept
  - Augment Context Engine MCP (3/5): cloud alternative to grepai
  - LinkedIn context engineering post (2/5): marginal relevance
  - LinkedIn activity-7428930570451083264 (inaccessible)
- README: update evaluations count 67 → 78, threat DB badge 18/341 → 19/655
- CLAUDE.md: add Whitepaper Generation section (PDF + EPUB commands)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-19 13:47:38 +01:00
Florian BRUNIAUX
267ce0ba86 chore: update guide content and add new examples 
- Update ultimate guide and cheatsheet
- Update llms.txt and reference YAML
- Add velocity-governor hook and cc-sessions script

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-18 18:48:19 +01:00
Florian BRUNIAUX
1f720f7d74 release: v3.27.4 - template count update + worktree docs 
- Templates 113 → 116 (review-plan, git-worktree-status/remove/clean, rules)
- Commands 23 → 26 (worktree lifecycle suite)
- Git worktree section expanded with lifecycle commands table
- Version sync across all docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-17 11:15:32 +01:00
Florian BRUNIAUX
70c6c34658 docs: update template count 108 → 113 (new rules + review-plan) 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 20:49:05 +01:00
Florian BRUNIAUX
d1182af4cf docs: v3.27.1 — fact-check corrections, grepai docs, RTK overhaul 
Fact-check (README positioning):
- Template count: 120/123 → 108 (ground truth recount)
- Ratio: 14× → 24× (19,000 ÷ 784 = 24.2×)
- everything-cc stars: 31.9k → 45k+ (verified Feb 15)
- Commands count: 20 → 23, hooks: 30 → 31

Added:
- Grepai MCP documentation (semantic search, call graphs)
- 3 hook templates (rtk-baseline, session-summary, session-summary-config)
- 2 resource evaluations (system-prompts update, qmd token savings)

Changed:
- RTK documentation overhaul (v0.7.0 → v0.16.0, rtk-ai org)
- Exports deprecated (kimi.pdf, notebooklm.pdf → deprecated/)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 18:41:45 +01:00
Florian BRUNIAUX
971a297db3 feat(security): add threat intelligence DB, security commands, and cheatsheet audit fixes (v3.26.0) 
- Add threat-db.yaml v2.0.0 with 63 malicious skills, 22 CVEs, 4 campaigns
- Add /security-check, /security-audit, /update-threat-db slash commands
- Add Snyk ToxicSkills evaluation (58th resource evaluation)
- Fix cheatsheet: add Alt+T to keyboard shortcuts table, add /fast and /debug commands
- Update Features Meconnues table with Agent Teams and Auto-Memories
- Clean up cheatsheet.md.bak
- Bump version to 3.26.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-11 16:12:36 +01:00
Florian BRUNIAUX
b48d95c024 feat: add agent/skill quality audit tooling + Grenier evaluation 
AUDIT TOOLING (3 templates):
- Command: /audit-agents-skills (quick project audits)
  - 16-criteria framework (Identity 3x, Prompt 2x, Validation 1x, Design 2x)
  - Weighted scoring: 32 pts (agents/skills), 20 pts (commands)
  - Production grading (A-F, 80% threshold)
  - Fix mode with actionable suggestions
- Skill: audit-agents-skills (advanced audits)
  - 3 modes: Quick (top-5), Full (all 16), Comparative (vs templates)
  - JSON + Markdown output for CI/CD
- Scoring grids: criteria.yaml (externalized for reuse)

EVALUATION:
- Grenier agent/skill quality (3/5 - Moderate Value)
  - Gap: 29.5% deploy without evaluation (LangChang 2026)
  - Integration: Created audit command + skill + criteria
  - Industry context: 18% cite agent bugs as top challenge

DOCUMENTATION:
- Guide refs: 2 strategic call-outs (after Agent/Skill validation)
- CHANGELOG: New "Added" section + evaluation details
- README: Templates 106→107, Evaluations 49→24 (count corrections)
- reference.yaml: 10 new audit entries + updated counts

SYNC:
- Landing index.html: Templates 107, Evals 24, Quiz 257
- Landing examples/index.html: Templates 107

FILES: 14 changed, 4148 insertions (+1250 lines new audit content)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-07 15:40:18 +01:00
Florian BRUNIAUX
23e0ac476d docs: add /release command docs + visual-reference to guide index 
- CLAUDE.md: document /release slash command with examples
- guide/README.md: add visual-reference.md to contents table
- scripts/compile-questions.sh: quiz compilation utility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 23:20:01 +01:00
Florian BRUNIAUX
a7962d5560 release: v3.20.4 - 30 new quiz questions (227 → 257) 
Add 30 questions across 11 categories covering recent guide content:
Advanced Patterns (+8), MCP Servers (+3), Architecture (+3),
Reference (+3), Hooks (+2), Learning (+2), Security (+2),
AI Ecosystem (+3), Memory (+2), Agents (+1), Privacy (+1).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 22:17:32 +01:00
Florian BRUNIAUX
1136dc683f docs: add resource-evaluations to tracked docs 
- Create docs/resource-evaluations/ with 15 evaluation files
- Standardize filenames (remove date prefixes)
- Keep working docs and private audits in claudedocs/ (gitignored)
- Add resource evaluation workflow to CLAUDE.md

Files migrated:
- gsd, worktrunk, boris-cowork-video, wooldridge-productivity-stack
- remotion, nick-jensen, se-cove, self-improve-skill
- astgrep, clawdbot, prompt-repetition, uml-diagrams
- vibe-coding-rusitschka, anthropic-releases

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:02:05 +01:00
Florian BRUNIAUX
61eec21b80 docs: add resource evaluation system documentation 
- Document claudedocs/resource-evaluations/ structure in CLAUDE.md
- Establish scoring methodology (1-5 scale) for external resources
- Create process: analysis → scoring → challenge → decision
- First evaluation: Remotion + Claude Code (2/5, rejected)

Rationale: Systematic tracking of evaluated resources prevents
duplicate analysis and provides audit trail for integration decisions.

Files remain local (claudedocs/ is gitignored).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-23 18:30:39 +01:00
Florian BRUNIAUX
16d484a50f feat: add maintenance slash commands for release management 
Commands added:
- /update-infos-release [bump-type]: Automate CC releases tracking + version bump
- /version: Display guide & CC versions with content stats
- /changelog [count]: View recent CHANGELOG entries
- /sync: Check guide/landing synchronization status

Workflow automation:
- Claude Code releases tracking (YAML + MD + Landing badge)
- Guide version management (VERSION + sync all docs)
- CHANGELOG updates
- Landing site sync verification
- Git commit/push to both repositories

Files:
- .claude/commands/update-infos-release.md: Full release workflow
- .claude/commands/version.md: Version info display
- .claude/commands/changelog.md: CHANGELOG viewer
- .claude/commands/sync.md: Sync check with actionable fixes
- .gitignore: Allow .claude/commands/ while ignoring other .claude/ config
- CLAUDE.md: Document new maintenance commands

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:41:24 +01:00
Florian BRUNIAUX
6703e4b6a4 docs: update CHANGELOG and fix template count (69→65) 
Changes:
- CHANGELOG.md: Document cross-reference addition and template count fix
- README.md: Correct template count from 69 to 65 (badge, summary, table)
- CLAUDE.md: Update version reference (3.9.7 → 3.9.9)

Template count verification:
- Actual count: 65 templates in examples/ (excluding README.md files)
- Previous count of 69 was overcounted by 4 templates since v3.9.9

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 10:02:38 +01:00
Florian BRUNIAUX
ffe8d782fd fix: sync CLAUDE.md version reference with VERSION file 
- Update version reference from 3.8.2 to 3.9.7 in CLAUDE.md
- Aligns with VERSION file which was already at 3.9.7
- Removes accidental marketing document from version control

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 14:01:53 +01:00
Florian BRUNIAUX
af6f56d618 docs: document complete 4-repo ecosystem architecture 
- Add ecosystem section to CLAUDE.md with architecture diagram
- Add landing sites table to README.md ecosystem section
- Add landing_sites section to reference.yaml with sync history
- Document bidirectional cross-links and sync triggers
- Include migration history and commit references

Ecosystem:
- Claude Code Guide (this repo) → devs
- Claude Cowork Guide (dedicated) → knowledge workers
- Code Landing (vitrine) → discovery
- Cowork Landing (vitrine) → discovery

Architecture: 2 source repos + 2 landing sites, synchronized

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 12:57:48 +01:00
Florian BRUNIAUX
84112237e8 docs(claude): add model configuration recommendations 
- Add recommended /model opusplan configuration
- Document hybrid planning workflow (Opus plan + Sonnet execute)
- Include task breakdown table with model justifications
- Add cost optimization rationale

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:52:21 +01:00
Florian BRUNIAUX
0348f08288 feat: add Claude Code releases tracking 
Add condensed release history for Claude Code product (v2.0.24 → v2.1.12)

New files:
- machine-readable/claude-code-releases.yaml: Source of truth (YAML)
- guide/claude-code-releases.md: Human-readable changelog
- scripts/update-cc-releases.sh: Check for new releases from GitHub

Modified:
- reference.yaml: Add deep_dive entries for releases
- check-landing-sync.sh: Add CC version check (#5)
- README.md, guide/README.md: Add navigation links
- CLAUDE.md: Document update workflow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-18 11:33:21 +01:00
Florian BRUNIAUX
b814c568d1 fix: correct template count to 53 (validated by sync script) 
- Update sync script to include .json files in count
- Fix README.md and CLAUDE.md with accurate count

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-17 15:56:24 +01:00
Florian BRUNIAUX
fb9689fed3 docs: sync stats (57 templates, 9800+ lines) 
- Update CLAUDE.md with current values
- Update README.md badges and line counts
- Add Fresh Context Pattern reference in methodologies.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-17 15:50:22 +01:00
Florian BRUNIAUX
15475197ab feat(sync): add landing site synchronization system 
- Add scripts/check-landing-sync.sh verifying 4 metrics:
  - Version (VERSION vs landing index.html)
  - Templates count (find examples/ vs landing badges)
  - Quiz questions (questions.json vs index.html + quiz.html)
  - Guide lines (with ±500 tolerance)
- Update CLAUDE.md with sync documentation and expected output
- Fix templates count: 87 → 49 in README.md badges and text

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-17 12:21:09 +01:00
Florian BRUNIAUX
373b0c7ed1 docs(claude): sync version reference to 3.8.1 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-17 11:46:19 +01:00
Florian BRUNIAUX
30cbe57d1e docs(readme): add onboarding screenshots preview 
- Add 4 screenshots showing interactive onboarding flow
- Collapsible gallery (2x2 grid) under one-liner command
- Images in assets/screenshots/ with descriptive names

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-15 09:34:31 +01:00
Florian BRUNIAUX
0552522030 docs(claude): add Perplexity Pro research resource 
User has Perplexity Pro license - Claude can request advanced
searches for reliable sources on Claude Code, Anthropic updates,
and AI-assisted development best practices.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-15 08:49:27 +01:00
Florian BRUNIAUX
8da84104c6 feat: add CLAUDE.md project context 
- Repository purpose and structure
- Key files reference
- Version management commands
- Documentation conventions
- Quick lookup workflow for answering questions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-15 08:24:32 +01:00