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

316 commits

This branch
This branch
All branches
Author SHA1 Message Date
Florian BRUNIAUX
e4d9d9e825 fix: correct v2.1.39/v2.1.41 feature attributions + add claude auth CLI docs 
3 features were incorrectly attributed to v2.1.39 instead of v2.1.41
(guard nested sessions, OTel speed attribute, Agent Teams model fix).
Verified against official CHANGELOG. Also adds claude auth login/status/logout
to the ultimate guide maintenance commands table.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 20:37:08 +01:00
Florian BRUNIAUX
75e93f79a4 docs: update CHANGELOG with review-plan templates 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 20:35:02 +01:00
Florian BRUNIAUX
7d43b67bcd docs: add review-plan command + rules templates (inspired by Garry Tan) 
Structured plan review across 4 axes (architecture, code quality, tests,
performance) as a reusable custom command with separate rules files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 20:34:33 +01:00
Florian BRUNIAUX
c7c63a1bc4 docs: update session-summary install to recommend plugin system 
- Add plugin install as recommended method in Implementation section
- Fix hook event: Stop → SessionEnd (correct event)
- Add plugin install option in Installation section
- Keep manual install as alternative

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 14:55:10 +01:00
Florian BRUNIAUX
c955098cc7 docs: add plugin marketplace install for session-summary 
Link to FlorianBruniaux/claude-code-plugins in ecosystem section
and hooks README. Plugin system auto-wires hooks, no manual config.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 11:58:58 +01:00
Florian BRUNIAUX
9075b966ab fix: make session-summary-config.sh compatible with Bash 3.2+ (macOS) 
Replace all `declare -A` (associative arrays, Bash 4+ only) with simple
variables and helper functions. Fixes crash on macOS default Bash 3.2:
- "operand expected" at line 40
- "meta: unbound variable" at line 43

Reported by community user (Slack).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-16 11:42:20 +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
66ebec567a docs: add SkillHub badge and update skills listing to 13 
- Add SkillHub badge (9 skills) to README header
- Update examples/README.md with 5 new skill entries
- Link to SkillHub profile for installable skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 21:24:17 +01:00
Florian BRUNIAUX
52d76411e3 feat(skills): publish 5 new skills to SkillHub 
Add skill-creator, landing-page-generator, ccboard, guide-recap,
and release-notes-generator with genericized content (no personal
refs, FR→EN translation, placeholder URLs/paths).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 21:10:09 +01:00
Florian BRUNIAUX
9e738f0a87 docs: update session summary screenshot 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 21:01:20 +01:00
Florian BRUNIAUX
e504f0d1bf feat: add session summary screenshot, skills, and GitHub templates 
- Add session-summary-v3.png screenshot for hook documentation
- Add GitHub issue templates (bug report, feature request, question)
- Add new skills: ccboard, guide-recap, landing-page-generator,
  release-notes-generator, skill-creator

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 20:55:16 +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
e60b24d27c docs(examples): add YAML frontmatter to 19 miscellaneous example files 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:21:00 +01:00
Florian BRUNIAUX
9170095320 docs(examples): add YAML frontmatter to 7 README files 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:20:57 +01:00
Florian BRUNIAUX
3029d1d3b8 docs(examples): add YAML frontmatter to 5 claude-md templates 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:20:37 +01:00
Florian BRUNIAUX
91d36f00dd docs(examples): add YAML frontmatter to 20 command templates 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:20:36 +01:00
Florian BRUNIAUX
624b2e0425 docs(guide): add YAML frontmatter to 15 workflow guide files 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-15 19:20:35 +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
d94f6bf62e docs: update Claude Code releases tracking (v2.1.38 → v2.1.41) 
- Add v2.1.39: recursive launch guard, Agent Teams 3P model fix, OTel speed
- Add v2.1.41: claude auth CLI, Windows ARM64, /rename auto-name
- Fix markdown missing v2.1.38 entry (security: heredoc, sandbox skills)
- Add heredoc command smuggling to security breaking summary

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-13 11:06:07 +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
1b04bdbcf5 feat(onboarding): wire learn_security goal into onboarding UX 
- Phase 0: add learn_security option between build_agents and fix_problem
- Phase 3: add hands-on security exercises (security-check, skill scanning, MCP review)
- Phase 4: add learn_security quick win (/security-check) and security quiz link (30 questions)
- Who This Is For: add Learn security row
- French example: add security option
- Quiz counts: 257 → 274 questions (2 occurrences)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 15:47:28 +01:00
Florian BRUNIAUX
deb518ceff fix(security): fact-check corrections across threat-db and hardening guide 
- CVE-2025-53109/53110: fix version 0.6.4 → 0.6.3 (per NVD/Cymulate)
- CVE-2025-53967: CVSS 8.0 → 7.5 (per NVD)
- CVE-2026-25536: add missing fixed_in 1.26.0
- CVE-2026-25546: add missing fixed_in 0.1.1
- Rename pseudo-CVE "claude-code-v2.1.34" → ADVISORY-CC-2026-001
- Fix Flatt Security URL to specific blog post
- Fix SentinelOne URL to specific CVE page

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 15:11:13 +01:00
Florian BRUNIAUX
93ac775b6d refactor: drop hardcoded numbers from tagline 
Replace exact counts (19K lines, 111 templates, 257 quiz) with
value-focused description. Numbers go stale fast, value doesn't.

Inspired by awesome-claude-code curator feedback.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-11 10:26:59 +01:00
Florian BRUNIAUX
b5eea8d30c feat: add "Last Update" badge showing daily activity 
Add visible "Last Update" badge in README to showcase guide's high
activity (95+ releases in 33 days). Auto-updates via sync-version.sh.

Changes:
- README.md: Badge "Updated-{date}_·_v{version}" before Quiz badge
- README.md: Footer now shows "Updated daily · {date}"
- sync-version.sh: Auto-update date in badge + footer on version sync

Badge links to CHANGELOG.md for full history.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 18:18:56 +01:00
Florian BRUNIAUX
7b0d65cb09 fix(docs): correct effort parameter documentation based on official Anthropic docs 
- Fix API syntax: `thinking={}` → `output_config={"effort": "medium"}`
- Clarify scope: effort controls entire response (text + tools + thinking)
- Add official descriptions for max/high/medium/low levels
- Update control table: Opus 4.5 vs 4.6 support
- New subsection: "Effort and Tool Use" with concrete examples
- Clarify effort/thinking/budget_tokens relationship

Source: https://platform.claude.com/docs/en/build-with-claude/effort
Section: guide/ultimate-guide.md lines 10396-10442

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 17:38:08 +01:00
Florian BRUNIAUX
5f67bd8957 docs: add Robin Lorenz attribution with LinkedIn links 
- CHANGELOG: Added LinkedIn profile and comment links
- Guide §2.5: Added direct quote with attribution
 2026-02-10 13:18:58 +01:00
Florian BRUNIAUX
c958738c20 docs: integrate AI fatigue symptom recognition (score 3/5) 
Add session time-boxing guidance and nondeterminism stress recognition
to learning-with-ai.md across 3 strategic locations (~220 words total).

Changes:
- Red Flags Checklist: Add session fatigue warning with time-boxing mitigation
  (30 min limit, max 3 attempts before manual implementation)
- Productivity Reality: Add nondeterminism stress paragraph (identical prompts
  → varying outputs causes AI fatigue)
- UVAL Protocol: Add Step 2.5 checkpoint for fatigue signal recognition
  (session duration, retry count, frustration assessment)

Rationale:
- Score 3/5: Moderate relevance (90% overlap with existing content)
- Extracted only novel tactics: session time-boxing (distinct from weekly 70/30)
- Rejected contradictory recommendations (70% quality vs understand 100%)
- Full evaluation + technical-writer challenge: docs/resource-evaluations/

Source: Siddhant Khare, "AI Fatigue is Real and Nobody Talks About It"
        (Feb 2026, https://siddhantkhare.com/writing/ai-fatigue-is-real)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 13:13:32 +01:00
Florian BRUNIAUX
9088d68b9f feat: add "From Chatbot to Context System" mental model (v3.25.0) 
New Section §2.5:
- 4-layer framework: CLAUDE.md + Skills + Hooks + Memory
- Before/After comparison (chatbot mode vs context system)
- Addresses gap: features documented separately, never unified
- Inspired by Robin Lorenz feedback (17-agent orchestration)

Changes:
- Mistake #8 rewritten: "Treating Claude Code Like a Chatbot"
- Key mindset shift updated: "structured context system"
- Cross-references added: §1.6, §1.8, §2.5, §9.10

Impact: Shifts from "write better prompts" to "build context that compounds"

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 13:06:49 +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
12568fbd61 docs: eval resource Rakesh Gohel / Aakash Gupta "Master Claude Code" infographic (score 2/5) 
Evaluation complète de l'infographie LinkedIn "Master Claude Code v1.0" (9 février 2026).
Score 2/5 (Marginal) - Ne pas intégrer.

Justifications:
- Aucune information technique nouvelle vs guide actuel
- Cheatsheet v3.23.4 strictement supérieur
- Erreur notable: recommandation Cursor comme "best experience" (red flag technique)
- Angle PM déjà couvert par Cowork Guide (repo dédié)
- 0/12 aspects apportent valeur nouvelle

Fichiers:
- docs/resource-evaluations/rakesh-gohel-aakash-gupta-master-claude-code.md (nouveau)
- docs/resource-evaluations/README.md (index mis à jour, 56→57 évaluations)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 10:42:11 +01:00
Florian BRUNIAUX
d0320f3e30 docs: add memory stack integration workflow example 
Real-world 5-day sprint example showing claude-mem + Serena + grepai integration.

Scenario: JWT migration across e-commerce API (50k lines, 200+ files)

Demonstrates:
- Day 1: Discovery with grepai + architectural decisions in Serena
- Day 2: Implementation with auto-capture via claude-mem
- Day 3: Integration with context retention across sessions
- Day 4: Testing with full memory stack
- Day 5: Deployment with comprehensive handoff docs

Key metrics:
- 85% reduction in file re-reads (1000 → 150)
- 90% token savings via progressive disclosure
- 4 Serena memories (arch decisions preserved)
- 312 observations captured automatically
- $4.68 total cost for 5 days of perfect memory
- Net ROI: $0.43 cost vs 425k tokens saved

Shows practical usage:
- When to use auto vs manual memory
- Progressive disclosure in action
- Memory search queries
- Handoff documentation generation
- Cost analysis and ROI

File: examples/workflows/memory-stack-integration.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 09:36:37 +01:00
Florian BRUNIAUX
d5c3a82cac docs: add claude-mem plugin documentation (automatic session memory) 
Integrate claude-mem (thedotmack/claude-mem) into the guide as Section 8.2.5.
Score: 4/5 (High Value - automatic session capture fills documentation gap).

Added:
- Section 8.2.5: claude-mem plugin (automatic session memory)
  * Automatic capture via lifecycle hooks
  * AI compression + progressive disclosure (10x tokens)
  * Web dashboard at localhost:37777
  * Natural language search
  * Privacy controls (<private> tags)
  * Cost analysis ($0.15/100 obs)
  * AGPL-3.0 licensing considerations

- Memory Tools Decision Matrix (claude-mem vs Serena vs grepai)
  * 4-layer memory stack pattern
  * Integrated workflow examples
  * When to use automatic vs manual memory

- Plugin template: examples/plugins/claude-mem.md
  * Installation, configuration, troubleshooting
  * Advanced features (progressive disclosure, endless mode)
  * Export/import, cost optimization

- Resource evaluation: docs/resource-evaluations/claude-mem-evaluation.md
  * Technical analysis (fact-checked stats)
  * Comparison to existing tools
  * Integration recommendations

- reference.yaml: 14 new claude-mem entries

Changed:
- Updated search tools comparison (5 tools: rg, grepai, Serena, ast-grep, claude-mem)
- Extended feature matrix with "Auto capture" and "Web dashboard" rows

Stats (verified 2026-02-10):
- 26.5k GitHub stars, 1.8k forks
- 181 releases, 46 contributors
- Latest: v9.1.1 (Feb 7, 2026)
- License: AGPL-3.0 + PolyForm Noncommercial

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 08:47:17 +01:00
Florian BRUNIAUX
9031c8fd05 sync: Claude Code v2.1.38 release 
- Fixed VS Code terminal scroll-to-top regression
- Fixed Tab key queueing slash commands
- Fixed bash permission matching with env vars
- Security: Blocked .claude/skills writes in sandbox

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-10 08:29:07 +01:00
Florian BRUNIAUX
89084c89ec docs: integrate Anthropic 2026 Agentic Coding Trends Report 
Integration strategy: diffusion transversale (~450 lines across 5 files)
instead of monolithic Section 9.21 (rejected after technical-writer review).

Evaluation: 4/5 score (high value, but lacks concrete code examples)
Source: https://resources.anthropic.com/hubfs/2026%20Agentic%20Coding%20Trends%20Report.pdf

Changes:
1. Created evaluation report (docs/resource-evaluations/)
   - Summary, gap analysis, challenge results, fact-check
   - Justification: validation industrie, benchmarks, anti-patterns

2. Modified guide/ultimate-guide.md (3 insertions, ~270 lines)
   - Section 9 intro: Industry context encadré with adoption data
   - Section 9.17 Multi-Instance: ROI benchmarks ($500-1K/month validation)
   - Section 9.11: Enterprise Anti-Patterns section (5 detailed patterns)

3. Modified guide/workflows/agent-teams.md (~80 lines)
   - Industry adoption data with case studies
   - Timeline: 3-6 months, success rates by phase
   - Real-world performance metrics (Fountain 50%, Rakuten 7h, TELUS 500K hours)

4. Modified machine-readable/reference.yaml (~40 lines)
   - Added agentic_trends_2026_* metadata section
   - Research data, case studies, benchmarks, anti-patterns references

5. Modified README.md (~8 lines)
   - Added "Research & Industry Reports" section
   - Link to Anthropic report with evaluation details

Stats validated: 60% AI usage, 0-20% full delegation, 67% more PRs/day,
27% new work, 7 case studies (Fountain, Rakuten, CRED, TELUS, Legora, Zapier, Augment).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 17:18: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
94b9ad4f89 docs: update metadata and statistics for v3.9.9 
Update CHANGELOG, README, and workflow docs to reflect latest additions.

Changes:
1. CHANGELOG.md
   - 4 new entries under [Unreleased] → Added:
     * llms.txt Standard Documentation (Section 9.18.4)
     * Background Tasks Workflow (Section 9.5)
     * Chrome DevTools MCP Server (mcp-servers-ecosystem.md)
     * Convention-Over-Configuration for AI (Section 9.18.1)
   - Each entry with line numbers, resources, gaps addressed

2. README.md statistics
   - Guide lines: 16K → 19K (actual: 18,820 lines)
   - Templates: 107 → 111 (verified count)
   - Evaluations: 55 → 56 (wasp-fullstack-essentials-eval.md)
   - Updated in 8 locations: hero, badges, mermaid diagram, structure

3. guide/workflows/agent-teams-quick-start.md
   - Improved task delegation clarity (Content Scope, Index Scope labels)
   - Enhanced context boundaries in multi-file operations

Statistics verification:
- Templates: find examples -type f | wc -l → 111
- Guide lines: wc -l guide/ultimate-guide.md → 18,820
- Evaluations: docs/resource-evaluations/README.md → 56

Related commits:
- 783c43b: llms.txt conceptual documentation
- 17846b1: Background tasks + Chrome DevTools + convention-over-config

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 10:07:12 +01:00
Florian BRUNIAUX
baebe23816 docs: integrate Anthropic update 2-9 Feb 2026 (Opus 4.6, auto-memories, fast mode) 
Comprehensive integration of Claude Opus 4.6 features and v2.1.32-2.1.37
releases based on Anthropic veille (8 items evaluated, score 5/5).

## Critical Updates (Phase 1)

### Opus 4.6 + Adaptive Thinking
- Extended Thinking section: Adaptive thinking replaces budget-based approach
- API syntax: thinking: {type: "adaptive", effort: "low|medium|high|max"}
- Deprecated: budget_tokens parameter no longer functional
- 8 references updated: "Opus 4.5" → "Opus 4.6" contextually

### Pricing Model
- Three-tier structure: Standard ($5/$25), 1M Context Beta ($10/$37.50),
  Fast Mode ($30/$150) per 1M tokens
- Default model: Sonnet 3.5 → Sonnet 4.5

### Commands Table
- Added: /fast (toggle fast mode, 2.5x speed, 6x price, persists)
- Added: /debug (systematic troubleshooting)

## High-Value Features (Phase 2)

### Auto-Memories (v2.1.32+)
- Automatic context capture: decisions, preferences, patterns, gotchas
- Opt-in, per-project, separate from CLAUDE.md
- Comparative table: Manual CLAUDE.md vs automatic memories

### Context Management
- "Summarize from here": Right-click message → selective summarization
- More precise than full /compact

### Agent Teams Enhancements
- Hook events: TeammateIdle, TaskCompleted (events table)
- Agent frontmatter: memory field for pre-populated context

### Security
- CVE table: Claude Code v2.1.34 sandbox bypass fix
- Recommendation: Upgrade to v2.1.34+ immediately

## Contextual Additions (Phase 3)

### Xcode Integration (Feb 2026)
- Xcode 26.3 RC+: Native Claude Agent SDK support
- Same harness as Claude Code CLI
- Clarified: Agent SDK ≠ Claude Code (shared framework)

### API Breaking Changes (Opus 4.6)
- Removed: assistant-prefill (use system prompts instead)
- New: Fast mode API (speed: "fast" + beta header)

### Corrections
- PowerPoint capability: "No PPTX" → "Limited (add-in only)"

## Documentation

### Fact-Checking (Perplexity Pro)
- Opus 4.6 pricing: Verified via pricepertoken.com, eesel.ai
- Adaptive thinking: Verified syntax, effort parameter, API examples
- Fast mode: Confirmed 2.5x speed, 6x cost, persistence
- Auto-memories: Validated opt-in, per-project behavior

### machine-readable/reference.yaml
- 24 new entries: auto-memories, fast mode, debug, Opus 4.6, hooks
- Updated: 2026-02-09

### Metrics
- 14 files modified across 3 phases
- 11 sections updated in ultimate-guide.md
- Confidence: High (official sources + Perplexity validation)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 10:02:47 +01:00
Florian BRUNIAUX
17846b1179 docs: complete Wasp fullstack essentials integration 
Complete all 4 action items from wasp-fullstack-essentials-eval.md resource
evaluation (score 3/5). Framework-agnostic insights only, promotional content
excluded.

Changes (3 sections):

1. Background tasks workflow (Section 9.5)
   - New subsection: "Background Tasks for Fullstack Development"
   - When to background tasks (5 scenarios table)
   - Fullstack workflow pattern with examples
   - Context rot prevention strategies
   - Limitations and workarounds
   - Integration with teleportation
   - /tasks monitoring guide
   - ~100 lines added to Section 9.5 "Tight Feedback Loops"

2. Chrome DevTools MCP (mcp-servers-ecosystem.md)
   - New server entry in "Browser Automation" section
   - Official Anthropic server (not community)
   - Comparison table vs Playwright MCP (debugging vs testing)
   - Setup and configuration
   - Use cases and limitations
   - Updated stats: 3 browser servers (was 2), 6 official servers (was 5)
   - ~60 lines added to Browser Automation section

3. Convention-over-config for AI (Section 9.18.1)
   - New subsection: "Convention-Over-Configuration for AI Agents"
   - Why opinionated frameworks reduce agent cognitive load
   - Comparison table: custom vs opinionated architectures
   - Examples: Next.js, Rails, Phoenix, Django
   - Real-world impact on agent productivity
   - Trade-offs analysis
   - Connection to CLAUDE.md sizing (token reduction)
   - ~60 lines added to Section 9.18.1

Total additions: ~220 lines (workflow patterns + MCP server + AX framework)

Source evaluation: docs/resource-evaluations/wasp-fullstack-essentials-eval.md
Primary sources: llmstxt.org (llms.txt), official docs (background tasks, Chrome
DevTools MCP), existing Section 9.18 (Marmelab/AX framework)

Related commits:
- 783c43b: llms.txt conceptual documentation (completed earlier)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 10:00:53 +01:00
Florian BRUNIAUX
783c43baed docs: add llms.txt conceptual documentation to Section 9.18 
Add comprehensive llms.txt documentation based on Wasp fullstack essentials
resource evaluation (score 3/5). Sourced from llmstxt.org spec, not the
promotional article.

Changes:
- New section 9.18.4: Documentation Formats for Agents (llms.txt)
- Explains llms.txt standard, format, and use cases
- Clarifies complementarity with Context7 MCP (not opposition)
- Provides minimal and advanced examples with line numbers
- Integration patterns with CLAUDE.md
- References this repo's own llms.txt implementation
- Updated section numbering (9.18.4-9.18.11)
- Updated Section 9.18 TL;DR with new principle
- Added reference.yaml entries for llms.txt

Resource evaluation:
- File: docs/resource-evaluations/wasp-fullstack-essentials-eval.md
- Source: Wasp DevRel blog (framework-agnostic insights extracted)
- Score: 3/5 (partial integration, promotional content excluded)
- Gap identified: Embarrassing to have llms.txt file without explaining concept
- Primary source: llmstxt.org specification

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 09:46:50 +01:00
Florian BRUNIAUX
9805b615c5 docs: correct Agent Teams architecture + add session handoff template 
## Agent Teams Architecture Corrections

Based on official sources (Addy Osmani blog, Feb 2026):

**Major changes**:
- Add mailbox system documentation (peer-to-peer messaging)
- Correct communication model: not only team lead synthesis
- Update diagrams to show peer-to-peer arrows
- Clarify context isolation vs message sharing
- Add 7 sections with source attribution
- Add documentation update note (2026-02-09)

**Key correction**: Agents communicate via mailbox system (direct
peer-to-peer + team lead synthesis), not only hierarchical reporting.

**Files modified**:
- guide/workflows/agent-teams.md (+72 -19): 7 major corrections
- CHANGELOG.md: Document session handoff template addition
- guide/architecture.md: Architecture clarifications
- guide/ultimate-guide.md: Cross-references updates

**Sources**:
- https://addyosmani.com/blog/claude-code-agent-teams/
- Perplexity research (sonar-reasoning-pro, Feb 2026)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-09 09:23:41 +01:00
Florian BRUNIAUX
734a1cbef7 docs: add Zadig&Voltaire case study + awesome-claude-skills taxonomy 
- Ecosystem: Zadig&Voltaire migration path (Cursor → Windsurf → Claude Code)
  with team productivity data (7 → 27 MRs/week, 4x acceleration)
  Source: Benjamin Calef, tech.zadig-et-voltaire.com (Feb 2026)
- Ecosystem: awesome-claude-skills (BehiSecc) - 62 skills across 12 categories
  Evaluation: 3/5, complementary to awesome-claude-code

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-08 15:34:46 +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
36880caf29 docs: update Claude Code releases to v2.1.37 
- Update latest tracked version: v2.1.33 → v2.1.37
- v2.1.36: Fast mode now available for Opus 4.6
- v2.1.34: Security fix for sandbox-excluded commands bypass
- v2.1.37: Fixed /fast availability after /extra-usage
- Fix reference.yaml line numbers for architecture.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-08 11:25:05 +01:00
Florian BRUNIAUX
b8eb937642 fix: correct evaluation count in README (25 → 55) 
The previous automatic update showed 25 evaluations instead of 55.
Verified with: find docs/resource-evaluations -type f -name '*.md' ! -name 'README.md' | wc -l

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-07 16:14:37 +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
b48d95c024 feat: add agent/skill quality audit tooling + Grenier evaluation 
AUDIT TOOLING (3 templates):
- Command: /audit-agents-skills (quick project audits)
  - 16-criteria framework (Identity 3x, Prompt 2x, Validation 1x, Design 2x)
  - Weighted scoring: 32 pts (agents/skills), 20 pts (commands)
  - Production grading (A-F, 80% threshold)
  - Fix mode with actionable suggestions
- Skill: audit-agents-skills (advanced audits)
  - 3 modes: Quick (top-5), Full (all 16), Comparative (vs templates)
  - JSON + Markdown output for CI/CD
- Scoring grids: criteria.yaml (externalized for reuse)

EVALUATION:
- Grenier agent/skill quality (3/5 - Moderate Value)
  - Gap: 29.5% deploy without evaluation (LangChang 2026)
  - Integration: Created audit command + skill + criteria
  - Industry context: 18% cite agent bugs as top challenge

DOCUMENTATION:
- Guide refs: 2 strategic call-outs (after Agent/Skill validation)
- CHANGELOG: New "Added" section + evaluation details
- README: Templates 106→107, Evaluations 49→24 (count corrections)
- reference.yaml: 10 new audit entries + updated counts

SYNC:
- Landing index.html: Templates 107, Evals 24, Quiz 257
- Landing examples/index.html: Templates 107

FILES: 14 changed, 4148 insertions (+1250 lines new audit content)

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