Florian BRUNIAUX
87994bb797
feat(guide): add thinking keywords, GitHub Actions examples, and improvement recommendations
...
Documentation enhancements:
- Add inline thinking keywords section (think, think hard, ultrathink) with usage examples
- Create examples/github-actions/ directory with 3 ready-to-use workflows:
* Auto PR review with inline comments
* Security review on every PR
* Issue triage with label suggestions
- Add comprehensive IMPROVEMENT_RECOMMENDATIONS.md with prioritized action items
Improvements based on zebbern/claude-code-guide analysis:
- Enhanced troubleshooting guidance
- Format enhancements (badges, collapsible tables, C-style comments)
- Security/performance/workflow pitfalls sections
- DeepSeek integration documentation
- One-shot health check scripts
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-10 15:26:18 +01:00
Florian BRUNIAUX
266e4d285d
docs(guide): add community cybersecurity skills repository section
...
Add section 5.5 documenting zebbern/claude-code-guide repository containing 29 cybersecurity-focused skills for penetration testing, security tools, infrastructure security, and application security testing.
Includes:
- Organized skills catalog by domain
- Installation and usage instructions
- Important legal/ethical disclaimers
- Encouragement for community contributions
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-10 14:59:50 +01:00
Florian BRUNIAUX
7d866571fa
docs(guide): expand troubleshooting section
...
- Add MCP server issues (Serena, Context7, Sequential)
- Add permission pattern examples
- Add timeout troubleshooting
- Add platform-specific installation issues (Windows/macOS/Linux)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-10 14:46:58 +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
Florian BRUNIAUX
45ae9e6a16
docs: add comprehensive Windows compatibility support
...
Cross-platform improvements:
- Installation: npm as primary method (all platforms)
- Platform path reference table (macOS/Linux vs Windows)
- Global note for Windows users on path differences
Windows hook templates (PowerShell + Batch):
- Template W1: PreToolUse security check (.ps1)
- Template W2: PostToolUse auto-formatter (.ps1)
- Template W3: Context enricher (.cmd)
- Template W4: Windows notifications (.ps1)
- Windows settings.json example with ExecutionPolicy
Terminal integration:
- PowerShell profile aliases (cc, ccp, cce, cq)
- Profile location and creation instructions
- Windows Auto Plan Mode setup (claude-safe function)
Additional Windows notes:
- Cheatsheet: dual-platform paths table
- Cheatsheet: bash + PowerShell hook examples
- CI/CD: Git Bash compatibility note
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 17:28:51 +01:00
Florian BRUNIAUX
28b01c4dfe
feat: add audit prompt and enhance guide with advanced patterns
...
- Add claude-setup-audit-prompt.md: self-contained prompt for setup analysis
- 3-phase audit: Discovery → Evaluate & Report → Validation
- Weighted health score formula (High=3, Med=2, Low=1 points)
- Stack detection for contextual templates
- Glossary of terms for beginners
- Cross-platform paths (Unix + Windows)
- Integrate Nick Tune's workflow patterns:
- Section 3.1: Single Source of Truth pattern
- Section 7.1: Shell Scripts vs AI Agents decision framework
- Section 9.3: Verify Gate pattern with autonomous retry loop
- Section 9.10: NEW Continuous Improvement Mindset
- Add Community Resources section:
- 5 awesome-* repos with descriptions
- SuperClaude framework documentation
- Learning sites (Claudelog, Official Docs)
- Update README with:
- Audit tool in What's Inside table
- Dedicated "Audit Your Setup" section
- Resources section with community links
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 17:18:35 +01:00
Florian BRUNIAUX
729a90f1f4
docs(mcp): enhance Serena documentation and add mgrep
...
Serena section now covers:
- Why it matters (Claude Code lacks native indexation unlike Cursor)
- Key features: indexation, project memory, auto-onboarding
- Memory tools: write_memory, read_memory, list_memories
- Session memory workflow example
- Pre-indexing setup command
New mgrep section:
- Intent-based semantic search alternative
- Comparison with Serena (intent vs symbol-level)
- Key features and example usage
- Honest note: not personally tested
Also updated:
- Server comparison table with memory and mgrep entries
- Cheatsheet MCP section
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 16:32:10 +01:00
Florian BRUNIAUX
54ae484e67
docs: align terminology with official Anthropic documentation
...
- Rename "Configuration" to "Memory & Settings" (section 3)
- CLAUDE.md files are now properly called "Memory Files"
- Add explanatory note about why they're called "memory"
- Update all internal references (diagrams, headings, precedence rules)
- Add table of contents with direct links to README
- Add GitHub stars badge and call-to-action
- Update cheatsheet with consistent terminology
Based on feedback that configuration should refer to settings.json,
while CLAUDE.md files are officially called "memory" in Anthropic docs.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 16:18:23 +01:00
Florian BRUNIAUX
48687e82d3
fix: correct license from MIT to CC BY-SA 4.0
...
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 15:25:22 +01:00
Florian BRUNIAUX
afd9cb6f20
docs: add complete Claude Code ultimate guide content
...
- Add comprehensive guide (4000+ lines) covering all Claude Code features
- Add printable cheatsheet for daily reference
- Add PDF versions (NotebookLM podcast, Kimi export)
- Update README with author context, inspiration sources, and contact info
- Change license from MIT to CC BY-SA 4.0 for content sharing
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 15:18:49 +01:00