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
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
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
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
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
