Florian BRUNIAUX
19bdc910cc
release: v3.36.0 — 3 AI roles + ContextOps + comprehension debt
...
Added:
- guide/roles/ai-roles.md: §14 MLOps Engineer, §15 AI Developer Advocate,
§16 AI Orchestration Engineer with full profiles (responsibilities, skills,
entry paths, salary benchmarks, career matrix rows)
- 4 resource evaluations (Packmind ContextOps, comprehension debt,
Addy Osmani agents.md anti-pattern, Claude Swarm Monitor)
Changed:
- guide/roles/ai-roles.md: ToC renumbered, Career Decision Matrix +3 rows,
Salary Benchmarks +3 rows, removed "Orchestration Engineer" from What's Not a Role
- docs/for-cto.md, for-cio-ceo.md, for-tech-leads.md: updated docs positioning
- guide/ecosystem: mcp-servers-ecosystem.md + third-party-tools.md updates
- guide/roles/learning-with-ai.md: content updates
Bump: 3.35.0 → 3.36.0 (VERSION, README, cheatsheet, ultimate-guide, reference.yaml,
llms.txt, llms-full.txt, machine-readable/llms.txt)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 09:14:26 +01:00
Florian BRUNIAUX
ca69a1a7fd
release: v3.35.0 — workflows, hook, threat-db, GitHub Actions CI
...
New workflow guides (RPI, changelog-fragments, github-actions), smart-suggest
UserPromptSubmit hook, LLM variance known-issue, threat-db v2.7.0, desloppify,
cc-sessions discover documentation, prompt-caching verification script.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-13 19:30:34 +01:00
Florian BRUNIAUX
ded3a9858d
docs: expand quiz 277 → 311 questions (+34), sync counters
...
33 new questions covering recent CC releases and guide additions:
- Settings: modelOverrides, autoMemoryDirectory, tool-qualified deny, HTML comments, spinnerVerbs, team config
- Commands: /loop, /simplify, /batch, /stats, /rename
- Hooks: WorktreeCreate/Remove, TeammateIdle/TaskCompleted, auto-rename-session
- MCP: Git MCP vs GitHub MCP
- Advanced: Context 150% ceiling, ACE pipeline, Plan-Validate-Execute, dual-instance, isolation:worktree
- Reference: effort levels ○◐●, Fast mode, model param on Agent, /context v2.1.74
- Learning: METR RCT 2025, Borg RCT 2025, Contribution Metrics
- Security: enterprise governance tiers, MCP registry, native sandbox, dangerouslyDisableSandbox
- Ecosystem: RTK, Google Antigravity
1 correction: architecture-internals/002 (TodoWrite → Tasks API, v2.1.16+)
Counters: quiz_count 271 → 311 in reference.yaml + all llms.txt files
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-13 10:08:49 +01:00
Florian BRUNIAUX
0d70fd88f0
feat(seo): GEO optimization — llms.txt v3.32.2, llms-full.txt, FAQ
...
Phase 1 (repo): update machine-readable/llms.txt (v3.8.0→3.32.2,
87→238 templates, 9.6K→22.7K lines), create root llms.txt per
llmstxt.org convention, create llms-full.txt (~20KB: cheatsheet,
template list, FAQ), sync mcp-server/content/llms.txt.
Phase 4 (README): replace invisible HTML keyword comment with visible
mini-FAQ (5 Q&A) for GEO crawlers.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-09 14:15:35 +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
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
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
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
174192f583
feat(seo): add CITATION.cff and improve AI discoverability
...
- Add CITATION.cff for academic citations and GitHub citation button
- Add "For AI Assistants" section in README with llms.txt reference
- Update machine-readable/llms.txt stats (4700+ → 9600+ lines)
- Bump version display to 3.8.0 in README footer
Improves discoverability in GitHub search, Google Scholar, and AI assistants
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:21:58 +01:00
Florian BRUNIAUX
f9044e2deb
feat(docs): add architecture deep-dive documentation v3.4.0
...
Add comprehensive technical documentation explaining Claude Code internals:
- NEW: guide/architecture.md (~800 lines) - Complete architecture deep-dive
- Master Loop (while tool_call), Tool Arsenal, Context Management
- Sub-Agent Architecture, Permission System, MCP Integration
- Edit Tool mechanics, Session persistence, Philosophy comparison
- 5 ASCII diagrams, source confidence tiers (Tier 1/2/3)
- guide/ultimate-guide.md: Add Section 2.7 "Under the Hood" summary
- guide/cheatsheet.md: Add "Under the Hood (Quick Facts)" section
- machine-readable/reference.yaml: Add architecture index + deep_dive refs
- Update all navigation links across repository
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:29:46 +01:00
Florian BRUNIAUX
bc07651cdf
refactor: restructure repo into thematic directories v3.1.0
...
Major repository reorganization for improved navigation:
New directory structure:
- guide/ - Core documentation (ultimate-guide, cheatsheet, adoption)
- tools/ - Interactive utilities (audit, onboarding, mobile-access)
- machine-readable/ - LLM/AI consumption (reference.yaml, llms.txt)
- exports/ - Generated outputs (PDFs)
Changes:
- Move 10 files to thematic directories with cleaner names
- Create README.md index for each new directory
- Update 150+ internal links across all documentation
- Add "Repository Structure" section to main README
- Remove redundant npm install command from README header
- Remove unverified cost estimate from prerequisites
- Fix broken anchor link (#-quick-start-15-minutes)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 15:30:02 +01:00
