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

208 commits

This branch
This branch
All branches
Author SHA1 Message Date
Florian BRUNIAUX
11d2e4dfe3 docs: add everything-claude-code repository evaluation (5/5 CRITICAL) 
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 16:29:12 +01:00
Florian BRUNIAUX
9055c31ee7 release: version 3.17.0 - Tasks API limitations documentation 
Version bump from 3.16.0 to 3.17.0 with Tasks API field visibility
limitations integration.

Changes:
- VERSION: 3.16.0 → 3.17.0
- CHANGELOG.md: Moved [Unreleased] to [3.17.0] - 2026-01-27
- README.md: Updated version footer, resource evaluations count (22)
- guide/cheatsheet.md: Updated version headers
- guide/ultimate-guide.md: Updated version
- machine-readable/reference.yaml: Updated version + date

Release highlights:
- 🚨 CRITICAL: Tasks API limitations documented (Gang Rui analysis)
  * TaskList field visibility constraints
  * 11x-51x cost overhead for N tasks
  * 3 workaround patterns provided
  * Prevents user frustration, maintains guide credibility

- 📊 Stats: 22 resource evaluations, 493 lines added
- 🎯 Impact: All Tasks API users (v2.1.16+) benefit from transparency

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 16:21:05 +01:00
Florian BRUNIAUX
3a5012eef7 docs: document Tasks API field visibility limitations (Gang Rui analysis) 
Integration of community practitioner feedback on Tasks API (v2.1.16+)
field visibility constraints discovered through real-world usage.

Changes:
- guide/ultimate-guide.md:
  * Added 3 rows to comparison table (field visibility, metadata, overhead)
  * New subsection "⚠️ Tasks API Limitations (Critical)" (~40 lines)
  * Field visibility constraint table, cost examples, 3 workaround patterns

- guide/workflows/task-management.md:
  * New subsection "⚠️ Field Visibility Limitations" (~35 lines)
  * Workflow adjustments, cost awareness, mitigation strategies

- guide/cheatsheet.md:
  * Added limitation note with actionable tip (~3 lines)

- machine-readable/reference.yaml:
  * 4 new entries: limitations, field_visibility, cost_overhead, workarounds
  * Updated resource_evaluations_count: 16 → 22

- docs/resource-evaluations/016-gang-rui-tasks-api-limitations.md:
  * New comprehensive evaluation (score 5/5 CRITICAL)
  * Fact-check, challenge phase, integration details

- README.md:
  * Updated resource evaluations count: 15 → 22 assessments

Score: 5/5 (CRITICAL) - Breaks recommended workflow, 11x-51x cost
overhead, prevents user frustration, maintains guide credibility.

Source: https://www.linkedin.com/posts/limgangrui_i-explored-the-new-claude-codes-task-system-activity-7420651412881268736-Hpd6
Date: 2026-01-24

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 16:16:49 +01:00
Florian BRUNIAUX
edf74b38c5 docs: add missing hook events from official CHANGELOG (v2.1.9-v2.1.10) 
- Add 3 missing events to Section 7.1: Setup, PermissionRequest, SubagentStop
- Document PreToolUse additionalContext feature (v2.1.9+)
- Create 3 production-ready hook templates (setup, permission, subagent)
- Add resource evaluation documenting rejection of secondary source

Source: Official Claude Code CHANGELOG, not external blog posts
Closes gap identified during resource evaluation process

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 12:45:47 +01:00
Florian BRUNIAUX
bd193cf73a feat: add GitHub stars verification to sync script 
Added automatic verification of GitHub stars count:
- Fetches actual count from GitHub API
- Compares with landing index.html badge
- Tolerance: ±10% or ±10 stars (whichever is larger)
- Prevents future mismatches like 1.2k vs 60

Verification output example:
  Actual (GitHub API): 60
  Landing (index.html): 60
  ✓ OK (within tolerance: ±10)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 12:45:18 +01:00
Florian BRUNIAUX
c198cf2645 docs: update cheatsheet to v3.16.0 + Features Méconnues section 2026-01-27 10:42:26 +01:00
Florian BRUNIAUX
87423c5546 release: version 3.16.0 - TeammateTool + Myths vs Reality 
- TeammateTool: Experimental multi-agent coordination docs
- Appendix D: Myths vs Reality (debunk misinformation)
- Cheatsheet: Features Méconnues section
- Resource evaluation: Rejected social media post (score 1/5)
- Version bump: 3.15.0 → 3.16.0
- Landing sync: 15,400+ lines (vs 14,900+)
 2026-01-27 10:15:39 +01:00
Florian BRUNIAUX
6e621806a4 docs: add Myths vs Reality appendix + TeammateTool documentation 
- Appendix D: Myths vs Reality
  - Myth: Hidden features with secret flags
  - Myth: Tasks API = autonomous agents
  - Myth: 100x faster claims
  - Reality: Documented strengths of Claude Code
  - How to spot reliable vs unreliable sources

- New: TeammateTool experimental feature documentation
  - Multi-agent orchestration capabilities
  - Execution backends (in-process, tmux, iTerm2)
  - Usage patterns (parallel specialists, swarm)
  - Clear warnings about experimental status
  - Community sources cited

- Cheatsheet: Features Méconnues (But Official!) section
  - Tasks API, Background Agents, TeammateTool
  - Session Forking, LSP Tool
  - Pro tip: Read the CHANGELOG

- Reference.yaml: Added line numbers for new sections

- Resource evaluation: Rejected low-quality social media post
  (docs/resource-evaluations/2026-01-27-claude-code-hidden-feature-social-post.md)

Addresses community misinformation while documenting real experimental features with proper sourcing.
 2026-01-27 09:45:06 +01:00
Florian BRUNIAUX
db5c761d13 docs: track Claude Code v2.1.20 release 2026-01-27 09:02:45 +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
18ea240e12 docs: add MCP Apps (SEP-1865) documentation 
Integrate comprehensive documentation for MCP Apps, the first official
MCP extension enabling interactive UI delivery.

Changes:
- guide/architecture.md (656): New section "MCP Extensions: Apps"
  - Technical architecture (primitives, SDK, security)
  - Platform support (Claude Desktop, VS Code, ChatGPT, Goose)
  - Example implementations (9 production tools at launch)
  - Developer workflow and SDK usage
  - ~150 lines of technical documentation

- guide/ultimate-guide.md (6509): New section "MCP Evolution: Apps"
  - User context and use cases
  - Available interactive tools (Asana, Slack, Figma, etc.)
  - Platform support matrix
  - Hybrid workflow examples
  - ~90 lines of user-facing documentation

- guide/ultimate-guide.md (7522): Table update
  - Added "Interactive UI" row to Plugin vs. MCP Server comparison
  - Clarified MCP Apps = "What Claude can show"

- machine-readable/reference.yaml: 8 new entries
  - mcp_apps_architecture, mcp_apps_evolution
  - Links to spec, SDK, blog posts
  - CLI relevance note (indirect)

- docs/resource-evaluations/mcp-apps-announcement.md: New evaluation
  - Score: 4/5 (High Value - Integrate within 1 week)
  - Fact-checked with Perplexity searches
  - Technical review by agent

Resource evaluated:
- https://blog.modelcontextprotocol.io/posts/2026-01-26-mcp-apps/
- https://claude.com/blog/interactive-tools-in-claude

Total documentation: ~240 lines across 3 files
Score: 4/5 (High Value)
CLI relevance: Indirect (ecosystem understanding, MCP server dev, hybrid workflows)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 08:14:49 +01:00
Florian BRUNIAUX
3a7671ac5e docs: update $ARGUMENTS syntax for v2.1.19 breaking change + evaluation 
Updated all documentation and examples to reflect Claude Code v2.1.19
breaking change: $ARGUMENTS.0 → $ARGUMENTS[0] (bracket syntax).

Changes:
- guide/ultimate-guide.md: 7 occurrences updated to bracket/shorthand syntax
- guide/cheatsheet.md: Command template updated
- Added migration note in § 6.2 Variable Interpolation
- Created migration scripts: migrate-arguments-syntax.{sh,ps1}
  • Automated detection + conversion with backups
  • Dry-run mode, cross-platform (macOS/Linux/Windows)
- Added formal evaluation: eval-claude-code-releases-jan2026.md
  • Score: 5/5 (Critical - Integrate Immediately)
  • Covers releases 2.1.0 to 2.1.19 (January 2026)
  • Technical accuracy verified against GitHub CHANGELOG

Files:
- guide/ultimate-guide.md (+23 lines, 7 occurrences fixed)
- guide/cheatsheet.md (+1 line)
- examples/scripts/migrate-arguments-syntax.sh (+152 lines)
- examples/scripts/migrate-arguments-syntax.ps1 (+143 lines)
- docs/resource-evaluations/eval-claude-code-releases-jan2026.md (+273 lines)
- CHANGELOG.md (+12 lines, Unreleased section)

Total: +605 lines

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 17:37:49 +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
ab8bfcf782 docs: add Anaconda Croce evaluation (minimal integration) 
Resource evaluated: "What I Learned Challenging Claude to a Coding Competition"
by Steve Croce (Anaconda Field CTO, Jan 16, 2026)

Score: 2/5 (Marginal - Info secondaire)

Integration:
- Added "Community Experiences" section in guide/learning-with-ai.md
- 2-paragraph mention with strong caveats (N=1, non-representative context)
- Full evaluation in docs/resource-evaluations/anaconda-croce-evaluation.md
- Updated reference.yaml count (14 → 16 evaluations)

Rationale:
- Provides light empirical validation (90s vs 60min on Advent of Code)
- Highlights "collaboration cost" angle (decreased Slack engagement)
- Limitations prevent extensive integration (solo puzzles ≠ team dev)
- Commercial bias noted (Anaconda blog by Anaconda CTO)

Technical review challenged initial 4/5 score → adjusted to 2/5.
Maintains guide rigor through minimal integration + explicit caveats.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 16:53:48 +01:00
Florian BRUNIAUX
444ce5aa6a docs: add resource evaluation process documentation 
Added comprehensive documentation for resource evaluation methodology:

- Appendix C in ultimate-guide.md (line 15034)
  * 5-point scoring system with decision criteria
  * 14 documented assessments by category
  * Transparency on integration decisions
  * Links to full methodology

- Fixed methodologies.md GSD evaluation link
  * Corrected path: claudedocs → docs (public)

- Updated reference.yaml with resource evaluations metadata
  * Directory, count (14), methodology references
  * Appendix and README section line numbers

All resource-evaluations now properly documented and discoverable.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 15:10:24 +01:00
Florian BRUNIAUX
893c125fa7 release: version 3.14.0 - NotebookLM MCP integration 
Bump version from 3.13.0 to 3.14.0 with complete NotebookLM MCP documentation.

## Version Updates

- VERSION: 3.13.0 → 3.14.0
- Synced across: README.md, guide/cheatsheet.md, guide/ultimate-guide.md, machine-readable/reference.yaml

## CHANGELOG.md

- Added comprehensive v3.14.0 entry with NotebookLM MCP documentation details
- Moved previous [Unreleased] items to v3.14.0
- Updated templates count: 86 → 83 (accurate count)

## Documentation Changes

Already committed in ff3458a:
- guide/ai-ecosystem.md: +603 lines (§ 4.1-4.5)
- guide/ultimate-guide.md: +3 lines (MCP integration mention)
- Complete coverage of 16 MCP tools across 3 profiles

## Landing Site Sync

- Landing site updated: 3.13.0 → 3.14.0
- All checks passing (version, templates, quiz, guide lines)
- Verified with ./scripts/check-landing-sync.sh

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 15:06:46 +01:00
Florian BRUNIAUX
8aa1b0401c docs: update README metrics for accuracy and landing sync 
- Guide length: ~10K → ~15K lines (actual: 15,053)
- Reading time: ~3h → ~4h
- Security hooks: 15+ → 18
- Templates: maintained at 86 (sync script logic)
- Added Resource Evaluations section (14 assessments)
- Verified sync with check-landing-sync.sh

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:56:58 +01:00
Florian BRUNIAUX
ff3458a67c docs: add complete NotebookLM MCP integration documentation 
Added comprehensive documentation for NotebookLM MCP server integration
in Claude Code, covering all 16 tools across 3 profiles (minimal/standard/full).

## Changes

### guide/ai-ecosystem.md (~330 new lines)

**§ 4.1 - Enhanced installation section**:
- Detailed tool breakdown table (16 tools × 3 profiles)
- Profile comparison with recommended defaults
- Multi-account authentication workflow
- Share links library building pattern

**§ 4.2 - Advanced Features (Full Profile)** (~110 lines):
- remove_notebook: Library cleanup
- re_auth: Google account switching
- cleanup_data: Complete MCP reset with preserve_library option
- Manual browser control (3 functions): state inspection, actions, element waiting

**§ 4.3 - Browser Options** (~70 lines):
- Complete options reference (headless, timeout, viewport, stealth)
- Stealth mode configuration (typing speed, delays, mouse movements)
- Usage examples: debug visually, custom timeouts, disable stealth

**§ 4.4 - Session Management** (~60 lines):
- Session lifecycle and properties (15min timeout, 10 max concurrent)
- Automatic vs manual session control
- List/resume/force new session workflows

**§ 4.5 - Library Management Best Practices** (~90 lines):
- Naming conventions and topics strategy
- Metadata refinement workflow (add → use → refine → archive)
- Search and discovery patterns
- Notebook lifecycle management

### guide/ultimate-guide.md

- Updated Complementary Tools table: Added "MCP integration" mention
- Added redirect note to ai-ecosystem.md § 4.1

### README.md

- Template count updated (86 → 83) to reflect current state

## Coverage

- ✅ All 16 MCP tools documented
- ✅ 3 profiles explained (minimal/standard/full)
- ✅ Installation, auth, queries, advanced features
- ✅ Browser options, session management, best practices
- ✅ Troubleshooting and examples

## Testing

- Installation: Verified (standard profile)
- Authentication: Tested with multi-account setup (authuser=1)
- Library: 4 notebooks added and queried successfully
- Advanced features: Documented from API spec (not yet tested in practice)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:40:17 +01:00
Florian BRUNIAUX
be79f6c09a docs: update CHANGELOG and README for recent additions 
- Add resource-evaluations and task-management entries to CHANGELOG [Unreleased]
- Update README workflows description (TDD, Plan-Driven, Task Management)
- Add docs/resource-evaluations/ to repository structure diagram
- Clarify documentation organization for contributors

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:08:59 +01:00
Florian BRUNIAUX
821c900ba0 docs: add task management workflow and update guides 
- Add guide/workflows/task-management.md (comprehensive workflow)
- Update ultimate-guide.md with task management sections
- Add task management quick reference to cheatsheet
- Update machine-readable/reference.yaml with new content
- Update .gitignore for docs/ directory

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 14:02:54 +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
Florian BRUNIAUX
6f6cd90bc1 release: version 3.13.0 - Boris Cherny mental models integration 
Major additions:
- CLAUDE.md as Compounding Memory philosophy (never correct Claude twice)
- Plan-First Discipline methodology (foundational pattern)
- Verification Loops architectural pattern (8 domains)
- Advanced Worktree Tooling section (3 independent tools validated)
- Anthropic governance resources (Constitution, Petri v2)
- Search tools mastery workflow (grep, grepai, ast-grep, Serena)

Updates:
- Boris Cherny case study enhanced with direct quotes
- Templates count: 83 → 86
- Reference YAML: new architecture diagram, search tools comparison

Resource evaluations:
- Boris Cowork video (3/5 - pertinent)
- Wooldridge productivity stack (3/5 - remote-first workflows)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 13:32:54 +01:00
Florian BRUNIAUX
6ed7e92e64 docs: add Anthropic governance resources 
- Add Claude's Constitution (CC0) to data-privacy guide
- Add Petri 2.0 research tool to README
- Update reference.yaml with external research section

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-26 09:31:19 +01:00
Florian BRUNIAUX
257f2ff65d docs: add search tools guides and ast-grep patterns 
New documentation:
- guide/search-tools-cheatsheet.md: Quick reference for Grep/Glob/Read tools
- guide/workflows/README.md: Workflows directory index
- examples/skills/ast-grep-patterns.md: AST-based code search patterns

Updated:
- guide/architecture.md: MCP architecture visual diagram section

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 18:47:29 +01:00
Florian BRUNIAUX
96da6ebd7e feat: add bridge script for Claude Code → LM Studio execution (v3.12.1) 
Bridge script enables local execution of Claude Code plans via LM Studio:
- Python CLI with 5 components (DoobidooReader, LMStudioClient, Validator, StepExecutor, PlanExecutor)
- JSON Schema for plan validation (bridge-plan-schema.json)
- Cost optimization: Plan with Opus (~$0.50-2), execute free locally (80-90% savings)
- 4 validation types: json, syntax_check, contains_keys, non_empty
- CLI: --health, --list, --plan ID, -v verbose mode

Documentation:
- New section "Local Execution Bridge" in ultimate-guide.md §11.2
- scripts/README.md with full usage documentation
- machine-readable/reference.yaml entries for discoverability

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 18:43:05 +01:00
Florian BRUNIAUX
2ace737018 docs: add grepai benchmark data to search tools workflow 
Add real-world benchmark section with YoanDev's grepai vs grep
comparison (Excalidraw 155k TS, Jan 2026). Includes honest
disclosure of limitations (benchmark by tool maintainer).

Source: https://yoandev.co/grepai-benchmark

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 18:35:38 +01:00
Florian BRUNIAUX
ccf2b2a01e docs: add "Do I Need Worktrunk?" self-assessment section 
Added decision-making framework to help readers evaluate if they need
Worktrunk or should stick with vanilla git/aliases.

Key additions (guide/ultimate-guide.md:10762):
- 3 quick self-assessment questions (volume, multi-instance, team)
- Decision matrix: 4 user profiles (Beginner → Boris scale)
- Quick alias alternative for casual users (2 min setup, -79% typing)
- Bottom line: "80% should start with vanilla git or alias"
- YAGNI principle applied to tooling adoption

Philosophy: Prevents premature tool adoption by providing objective
criteria. Most readers (2-3 worktrees/week) don't need Worktrunk.

Updated:
- machine-readable/reference.yaml: Added worktree_tooling_self_assessment: 10762
- CHANGELOG.md: Updated Advanced Worktree Tooling entry with self-assessment details
- Total guide additions: +139 lines (self-assessment section)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 18:33:57 +01:00
Florian BRUNIAUX
24481ea9a7 docs: update CHANGELOG with advanced worktree tooling entry 
Added [Unreleased] entry documenting new Section 9.17 "Advanced Tooling
for Worktree Management (Optional)".

Entry includes:
- Pattern validation (3 independent implementations)
- Benchmark comparison (Worktrunk vs vanilla git vs DIY)
- Progressive recommendation philosophy
- ROI evidence (incident.io 18% improvement)
- Resource evaluation reference (score: 3/5)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 18:06:04 +01:00
Florian BRUNIAUX
da8dedc7f8 docs: add advanced worktree tooling section (Worktrunk + DIY alternatives) 
Added Section 9.17 "Advanced Tooling for Worktree Management (Optional)" based on
deep-dive analysis of 4 sources (Worktrunk GitHub, incident.io blog, Anthropic best
practices, GitHub issue #1052).

Key additions:
- Pattern validation: 3 independent teams created worktree wrappers
- Benchmark: Worktrunk vs vanilla git vs custom wrappers
- Option 1: Worktrunk (1.6K stars, multi-platform, CI/LLM integration)
- Option 2: DIY custom wrappers (incident.io, GitHub #1052 examples)
- Philosophy: Learn fundamentals first, add wrapper for productivity later

Updated machine-readable/reference.yaml:
- Added advanced_worktree_tooling: 10661
- Fixed line references for sections after git worktrees
- Updated Appendix references (14356, 14530, 14532, 14601)

Score: 3/5 (pertinent - complément utile)
Evaluation: claudedocs/resource-evaluations/worktrunk-evaluation.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 18:00:55 +01:00
Florian BRUNIAUX
3e5a35295c docs: add GSD methodology and update CHANGELOG 
- Add GSD (Get Shit Done) to Tier 1: Strategic Orchestration (guide/methodologies.md:47-55)
- Document 6-phase workflow addressing context rot with fresh 200k contexts per task
- Note overlap with existing patterns (Ralph Loop, Gas Town, BMAD)
- Add CHANGELOG entry for ClawdBot FAQ enrichment (commit 4a3f83b)
- Source: https://github.com/glittercowboy/get-shit-done (7.5k stars)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 17:52:58 +01:00
Florian BRUNIAUX
3f923efb7e docs: add GSD methodology mention with evaluation 
- Added GSD to Tier 1: Strategic Orchestration (guide/methodologies.md:47-55)
- Meta-prompting 6-phase workflow with fresh 200k-token contexts per task
- Note: Core concepts overlap with existing patterns (Ralph Loop, Gas Town, BMAD)
- Resource evaluation saved in claudedocs/resource-evaluations/gsd-evaluation.md (score: 2/5 - marginal/redundant)
- Updated CHANGELOG.md and machine-readable/reference.yaml for LLM indexing
- Source: https://github.com/glittercowboy/get-shit-done (7.5k stars, created Dec 2025)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 17:49:48 +01:00
Florian BRUNIAUX
4a3f83bebf docs: enrich ClawdBot FAQ with community adoption stats 
Add community adoption analysis link and stats to ClawdBot comparison section:
- Added link to Twitter/X community analysis (5,600+ social mentions)
- Updated final note with adoption metrics and use case examples
- Complements existing FAQ without replacing structured comparison

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 17:47:09 +01:00
Florian BRUNIAUX
68e738b5e0 fix: correct indentation in architecture.md MCP section 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:49:17 +01:00
Florian BRUNIAUX
1e5e9d5810 docs: add MCP diagram to changelog, fix architecture.md typo 
- CHANGELOG.md: Document MCP visual diagram (guide/architecture.md:513)
- guide/architecture.md: Fix image path typo (.t → .svg)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:42:20 +01:00
Florian BRUNIAUX
adb252f97a feat: add multi-agent orchestration systems documentation (v3.12.0) 
- Gas Town (Steve Yegge): Multi-agent workspace manager
- multiclaude (dlorenc): Self-hosted agent spawner (383 stars)
- agent-chat (Justin Abrahms): Real-time monitoring UI (v0.2.0)

Added comprehensive documentation in guide/ai-ecosystem.md:808:
- Overview table comparing 3 orchestration systems
- Detailed descriptions with key points and use cases
- Security & cost warnings (experimental status, cost explosion)
- Integration patterns for native Claude Code workflows
- Decision matrix: when to use orchestrators vs single sessions

Machine-readable enhancements:
- reference.yaml: external_orchestrators section with structured data
- Programmatic access to repos, authors, status, guide sections

Cross-references:
- guide/observability.md:117: Multi-agent monitoring comparison
- Architecture pattern: hooks + SQLite + SSE for custom dashboards

Version bump: 3.11.7 → 3.12.0 (minor release)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:31:28 +01:00
Florian BRUNIAUX
7330eacb2b chore: bump version to 3.12.0 
- Update VERSION file (3.11.7 → 3.12.0)
- Sync cheatsheet.md version references

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:31:15 +01:00
Florian BRUNIAUX
29f778daf7 docs: update template count badge (82 → 83) 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:30:40 +01:00
Florian BRUNIAUX
a858dceda0 docs: add Context Overload anti-pattern (Rusitschka) 
- Add "Context Overload" anti-pattern in §9.8 Vibe Coding (line 8746)
- Unify plan mode + fresh context + handoffs under phased strategy
- Credit Jens Rusitschka ("Vibe Coding, Level 2", Jan 2026)
- Cross-reference existing patterns (§2.2, §2.3)
- Update reference.yaml with new entries (3 keys)
- Add cross-ref in learning-with-ai.md (line 96)

Source: https://kickboost.substack.com/p/are-you-still-vibe-coding-or-are

Score: 2.5/5 (10% useful packaging, 90% rebranding)
Integration: 60 lines added (concise, no duplication)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-25 13:29:02 +01:00
Florian BRUNIAUX
a39d77f97b docs: update Claude Code releases (v2.1.19, v2.1.18) 
- v2.1.19: CLAUDE_CODE_ENABLE_TASKS env var, $0/$1 argument shorthand
- v2.1.18: Customizable keyboard shortcuts with /keybindings
- Breaking: $ARGUMENTS.0 → $ARGUMENTS[0] syntax change (v2.1.19)
- Milestone: Keyboard shortcuts added to feature list
- Update both YAML and Markdown files
- Sync dates to 2026-01-25

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 12:45:51 +01:00
Florian BRUNIAUX
caf302107f docs: add ClawdBot vs Claude Code FAQ (v3.11.7) 
- Add Appendix B: FAQ section addressing ClawdBot confusion
- Comprehensive comparison table (9 dimensions)
- Early warning note in 'Before You Start' section
- New README section with quick explanation
- Update all version references to 3.11.7
- Index FAQ in reference.yaml

Context: Jan 2026 community buzz created confusion between
ClawdBot (chatbot for messaging apps) and Claude Code (CLI dev tool)

Total: +86 lines across 5 files

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 11:38:19 +01:00
Florian BRUNIAUX
b52d95a634 docs: add architecture diagrams pattern for OOP codebases 
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-25 11:18:53 +01:00
Florian BRUNIAUX
c84c56bfbd docs: add AI Traceability & Attribution guide 
Comprehensive documentation on AI code attribution and disclosure:

- New guide: guide/ai-traceability.md (~640 lines)
  - LLVM "Human-in-the-Loop" policy (Assisted-by trailer)
  - Ghostty mandatory disclosure pattern
  - Fedora contributor accountability framework
  - git-ai tool documentation
  - PromptPwnd security vulnerability
  - Four-level disclosure spectrum
  - Implementation guides (solo, team, enterprise)

- Templates: examples/config/
  - CONTRIBUTING-ai-disclosure.md
  - PULL_REQUEST_TEMPLATE-ai.md

- Cross-references added to:
  - ultimate-guide.md (after Co-Authored-By section)
  - learning-with-ai.md (after Vibe Coding Trap)
  - security-hardening.md (See Also)
  - guide/README.md (table of contents)

- reference.yaml: 14 new entries for AI traceability topics

Source: Vibe coding needs git blame (Piotr Migdał, Jan 2026)
+ Perplexity research on LLVM, Ghostty, Fedora policies

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-24 20:11:53 +01:00
Florian BRUNIAUX
c75e48671c fix: typo in Community Marketplaces heading 
Corrected markdown heading: v### → ###

Location: guide/ultimate-guide.md:7246

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-24 18:34:58 +01:00
Florian BRUNIAUX
d2362401b1 docs: update plugin system with community marketplaces and official docs 
Section 8.5 Plugin System:
- CRITICAL FIX: Correct structure (.claude-plugin/plugin.json not root)
- Add .mcp.json, .lsp.json, hooks/hooks.json to directory structure
- Add skill namespacing documentation (/plugin-name:skill)
- Add warning about common mistake (components outside .claude-plugin/)
- Link to official Anthropic docs: code.claude.com/docs/en/plugins

Community Marketplaces subsection (line 7246):
- wshobson/agents: 67 plugins, 99 agents, 107 skills
- claude-plugins.dev: 11,989 plugins, 63,065 skills indexed
- Popular plugins: Context7 (~72k), Ralph Wiggum (~57k)
- awesome-claude-code: 20k+ stars curated list

Resource evaluation: Nick Jensen article rejected (outdated stats)
- Primary sources integrated instead of blog post

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-24 18:32:37 +01:00
Florian BRUNIAUX
873aade097 docs: add Claude Reflect System + skill lifecycle documentation 
- Claude Reflect System: Automatic skill improvement via feedback analysis
- 8-step workflow: Monitor → Parse → Classify → Propose → Review → Backup → Apply → Commit
- Safety features: User review gate, Git backups, syntax validation, locking
- Security warnings: Feedback poisoning, memory poisoning, prompt injection mitigations
- YAML index: 10 new skill lifecycle entries (lines 113-123)
- Resource evaluation: Self-improve skill pattern (redirected to proven alternative)
- Landing sync history: v3.11.5 → v3.11.6

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-24 17:49:37 +01:00
Florian BRUNIAUX
ee5791668a docs: add SE-CoVe plugin example + resource evaluation workflow (v3.11.6) 
- First plugin example: SE-CoVe (Chain-of-Verification, Meta AI ACL 2024)
- Academic approach: cite paper metrics, not marketing claims
- Performance table: +23-112% accuracy (task-dependent, trade-offs disclosed)
- Resource evaluation template established (Perplexity fact-check workflow)
- Curation policy: Academic validation + Claims verified + Costs transparent
- Templates count: 82 → 83
- Architecture diagram added (visual overview of Claude Code internals)

Files:
- examples/plugins/se-cove.md (new plugin documentation)
- claudedocs/resource-evaluations/2026-01-24-se-cove-plugin.md (evaluation report)
- README.md, CHANGELOG.md, VERSION, reference.yaml (version bump 3.11.5 → 3.11.6)
- guide/architecture.md + image (visual overview)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-24 17:40:54 +01:00
Florian BRUNIAUX
f7e1254b06 docs: enrich Remotion quickstart with curated resources 
Add comprehensive "Resources Complémentaires" section (115 lines):
- Top 3 essentials (Official Resources, Fireship, Discord)
- Written tutorials by level (ClipCat, Prismic, SitePoint)
- Video tutorials by objective (beginner, deep-dive, Claude Code)
- Templates & examples (Hello World, Audiogram, GitHub Unwrapped)
- Success stories ($5M ARR Icon.me, $1M ARR Revid.ai)
- Community support (Discord 5.6K+ members, bot AI)
- Advanced resources (performance, AI skills, deployment)
- Useful packages (@remotion/shapes, transitions, subtitle)
- 3-week learning roadmap (fundamentals → practice → production)

Research source: Perplexity Pro (50+ URLs verified, 95% confidence)

Rationale: Users requested learning resources. Now have complete
learning path from installation to production.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-24 16:09:40 +01:00
Florian BRUNIAUX
341d1b1c01 docs: add Remotion skills + quickstart tutorial 
- Add remotion-best-practices to skills.sh table (line 5202)
- Create comprehensive Remotion + Claude Code quickstart tutorial
  - 15-min setup guide for first video
  - Step-by-step: install → preview → render → iterate
  - Troubleshooting section
  - Example prompts and use cases
  - Success metrics ($5M-8M ARR products)

Rationale: Post fact-check (80+ sources), Remotion validated as
legitimate tool (27K GitHub stars, verified success stories).
Score upgraded from 2/5 → 3/5 (Moderate).

Tutorial location: examples/workflows/remotion-quickstart.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-24 10:55:39 +01:00
Florian BRUNIAUX
61eec21b80 docs: add resource evaluation system documentation 
- Document claudedocs/resource-evaluations/ structure in CLAUDE.md
- Establish scoring methodology (1-5 scale) for external resources
- Create process: analysis → scoring → challenge → decision
- First evaluation: Remotion + Claude Code (2/5, rejected)

Rationale: Systematic tracking of evaluated resources prevents
duplicate analysis and provides audit trail for integration decisions.

Files remain local (claudedocs/ is gitignored).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-23 18:30:39 +01:00
Florian BRUNIAUX
89eefea8ac docs: add skills.sh marketplace documentation (v3.11.5) 
Added comprehensive documentation for skills.sh (Vercel Labs) marketplace:

Section 5.5 (Skills Marketplace):
- Installation instructions (npx add-skill <owner/repo>)
- Top skills by category (Frontend, Database, Auth, Testing)
- Format compatibility (100% compatible with .claude/skills/)
- Status & trade-offs (community project, early stage)

Section 11.3 (Skills Distribution Platforms):
- Comparison: skills.sh vs claude-code-templates vs SkillsMP
- When to use each platform (discovery, installation, team-specific)

Updated files:
- guide/ultimate-guide.md: New subsection Skills Marketplace (~line 5172)
- guide/ai-ecosystem.md: New section 11.3 Skills Distribution Platforms
- machine-readable/reference.yaml: Added 7 skills_marketplace_* entries
- README.md: Added skills.sh to Complementary Resources table
- CHANGELOG.md: Detailed entry for v3.11.5
- VERSION: Bumped to 3.11.5
- guide/cheatsheet.md: Version sync

Marketplace stats (Jan 23, 2026):
- 200+ skills available
- Top skill: vercel-react-best-practices (35K+ installs)
- 20+ agents supported (Claude Code, Cursor, Copilot, etc.)
- Launched: January 21, 2026 by Vercel Labs

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-23 18:21:15 +01:00