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

143 commits

This branch
This branch
All branches
Author SHA1 Message Date
Florian BRUNIAUX
be91799dcf feat: add cc-copilot-bridge reference in examples 
- Created multi-provider/ directory with redirect to dedicated repo
- Added cc-copilot-bridge in examples index table
- Added Multi-Provider Bridge section with link to github.com/FlorianBruniaux/cc-copilot-bridge

Related: github.com/FlorianBruniaux/cc-copilot-bridge v1.2.0

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-01-22 11:25:40 +01:00
Florian BRUNIAUX
222a2ed39c feat(guide): add Pencil (IDE-native canvas) to Product Designer workflow 
Add comprehensive documentation for Pencil, a new IDE-native design canvas tool launched January 2026.

Changes:
- guide/ultimate-guide.md (Wireframing Tools section):
  - Added Pencil to tools comparison table (after tldraw)
  - Added detailed description with features, founder info, disclaimer
  - Note: Launched Jan 2026, strong traction (1M+ views, a16z funded) but still maturing

- guide/workflows/design-to-code.md:
  - NEW section "Alternative: Pencil (IDE-Native Canvas)" (~115 lines)
  - Architecture explanation (WebGL + AI agents + Git-native)
  - Comparison table: Pencil vs Figma MCP
  - When to use (good fit / consider carefully)
  - Setup instructions + example prompt
  - Founder & backing details (Tom Krcha, ex-Adobe XD, a16z Speedrun)
  - Maturity note with recommendations

- machine-readable/reference.yaml:
  - Added 3 entries: pencil_canvas, pencil_workflow, pencil_vs_figma

Positioning:
- Pencil complements Figma MCP (not replaces)
- Target: Engineer-designers, code-centric teams on Cursor/VSCode/Claude Code
- Format: .pen JSON (open, git-versionnable)
- AI agents: Multiplayer parallel (unique feature)
- MCP: Bi-directional read+write (vs Figma read-only)

Status: Early but promising (score 3.5/5)
- Strong founder (Adobe XD co-creator, 2 exits)
- Solid funding (a16z + KAYA VC)
- Viral traction (1M+ views, FAANG signups)
- Currently FREE, pricing TBD

Disclaimers included for maturity/pricing uncertainty.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-22 10:16:20 +01:00
Florian BRUNIAUX
f6c98851e9 chore: sync version to 3.11.0 across all docs 
- README.md: pre-v3.10.0 → pre-v3.11.0
- guide/cheatsheet.md: version references updated
- guide/ultimate-guide.md: version references updated
- machine-readable/reference.yaml: version updated

Run via: ./scripts/sync-version.sh
 2026-01-22 09:41:52 +01:00
Florian BRUNIAUX
8c93c31b90 feat(guide): add Product Designer learning path and design-to-code workflow 
Add comprehensive resources for Product Designers working with Claude Code via Figma MCP:

- New workflow: guide/workflows/design-to-code.md (700 lines)
  - Documented metrics: 62% reduction in design inconsistencies, 78% workflow efficiency improvement
  - 4 core workflows: Frame→Component, Design System Audit, Token Automation, Visual Iteration
  - 3-tier token hierarchy (base/composite/semantic)
  - Team adoption patterns for designers, developers, PMs
  - Implementation roadmap (Foundation → Scaling → Orchestration)
  - Sources: builder.io, parallelhq.com, composio.dev, vladimirsiedykh.com

- New template: examples/claude-md/product-designer.md (400 lines)
  - Complete CLAUDE.md configuration for design-to-code projects
  - Figma MCP commands reference
  - Design handoff checklist
  - Token conventions and implementation constraints

- Updated README.md: Added "Product Designer" learning path (5 steps)
  - Positioned after DevOps/SRE, before main content
  - Links to image analysis, wireframing, Figma MCP, new workflow, cheatsheet

- Updated machine-readable/reference.yaml: Added 4 new entries
  - product_designer_workflow, product_designer_claudemd
  - design_system_handoff, figma_make_integration

Templates count: 72 → 73 (examples/claude-md/product-designer.md)
Guide workflows: 6 → 7 (guide/workflows/design-to-code.md)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-22 09:15:16 +01:00
Florian BRUNIAUX
01f35bf8b7 docs: sync templates count to 74 (includes config templates) 2026-01-21 14:23:01 +01:00
Florian BRUNIAUX
bcc0b59dd8 chore: release v3.11.0 - Design Patterns Analyzer skill 2026-01-21 14:04:12 +01:00
Florian BRUNIAUX
53d5d92c72 docs: update CHANGELOG and reference.yaml for design-patterns skill 
- CHANGELOG.md: Added detailed entry in [Unreleased] section
  - 9 files, 5,690 lines comprehensive GoF analyzer
  - 3 operating modes, 23 patterns, 8 stacks support
  - Template count 65 → 66
  - Tested on Méthode Aristote codebase results

- machine-readable/reference.yaml: Added design_patterns_skill entries
  - Line number reference (4799)
  - Location, modes, patterns count, supported stacks
  - Updated community_skills line numbers (4788→4947, 4871→5030)

Completes design-patterns skill documentation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 13:50:51 +01:00
Florian BRUNIAUX
fcc6f2dba3 feat(skills): add design-patterns analyzer skill 
Comprehensive GoF design patterns analyzer with stack-aware suggestions.

**Features**:
- Detects 23 GoF patterns (Creational, Structural, Behavioral)
- Stack detection (React, Angular, NestJS, Vue, Express, RxJS, Redux, ORMs)
- Code smell detection with pattern suggestions
- Quality evaluation (5 criteria scoring)
- Prefers stack-native alternatives (e.g., React Context over Singleton)

**Structure**:
- 9 files: SKILL.md + reference docs + detection rules + evaluation checklists
- 3 operating modes: Detection, Suggestion, Evaluation
- Pattern-specific documentation for all 23 GoF patterns

**Documentation**:
- Added comprehensive example in guide section 5.4
- Updated examples/README.md with skill entry
- Updated template count: 65 → 66

**Use cases**:
- Analyze existing patterns in codebase
- Suggest refactoring with stack-native patterns
- Evaluate pattern implementation quality

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 13:46:20 +01:00
Florian BRUNIAUX
936f8dd564 feat(guide): add Section 9.18 - Codebase Design for Agent Productivity 
Based on Agent Experience Best Practices by François Zaninotto (Marmelab).
Covers domain knowledge, code discoverability, testing for agents, guardrails.

- Add ~1809 lines to Section 9 (10 subsections)
- Enrich Section 3.1 with domain knowledge patterns
- Add Codebase Pitfalls to Section 9.11
- Bump version 3.9.11 → 3.10.0
- Guide grew from 11,560 to 13,425 lines (+16.1%)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 13:37:35 +01:00
Florian BRUNIAUX
16d484a50f feat: add maintenance slash commands for release management 
Commands added:
- /update-infos-release [bump-type]: Automate CC releases tracking + version bump
- /version: Display guide & CC versions with content stats
- /changelog [count]: View recent CHANGELOG entries
- /sync: Check guide/landing synchronization status

Workflow automation:
- Claude Code releases tracking (YAML + MD + Landing badge)
- Guide version management (VERSION + sync all docs)
- CHANGELOG updates
- Landing site sync verification
- Git commit/push to both repositories

Files:
- .claude/commands/update-infos-release.md: Full release workflow
- .claude/commands/version.md: Version info display
- .claude/commands/changelog.md: CHANGELOG viewer
- .claude/commands/sync.md: Sync check with actionable fixes
- .gitignore: Allow .claude/commands/ while ignoring other .claude/ config
- CLAUDE.md: Document new maintenance commands

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:41:24 +01:00
Florian BRUNIAUX
788493402f docs: update Claude Code releases to v2.1.14 
- Update latest tracked version: v2.1.12 → v2.1.14
- Add v2.1.14 highlights: history-based autocomplete, plugin search, SHA pinning
- Fix context window blocking limit and memory leak fixes
- Update dates: 2026-01-21

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:35:34 +01:00
Florian BRUNIAUX
868d3513b2 feat(guide): add Production Safety Rules (v3.9.11) 
Add comprehensive production safety guide for teams deploying Claude Code in production environments with 6 critical rules:

- Port Stability: Prevent accidental port changes breaking configs
- Database Safety: Backup enforcement via PreToolUse hooks
- Feature Completeness: No TODOs for core functionality
- Infrastructure Lock: Protect docker-compose, Dockerfile, terraform
- Dependency Safety: Block unapproved npm packages
- Pattern Following: Enforce codebase conventions

Adapted from community "10 non-negotiable CLAUDE.md rules" (6/10 integrated, 4/10 already covered). Verified gaps using grepai searches. Target audience: 20% production teams.

Cross-references added in ultimate-guide.md (section 3.1) and adoption-approaches.md (Medium/Large teams).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:23:50 +01:00
Florian BRUNIAUX
95eca423a2 feat(cheatsheet): add printable PDF version (2-column layout) 
- 2-column A4 layout optimized for print
- Light theme with indigo accent (print-safe colors)
- Visual components matching web design:
  * Context bar (4 zones: green/yellow/orange/red)
  * Do-dont grid comparison boxes
  * Golden rules with numbered badges
- Anti-orphan corrections (titles stick with content)
- Generated from Quarto/Typst template in whitepapers/

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 11:05:34 +01:00
Florian BRUNIAUX
5b15f25eb2 docs(guide): add Section 9.17 - Multi-Instance Workflows 
- Add comprehensive multi-instance orchestration guide (391 lines)
- Document Boris Cherny case study (259 PRs/30 days)
- Include Anthropic study metrics (132 engineers, +50% productivity)
- Add decision matrix, cost analysis, implementation phases
- Update reference.yaml with 10 new entries
- Fix table of contents (add 9.12-9.17)
- Bump version to 3.9.10

Sources:
- InfoQ: Claude Code Creator Workflow (2026-01-09)
- Anthropic Research: How AI is Transforming Work (2025-08)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 10:45:03 +01:00
Florian BRUNIAUX
6703e4b6a4 docs: update CHANGELOG and fix template count (69→65) 
Changes:
- CHANGELOG.md: Document cross-reference addition and template count fix
- README.md: Correct template count from 69 to 65 (badge, summary, table)
- CLAUDE.md: Update version reference (3.9.7 → 3.9.9)

Template count verification:
- Actual count: 65 templates in examples/ (excluding README.md files)
- Previous count of 69 was overcounted by 4 templates since v3.9.9

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-21 10:02:38 +01:00
Florian BRUNIAUX
00df38d318 feat: add DevOps & SRE Guide with FIRE Framework (v3.9.9) 
New files:
- guide/devops-sre.md: FIRE Framework for infrastructure diagnosis (~870 lines)
- examples/agents/devops-sre.md: DevOps/SRE agent persona
- examples/claude-md/devops-sre.md: CLAUDE.md template for infra projects

Guide includes:
- Kubernetes troubleshooting prompts by symptom
- Solo incident response workflow (3 AM design)
- IaC patterns (Terraform, Ansible, GitOps)
- Claude limitations table (transparency)
- Team adoption checklist

Updated:
- README.md: Added DevOps/SRE learning path, templates count → 69
- ultimate-guide.md: Added reference after Section 5.4
- reference.yaml: Added 11 DevOps/SRE entries
- examples/README.md: Added to indexes

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-20 22:09:31 +01:00
Florian BRUNIAUX
83a62ffb5d feat: integrate AI Coding Agents Matrix (v3.9.8) 
- Add Section 11 in guide/ai-ecosystem.md (~60 lines)
  - Interactive comparison of 23 AI coding agents
  - Complementarity table (Discovery vs Mastery)
  - Interactive features, limitations, positioning
- Enhance machine-readable/reference.yaml
  - Add maintainers (Cédric Teyton, Arthur Magne)
  - Add license (Apache-2.0), tech stack, features
  - Add positioning note and freshness warning
- Update README.md ecosystem section
  - Convert to comparison table (4 projects)
  - Add dedicated paragraph for Matrix
- Bump version 3.9.7 → 3.9.8
- Sync versions across all files

Cross-promotion with coding-agents-matrix.dev (Packmind)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 21:03:12 +01:00
Florian BRUNIAUX
dc0a3e1f27 docs: add cross-reference to Claude Cowork Guide 
- Add 'Not a Developer?' section after author info
- Link to Claude Cowork Guide for non-technical users
- Improves ecosystem discovery and audience routing

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 15:24:20 +01:00
Florian BRUNIAUX
207a018da5 docs: update CHANGELOG for AI Coding Agents Matrix addition 2026-01-20 15:08:43 +01:00
Florian BRUNIAUX
eee6a5a20a docs: add AI Coding Agents Matrix reference to ecosystem section 
Add link to coding-agents-matrix.dev in ai-ecosystem.md and reference.yaml.

This external resource provides a technical comparison of Claude Code vs 22+
alternatives across MCP support, Skills, Commands, Subagents, and Plan Mode.

Minimal integration (1-line note) to acknowledge the ecosystem without
diluting our focus on Claude Code mastery.
 2026-01-20 15:00:39 +01:00
Florian BRUNIAUX
ffe8d782fd fix: sync CLAUDE.md version reference with VERSION file 
- Update version reference from 3.8.2 to 3.9.7 in CLAUDE.md
- Aligns with VERSION file which was already at 3.9.7
- Removes accidental marketing document from version control

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 14:01:53 +01:00
Florian BRUNIAUX
af6f56d618 docs: document complete 4-repo ecosystem architecture 
- Add ecosystem section to CLAUDE.md with architecture diagram
- Add landing sites table to README.md ecosystem section
- Add landing_sites section to reference.yaml with sync history
- Document bidirectional cross-links and sync triggers
- Include migration history and commit references

Ecosystem:
- Claude Code Guide (this repo) → devs
- Claude Cowork Guide (dedicated) → knowledge workers
- Code Landing (vitrine) → discovery
- Cowork Landing (vitrine) → discovery

Architecture: 2 source repos + 2 landing sites, synchronized

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 12:57:48 +01:00
Florian BRUNIAUX
9a29ba4e8d chore: remove cowork folder after migration to dedicated repo 
- Update all internal links to point to GitHub repo
- Remove cowork/ directory (35 files migrated)
- Add migration notice to guide/cowork.md summary
- Update machine-readable/reference.yaml with GitHub URLs
- Keep machine-readable/cowork-reference.yaml as index (not in cowork/)

Dedicated repo: https://github.com/FlorianBruniaux/claude-cowork-guide
Refs: 9a743cd (README update), 7a686a8 (cowork v1.0.0)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 12:16:32 +01:00
Florian BRUNIAUX
9a743cd5ae docs: update Cowork section to point to dedicated repository 
- Replace detailed documentation table with prominent link
- Add quick access table to new repo
- Keep local copy note for cloned users
- New repo: https://github.com/FlorianBruniaux/claude-cowork-guide
 2026-01-20 12:02:20 +01:00
Florian BRUNIAUX
43252306e4 docs: v3.9.7 - OpusPlan workflow documentation 
- CHANGELOG: Add 3.9.7 entry for CLAUDE.md Model Configuration
- Sync version numbers across cheatsheet and ultimate-guide
- OpusPlan hybrid workflow (Opus plan → Sonnet execute)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:56:12 +01:00
Florian BRUNIAUX
84112237e8 docs(claude): add model configuration recommendations 
- Add recommended /model opusplan configuration
- Document hybrid planning workflow (Opus plan + Sonnet execute)
- Include task breakdown table with model justifications
- Add cost optimization rationale

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:52:21 +01:00
Florian BRUNIAUX
014b4ad0b3 docs(cowork): prepare for standalone repository (Option C) 
Phase 2: Improvements + migration preparation completed

## README.md Enhanced
- Add badges (Stars, Prompts 60+, Workflows 5, Version 1.0.0)
- Add 3 Learning Paths (Knowledge Worker, PM/Executive, Power User)
- Add 7 Golden Rules (Cowork-specific safety practices)
- Add 6 collapsible sections (reduce visual density)
- Add About section (Origins, Privacy, Limitations, Future Roadmap)
- Harmonize footer (version + date + attribution)

## Independence Files Created
- VERSION: 1.0.0 source of truth
- CHANGELOG.md: Complete v1.0.0 history
- CONTRIBUTING.md: Contribution guidelines for Cowork

## Interactive Onboarding
- tools/cowork-onboarding.md: Personalized learning experience
- Command: Fetch and follow from GitHub raw URL
- Features: 3-question profiling, loads cowork-reference.yaml
- 5 goals: organize_files, create_documents, extract_data, research, learn_everything
- Depth control: deeper/next/skip/reset
- Multilingual: EN/FR/ES support

## Maintenance Scripts (3 executable)
- scripts/check-version-sync.sh: Verify VERSION synchronized
- scripts/sync-version.sh: Auto-sync VERSION across files
- scripts/update-stats.sh: Update prompts/workflows counts

## GitHub Templates Structure
- .github/ISSUE_TEMPLATE/bug_report.md
- .github/ISSUE_TEMPLATE/feature_request.md
- .github/ISSUE_TEMPLATE/workflow_contribution.md
- .github/ISSUE_TEMPLATE/config.yml
- .github/PULL_REQUEST_TEMPLATE.md
- .github/README.md: Contributor guide

## Updated MANIFEST.yaml
- Add root, tools, scripts, github sections
- Update metadata: total_files: 34, total_prompts: 67, total_workflows: 5
- License: CC-BY-SA-4.0
- Last updated: 2026-01-20

## Statistics
- Total files: 34 markdown + 3 scripts + YAML files
- Total documentation: ~15K lines
- 67 prompts, 5 workflows, 6 guides
- Version: 1.0.0

Ready for:
- Immediate use in current repo
- Future migration to claude-cowork-guide repository
- Community contributions (GitHub templates)
- Autonomous maintenance (scripts)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:46:56 +01:00
Florian BRUNIAUX
c2de35caba docs: complete Cowork documentation v1.0 (Phase 2) 
- Create comprehensive Cowork docs (23 files in cowork/)
  - 6 guides: overview, getting started, capabilities, security, troubleshooting
  - 60+ ready-to-use prompts across 4 categories
  - 5 step-by-step workflows
  - Reference materials: cheatsheet, FAQ, comparison, glossary

- Integrate Perplexity research (P0/P1/P2)
  - Exact error messages with solutions (VPN, Chrome host, context limits)
  - Competitive analysis (vs Copilot/Gemini/ChatGPT/Apple Intelligence)
  - Enterprise validation (TELUS, Rakuten, Zapier stats)
  - OCR accuracy benchmarks (97% field, 63% line-item)
  - Token budget planning per task type

- Document critical limitations
  - VPN incompatibility (#1 community issue)
  - Context limit reality (165K vs 200K theoretical)
  - Platform constraints (macOS only)
  - Usage limits and pricing (Pro $20, Max $100-200)

- Update central files
  - README.md: detailed Cowork section with tables
  - VERSION: 3.9.6 → 3.9.7
  - machine-readable/reference.yaml: add cowork_reference entry
  - machine-readable/cowork-reference.yaml: new LLM-optimized index (~1.5K tokens)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-20 11:23:43 +01:00
Florian BRUNIAUX
360e5203f6 feat: add Voice-to-Text section and voice-refine skill 
- Add section 5 "Voice-to-Text Tools" to ai-ecosystem.md
  - Tool comparison (Wispr Flow, Superwhisper, MacWhisper)
  - Vibe Coding workflow and trade-offs
  - Recommendations by user profile
- Create voice-refine skill in examples/skills/
  - Transforms verbose voice input into structured prompts
  - 4-step pipeline: Dedupe → Extract → Structure → Compress
  - Before/after examples with ~3.3x compression ratio
- Update reference.yaml with new entries and corrected line numbers
  - ai_ecosystem_voice_to_text: line 449
  - voice_refine_skill: new skill reference
  - cowork_section: 701 → 760
  - alternative_providers: 902 → 959

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-20 10:11:03 +01:00
Florian BRUNIAUX
09eb141976 docs: v3.9.6 - Trust Calibration, Vibe Coding Trap, reference.yaml sync 
Added:
- ultimate-guide.md: Trust Calibration section (1.7) with research-backed verification strategies
- ultimate-guide.md: Infrastructure as Code Skills (Anton Babenko's terraform-skill)
- learning-with-ai.md: "The Vibe Coding Trap" anti-pattern (Karpathy, Feb 2025)
- learning-with-ai.md: "Reality of AI Productivity" section with research
- learning-with-ai.md: External resource link to leerob.com/ai (AI fundamentals)
- IDEAS.md: "Vibe Coding Discourse" watching entry

Changed:
- reference.yaml: Complete line number synchronization (~55 entries)
  Guide grew from ~9900 to 11154 lines; all deep_dive references updated
- Version bump: 3.9.5 → 3.9.6

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-20 08:36:35 +01:00
Florian BRUNIAUX
fd17414abb docs: add AI productivity research, trust calibration, and exploration workflow 
## New Content

### Trust & Verification (ultimate-guide.md)
- Section 1.7 "Trust Calibration: When and How Much to Verify" (~155 lines)
  - Research-backed stats (ACM, Veracode, CodeRabbit, Cortex.io)
  - Verification spectrum by code type
  - Solo vs Team strategies with workflow diagrams
  - "Prove It Works" checklist
- New pitfall: "Trust AI output without proportional verification"
- CLAUDE.md size guideline: 4-8KB optimal, >16K degrades coherence

### AI Productivity (learning-with-ai.md)
- Section "The Reality of AI Productivity" (~55 lines)
  - Productivity curve phases (Wow Effect → Targeted Gains → Plateau)
  - High-gain vs low/negative-gain task categorization
  - Team success factors
- Productivity trajectory table by pattern (Dependent/Avoidant/Augmented)
- 5 new sources (GitHub, McKinsey, Stack Overflow, Uplevel, DORA)

### Session Limits (architecture.md)
- "Session Degradation Limits" section
  - Turn limits (15-25), token thresholds (80-100K)
  - Success rates by scope (1-3 files: ~85%, 8+ files: ~40%)

### Exploration Workflow
- NEW: guide/workflows/exploration-workflow.md
  - Anti-anchoring prompts, 3-5 approaches pattern
- iterative-refinement.md: Script Generation Workflow (3-7 iteration pattern)
- anchor-catalog.md: Anti-Anchoring Techniques, Exploration/Iteration Prompts

### Reference Updates
- adoption-approaches.md: Empirical data section
- reference.yaml: New deep_dive entries, updated line numbers

Sources: MetalBear engineering blog, arXiv studies, Addy Osmani (Jan 2026)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 19:16:33 +01:00
Florian BRUNIAUX
a9d302326c docs: refactor README for better scannability (761 → 326 lines) 
- Remove "Lines: 11,100+" badge (intimidating)
- Merge TL;DR + Get Started into Quick Start section
- Condense "Why This Guide" to 7 lines (remove comparison table)
- Move Learning Paths before What's Inside (user identifies first)
- Restructure What's Inside with 6 collapsibles
- Simplify Golden Rules to 5 bullets (move Context % table to cheatsheet)
- Consolidate About section into 4 collapsibles
- Remove redundant sections: Choose Your Path, Guide Navigation, What Makes Different

Context % thresholds table moved to guide/cheatsheet.md#context-thresholds

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 19:11:56 +01:00
Florian BRUNIAUX
3968c13aa2 docs: sync README badges + fix template count methodology 
- Update Lines badge: 10,900+ → 11,100+ (Trust Calibration section added)
- Update Templates badge: 65 → 61 (exclude README/index files)
- Update Commands: 15 → 18 (add /learn:teach, /learn:quiz, /learn:alternatives)
- Fix check-landing-sync.sh: exclude README.md and index.md from template count
- Restructure README: move Privacy/Community to bottom, remove newsletter callout

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 17:41:56 +01:00
Florian BRUNIAUX
db322b8370 chore: ignore .mcp.json (local MCP config) 2026-01-19 16:44:46 +01:00
Florian BRUNIAUX
9c2ce7ccce docs: add IDEAS.md Watching section + README restructure (v3.9.5) 
- Add "Watching (Waiting for Demand)" section to IDEAS.md
  - Track Multi-LLM Consultation Patterns research
  - Criteria: implement if 3+ requests
- Restructure README.md (~40% cognitive load reduction)
  - Collapsible ToC with 4 learning paths
  - Remove duplicate "5 Rules" section
- Version bump to 3.9.5

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 16:43:20 +01:00
Florian BRUNIAUX
3bc38ef982 docs: add Session Teleportation documentation (v3.9.4) 
- Add Section 9.16 Session Teleportation in ultimate-guide.md (~105 lines)
  - Evolution timeline (2.0.24 → 2.1.0)
  - Commands: %, &, --teleport, /teleport, /tasks, /remote-env, Ctrl+B
  - Prerequisites, limitations, environment support matrix
- Update cheatsheet.md with new commands and shortcuts
- Update reference.yaml with new entries and line numbers
- Add cowork.md (collaboration guidance)
- Bump version to 3.9.4

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 15:35:24 +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
001310bf67 docs: add Perplexity/Claude Code complementarity diagrams 
- Add Mermaid diagram showing domain separation (research vs implementation)
- Add decision flow diagram for tool selection
- Key insight: Perplexity = "what to build", Claude Code = "how to build it"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 11:59:58 +01:00
Florian BRUNIAUX
e822452000 feat(guide): add AI Ecosystem section for complementary tools (v3.9.1) 
New Section 11 documenting tool complementarity with Claude Code:
- guide/ai-ecosystem.md (752 lines): detailed guide covering Perplexity,
  Gemini, Kimi, NotebookLM, IDE tools, and UI prototypers
- Section 11 in ultimate-guide.md (~250 lines): condensed version with
  practical workflows and integration patterns
- 4 workflow pipelines: Research→Code, Visual→Code, Documentation, Presentation
- Ready-to-use prompts and cost optimization strategies

Also includes: mobile-access.md enhancements from [Unreleased]

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 11:25:36 +01:00
Florian BRUNIAUX
dab11d260c feat: reorganize learning commands under /learn namespace 
- Move quiz.md → learn/quiz.md (/learn:quiz)
- Add learn/teach.md (/learn:teach) for step-by-step concept explanations
- Add learn/alternatives.md (/learn:alternatives) for approach comparisons
- Update all references in guide, README, and reference.yaml

Follows Claude Code namespaced commands convention:
/namespace:command → .claude/commands/namespace/command.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 11:13:54 +01:00
Florian BRUNIAUX
e7e1de7ad5 docs: add Pattern Amplification callout to mental model section 
Explains that Claude mirrors codebase patterns - good structure yields
good suggestions, messy code perpetuates mess. Bridges "What Claude
Doesn't Know" to "Communicating Effectively" with actionable guidance.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 11:03:33 +01:00
Florian BRUNIAUX
876f92fad5 docs: add behavior category to breaking_summary 
ultrathink/think keywords now cosmetic only since v2.0.67
(thinking enabled by default with Opus 4.5)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 10:18:25 +01:00
Florian BRUNIAUX
43d2aeae22 fix: correct templates count 62→63 and lines badge 10,300→10,500 
- README.md: badges updated to reflect actual counts
- CHANGELOG.md: v3.9.0 stats corrected
- anchor-catalog.md was the 63rd template (already documented in CHANGELOG)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 09:22:29 +01:00
Florian BRUNIAUX
b05ce81e66 docs: improve CLAUDE.md section structure & clarifications 
- Restructure section 3.1: move MVP CLAUDE.md before Level 1/2/3 examples
- Replace unverified "90% of projects" claim with "most projects"
- Add Skills/Commands unification note to Section 6 (matching Section 5)
- Add cross-references between Memory Loading and Token Cost sections
- Clarify Monorepo CLAUDE.md merge/conflict resolution behavior
- Clarify Path-specific rules glob matching syntax

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 09:14:06 +01:00
Florian BRUNIAUX
7a6d369512 docs: add subscription plans section & semantic anchors 
- Add "Subscription Plans & Limits" section (line 1750)
  - Concepts: message windows, hybrid counting, weekly caps
  - Tier-specific strategies (no volatile numbers)
  - Links to official pricing page
- Add Semantic Anchors section (2.7) with anchor catalog
- Fix drifted line numbers in reference.yaml
- Add 6 new slash commands (catchup, security, refactor, etc.)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 09:06:39 +01:00
Florian BRUNIAUX
a5f441bcea feat: add ecosystem positioning, install script & new commands 
Ecosystem & Positioning:
- Add README section with competitive positioning (davila7, awesome-claude-code, wesammustafa)
- Add comparison table highlighting unique features (architecture, TDD/SDD, quiz, YAML index)
- Add ecosystem section to reference.yaml

Template Installation:
- Add scripts/install-templates.sh for one-liner template installation
- Support for agents, hooks, commands, skills, memory templates

New Commands:
- catchup, explain, optimize, refactor, security, ship

New Content:
- Semantic anchors catalog and documentation
- Extended guide content (+470 lines)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-19 08:42:33 +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
d3f3db0d14 fix(sync): distinguish guide version from Claude Code version in check 
The previous regex matched any 'vX.Y.Z' pattern, capturing 'Claude Code v2.1.12'
instead of the guide version. Now specifically looks for 'Version X.Y.Z' pattern.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-18 18:10:24 +01:00
Florian BRUNIAUX
0348f08288 feat: add Claude Code releases tracking 
Add condensed release history for Claude Code product (v2.0.24 → v2.1.12)

New files:
- machine-readable/claude-code-releases.yaml: Source of truth (YAML)
- guide/claude-code-releases.md: Human-readable changelog
- scripts/update-cc-releases.sh: Check for new releases from GitHub

Modified:
- reference.yaml: Add deep_dive entries for releases
- check-landing-sync.sh: Add CC version check (#5)
- README.md, guide/README.md: Add navigation links
- CLAUDE.md: Document update workflow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-18 11:33:21 +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