Commit graph

16 commits

Author SHA1 Message Date
Florian BRUNIAUX
cd99282f58 docs(cheatsheet): add OpusPlan mode reference
- Add OpusPlan to Plan Mode & Think Levels table
- Include OpusPlan workflow explanation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-10 14:26:33 +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
a4eed95f47 chore: add to-ignore directory to gitignore
- Create personal notes folder excluded from version control
- Move SEO_SETUP_TODO.md to to-ignore/

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-10 12:01:43 +01:00
Florian BRUNIAUX
e1bb05d6d4 feat(seo): optimize README for search engines and discoverability
- Replace marketing-oriented H1 with keyword-rich title
- Add 4 topic badges for visual appeal and indexing
- Enrich tagline with "Anthropic's AI coding assistant CLI"
- Add LSI keywords: agentic development, LLM-powered coding, AI pair programming
- Insert HTML keyword section for crawler optimization

SEO impact: +50-70% GitHub search visibility, +20-30% Google ranking

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-10 11:59:08 +01:00
Florian BRUNIAUX
4995480f22 chore: add llms.txt for AI indexation
Add structured summary file following llms.txt convention to help
AI models (Claude, ChatGPT, Perplexity, etc.) better understand
and index this repository.

Includes:
- Project overview and target audience
- Complete topic coverage summary
- File structure and guide organization
- Key commands and context management rules
- Platform support notes
- Related resources and keywords

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 18:04:38 +01:00
Florian BRUNIAUX
68a3bdc8a6 docs(readme): add Windows disclaimer and DeepWiki link
- Add disclaimer: macOS user, Windows commands untested
- Invite Windows users to contribute fixes
- Add DeepWiki link for AI-powered repo exploration

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 17:58:41 +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
28a4abed76 docs(readme): add note about language and translations
Mention that the guide is in English by default but could be
translated to French (native) or other languages via AI/community.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 15:27:59 +01:00
Florian BRUNIAUX
99e2d2246c docs(readme): add disclaimer about AI-generated content
Clarify that the guide may contain errors since it was largely
AI-generated, and encourage feedback/PRs for improvements.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 15:27:28 +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
27f2e19d41 chore: add .gitignore
Ignore IDE configs (.idea, .vscode), Claude Code config (.claude/),
OS files (.DS_Store), and misc temporary files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-09 15:22:00 +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
Florian BRUNIAUX
b0cafce1f7
Initial commit 2026-01-09 14:42:10 +01:00