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

14 commits

Author SHA1 Message Date
Florian BRUNIAUX
4a0a0bf30e docs: complete factual audit pass 2 — 90+ corrections 
Second 10-agent parallel audit covering all remaining sections:
ultimate-guide.md (ch1-ch11), workflows/ (17 files), quiz/ (12 files),
examples/agents+skills+commands. Source of truth: official Anthropic docs.

Key corrections:

Hook system (+8 missing events):
- Complete 17-event list: PermissionRequest, PostToolUseFailure, SubagentStart,
  TeammateIdle, TaskCompleted, WorktreeCreate, WorktreeRemove, SessionEnd
- SessionStart confirmed valid (previous audit wrongly doubted it)
- Hook output format: hookSpecificOutput.permissionDecision (not {"decision":"block"})
- Missing common input fields added: transcript_path, cwd, permission_mode

Agent YAML frontmatter (13 valid fields restored/added):
- Restored: disallowedTools, memory, background, isolation, skills, permissionMode, hooks
- Added new: maxTurns, mcpServers
- Fixed: tools format is comma-separated (not space-separated)

Plan Mode (12 occurrences fixed):
- Ctrl+G = "open plan in text editor" (NOT "enter plan mode")
- Plan Mode = Shift+Tab × 2 (Normal → acceptEdits → plan)

Commands table (10.1) + built-in commands (6.1):
- Added 18+ missing commands: /copy, /doctor, /hooks, /memory, /model,
  /config, /permissions, /remote-control, /rename, /resume, /sandbox, etc.

Workflow files:
- agent-teams.md: removed fake --experimental-agent-teams flag
- hooks.yaml + post_edit event → settings.json + PostToolUse (2 files)
- TodoWrite → TaskCreate/TaskUpdate (3 files)
- task-management.md: removed fake "failed" task status

Quiz / examples:
- 01-010: Esc stops mid-action (not Ctrl+C)
- refactoring-specialist.md: removed MultiEdit (not a valid tool)
- ast-grep-patterns.md: name field (not title)
- validate-changes.md, diagnose.md: field name fixes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-26 18:21:28 +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
6049bd99c2 release: v3.28.0 - Section 2.5 Model Selection & Thinking Guide 
Section canonique consolidée pour le choix de modèle :
- Section 2.5 (decision table, effort levels avec prompts, model-per-agent patterns, thinking guide)
- 3 nouveaux agents : planner (Opus), implementer (Haiku), architecture-reviewer (Opus)
- 7 nouvelles questions quiz (09-037→09-043, intermediate→power)
- 3 tables redondantes remplacées par cross-refs vers Section 2.5

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-21 18:25:50 +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
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
dd833bcc07 docs: reference ai-ecosystem.md everywhere + add quiz questions 
- Add AI Ecosystem to README.md Core Documentation table
- Create quiz/questions/15-ai-ecosystem.yaml (10 questions)
- Update question count: 217 → 227

Topics covered: Perplexity, Gemini, Kimi, NotebookLM, v0.dev,
workflow orchestration, cost optimization

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 13:04:07 +01:00
Florian BRUNIAUX
77d6d8eeb6 docs: update Extended Thinking documentation (v2.0.67+ changes) 
- Thinking mode now ON by default at max budget with Opus 4.5
- Keywords "think", "think hard", "ultrathink" are cosmetic only
- Control via Alt+T (session) or /config (permanent)
- Update Trinity pattern references
- Update quiz questions (09-001, 09-002, 04-014)
- Update cheatsheet thinking section
- Add note about cosmetic flags in modes README

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-18 18:25:20 +01:00
Florian BRUNIAUX
741acd0fa3 feat(quiz): add 58 new questions (159→217) in 4 new categories 
New categories:
- 11-learning-with-ai.yaml (15 questions): UVAL protocol, 70/30 rule, dependency patterns
- 12-architecture.yaml (12 questions): master loop, 8 tools, context budget, sub-agents
- 13-security.yaml (10 questions): MCP Rug Pull, CVEs, defense-in-depth
- 14-privacy-observability.yaml (10 questions): retention tiers, session search

Additions to existing:
- 08-mcp-servers.yaml: +3 Figma MCP questions (token efficiency, tools, setup)
- 09-advanced-patterns.yaml: +5 methodology questions (SDD, BDD, TDD)
- 01-quick-start.yaml: +3 image optimization questions

README updated: 217 questions, 56 templates, 14 categories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-17 22:48:57 +01:00
Florian BRUNIAUX
d7c29f49c9 docs: prioritize grepai over mgrep as recommended semantic search 
- Reorder sections in ultimate-guide.md (grepai first, mgrep second)
- Update cheatsheet.md MCP table (mgrep → grepai)
- Update quiz question 08-013 to reference grepai
- Sync versions to 3.8.2

Rationale: grepai is fully open-source, runs locally (privacy-first),
and offers call graph analysis that mgrep doesn't provide.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-17 15:29:33 +01:00
Florian BRUNIAUX
174192f583 feat(seo): add CITATION.cff and improve AI discoverability 
- Add CITATION.cff for academic citations and GitHub citation button
- Add "For AI Assistants" section in README with llms.txt reference
- Update machine-readable/llms.txt stats (4700+ → 9600+ lines)
- Bump version display to 3.8.0 in README footer

Improves discoverability in GitHub search, Google Scholar, and AI assistants

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-17 11:21:58 +01:00
Florian BRUNIAUX
46c5862c4e fix(docs): critical factual corrections v3.6.1 
Major audit correcting misleading documentation about Claude Code behavior:

### Fixed
- `--add-dir`: permissions (not context loading)
- `excludePatterns` → `permissions.deny` (never existed)
- `.claudeignore` removed (not an official feature)
- "selective loading" myth → lazy loading reality
- Invented CLI flags (`--think`, `--headless`, `--learn`) → prompt keywords
- `@` file reference: "loads automatically" → "reads on-demand"

### Added
- Session Search Tool (`cs`) - zero-dep bash script for finding sessions
- Security section: Known limitations of permissions.deny

15 files modified, 516 insertions, 200 deletions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-15 09:16:53 +01:00
Florian BRUNIAUX
bc07651cdf refactor: restructure repo into thematic directories v3.1.0 
Major repository reorganization for improved navigation:

New directory structure:
- guide/ - Core documentation (ultimate-guide, cheatsheet, adoption)
- tools/ - Interactive utilities (audit, onboarding, mobile-access)
- machine-readable/ - LLM/AI consumption (reference.yaml, llms.txt)
- exports/ - Generated outputs (PDFs)

Changes:
- Move 10 files to thematic directories with cleaner names
- Create README.md index for each new directory
- Update 150+ internal links across all documentation
- Add "Repository Structure" section to main README
- Remove redundant npm install command from README header
- Remove unverified cost estimate from prerequisites
- Fix broken anchor link (#-quick-start-15-minutes)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-13 15:30:02 +01:00
Florian BRUNIAUX
33c37651a6 feat(quiz): add interactive CLI knowledge quiz v3.0.0 
BREAKING: Major version release with new quiz feature

New Features:
- Interactive CLI quiz with 159 curated questions
- 4 user profiles: Junior, Senior, Power User, Product Manager
- 10 topic categories covering all guide sections
- Immediate feedback with explanations and doc references
- Session persistence to ~/.claude-quiz/
- Score tracking with category breakdown
- Optional dynamic question generation via claude -p
- Cross-platform support (Node.js): macOS, Linux, Windows

Quiz highlights:
- Profile-based question filtering and difficulty weighting
- Retry wrong questions only or new quiz options
- Visual progress bar and score visualization
- Direct documentation links for wrong answers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-12 15:49:38 +01:00
Florian BRUNIAUX
5b526f5e53 feat(audit): enhanced stack detection with integrations 
- Detailed stack breakdown: runtime, framework, test, bundler, database
- Generic integration detection (25+ packages: Clerk, Stripe, OpenAI, Sentry...)
- jq fallback: grep-based JSON parsing when jq not installed
- Stack recap at top of human output + full stack object in JSON
- README prompt updated: Stack Recap first, CLAUDE.md template ~100 lines

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-12 14:52:55 +01:00