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

20 commits

Author SHA1 Message Date
Florian BRUNIAUX
8f1dcecfa2 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>
 2026-03-09 15:32:33 +01:00
Florian BRUNIAUX
37d9d70ea2 docs: tech leads section, straude, session-naming, cowork updates 
- guide/learning-with-ai.md: §12 For Tech Leads & Engineering Managers
  (onboarding 4 semaines, métriques croissance réelle, mentoring scalable,
  warning signs équipe, template politique AI)
- guide/third-party-tools.md: fiche straude (dashboard social CC, analyse sécu)
- examples/claude-md/session-naming.md: template auto-rename sessions
- guide/cowork.md: mise à jour contenu et comparaisons
- docs/resource-evaluations/: +2 évaluations (eveillard, straude)
- README.md + examples/README.md: compteurs templates 175→176
- machine-readable/reference.yaml: nouvelles entrées

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-04 17:29:06 +01:00
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
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
d72905e9ba docs: integrate Entire CLI across guide (v3.27.0) 
Major integration of Entire CLI, an agent-native platform launched
Feb 2026 by Thomas Dohmke (ex-GitHub CEO) with $60M funding. Provides
rewindable checkpoints, approval gates, and audit trails for AI sessions.

## Added (7 guide files + 3 meta files)

- **ai-traceability.md**: Replace git-ai 404 with Entire CLI (section 5.1)
- **third-party-tools.md**: Fill "Session replay" gap + add tool section
- **observability.md**: Add session portability alternative
- **ai-ecosystem.md**: Add governance-first orchestration (section 8.1.5)
- **ultimate-guide.md**: Enrich multi-instance section 9.17
- **security-hardening.md**: Add compliance audit trails (section 3.4)
- **cheatsheet.md**: Add Community Tools quick reference
- **README.md**: Update structure tree with third-party-tools mention
- **CHANGELOG.md**: Document v3.27.0 release
- **docs/resource-evaluations/entire-cli.md**: Formal evaluation (5/5)

## Fixed

- git-ai references (404 repo) replaced with working alternative
- "Session replay" Known Gap now marked as ✅ FILLED

## Key Features Documented

- Rewindable checkpoints (prompts + reasoning + tool usage)
- Governance layer (approval gates, permissions, audit trails)
- Multi-agent handoffs (Claude → Gemini with context)
- Compliance-ready (SOC2, HIPAA, FedRAMP)
- Session portability (path-agnostic vs native --resume)

## Positioning

- vs git-ai: Replaces non-existent tool (404)
- vs claude-code-viewer: Active replay vs read-only history
- vs Gas Town: Governance sequential vs parallel coordination

Files modified: 10 (7 content + 3 meta)
Words added: ~2,500
Version: 3.26.0 → 3.27.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-12 23:33:16 +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
12568fbd61 docs: eval resource Rakesh Gohel / Aakash Gupta "Master Claude Code" infographic (score 2/5) 
Evaluation complète de l'infographie LinkedIn "Master Claude Code v1.0" (9 février 2026).
Score 2/5 (Marginal) - Ne pas intégrer.

Justifications:
- Aucune information technique nouvelle vs guide actuel
- Cheatsheet v3.23.4 strictement supérieur
- Erreur notable: recommandation Cursor comme "best experience" (red flag technique)
- Angle PM déjà couvert par Cowork Guide (repo dédié)
- 0/12 aspects apportent valeur nouvelle

Fichiers:
- docs/resource-evaluations/rakesh-gohel-aakash-gupta-master-claude-code.md (nouveau)
- docs/resource-evaluations/README.md (index mis à jour, 56→57 évaluations)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 10:42:11 +01:00
Florian BRUNIAUX
783c43baed docs: add llms.txt conceptual documentation to Section 9.18 
Add comprehensive llms.txt documentation based on Wasp fullstack essentials
resource evaluation (score 3/5). Sourced from llmstxt.org spec, not the
promotional article.

Changes:
- New section 9.18.4: Documentation Formats for Agents (llms.txt)
- Explains llms.txt standard, format, and use cases
- Clarifies complementarity with Context7 MCP (not opposition)
- Provides minimal and advanced examples with line numbers
- Integration patterns with CLAUDE.md
- References this repo's own llms.txt implementation
- Updated section numbering (9.18.4-9.18.11)
- Updated Section 9.18 TL;DR with new principle
- Added reference.yaml entries for llms.txt

Resource evaluation:
- File: docs/resource-evaluations/wasp-fullstack-essentials-eval.md
- Source: Wasp DevRel blog (framework-agnostic insights extracted)
- Score: 3/5 (partial integration, promotional content excluded)
- Gap identified: Embarrassing to have llms.txt file without explaining concept
- Primary source: llmstxt.org specification

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 09:46:50 +01:00
Florian BRUNIAUX
b8eb937642 fix: correct evaluation count in README (25 → 55) 
The previous automatic update showed 25 evaluations instead of 55.
Verified with: find docs/resource-evaluations -type f -name '*.md' ! -name 'README.md' | wc -l

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-07 16:14:37 +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
bd01add3f6 docs: integrate /insights architecture from Zolkos deep dive (4/5) 
1. Resource evaluation (docs/resource-evaluations/zolkos-insights-deep-dive.md):
   - Score: 4/5 (High Value) - comprehensive technical architecture
   - Content: 7-stage pipeline, facets classification (6 dimensions), technical specs
   - Decision: Integrate architecture + facets (complementary with usage doc)
   - Comparison: Zolkos (architecture interne) vs Guide (usage externe) = complet
   - Why not 5/5: Missing user guidance, screenshots, prompt examples
   - Updated index: 23 evaluations total

2. Architecture Overview added to guide (ultimate-guide.md L6460+):
   - 7-stage pipeline: filtering, summarization, facet extraction, aggregation,
     executive summary, report generation, facet caching
   - Facets Classification System (6 dimensions):
     * Goals (13 types): Debug, Implement, Fix Bug, Write Script, Refactor, etc.
     * Friction (12): Misunderstood, wrong approach, buggy code, user rejection, etc.
     * Satisfaction (6): Frustrated → Dissatisfied → Likely → Satisfied → Happy
     * Outcomes (4): Not → Partially → Mostly → Fully Achieved
     * Success (7): Fast search, correct edits, explanations, proactive, multi-file, etc.
     * Session Types (5): Single, multi, iterative, exploration, quick question
   - Performance: Caching system (facets/<session-id>.json) for incremental analysis
   - Interpretation guidance: How facets help understand report recommendations
   - Source attribution: Zolkos Technical Deep Dive (2026-02-04)

3. CHANGELOG [Unreleased]:
   - Comprehensive /insights documentation with architecture deep dive
   - Facets classification system (6 dimensions documented)
   - Performance optimization explanation (caching)
   - Resource evaluation: Zolkos deep dive (4/5, integrated)

Impact: Power users can now understand WHY /insights generates specific suggestions
(based on facets classification), optimize workflows for better analysis (avoid <2 msg
sessions), and interpret friction categories with context (12 types documented).

Complementarity proven: Usage documentation (existing) + Architecture (Zolkos) = complete.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-06 15:38:45 +01:00
Florian BRUNIAUX
669199e215 docs: add comprehensive /insights documentation + eval Kajan Siva post 
1. Slash Commands documentation (ultimate-guide.md L6339+):
   - What /insights analyzes: Project areas, interaction style, success/friction patterns
   - Report structure: 8 sections (At a Glance, Work Areas, Usage Style, Wins, Friction, Features, Patterns, Horizon)
   - Interactive elements: Copy buttons, checkboxes, charts, navigation TOC
   - Technical details: Haiku, 50 sessions max, 8192 tokens, ~/.claude/usage-data/
   - Typical insights: CLAUDE.md suggestions, feature recommendations, horizon workflows
   - Integration examples: Monthly optimization, git cross-reference, ccboard combo
   - Comparison table: /insights vs /status vs ccboard vs git history

2. Cheatsheet (cheatsheet.md L25):
   - Added /insights to command table: "Usage analytics + optimization report"

3. Resource evaluation (docs/resource-evaluations/kajan-siva-insights-command.md):
   - Score: 2/5 (Marginal) - no technical content, just surface mention
   - Post confirms /insights exists + provides suggestions, but zero details
   - Real value: HTML report with 18+ actionable suggestions (not documented in post)
   - Recommendation: Do NOT integrate post, document command from actual usage
   - Next: Evaluate Zolkos deep dive for technical architecture specs

4. CHANGELOG [Unreleased]:
   - Comprehensive /insights documentation added to Section 6.1
   - Interactive HTML report details, typical insights, integration examples

Impact: Users can now understand /insights output structure, actionable sections,
and integration workflows. Command properly documented with generic examples.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-06 15:21:19 +01:00
Florian BRUNIAUX
0a2e05f290 fix(keybindings): correct Ctrl+R from "Retry" to "Search history" 
- Updated 5 locations in guide (cheatsheet + ultimate-guide)
- Verified against official keybindings: history:search action
- Added resource evaluation: Sankalp's Claude Code experience (2/5)
- Blog correctly identified guide error

Closes evaluation workflow for sankalp-claude-code-experience

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-03 17:27:54 +01:00
Florian BRUNIAUX
bc86c8ed7f release: v3.20.6 - agentskills.io integration + 4 resource evaluations 
- agentskills.io open standard: frontmatter table, skills-ref CLI, portability section
- Agent Skills supply chain risks (security-hardening.md §1.2)
- anthropics/skills (60K+★) added to complementary resources
- 16 new reference.yaml entries
- Resource evaluations: agentskills.io (4/5), Skill Doctor (2/5), dclaude (new), paddo (new)
- Sandbox isolation + README updates

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-01 16:49:33 +01:00
Florian BRUNIAUX
950370e81b release: v3.20.2 - Sandbox Isolation for Coding Agents 
New guide file covering Docker Sandboxes (microVM isolation),
cloud alternatives (Fly.io Sprites, E2B, Vercel, Cloudflare),
safe autonomy workflows, and comparison matrix.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 19:08:25 +01:00
Florian BRUNIAUX
fd4550cbd3 release: v3.20.0 - Multi-Agent Code Review Automation 
Integration of production-grade PR review patterns from Pat Cullen + Méthode Aristote.

New Features:
- Resource evaluation: Pat Cullen Final Review (5/5 - Critical)
- Enhanced /review-pr: +150 lines with Advanced Multi-Agent Review section
- Enhanced code-reviewer agent: +219 lines with anti-hallucination rules
- New workflow: Review Auto-Correction Loop in iterative-refinement.md
- Production example: Multi-Agent Code Review in ultimate-guide.md
- Reference updates: +3 entries (review_pr_advanced, review_anti_hallucination, review_auto_fix_loop)

Key Patterns:
- 3 specialized agents: Consistency, SOLID, Defensive Code Auditor
- Pre-flight check: git log Co-Authored-By detection
- Anti-hallucination: Grep/Glob verification before suggestions
- Severity classification: 🔴 Must Fix / 🟡 Should Fix / 🟢 Can Skip
- Convergence loop: review → fix → re-review (max 3 iterations)
- Conditional context loading: stack-agnostic decision table

Design Principles:
- Enrich existing files (no fragmentation)
- No breaking changes (review-pr.md template simple preserved)
- Complete attribution (Pat Cullen + Méthode Aristote with links)
- Audience-aware (beginner → advanced progression)

Files Modified:
- CHANGELOG.md, VERSION: bumped to 3.20.0
- docs/resource-evaluations/017-pat-cullen-final-review.md: NEW (120 lines)
- examples/commands/review-pr.md: 80 → 230 lines (+150)
- examples/agents/code-reviewer.md: 72 → 291 lines (+219)
- guide/workflows/iterative-refinement.md: 389 → 522 lines (+133)
- guide/ultimate-guide.md: +28 lines (Production Example section)
- machine-readable/reference.yaml: +3 entries
- README.md, guide/cheatsheet.md: version sync

Total: +537 insertions, 0 deletions (no breaking changes)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-30 16:07:09 +01:00
Florian BRUNIAUX
7df11b224f release: v3.18.2 - Steinberger Practitioner Insight 
Add Peter Steinberger (PSPDFKit Founder, Moltbot Creator) to Practitioner
Insights with model-agnostic workflow patterns.

Changes:
- Add Steinberger entry in guide/ai-ecosystem.md (stream monitoring,
  multi-project juggling, fresh context validation, iterative exploration)
- Complete evaluation in docs/resource-evaluations/steinberger-inference-speed.md
  (score 3/5, fact-checked GPT-5.2, validated credentials)
- Update docs/resource-evaluations/README.md (15→16 evaluations)
- Add practitioner_steinberger references in machine-readable/reference.yaml
- Version bump 3.18.1 → 3.18.2 (VERSION + sync all docs)
- Update CHANGELOG.md with detailed v3.18.2 entry
- Update README.md evaluations count (22→25)

Scope: Model-agnostic patterns only, zero model comparisons.
Source: https://steipete.me/posts/2025/shipping-at-inference-speed

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-30 09:49:55 +01:00
Florian BRUNIAUX
a8d0f0273d release: version 3.15.0 - MCP Apps integration 
Bump version to 3.15.0 with comprehensive MCP Apps documentation.

Version updates:
- VERSION: 3.14.0 → 3.15.0
- Synced across: README.md, cheatsheet.md, ultimate-guide.md, reference.yaml
- Updated date: reference.yaml (2026-01-27)

CHANGELOG.md:
- Added MCP Apps (SEP-1865) documentation entry in [Unreleased]
- ~50 lines detailing all changes:
  - architecture.md section (~150 lines)
  - ultimate-guide.md section (~90 lines)
  - Table update (Plugin vs MCP vs MCP Apps)
  - machine-readable/reference.yaml (8 entries)
  - Resource evaluation (159 lines, score 4/5)
- Key facts: First official MCP extension, co-authored OpenAI+Anthropic
- 9 interactive tools at launch (Asana, Slack, Figma, etc.)
- Platform support: Claude Desktop, VS Code, ChatGPT, Goose
- CLI relevance: Indirect (ecosystem, dev, hybrid workflows)

README.md:
- Resource Evaluations: 14 → 15 assessments

docs/resource-evaluations/README.md:
- Added MCP Apps entry in index table
- Score: 3/5 → 4/5 (High Value)
- Updated date: 2026-01-27
- Confirmed count: 15 evaluations

Total changes:
- 2 commits (MCP Apps docs + version bump)
- ~240 lines documentation (architecture + guide)
- 15 resource evaluations tracked
- 4/5 integration score (ecosystem impact)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 08:24:25 +01:00
Florian BRUNIAUX
08a2a4261f docs: add system prompts official sources (Anthropic + community analyses) 
- Add System Prompt Contents section in architecture.md (line 300-326)
  - Official Anthropic sources (Tier 1, 100% confidence)
  - Community analyses (Simon Willison, PromptHub)
  - Claude.ai vs API vs Code CLI distinctions

- Update reference.yaml with 4 new system prompts entries
  - system_prompts_official, willison_analysis, prompthub, architecture

- Create resource evaluation: system-prompts-official-vs-community.md
  - Score evolution: 4/5 → 3/5 → 2/5 (after Perplexity fact-check)
  - Decision: Do not integrate x1xhlol repository (redundant)
  - Use official Anthropic sources instead

- Create watchlist for non-integrated resources
  - claudedocs/resource-evaluations/watch-list.md (gitignored)
  - Re-evaluation triggers: Q2 2026 or if 10+ user requests

Related evaluation: docs/resource-evaluations/system-prompts-official-vs-community.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 17:03:42 +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