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

15 commits

Author SHA1 Message Date
Florian BRUNIAUX
08facfdbdc feat(llm-ref): add machine-optimized YAML index for Claude Code 
- Create claude-code-reference.yaml (~2K tokens vs 70K full guide)
- Add deep_dive section with 38 line references to main guide
- Structure: decision tree first, then prompting formula, commands, etc.
- Update README.md with LLM Reference in Core Documentation
- Update llms.txt with Machine-Optimized Reference section
- Bump version to 2.9.2

Use case: Claude Code self-reference for fast user question answering

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-12 10:37:09 +01:00
Florian BRUNIAUX
a8049b2ae8 fix(cheatsheet): audit and complete missing commands 
Cheatsheet completeness audit (v2.8 → v2.8.1):
- Add /execute, /model slash commands
- Add Ctrl+R, Ctrl+L keyboard shortcuts
- Add -c/--continue, -r/--resume, --headless CLI flags
- Add `claude update` maintenance command
- Fix false /resume (was CLI flag, not slash command)
- Clarify /status vs /context descriptions

Coverage improved from ~36% to ~85% of documented commands.
Format preserved: 377 lines, 1-page printable.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-12 09:05:05 +01:00
Florian BRUNIAUX
0833e1ca65 fix(audit): correct MCP detection to check ~/.claude.json 
The audit script was looking for MCP config in ~/.claude/mcp.json which
doesn't exist. Claude Code actually stores MCP config in ~/.claude.json
under projects.<path>.mcpServers.

Changes:
- audit-scan.sh: Multi-source MCP detection (3 locations with priority)
- audit-scan.sh: Fixed count_pattern() bug causing "0\n0" output
- claude-setup-audit-prompt.md: Updated bash commands for MCP detection
- Version bump: 2.8 → 2.9

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-12 08:37:01 +01:00
Florian BRUNIAUX
bafbeae31c docs(changelog): add README navigation improvements to v2.8.0 
- Decision Helper table, Audit visibility, Prerequisites
- examples/README.md catalog completion with github-actions/workflows
- Updated Stats section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-11 19:12:57 +01:00
Florian BRUNIAUX
37cb2b7c77 chore: release v2.8.0 with verified CLI commands and troubleshooting guide 
### Added
- Verified CLI maintenance commands (claude update, claude doctor)
- Slash commands (/output-style, /feedback)
- CLI flags (--json-schema, --max-budget-usd)
- Quick Diagnostic Guide with 8 symptom-based scenarios

### Stats
- Guide: 8,787 → 8,848 lines (+61 lines, +0.7%)
- Verification: 7 confirmed additions / 22 rejected claims (~32% valid from source)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-11 14:53:13 +01:00
Florian BRUNIAUX
869f0df782 feat: optimize audit prompt with bash scanning (v2.7.0) 
Add fast bash-based setup scanner for 80% speed improvement:
- New audit-scan.sh script with JSON/human output modes
- Rewrite audit prompt Phase 1-2 to use grep/find/wc
- Update README with dual-option audit approach
- Token reduction from ~5000 to ~500 (90% improvement)
- Execution time from ~30s to ~2s

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-11 14:39:46 +01:00
Florian BRUNIAUX
c7184ea5da feat(docs): add comprehensive Plugin System documentation (v2.6.0) 
Add Section 8.5 Plugin System with complete coverage of Claude Code's
plugin marketplace and extensibility features. Resolve keyboard shortcut
documentation inconsistency.

**Added:**
- Section 8.5 Plugin System (~245 lines)
  - Plugin commands: install, enable, disable, uninstall, update
  - Marketplace management (add, list, update, remove)
  - Custom plugin creation guide with manifest structure
  - Plugin vs MCP Server comparison
  - Security considerations and best practices
  - Real-world use cases (team standards, security audit, a11y)
  - Troubleshooting guide
- Esc×2 double-tap shortcut in keyboard shortcuts table
- /plugin command in commands reference
- --plugin-dir flag in CLI flags reference

**Changed:**
- Updated Table of Contents with Plugin System entry
- Enhanced Section 8 navigation with plugin link
- Added Plugins to Power Features in TL;DR
- Version bumped: 2.5 → 2.6 (README + guide)

**Stats:**
- Guide: 8,545 → 8,787 lines (+242 lines, +2.8%)
- Focus: Extensibility and community-driven functionality

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-11 14:15:14 +01:00
Florian BRUNIAUX
76845f8226 chore: release v2.5.0 with content optimization and script externalization 
- Remove ~1048 lines of non-Claude-Code-specific content (-10.9%)
- Externalize health check and reinstall scripts to examples/scripts/
- Clean up table of contents and fix broken references
- Update version numbers and statistics across all documentation

Removed sections:
- DeepSeek Integration (200 lines)
- Git Archaeology Pattern (250 lines)
- Emergency Hotfix Checklist (140 lines)
- Maturity Model & Success Metrics (95 lines)
- Generic Prompt Templates (105 lines)
- Task-specific checklists

New files:
- examples/scripts/check-claude.{sh,ps1}
- examples/scripts/clean-reinstall-claude.{sh,ps1}

Stats: 9593 → 8545 lines, focus on Claude Code-specific content

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-11 13:52:19 +01:00
Florian BRUNIAUX
07b8810fe3 feat(workflows): add database branch isolation with git worktrees 
Add comprehensive documentation for combining git worktrees with database branches
for true feature isolation across Neon, PlanetScale, Supabase, and local Postgres.

Changes:
- examples/commands/git-worktree.md: Add database branch detection and quick reference (~90 lines)
- examples/workflows/database-branch-setup.md: New complete guide with TL;DR and provider workflows (349 lines)
- english-ultimate-claude-code-guide.md: Add section 9.12 "Database Branch Isolation with Worktrees" (~95 lines)
- CHANGELOG.md: Add v2.4.0 release notes
- README.md: Update version to 2.4, line count to 9500+, add source attributions

Architecture: Progressive disclosure pattern (concise command → complete workflow guide)
Sources: Neon branching docs, PlanetScale branching docs

Stats: ~540 lines added | Guide now 9,592 lines, 35,576 words

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-11 13:25:58 +01:00
Florian BRUNIAUX
162b8562cf docs: release v2.3.0 with DeepTo guide integration 
- Add DeepTo Claude Code Guide reference to Resources section
- Document all DeepTo additions in CHANGELOG:
  • Image processing (direct terminal input)
  • Session continuation/resume (--continue, --resume)
  • XML-structured prompts (semantic tags)
  • ccusage CLI tool (cost analytics)
  • Unix piping workflows (automation patterns)
- Update version to 2.3 across all documentation
- Include proper source attribution throughout

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 17:55:46 +01:00
Florian BRUNIAUX
cd44749326 chore: bump version to 2.1.0 
Updated version numbers across all documentation files:
- CHANGELOG.md: Created [2.1.0] section with comprehensive release notes
- README.md: Version 2.0 → 2.1
- english-ultimate-claude-code-guide.md: Version 2.0 → 2.1
- cheatsheet-en.md: Version 2.0 → 2.1
- claude-setup-audit-prompt.md: Version 2.0 → 2.1

Release highlights:
- 6 new production-ready files (3 commands, 2 hooks, 1 documentation)
- Guide expanded by 837 lines (+10.9%)
- README restructured for better discoverability
- DeepWiki integration for interactive documentation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 17:33:37 +01:00
Florian BRUNIAUX
96f0435291 feat(examples): add production-ready commands, hooks, and comprehensive documentation 
Added 3 production slash commands:
- /pr: PR creation with complexity scoring and scope analysis
- /release-notes: Generate release notes in 3 formats with migration detection
- /sonarqube: Analyze SonarCloud quality issues for PRs

Added 2 production hooks:
- dangerous-actions-blocker.sh: PreToolUse security hook blocking destructive operations
- notification.sh: Contextual macOS alerts with sound mappings

Created comprehensive hooks documentation (examples/hooks/README.md)

Improved README discoverability:
- Moved "What's Inside" to line 24 for immediate visibility
- Added DeepWiki interactive documentation explorer section
- Added "Ready-to-Use Examples" section with command/hook tables

Extended guide documentation:
- Expanded bash mode (!) with 9 concrete examples
- Documented file references (@) with usage patterns
- Updated statistics: guide now 8,505 lines (+837 lines, +10.9%)

All templates are fully generic with no project-specific references.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 17:30:30 +01:00
Florian BRUNIAUX
2dd2744721 feat: add git best practices, worktrees, and cost optimization sections 
- Add Section 9.12: Git Best Practices & Workflows (~400 lines)
  - Commit message best practices with Conventional Commits
  - Git amend workflow with safety rules
  - Branch management and naming conventions
  - Rewind vs Revert decision tree
  - Comprehensive git worktrees documentation
- Add Section 9.13: Cost Optimization Strategies (~350 lines)
  - Model selection matrix (Haiku/Sonnet/Opus)
  - OpusPlan mode for efficient workflows
  - Token-saving techniques and cost tracking
  - ROI calculations and economic workflows
- Add examples/commands/git-worktree.md slash command template
- Update CHANGELOG.md with v2.0.0 additions
- Update version metadata to 2.0 across documentation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 17:00:45 +01:00
Florian BRUNIAUX
29d922af72 docs: update meta-documentation for v1.2.0 release 
Update supporting documentation to reflect the major additions in v1.2.0:
- CHANGELOG.md: Document all v1.2.0 additions (~1300 lines of new content)
- README.md: Enhanced Windows disclaimer with prominent callout box
- claude-setup-audit-prompt.md: Add evaluation criteria for new sections

New evaluation criteria added:
- Cost Awareness & Optimization patterns
- Migration Patterns from Copilot/Cursor
- Release Notes automation
- Emergency Hotfix procedures
- Git Archaeology usage patterns

Stats: Guide expanded from ~4955 to ~6250 lines (~26% growth)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 15:00:41 +01:00
Florian BRUNIAUX
b2acc9b115 feat: add Learning Paths, examples, and project governance files 
### New Content
- Learning Paths section in README (Junior/Senior/Power User/PM tracks)
- examples/ folder with 18 ready-to-use templates:
  - 4 agents (code-reviewer, test-writer, security-auditor, refactoring)
  - 2 skills (TDD workflow, security checklist)
  - 3 commands (commit, review-pr, generate-tests)
  - 4 hooks (bash + PowerShell for security, formatting)
  - 3 config templates (settings, MCP, gitignore)
  - 2 memory templates (project + personal CLAUDE.md)

### Governance
- CHANGELOG.md: Version history (1.0.0 → 1.1.0 → Unreleased)
- CONTRIBUTING.md: Contribution guidelines for community

### Documentation
- llms.txt: Updated structure with new files/folders

This update makes the guide more actionable with concrete templates
and provides clear learning paths for different skill levels.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-10 14:25:22 +01:00