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

99 commits

Author SHA1 Message Date
Florian BRUNIAUX
2262d9e1f6 docs(cheatsheet): add /loop, /stats, /rename, /copy + Ctrl+F (v3.32.2) 
Cheatsheet updated with commands from Claude Code v2.1.59–v2.1.71:
- /loop [interval] [prompt] — recurring scheduler (bg polling while you work)
- /stats — usage graph, favorite model, streak
- /rename [name] — name/rename current session
- /copy — interactive picker for code blocks
- Ctrl+F — kill all background agents (double press)
- /loop added to "Features méconnues" section (v2.1.71)

Applied to both guide/cheatsheet.md and landing cheatsheet/index.astro.
Landing version synced: 3.29.2 → 3.32.2.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-09 10:44:06 +01:00
Florian BRUNIAUX
7bda706da2 feat(v3.32.0): Plan-Validate-Execute Pipeline — 3-command AI-first workflow 
New workflow for production teams: dynamic agent teams, ADR learning loop,
automated execution from PRD to merged PR.

Added:
- guide/workflows/plan-pipeline.md — complete workflow guide (philosophy,
  non-prescriptive AI-first, No Bandaids first principles, ADR learning loop,
  CLAUDE.md 120-line discipline, /clear context reset, cost profile)
- examples/commands/plan-start.md — 5-phase planning with 12-agent dynamic
  pool (trigger-based selection, Tier 0 Solo → Tier 4 Full Spectrum,
  planning-coordinator synthesis, auto-transition to validate)
- examples/commands/plan-validate.md — 2-layer validation (structural inline +
  8 specialist agents), ADR-aware auto-fix (Bucket A ~95% auto-resolve,
  Bucket B human input → new rule), issue persistence in metrics JSON
- examples/commands/plan-execute.md — worktree → TDD scaffold → level-based
  parallel agents → drift detection → quality gate → smoke test → PR squash
  merge → post-merge metrics → cleanup
- examples/agents/planning-coordinator.md — Opus synthesis agent: merges
  multi-agent reports into coherent task graph, resolves conflicts via ADR
  precedence, verifies plan completeness before output
- examples/agents/integration-reviewer.md — Opus runtime validator: connection
  params, async/sync consistency, env var completeness, library API
  correctness (WebFetch), OTEL pipeline validation

Updated:
- machine-readable/reference.yaml — 16 new indexed keys
- CHANGELOG.md — v3.32.0 entry with 6 detailed items
- VERSION, README.md, guide/cheatsheet.md, guide/ultimate-guide.md — bumped to 3.32.0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-06 17:24:26 +01:00
Florian BRUNIAUX
07c3c42b03 release: v3.31.0 — Skills 2.0 taxonomy, evals, lifecycle 
- §5.0 Two Kinds of Skills: Capability Uplift vs Encoded Preference
- §5.X Skill Lifecycle & Retirement: Catch Regressions + Spot Outgrowth
- §5.Y Skill Evals: Benchmark Mode, A/B Testing, Trigger Tuning
- Vitals + SE-CoVe community plugins documented (§8.5)
- Memory system: 3 corrections (Auto-Memories v2.1.59+, thresholds, WHAT/WHY/HOW)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-06 15:53:45 +01:00
Florian BRUNIAUX
a37f8b6aba docs(cheatsheet): update ultrathink note — re-introduced in v2.1.68 
ultrathink now forces high effort for next turn (no longer cosmetic).
Opus 4.6 defaults to medium effort since v2.1.68.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-05 18:16:50 +01:00
Florian BRUNIAUX
52d12a28b7 release: v3.30.2 — issue-triage skill, design-reference-file, Conductor docs 
New templates:
- examples/skills/issue-triage/ — 3-phase issue backlog management with
  Jaccard duplicate detection, risk classification, and validated actions
- examples/claude-md/design-reference-file.md — brand-book + ui-kit
  pattern for consistent UI generation across sessions

Resource evaluation:
- docs/resource-evaluations/075-paillard-design-system-first-website.md
  (Boris Paillard, mixt.care, score 3/5)

Docs update:
- guide/third-party-tools.md — Conductor section enriched with verified
  features (Next Workspace, Manual Mode, GitHub CI integration, BMAD pattern)

Version bump: 3.30.1 → 3.30.2 (synced across README, cheatsheet, guide, reference.yaml)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-05 16:18:24 +01:00
Florian BRUNIAUX
29e8b62679 docs: update Claude Code releases to v2.1.66 (v3.30.1) 
- Update latest tracked version: 2.1.63 → 2.1.66
- Add v2.1.66: reduced spurious error logging
- Add v2.1.63: HTTP hooks, worktree config sharing, /simplify & /batch, memory leaks wave
- Add v2.1.62/61: prompt cache + Windows config fixes
- Bump guide: 3.30.0 → 3.30.1
- Update 2.1.x series date range (January-March 2026)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-04 09:30:52 +01:00
Florian BRUNIAUX
d9187ba17b release: v3.30.0 - 10 advanced patterns documentation 
5 new files (plan-challenger, adr-writer, audit-codebase, first-principles, event-driven-agents),
4 workflow files enriched (iterative-refinement, agent-teams, ultimate-guide x3 sections),
reference.yaml updated with 9 new entries. Fact-checked via 9 Perplexity searches (March 2026).

Patterns covered: modular CLAUDE.md architecture, session invariants, auto-ADR, adversarial
plan review, worktree dependency coordination, auto-fix loops (Ralph Loop), Linear/Kanban
event-driven agents, codebase audit scoring, deployment automation (Vercel + Infisical).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-03 06:27:28 +01:00
Florian BRUNIAUX
01283fafec docs: SonnetPlan hack — budget Sonnet+Haiku hybrid via env var remap 
- guide/ultimate-guide.md §OpusPlan: new "Budget Variant: SonnetPlan"
  section with shell function, Plan/Act routing table, caveat on
  unreliable model self-report, link to GitHub issue #9749
- examples/scripts/sonnetplan.sh: new ready-to-use shell function
  with installation instructions and verification guidance

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-02 17:58:25 +01:00
Florian BRUNIAUX
2195622b50 release: v3.29.2 - /simplify + /batch commands documentation 
Added dedicated sections for the two bundled slash commands
introduced in Claude Code v2.1.63: /simplify (over-engineering
detection) and /batch (batch processing). Built-in Commands
table updated in §1.3 and §6.1.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-02 17:30:58 +01:00
Florian BRUNIAUX
252148fe75 release: v3.29.1 - Git MCP + GitHub MCP catalog entries 
Add Git MCP Server (12 tools, uvx setup) and GitHub MCP Server
(Issues/PRs/Projects, remote Copilot + self-hosted PAT-only) to §8.2
MCP Server Catalog. Document real-world fix for Incompatible auth
server error via gh auth token + manual header injection.

Also ships: CC v2.1.63 tracking, HTTP hooks, observability quality
patterns, config lifecycle §9.23, terminal personalization, tool
comparison table extensions, MCP server 3 new tools.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-02 16:10:19 +01:00
Florian BRUNIAUX
8e63d84b47 docs: factual audit + reference sync — 260 findings corrected 
Parallel 6-agent audit against official Anthropic docs (llms-full.txt).
Key corrections applied across permissions, hooks, MCP, security, privacy, reference.yaml.

Highlights:
- Fix MCP config path (~/.claude.json), mcpServers key, variable substitution syntax
- Fix permission modes (5 not 3), :* syntax (×6), Stop event description
- Fix hook JSON field names (hook_event_name, tool_name, tool_input, session_id)
- Fix filesystem restriction docs (permission rules, not settings.json keys)
- Fix data-privacy: 4-tier retention, /bug 5yr warning, ZDR conditions, 5 telemetry opt-out vars
- Add official llms.txt/llms-full.txt references to CLAUDE.md + machine-readable/llms.txt
- Reference.yaml: 375 entries re-synced (92% had wrong line numbers — guide grew 15K→21K lines)
- New script: scripts/resync-reference-yaml.py for automated line number sync
- Quiz: corrected answers for hooks (07), memory settings (03), MCP servers (08)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-26 12:10:14 +01:00
Florian BRUNIAUX
5e893f3ccd docs: add Remote Control (§9.22) — mobile access feature documentation 
- New section 9.22 in ultimate-guide.md with full Remote Control coverage
- Cheatsheet: dedicated section + Features Méconnues + slash commands
- security-hardening.md: Part 7 Remote Control Security threat model
- machine-readable/reference.yaml: /rc, /remote-control, /mobile, subcommand
- Resource evaluation: 2026-02-25 (score 4/5, community feedback included)

Key original content vs official Anthropic docs:
- Slash commands (/new, /compact) broken in remote UI — undocumented
- tmux multi-session workaround for 1-session limit
- Community security analysis (RCE surface, CISO implications)

Research Preview — Pro/Max plans only (v2.1.51+)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-25 18:45:41 +01:00
Florian BRUNIAUX
79157ac077 release: v3.29.0 
- Observability: MLflow Tracing section complète (CLI + SDK, LLM-as-judge)
- Skills §5.5: UI UX Pro Max (33.7k stars, design reasoning engine BM25)
- Diagram #41: AI Fluency High vs Low paths (Anthropic research)
- 3 callouts empiriques AI Fluency Index (Rev Engine 5.6×, CLAUDE.md 30%)
- Hooks docs v2.1.47-2.1.50: WorktreeCreate/Remove, ConfigChange, --from-pr
- CC releases tracking: v2.1.50 → v2.1.52
- 4 nouvelles évaluations ressources (AgentsView, AI Fluency, UX Pro Max)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-24 13:58:09 +01:00
Florian BRUNIAUX
dbb62306d7 release: v3.28.1 - Visual Diagrams Series (40 Mermaid diagrams) 
guide/diagrams/: new directory with 40 interactive Mermaid diagrams
- 10 thematic files: foundations, context/sessions, configuration,
  architecture, MCP ecosystem, dev workflows, multi-agent patterns,
  security/production, cost/optimization, adoption/learning
- Each diagram: Mermaid (GitHub-native) + ASCII fallback + source link
- Bold Guy palette (6-color system) consistent across all diagrams
- README with index, visual palette legend, navigation by use case

Also includes (backlog from v3.28.0→v3.28.1):
- guide/ultimate-guide.md: Managing Large MCP Server Sets, AI Code
  Disclosure Policy, claude-mem Gemini alternative, observability
- guide/workflows/plan-driven.md: Boris Tane custom markdown plans (+172L)
- guide/security-hardening.md: Part 4 PR security review workflow
- examples/agents/security-patcher.md: new security agent
- examples/hooks/bash/security-gate.sh: PreToolUse security hook
- guide/observability.md: activity monitoring, external tools, proxying
- docs/resource-evaluations/: 4 new evaluations (Boris Cherny, Moigneu,
  Boris Tane, Aristote AI instructions)
- README.md: Visual Diagrams section in "What Makes This Guide Unique"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-22 15:51:21 +01:00
Florian BRUNIAUX
6049bd99c2 release: v3.28.0 - Section 2.5 Model Selection & Thinking Guide 
Section canonique consolidée pour le choix de modèle :
- Section 2.5 (decision table, effort levels avec prompts, model-per-agent patterns, thinking guide)
- 3 nouveaux agents : planner (Opus), implementer (Haiku), architecture-reviewer (Opus)
- 7 nouvelles questions quiz (09-037→09-043, intermediate→power)
- 3 tables redondantes remplacées par cross-refs vers Section 2.5

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-21 18:25:50 +01:00
Florian BRUNIAUX
31802b61b1 release: v3.27.9 
- Update Claude Code releases tracking (v2.1.49 → v2.1.50)
- Cut versioned release for Talk Preparation Pipeline, AGENTS.md research,
  Profile-Based Module Assembly (Section 3.5), ATDD expansion,
  Spec-First Task Granularity, team-config templates, and Mergify case study

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-21 17:27:32 +01:00
Florian BRUNIAUX
9b75b5125e release: v3.27.8 - prompt-based GitHub Actions code review workflow 
New examples/github-actions/claude-code-review.yml with externalized prompt,
anti-hallucination protocol, /claude-review on-demand trigger. Templates 116→161.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-19 14:23:15 +01:00
Florian BRUNIAUX
267ce0ba86 chore: update guide content and add new examples 
- Update ultimate guide and cheatsheet
- Update llms.txt and reference YAML
- Add velocity-governor hook and cc-sessions script

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-18 18:48:19 +01:00
Florian BRUNIAUX
c3da456d3a release: v3.27.6 - Sonnet 4.6 default + 200K vs 1M context guide 
- Pricing table: Sonnet 4.6 now default (Feb 2026)
- New section: 200K vs 1M context decision guide (MRCR bench, cost table, use cases)
- threat-db.yaml v2.1.0: CVE-2026-23744, Slopsquatting T009, OWASP Agentic AI Top 10

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-18 09:33:55 +01:00
Florian BRUNIAUX
4b15bdb137 release: v3.27.5 - Claude Code v2.1.45 tracking 
- Bump guide: v3.27.4 → v3.27.5
- Update Claude Code releases: v2.1.44 → v2.1.45
  - Sonnet 4.6 model support
  - spinnerTipsOverride setting
  - SDK SDKRateLimitInfo/SDKRateLimitEvent types
  - Agent Teams fix on Bedrock/Vertex/Foundry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-02-17 21:12:53 +01:00
Florian BRUNIAUX
1f720f7d74 release: v3.27.4 - template count update + worktree docs 
- Templates 113 → 116 (review-plan, git-worktree-status/remove/clean, rules)
- Commands 23 → 26 (worktree lifecycle suite)
- Git worktree section expanded with lifecycle commands table
- Version sync across all docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-17 11:15:32 +01:00
Florian BRUNIAUX
4cf1bf3cec docs: v3.27.3 — track Claude Code v2.1.42 + Google Antigravity section 
- Claude Code releases: v2.1.41 → v2.1.42 (startup perf, prompt cache, Opus 4.6 effort callout)
- New AI ecosystem section: Google Antigravity agent-first IDE comparison
- Version sync across all docs (3.27.2 → 3.27.3)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 09:38:31 +01:00
Florian BRUNIAUX
0f4b1837c5 docs: v3.27.2 — YAML frontmatter on 90 markdown files 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:24:07 +01:00
Florian BRUNIAUX
ac9b07a837 docs(guide): add YAML frontmatter to 24 top-level guide files 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:20:31 +01:00
Florian BRUNIAUX
d1182af4cf docs: v3.27.1 — fact-check corrections, grepai docs, RTK overhaul 
Fact-check (README positioning):
- Template count: 120/123 → 108 (ground truth recount)
- Ratio: 14× → 24× (19,000 ÷ 784 = 24.2×)
- everything-cc stars: 31.9k → 45k+ (verified Feb 15)
- Commands count: 20 → 23, hooks: 30 → 31

Added:
- Grepai MCP documentation (semantic search, call graphs)
- 3 hook templates (rtk-baseline, session-summary, session-summary-config)
- 2 resource evaluations (system-prompts update, qmd token savings)

Changed:
- RTK documentation overhaul (v0.7.0 → v0.16.0, rtk-ai org)
- Exports deprecated (kimi.pdf, notebooklm.pdf → deprecated/)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 18:41:45 +01:00
Florian BRUNIAUX
d72905e9ba docs: integrate Entire CLI across guide (v3.27.0) 
Major integration of Entire CLI, an agent-native platform launched
Feb 2026 by Thomas Dohmke (ex-GitHub CEO) with $60M funding. Provides
rewindable checkpoints, approval gates, and audit trails for AI sessions.

## Added (7 guide files + 3 meta files)

- **ai-traceability.md**: Replace git-ai 404 with Entire CLI (section 5.1)
- **third-party-tools.md**: Fill "Session replay" gap + add tool section
- **observability.md**: Add session portability alternative
- **ai-ecosystem.md**: Add governance-first orchestration (section 8.1.5)
- **ultimate-guide.md**: Enrich multi-instance section 9.17
- **security-hardening.md**: Add compliance audit trails (section 3.4)
- **cheatsheet.md**: Add Community Tools quick reference
- **README.md**: Update structure tree with third-party-tools mention
- **CHANGELOG.md**: Document v3.27.0 release
- **docs/resource-evaluations/entire-cli.md**: Formal evaluation (5/5)

## Fixed

- git-ai references (404 repo) replaced with working alternative
- "Session replay" Known Gap now marked as ✅ FILLED

## Key Features Documented

- Rewindable checkpoints (prompts + reasoning + tool usage)
- Governance layer (approval gates, permissions, audit trails)
- Multi-agent handoffs (Claude → Gemini with context)
- Compliance-ready (SOC2, HIPAA, FedRAMP)
- Session portability (path-agnostic vs native --resume)

## Positioning

- vs git-ai: Replaces non-existent tool (404)
- vs claude-code-viewer: Active replay vs read-only history
- vs Gas Town: Governance sequential vs parallel coordination

Files modified: 10 (7 content + 3 meta)
Words added: ~2,500
Version: 3.26.0 → 3.27.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-12 23:33:16 +01:00
Florian BRUNIAUX
971a297db3 feat(security): add threat intelligence DB, security commands, and cheatsheet audit fixes (v3.26.0) 
- Add threat-db.yaml v2.0.0 with 63 malicious skills, 22 CVEs, 4 campaigns
- Add /security-check, /security-audit, /update-threat-db slash commands
- Add Snyk ToxicSkills evaluation (58th resource evaluation)
- Fix cheatsheet: add Alt+T to keyboard shortcuts table, add /fast and /debug commands
- Update Features Meconnues table with Agent Teams and Auto-Memories
- Clean up cheatsheet.md.bak
- Bump version to 3.26.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-11 16:12:36 +01:00
Florian BRUNIAUX
ef7cdd899e release: v3.24.0 - Agent Evaluation Framework 
Major addition: Complete agent evaluation framework with production-ready template.

## Added

- **Resource Evaluation**: nao framework (score 3/5)
  - Identified critical gap: agent evaluation not documented
  - Technical challenge adjusted score 2/5 → 3/5
  - All claims fact-checked (TypeScript 58.9%, Python 38.5%)

- **Guide Section**: Agent Evaluation (guide/agent-evaluation.md, ~3K tokens)
  - Metrics: response quality, tool usage, performance, satisfaction
  - Patterns: logging hooks, unit tests, A/B testing, feedback loops
  - Example: analytics agent with built-in metrics
  - Tools: nao framework reference, Claude Code hooks integration

- **AI Ecosystem**: Section 8.2 Domain-Specific Agent Frameworks
  - nao (Analytics Agents): Database-agnostic, built-in evaluation
  - Transposable patterns: context builder, evaluation hooks, DB integrations

- **Template**: Analytics Agent with Evaluation (5 files, ~1K lines)
  - README: setup, usage, troubleshooting
  - Agent: SQL generator with evaluation criteria, safety rules
  - Hook: automated metrics logging (safety, performance, errors)
  - Script: analysis with stats, safety reports, recommendations
  - Report template: monthly evaluation format

## Changed

- Agent Evaluation Guide: updated template references, verified links
- Landing Site: templates count 110 → 114
- Version: 3.23.5 → 3.24.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 11:52:13 +01:00
Florian BRUNIAUX
1fb783ebb8 release: v3.23.5 - Aristote claude-mem analysis prompt 
Added comprehensive 6-phase analysis framework for claude-mem integration
targeting the Aristote project (EdTech, Next.js/tRPC/Prisma).

Key features:
- Audit current memory stack (Serena, grepai, 9 hooks)
- Cost/ROI estimation ($3.75/month API, 50-100x ROI factor)
- Integration plan with hooks synergy (activity-logger, serena-sync)
- Go/No-Go decision criteria
- Self-contained prompt template in claudedocs/prompts/

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 11:03:52 +01:00
Florian BRUNIAUX
191ff42741 release: v3.23.4 - Agent Anti-Patterns & Scope-Focused Refactoring 
Major conceptual refactoring based on Dex Horty's principle:
"Subagents are not for anthropomorphizing roles, they are for controlling context"

### Added (1 new section)
- Agent Anti-Patterns section (§9.17, line 3662)
  - Wrong vs Right table (anthropomorphizing vs context control)
  - When to use agents (context isolation, parallel processing, scope limitation)
  - When NOT to use agents (fake teams, roleplaying, mimicking org structure)

### Changed (18 files, 200+ lines)
- Section rename: "Split-Role Sub-Agents" → "Scope-Focused Agents"
- Agent definitions: "Specialized role" → "Context isolation tool"
- 8 custom agent examples refactored (guide + examples/agents/)
- 10+ prompt examples with explicit scope boundaries
- 4 workflow files updated (agent-teams, TDD, iterative refinement)
- Terminology replacements:
  * "Specialized agents" → "Scope-focused agents"
  * "Expert personas" → "Context boundaries"
  * "Multi-domain expertise" → "Multi-scope analysis"

### Fixed
- Methodologies: Clarification note for BMAD role-based naming

Breaking change: Conceptual shift from role-based to scope-based agent usage.
All examples now demonstrate context isolation instead of persona simulation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 10:29:59 +01:00
Florian BRUNIAUX
0cc01e5d3a fix: correct multi-agent review findings across guide docs 
- architecture.md: fix Asana attribution (not Atlassian), Daniela Amodei
  title (President not CEO), update model refs (3.5→4+), update footer
- cheatsheet.md: update date to Feb 2026, TodoWrite→Tasks API in decision tree
- methodologies.md: update date to Feb 2026
- sync-version.sh: escape dots in sed patterns to prevent URL corruption

Findings from 3-agent parallel code review (Agent Teams experiment).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-08 12:38:22 +01:00
Florian BRUNIAUX
a68a1bd52b docs: add Agent Teams Quick Start Guide (v3.23.2) 
Added practical 8-10 min guide for using agent teams in real projects.

Added:
- guide/workflows/agent-teams-quick-start.md (580 lines)
  - 5-minute setup walkthrough
  - 4 copy-paste patterns (Guide + RTK projects)
  - Decision matrix (10+ scenarios)
  - Success metrics framework
  - Red flags section

Updated:
- guide/workflows/agent-teams.md: Link to quick start
- guide/ultimate-guide.md: Section 9.20 with quick start link
- machine-readable/reference.yaml: agent_teams_quick_start entry
- CHANGELOG.md: Release v3.23.2
- VERSION: 3.23.1 → 3.23.2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-08 11:47:40 +01:00
Florian BRUNIAUX
4c0e4b6ac6 docs: integrate Gur Sannikov ADR workflow + native capabilities audit (4/5) 
- Add ADR-Driven Development pattern to methodologies.md (~60 lines)
  - Pattern: ADR → skill → native execution
  - Example ADR template (database migration)
  - Complete bash workflow with benefits
- Add Native Capabilities Audit checklist to architecture.md (~50 lines)
  - 11 native capabilities with internal links
  - Onboarding tip for comprehension audit
- Add Dynamic Model Switching pattern to cheatsheet.md (~40 lines)
  - Pattern: Sonnet → Opus → Sonnet
  - Cost comparison table and best practices
- Add Community Validation to architecture.md (~15 lines)
  - External validation of 'less scaffolding, more model' approach
  - Cursor power user adopting Agent Skills standard
- Track evaluation in docs/resource-evaluations/ (full methodology)
- Update evaluations count: 24 → 55 (README + reference.yaml)
- Update CHANGELOG.md with integration details

Source: https://www.linkedin.com/posts/gursannikov_claudecode-embeddedengineering-aiagents-activity-7423851983331328001-DrFb
Score: 4/5 (HIGH VALUE) - fills ADR workflow gap + onboarding checklist

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-07 16:12:53 +01:00
Florian BRUNIAUX
669199e215 docs: add comprehensive /insights documentation + eval Kajan Siva post 
1. Slash Commands documentation (ultimate-guide.md L6339+):
   - What /insights analyzes: Project areas, interaction style, success/friction patterns
   - Report structure: 8 sections (At a Glance, Work Areas, Usage Style, Wins, Friction, Features, Patterns, Horizon)
   - Interactive elements: Copy buttons, checkboxes, charts, navigation TOC
   - Technical details: Haiku, 50 sessions max, 8192 tokens, ~/.claude/usage-data/
   - Typical insights: CLAUDE.md suggestions, feature recommendations, horizon workflows
   - Integration examples: Monthly optimization, git cross-reference, ccboard combo
   - Comparison table: /insights vs /status vs ccboard vs git history

2. Cheatsheet (cheatsheet.md L25):
   - Added /insights to command table: "Usage analytics + optimization report"

3. Resource evaluation (docs/resource-evaluations/kajan-siva-insights-command.md):
   - Score: 2/5 (Marginal) - no technical content, just surface mention
   - Post confirms /insights exists + provides suggestions, but zero details
   - Real value: HTML report with 18+ actionable suggestions (not documented in post)
   - Recommendation: Do NOT integrate post, document command from actual usage
   - Next: Evaluate Zolkos deep dive for technical architecture specs

4. CHANGELOG [Unreleased]:
   - Comprehensive /insights documentation added to Section 6.1
   - Interactive HTML report details, typical insights, integration examples

Impact: Users can now understand /insights output structure, actionable sections,
and integration workflows. Command properly documented with generic examples.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-06 15:21:19 +01:00
Florian BRUNIAUX
99cca4f498 docs: update Claude Code releases to v2.1.33 + guide v3.23.1 
Claude Code v2.1.33 (2026-02-06):
- Agent teams fixes (tmux sessions, availability warnings)
- TeammateIdle and TaskCompleted hook events for multi-agent workflows
- Agent frontmatter: memory field (user/project/local), Task(agent_type) syntax
- Plugin name in skill descriptions and /skills menu
- VSCode: Remote sessions, branch/message count in session picker
- Multiple stability fixes and improved error messages

Guide v3.23.1:
- Updated Claude Code releases tracking (YAML + Markdown)
- Version synced across all documentation files

Files updated:
- machine-readable/claude-code-releases.yaml (latest: 2.1.33)
- guide/claude-code-releases.md (v2.1.33 section + footer date)
- CHANGELOG.md ([3.23.1] entry)
- VERSION (3.23.0 → 3.23.1)
- Auto-synced: README.md, cheatsheet.md, ultimate-guide.md, reference.yaml

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-06 11:07:52 +01:00
Florian BRUNIAUX
c81180aec7 feat: adaptive onboarding architecture v2.0.0 (v3.23.0) 
Major overhaul of onboarding system with adaptive topic selection based on
user context and keywords. Addresses 8 critical gaps identified by technical-
writer agent challenge.

Core Changes:
- Adaptive matrix: core topics (always) + adaptive topics (keyword-triggered)
- Security-first: moved sandbox_native_guide to beginner_5min (before commands)
- Time budget validation: all 18 profiles validated at 6-8 min/topic
- Quiz integration: positioned as exit activity in Phase 4 wrap-up
- New learn_security goal with 2 profiles (beginner_15min, advanced_60min)

Technical Improvements:
- Added onboarding_matrix_meta for version tracking and maintenance triggers
- Created validation script (validate-onboarding.sh) with 6 automated checks
- Created automation script (detect-new-onboarding-topics.sh) for monthly reviews
- Fixed 8 missing deep_dive keys (rules, workflow, fix, architecture, etc.)
- Removed duplicate deep_dive section causing validation failures

Documentation:
- README.md: version 3.23.0, harmonized counts (106 templates, 49 evaluations)
- CHANGELOG.md: comprehensive v3.23.0 entry with all changes
- Onboarding-prompt.md: updated Phase 1.5, 2, 4 with adaptive logic
- Reference.yaml: 180+ lines added for adaptive architecture

Validation:
- All 18 profiles pass time budget constraints (30-50% buffer maintained)
- All deep_dive keys verified (no missing references)
- Version synchronized across 6 files via sync-version.sh

Challenge: technical-writer agent identified 8 gaps in initial analysis
Result: Full adaptive approach implemented, all gaps addressed

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-05 22:19:58 +01:00
Florian BRUNIAUX
de4b438a72 docs: update Claude Code releases to v2.1.32 + guide v3.22.1 
Claude Code v2.1.32 (2026-02-05):
- ⭐ Opus 4.6 now available
- ⭐ Agent teams research preview (experimental, token-intensive)
- ⭐ Automatic memory recording and recall
- "Summarize from here" for partial conversation summaries
- Skills auto-load from .claude/skills/ in --add-dir directories
- Fixes: @ file completion paths, bash heredoc JS template literals
- [VSCode] Slash commands execution fix, conversation loading spinner

Guide updates:
- Bumped guide version: 3.22.0 → 3.22.1 (minor)
- Updated CHANGELOG with v2.1.32 highlights
- Synced version across all documentation files
- Updated machine-readable tracking (YAML + Markdown)

Synchronization:
- Landing version badge updated: v2.1.31 → v2.1.32
- Landing footer version: v3.21.1 → v3.22.1
- Landing releases timeline updated with Opus 4.6 features
- All sync checks passing (templates, quiz, lines, stars)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-05 21:04:55 +01:00
Florian BRUNIAUX
f830b1c836 chore: bump version to 3.22.0 
Release dual-instance planning pattern (Jon Williams).

## Changes

- VERSION: 3.21.1 → 3.22.0
- CHANGELOG.md: Move [Unreleased] → [3.22.0] - 2026-02-04
  - Dual-instance planning pattern entry (~15 bullet points)
  - Documentation, Added section, full integration details
- Synced across: README.md, guide/cheatsheet.md, guide/ultimate-guide.md, reference.yaml

## Release Content

**Section 9.17.1**: Alternative Pattern: Dual-Instance Planning (~350 lines)
**Workflow**: guide/workflows/dual-instance-planning.md (~750 lines)
**Evaluation**: docs/resource-evaluations/jon-williams-dual-instance-pattern.md (~300 lines)
**References**: 15 new entries in reference.yaml

## Stats

- Total lines added: ~1,400
- Files modified: 10
- Evaluation score: 4/5 (High Value)
- Pattern: Vertical separation (planner ↔ implementer)
- Target audience: Solo devs, spec-heavy work, $100-200/month

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-04 10:41:55 +01:00
Florian BRUNIAUX
0a2e05f290 fix(keybindings): correct Ctrl+R from "Retry" to "Search history" 
- Updated 5 locations in guide (cheatsheet + ultimate-guide)
- Verified against official keybindings: history:search action
- Added resource evaluation: Sankalp's Claude Code experience (2/5)
- Blog correctly identified guide error

Closes evaluation workflow for sankalp-claude-code-experience

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-03 17:27:54 +01:00
Florian BRUNIAUX
975b8019ac feat: add 4 ClaudeKit-inspired hooks (checkpoint, validation, file-guard) 
- Add auto-checkpoint.sh (Stop event, git stash automation)
- Add typecheck-on-save.sh (PostToolUse, TypeScript validation)
- Add test-on-change.sh (PostToolUse, smart test detection)
- Add file-guard.sh (PreToolUse, unified file protection)
- Add ClaudeKit evaluation (3/5, patterns extracted)
- Version bump 3.21.0 → 3.21.1 (sync across all docs)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-02 21:50:48 +01:00
Florian BRUNIAUX
18cc838dcd chore: bump version to 3.21.0 and update documentation 
Version bump: 3.20.9 → 3.21.0

## Changes

- VERSION: Updated to 3.21.0
- CHANGELOG.md: Added [3.21.0] section with configuration management release notes
- README.md: Updated version footer and resource evaluations count (41 → 44)
- guide/cheatsheet.md: Updated version and date (January → February 2026)
- guide/ultimate-guide.md: Synced version references
- machine-readable/reference.yaml: Updated version and date

## Version Sync

All version references synchronized using ./scripts/sync-version.sh

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-02 18:25:09 +01:00
Florian BRUNIAUX
0bb116cd2c docs: add Multi-IDE Configuration Sync pattern (v3.20.9) 
Added comprehensive documentation for maintaining consistent AI instructions
across multiple coding tools (Claude Code, Cursor, Copilot, etc.).

Changes:
- guide/ai-ecosystem.md: New "Multi-IDE Configuration Sync" section (L1256-1329)
  - Problem statement with config file comparison table
  - Solution 1: Native @import for Claude Code (recommended)
  - Solution 2: Script-based generation for multi-IDE teams (bash example)
  - AGENTS.md support status clarification + workaround (symlink)
  - Compatibility matrix with external tool references
- machine-readable/reference.yaml: Added 2 index entries
  - ai_ecosystem_multi_ide_sync: guide/ai-ecosystem.md:1256
  - agents_md_support_status: guide/ai-ecosystem.md:1322
- CHANGELOG.md: Documented addition in [Unreleased] section
- VERSION: Bumped from 3.20.8 to 3.20.9 (patch)
- Auto-synced version across README, cheatsheet, ultimate-guide

Total: +91 insertions, -8 deletions (74 lines net content addition)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-02 09:04:00 +01:00
Florian BRUNIAUX
d5375e32a5 docs: add 2 resource evaluations (Osmani LinkedIn + Beyond Vibe Coding) 
Added:
- Resource Evaluation: Addy Osmani LinkedIn Post (scored 2/5, Marginal)
  - Post about Anthropic study (17% comprehension gap)
  - 100% overlap with Shen & Tamkin 2026 already documented
  - Decision: Tracking mention only (mainstream diffusion timeline)
  - New criterion: "Influencer Amplification" pattern documented

- Resource Evaluation: "Beyond Vibe Coding" Book (scored 3/5, Pertinent)
  - Comprehensive O'Reilly book by Addy Osmani
  - 90% overlap analysis (10/14 topics covered 100%)
  - Decision: Minimal integration (tracking mention + cross-refs)
  - Cross-validation with 2 Osmani articles already integrated

Updated:
- CHANGELOG.md: [Unreleased] section with detailed entries
- README.md: Resource evaluations count (36 → 38 assessments)

Files created:
- docs/resource-evaluations/addy-osmani-linkedin-anthropic-study.md
- docs/resource-evaluations/beyond-vibe-coding.md
- docs/resource-evaluations/nick-tune-feedback-loops.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-01 23:30:03 +01:00
Florian BRUNIAUX
9f9f735436 release: v3.20.7 - Addy Osmani spec-writing integration 
Version Bump:
- VERSION: 3.20.6 → 3.20.7
- CHANGELOG.md: New [3.20.7] section with Osmani integration details
- Synced across: README.md, cheatsheet.md, ultimate-guide.md, reference.yaml

Release Highlights:
- Addy Osmani spec-writing evaluation (4/5, High Value)
- 4 new sections in spec-first.md (Modular Design, Operational Boundaries, Command Templates, Anti-Monolithic)
- 180 lines added to spec-first.md (327 → 507)
- 8 new reference.yaml entries
- 1 new resource evaluation (36 total)

Integration Details (see CHANGELOG.md):
- Modular spec design pattern (split >200 line CLAUDE.md files)
- Always/Ask First/Never operational boundaries framework
- Command spec templates with error handling
- Anti-pattern: monolithic CLAUDE.md context pollution

Landing Sync: Ready for deployment (version updated in separate commit)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-01 21:48:29 +01:00
Florian BRUNIAUX
bc86c8ed7f release: v3.20.6 - agentskills.io integration + 4 resource evaluations 
- agentskills.io open standard: frontmatter table, skills-ref CLI, portability section
- Agent Skills supply chain risks (security-hardening.md §1.2)
- anthropics/skills (60K+★) added to complementary resources
- 16 new reference.yaml entries
- Resource evaluations: agentskills.io (4/5), Skill Doctor (2/5), dclaude (new), paddo (new)
- Sandbox isolation + README updates

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-01 16:49:33 +01:00
Florian BRUNIAUX
59ba1ae174 release: v3.20.5 - 4 new ASCII diagrams (visual-reference.md) 
- Add visual-reference.md with 20 ASCII diagrams (16 existing + 4 new)
  - #17 TDD Red-Green-Refactor Cycle
  - #18 UVAL Protocol Flow
  - #19 Security 3-Layer Defense
  - #20 Secret Exposure Timeline
- Add Visual Reference to README Core Documentation table
- Version sync: 3.20.4 → 3.20.5

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 23:14:41 +01:00
Florian BRUNIAUX
a7962d5560 release: v3.20.4 - 30 new quiz questions (227 → 257) 
Add 30 questions across 11 categories covering recent guide content:
Advanced Patterns (+8), MCP Servers (+3), Architecture (+3),
Reference (+3), Hooks (+2), Learning (+2), Security (+2),
AI Ecosystem (+3), Memory (+2), Agents (+1), Privacy (+1).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 22:17:32 +01:00
Florian BRUNIAUX
2fcc65e222 release: v3.20.3 - Competitive Analysis Gaps (claudelog.com) 
9 gaps filled from claudelog.com competitive analysis (313 pages):
- Section 9.19: Permutation Frameworks (CLAUDE.md-driven variation testing)
- Skeleton Projects workflow (guide/workflows/skeleton-projects.md)
- Task Lists as Diagnostic Tool (instruction clarity mirror)
- Rev the Engine + Mechanic Stacking (multi-round planning patterns)
- Split-Role Sub-Agents (multi-perspective analysis)
- "You Are the Main Thread" mental model (CPU scheduler analogy)
- Continuous Context Update (proactive CLAUDE.md enrichment)
- Smart Hook Dispatching (single entry point routing to handlers)

Guide: 15,771 → 16,293 lines (+522)
New workflow: skeleton-projects.md (208 lines)
Reference: +17 new entries in reference.yaml

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 21:55:12 +01:00
Florian BRUNIAUX
950370e81b release: v3.20.2 - Sandbox Isolation for Coding Agents 
New guide file covering Docker Sandboxes (microVM isolation),
cloud alternatives (Fly.io Sprites, E2B, Vercel, Cloudflare),
safe autonomy workflows, and comparison matrix.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-31 19:08:25 +01:00
Florian BRUNIAUX
26ee4ef894 release: v3.20.1 - Vercel AGENTS.md vs Skills evaluation 
- New resource evaluation (025): Vercel blog on eager context vs lazy
  skill invocation (Gao, Jan 2026). Score 3/5, 13/13 fact-checked.
- Guide: added 8KB compression benchmark to CLAUDE.md sizing (line 3527)
- Guide: added 56% skill invocation warning to Memory Loading (line 4082)
- Guide: added invocation reliability caveat to skills.sh trade-offs
- Version sync 3.20.0 → 3.20.1

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-30 21:45:14 +01:00