Commit graph

104 commits

Author SHA1 Message Date
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
Florian BRUNIAUX
7fd4048d5e feat: add learning guide & website badge
- Add "Visit Website" badge to README.md (prominent, top position)
- Add learning-with-ai.md guide for junior developers (~900 lines)
  - UVAL Protocol, dependency patterns, 30-day progression plan
- Add 3 learning templates (55 total):
  - examples/claude-md/learning-mode.md
  - examples/commands/quiz.md
  - examples/hooks/bash/learning-capture.sh
- Fix template count: 52 → 55 (was incorrectly showing 56)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 18:42:34 +01:00
Florian BRUNIAUX
b814c568d1 fix: correct template count to 53 (validated by sync script)
- Update sync script to include .json files in count
- Fix README.md and CLAUDE.md with accurate count

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:56:24 +01:00
Florian BRUNIAUX
fb9689fed3 docs: sync stats (57 templates, 9800+ lines)
- Update CLAUDE.md with current values
- Update README.md badges and line counts
- Add Fresh Context Pattern reference in methodologies.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:50:22 +01:00
Florian BRUNIAUX
6f968dbfc5 fix(sync): update landing sync script for new directory structure
- Change examples.html → examples/index.html
- Change quiz.html → quiz/index.html
- Add fresh-context-loop.sh script

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:42:03 +01:00
Florian BRUNIAUX
4a79455c4d docs(images): add wireframing tools & Figma MCP documentation
- Add Wireframing Tools section (Excalidraw, tldraw, Frame0, Paper+Photo)
- Add Figma MCP Integration with official setup and workflow
- Add Image Optimization for Claude Vision (resolution, tokens, formats)
- Create examples/mcp-configs/figma.json config template
- Update reference.yaml with new entries and shifted line numbers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:34:52 +01:00
Florian BRUNIAUX
d7c29f49c9 docs: prioritize grepai over mgrep as recommended semantic search
- Reorder sections in ultimate-guide.md (grepai first, mgrep second)
- Update cheatsheet.md MCP table (mgrep → grepai)
- Update quiz question 08-013 to reference grepai
- Sync versions to 3.8.2

Rationale: grepai is fully open-source, runs locally (privacy-first),
and offers call graph analysis that mgrep doesn't provide.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 15:29:33 +01:00
Florian BRUNIAUX
15475197ab feat(sync): add landing site synchronization system
- Add scripts/check-landing-sync.sh verifying 4 metrics:
  - Version (VERSION vs landing index.html)
  - Templates count (find examples/ vs landing badges)
  - Quiz questions (questions.json vs index.html + quiz.html)
  - Guide lines (with ±500 tolerance)
- Update CLAUDE.md with sync documentation and expected output
- Fix templates count: 87 → 49 in README.md badges and text

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 12:21:09 +01:00
Florian BRUNIAUX
373b0c7ed1 docs(claude): sync version reference to 3.8.1
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:46:19 +01:00
Florian BRUNIAUX
bc9b3fda3a chore(version): bump to 3.8.1
- Add PDF generation documentation to CHANGELOG
- Sync version across all docs (README, cheatsheet, ultimate-guide, reference.yaml)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:34:12 +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
36530c121c docs(changelog): document whitepaper template modernization
- New Slate + Indigo color palette (WCAG AA)
- Inter font + JetBrains Mono for code
- Cover redesign with Claude Code logo
- Fixed 42 nested markdown code blocks
- Added GitHub links for script references
2026-01-16 11:14:28 +01:00
Florian BRUNIAUX
4640e4e3e0 feat(visibility): add TTFV optimization, CONTRIBUTING rewrite, and distribution playbooks
Phase 0 - Foundation work for visibility campaign:

- Add TL;DR Quick Start section in README with CLAUDE.md template
- Rewrite CONTRIBUTING.md with welcome message, contribution types, PR process
- Add CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
- Document French whitepapers series (8 docs, ~185 pages) in README
- Add distribution playbooks in claudedocs/ (gitignored)
- Add prominent badges (version, license, Claude Code support)

TTFV (Time-to-First-Value) optimized from ~10min to < 5min.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 09:27:28 +01:00
Florian BRUNIAUX
3f246644a7 docs(readme): add prominent badges and rewrite Why This Guide section
- Add for-the-badge style badges (Stars, Lines 9600+, Templates 87, Quiz 159)
- Rewrite "Why This Guide" with problem-focused hook (awesome-lists, docs, tutorials pain points)
- Fix line count from 9500 to 9600
- Reorganize badge layout with centered alignment

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 08:59:17 +01:00
Florian BRUNIAUX
395308de5e docs(readme): add Dev With AI community reference
- French-speaking community for developers (~1500 on Slack)
- Meetups in Paris, Bordeaux, Lyon
- Placed near top of README for visibility

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 19:38:42 +01:00
Florian BRUNIAUX
792d46d4b8 docs(mcp): add grepai vs grep/rg benchmark comparison
- Add "Performance vs Traditional Tools" section with timing comparison
- Update decision tree with "Know exact pattern?" branch
- Update Server Comparison table with exact match recommendation
- Document key insight: grepai finds what pattern-based tools cannot

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 15:31:23 +01:00
Florian BRUNIAUX
1b5514e0e6 feat(onboarding): add adaptive pedagogy and multi-LLM compatibility
- Add communication tone preference (pedagogical/direct/coaching/adaptive)
- Extend style preference to all goals at 15min threshold
- Add "reset" option for mid-journey preference changes
- Add "skip" shows what's being skipped
- Add fallback roadmap when reference.yaml fetch fails
- Add multi-LLM compatibility footnote (works on ChatGPT, Gemini, etc.)
- Update reference.yaml with tone question and question_flow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 14:28:28 +01:00
Florian BRUNIAUX
846e2e6a1b docs(mcp): add grepai semantic search and call graph documentation
- Add grepai section in ultimate-guide.md (Section 8.3)
  - Privacy-first semantic code search using Ollama embeddings
  - Call graph analysis: trace callers, callees, dependency graphs
  - Combined workflow with Serena for exploration + editing
  - Setup instructions and MCP tools reference
- Update decision tree and comparison table to include grepai
- Add grepai config to examples/config/mcp.json
- Document changes in CHANGELOG.md [Unreleased]

Source: https://github.com/yoanbernabeu/grepai

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:56:18 +01:00
Florian BRUNIAUX
8fc9fb5568 docs(data-privacy): add Intellectual Property Considerations section
- Add new section 8 with IP disclaimer and key considerations table
- Cover: ownership, license contamination, vendor indemnification, sector compliance
- Bump version to 3.7.1
- Update .gitignore to exclude .grepai/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:41:03 +01:00
Florian BRUNIAUX
10c8665219 docs(methodologies): add Writing Effective Specs section
Add new section based on Addy Osmani's analysis of 2,500+ agent configs:
- Six essential components for specs (commands, testing, structure, style, git, boundaries)
- Permission tiers system (Always/Ask/Never)
- Curse of Instructions warning (more rules = worse adherence)
- Monolithic vs Modular decision table

Source: https://addyosmani.com/blog/good-spec/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:28:35 +01:00
Florian BRUNIAUX
71a08ca36a feat(scripts): session-search v2.1 - JSON encoding fix and clean previews
Bug fixes on top of v2.0:
- json_escape() function: proper backslash/quote escaping
- Preview cleanup: strip XML tags (<local-command-caveat>)
- Filter non-printable unicode characters

Quality score: 8/10 → 9.3/10

Tested with 239 sessions, all features validated.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 10:20:52 +01:00
Florian BRUNIAUX
785727d16c feat(scripts): session-search v2.0 with advanced filtering
- Multi-word AND search (all words must match)
- Project filter (-p, --project)
- Date filter (--since today/7d/30d/YYYY-MM-DD)
- JSON output (--json) for scripting
- Improved preview extraction (skips tool results)
- 3s search timeout for safety
- Updated documentation in observability.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:52:54 +01:00
Florian BRUNIAUX
30cbe57d1e docs(readme): add onboarding screenshots preview
- Add 4 screenshots showing interactive onboarding flow
- Collapsible gallery (2x2 grid) under one-liner command
- Images in assets/screenshots/ with descriptive names

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:34:31 +01:00
Florian BRUNIAUX
e4d00c7772 docs(onboarding): add clickable GitHub URLs for resources
Phase 4 wrap-up now provides:
- Direct GitHub links for quiz, cheatsheet, full guide
- Section-specific link format with line anchors (#L{line})
- Privacy guide link updated

Improves UX for users running onboarding via one-liner (no local repo)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:18:43 +01:00
Florian BRUNIAUX
46c5862c4e fix(docs): critical factual corrections v3.6.1
Major audit correcting misleading documentation about Claude Code behavior:

### Fixed
- `--add-dir`: permissions (not context loading)
- `excludePatterns` → `permissions.deny` (never existed)
- `.claudeignore` removed (not an official feature)
- "selective loading" myth → lazy loading reality
- Invented CLI flags (`--think`, `--headless`, `--learn`) → prompt keywords
- `@` file reference: "loads automatically" → "reads on-demand"

### Added
- Session Search Tool (`cs`) - zero-dep bash script for finding sessions
- Security section: Known limitations of permissions.deny

15 files modified, 516 insertions, 200 deletions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 09:16:53 +01:00
Florian BRUNIAUX
0552522030 docs(claude): add Perplexity Pro research resource
User has Perplexity Pro license - Claude can request advanced
searches for reliable sources on Claude Code, Anthropic updates,
and AI-assisted development best practices.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:49:27 +01:00
Florian BRUNIAUX
8da84104c6 feat: add CLAUDE.md project context
- Repository purpose and structure
- Key files reference
- Version management commands
- Documentation conventions
- Quick lookup workflow for answering questions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:24:32 +01:00
Florian BRUNIAUX
7084c48cf8 docs(changelog): add version sync infrastructure entry
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:21:13 +01:00
Florian BRUNIAUX
81a5caa5db feat(docs): add security-hardening navigation + onboarding matrix
README.md:
- Added security-hardening.md to Core Documentation table
- Added to "Not Sure Where to Start?" section
- Added to Power User learning path

machine-readable/reference.yaml:
- Added onboarding_matrix for personalized learning paths
- Added onboarding_questions structure for interactive profiling

tools/onboarding-prompt.md:
- Restructured for goal-based profiling (2 questions → tailored content)
- Simplified from assessment-heavy to action-oriented flow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:20:50 +01:00
Florian BRUNIAUX
5575ae69a8 feat: add VERSION file as single source of truth + sync script
- Create VERSION file (3.6.0) as the canonical version source
- Add scripts/sync-version.sh for automated version synchronization
- Fix version inconsistencies in cheatsheet.md and ultimate-guide.md
- Script supports --check mode for CI validation

Usage: ./scripts/sync-version.sh [--check]

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 08:18:32 +01:00
Florian BRUNIAUX
34b2ca7200 feat(security): add security hardening guide and hooks v3.6.0
- Add guide/security-hardening.md (~10K) covering:
  - MCP vetting workflow with CVE-2025-53109/53110, 54135, 54136
  - Prompt injection evasion techniques (Unicode, ANSI, null bytes)
  - Secret detection tool comparison (Gitleaks, TruffleHog, GitGuardian)
  - Incident response procedures

- Add 3 new security hooks:
  - unicode-injection-scanner.sh: zero-width, RTL, ANSI escape detection
  - repo-integrity-scanner.sh: scan README/package.json for injection
  - mcp-config-integrity.sh: verify MCP config hash

- Update existing hooks:
  - prompt-injection-detector.sh: +ANSI, +null bytes, +nested cmd
  - output-secrets-scanner.sh: +env leakage, +generic tokens

- Update cross-references in ultimate-guide.md (§7.4, §8.6)
- Move MCP Security Hardening to Done in IDEAS.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 07:39:53 +01:00
Florian BRUNIAUX
55a9fa34cf docs: add missing security-hardening.md to navigation
- README.md: add to Core Documentation, Not Sure Where to Start?, Power User path
- guide/README.md: add to Contents table
- CHANGELOG.md: update Unreleased section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 07:18:56 +01:00
Florian BRUNIAUX
89715680f6 docs: improve README.md navigation and structure alignment
- Repository Structure: add guide/workflows/, examples/modes/, config/, memory/
- Core Documentation: add methodologies.md, workflows/, data-privacy.md, observability.md
- Slash Commands: add generate-tests, review-pr, git-worktree, validate-changes
- Security Hooks: add 2 hooks + link to complete catalog
- Not Sure Where to Start?: add 5 navigation entries
- By Role Paths: enhance all 4 paths with new resources
- SEO Keywords: add 9 keywords for discoverability

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-15 07:07:45 +01:00
Florian BRUNIAUX
f7551037fe feat(docs): add development methodologies documentation v3.5.0
- Add guide/methodologies.md: index of 15 methodologies with decision tree
- Add guide/workflows/: 4 practical workflow guides
  - tdd-with-claude.md: TDD with Claude-specific patterns
  - spec-first.md: SDD adapted for CLAUDE.md
  - plan-driven.md: effective /plan mode usage
  - iterative-refinement.md: prompt→feedback→reprompt loops
- Add Section 9.14 in ultimate-guide.md linking to workflows
- Update guide/README.md with new documentation
- Bump version 3.4.0 → 3.5.0 across all files

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 22:28:02 +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
fb49152ee5 chore: consolidate IDEAS.md and bump version to 3.3.1
- IDEAS.md: Reduce from 12 to 4 actionable research topics
- Unified "MCP Security Hardening" (merged 3 overlapping topics)
- Expanded Discarded section (3 → 16 entries with justifications)
- Technical writer agent validation against reference.yaml
- Version bump: 3.3.0 → 3.3.1 across all docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:12:04 +01:00
Florian BRUNIAUX
8a4d116e2e feat(docs): add LLM Handbook + Google Whitepaper integration v3.3.0
Advanced Guardrails:
- prompt-injection-detector.sh (PreToolUse)
- output-validator.sh (PostToolUse heuristics)
- claudemd-scanner.sh (SessionStart injection detection)
- output-secrets-scanner.sh (PostToolUse secrets leak prevention)

Observability & Monitoring:
- session-logger.sh (JSONL activity logging)
- session-stats.sh (cost tracking & analysis)
- guide/observability.md (full documentation)

LLM-as-a-Judge Evaluation:
- output-evaluator.md agent (Haiku)
- /validate-changes command
- pre-commit-evaluator.sh (opt-in git hook)

Google Agent Whitepaper Integration:
- Context Triage Guide (Section 2.2.4)
- CLAUDE.md Injection Warning (Section 3.1.3)
- Agent Validation Checklist (Section 4.2.4)
- MCP Security: Tool Shadowing & Confused Deputy (Section 8.6)
- Session vs Memory patterns (Section 3.3.3)

Stats: 10 new files, 8 modified, 5 new guide sections

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:00:49 +01:00
Florian BRUNIAUX
19110eba22 feat(docs): add comprehensive data privacy documentation v3.2.0
- Create guide/data-privacy.md with retention policies (5y/30d/0)
- Add privacy notice to README.md
- Add section 2.6 "Data Flow & Privacy" to ultimate-guide.md
- Add Golden Rule #7 to cheatsheet.md (know what's sent)
- Add Phase 0.5 Privacy Awareness to onboarding-prompt.md
- Add privacy checks to audit-prompt.md
- Add PRIVACY CHECK section to audit-scan.sh (human + JSON)
- Add privacy reminder to check-claude.sh
- Create privacy-warning.sh SessionStart hook

Addresses user awareness of Anthropic data retention and opt-out options.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 20:42:19 +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
Florian BRUNIAUX
06b9fe2c51 feat(docs): add mobile access guide (ttyd + Tailscale) v3.0.7
- New mobile-access-setup.md with ToS-safe remote access solution
- ttyd exposes terminal via browser, Tailscale provides secure VPN
- Complete setup script with tmux for persistent sessions
- Marked as WIP/UNTESTED - community feedback welcome
- Added to README navigation table
- Version bump 3.0.6 → 3.0.7

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 14:26:46 +01:00